Here are some notes for part of chapter 4
Overview: creating and using external files -
You create and use external files using @<file> directives.
Most of these directives may only appear in headlines.
Here are all the ways of creating external files:
Perhaps:
You create and use external files by @<file> directives.
Most of these directives may only appear in headlines.
They consist of one of the directives below, a space, and
a path and file name, or a filename resolvable via a
@path directive in an ancestor node.
Note that for all these directives, (except @root), only body
text occurring in the directive's subtree can end up in the file
written, (neglecting sentinel text).
Here are all the ways of creating external files:
...
The choice between CWEB and noweb is independent of the directive is
used to create external files.
Perhaps:
The choice between CWEB and noweb is independent of which directive is
used to create external files.
or:
The choice between CWEB and noweb is independent of whatever directive
is used to create external files.
Overview: summary of directives -
- *...@auto**
Imports the external file every time Leo reads the outline.
The read-at-auto-nodes and write-at-auto-nodes commands can
be used to read and write and @auto nodes.
To:
- *...@auto**
Imports the external file every time Leo reads the outline.
Leo determines what computer language that file is written in
from its extension, and uses a set of rules defined for that
language
to create an outline for that file "auto"-maticaly. If no rules
exist for that language, the file is first put in a single node,
the same as @edit.
The read-at-auto-nodes command does the same thing as opening up an
outline
with an @auto node does. The write-at-auto-nodes command will do
the same
thing as a save, that is, write out the @auto nodes.
- *...@ignore**
Causes Leo to ignore all or part of an external file.
Hmm, that does not seem quite right, isn't it something closer to:
- *...@ignore**
Causes Leo to ignore this node and its descendants when writing out
an external file.
- *...@lineending**
Sets the line ending to be used in external files.
Additionally:
- *...@lineending**
Sets the line ending to be used in external files.
Note that Leo uses newlines in its internal buffers,
this directive only controls what line ending will
be used in the file(s) it writes out.
- *...@pagewidth**
Sets the page width used to break doc parts into lines.
Additionally:
- *...@pagewidth**
Sets the page width used to break doc parts into lines.
In Leo, doc parts are comments that can be written as paragraphs,
letting Leo wrap them to fit in the body pane. This directive
tells what column to wrap them at when writing them to an external
file.
- *...@path**
Set the path to be appended to filenames.
Additionally:
- *...@path**
Sets the path to be appended to the filenames following any @<file>
directive. This only affects descendant @<file> nodes.
- *...@verbose**, *...@terse**, *...@quiet** and *...@silent**
Set the verbosity of sentinels in external files from @root.
Perhaps:
- *...@verbose**, *...@terse**, *...@quiet** and *...@silent**
Set the verbosity of sentinels in external files generated from an
@root.
Tom
On Jul 17, 2:02 pm, thyrsus <[email protected]> wrote:
> Proofreading much appreciated!
--
You received this message because you are subscribed to the Google Groups
"leo-editor" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/leo-editor?hl=en.
