Your welcome. Working on the doc is important and I did not want you
work to go unacknowledged.
Here is some more:
Reference: creating and using external files -
...
Leo can not update the outline from changes made from external files
unless
those files contain sentinels. The primary source for @nosent and
@asis trees
are the outlines from which those files were created.
Perhaps:
Leo can not update the outline from changes made to external files
unless
those files contain sentinels. The primary source for @nosent and
@asis trees
are the outlines from which those files were genrated.
For @shadow trees, Leo creates *two* files, a **public** file without
sentinels,
and a **private** file (by default in the .leo_shadow subfolder)
containing
sentinels. The primary sources for @shadow trees are the private
files, updated
by changes to the public file.
Perhaps:
For @shadow headed trees, Leo creates *two* files, a **public** file
without
sentinels, and a **private** file with sentinels, (by default, the
private file
is placed in the .leo_shadow subfolder of .leo). The primary sources
for
@shadow trees are the private files, updated by changes to the public
file.
Note: Primary source is not defined and seems a little loose in usage
here,
probably needs tightened up.
\...@auto --
...
b) they do not contain a **significant** amount of information. An
@auto tree
contains a significant amount of information if it has children or
if the
root node contains more than 10 characters.
Perhaps:
b) they do not contain a **significant** amount of information. An
@auto tree
contains a significant amount of information if it has children or
if the
body of the @auto node contains more than 10 characters.
@edit --
Initially, Leo's File:Open command creates such nodes when opening any
non-.leo file.
When writing @edit nodes, Leo uses Leo's @auto write logic. That is,
no sentinels are written.
When reading @edit nodes, Leo just puts then entire text of the file
into the node, along with @language or @nocolor directives as
appropriate. These added directives will not change the file when it
gets written because no sentinels are written.
Perhaps:
This directive causes the file named to be placed in the node's body
each time the containing leo file is opened.
Initially, Leo's File:Open command creates such nodes when opening any
non-.leo file.
When writing @edit nodes, Leo uses Leo's @auto write logic. That
means
that any reorganizing you do using outlining will overwrite the file,
however, no sentinels will be written. Note that any such
reorganizing
will be messed up the next time the leo file is reopened, if you want
to
retain your new outline, change the @auto directive, (@nosent would
keep it sentinel free if that is your desire).
When reading @edit nodes, Leo just puts then entire text of the file
into the node, along with @language or @nocolor directives as
appropriate. These added directives will not change the file when it
gets written because no sentinels are written and thus the sentinels
that would contain these drectives are not created.
@nosent --
...
In effect, the default value of this
setting was False in previous versions of Leo.
Perhaps:
Note: earlier versions of Leo had a default value of False.
@asis --
...
- Files created from @asis trees contain *nothing* not contained in
body
text (or @@ headlines). In particular, if body text does not end in
a
newline, the first line from the next node will concatenated to the
last line
of the preceding node.
Perhaps:
- Files created from @asis trees have *nothing* not contained in body
text or @@ headlines. In particular, if body text does not end in a
newline, the first line from the next node will concatenated to the
last line
of the preceding node.
\...@root reference --
...
- @file and @thin trees use less markup than @root trees.
In particular, the @others directive is valid only within @file and
@thin trees.
Additionally:
- @file and @thin trees use less markup than @root trees. This stems
from the
requirement that the expansion for any section reference or
directive must be
foumd in the subtree of the point where the expansion is needed.
Note in particular, the @others directive is valid only within @file
and @thin trees.
On Jul 21, 2:16 am, thyrsus <[email protected]> wrote:
> Thanks so much! I'll be incorporating these tomorrow. I also see I
> missed an instance of @path "appending" - @path "prepends", or,
> probably better, "prefixes".
>
> - Stephen
--
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.
