Know that I'm on the right revision, here are some proposals:

Creating and destroying nodesNow that I'm looking at the right
leoDoc.leo:

Chapter 3 --
Outline Related ---
Navigating through the outline ----
...
When focus is in the outline Pane, you can move from
node to node by typing the first letter of a headline. For example,
typing 'a'
will go to the next visible headline that starts with either 'a' or
'A',
wrapping around to the start of the outline if needed. Typing an
uppercase 'A'
will go to the next headline that starts with 'a' or 'A', making the
node
visible (expanding its ancestors) if the node was not visible.
-> this is not implemented in the Qt gui

Expanding & contracting nodes ----
You can expand or contract a node by clicking in the tree view icon to
the left of the headline.  The icon in the Qt gui matches the native
OS's tree view icon, i.e. for Mac's; a triangle pointing right or
down, on Windows; (also when using the Tk gui), a square containing a
plus or minus.  Expanding a node shows its immediate children;
contracting a node hides all its children.  The corresponding commands
are ``expand-node`` and ``contract-node``.  For more convenient
navigation, there are ``expand-and-go-right`` and ``contract-or-go-
up`` which are bound to Alt-Right and Alt-Left.

The ``expand-all`` command expands every node in the outline.
``contract-all`` contracts every node in the outline.  Both commands
are availble in the Outline->Expand/Contract... submenu.  ``contract-
all`` is bound to Atl-- (Alt modifying a single hyphen).  In all but
the smallest outlines, ``expand-all`` is rarely used, and so does not
have a key binding.
--> note that there is no expand-all-subheads command, as bourne out
by trial minibuffer expansion.

Creating and destroying nodes ----
The ``insert-node`` command inserts a new node into the outline; it is
bound to Control-I and the Insert key.  When invoked, (from any pane),
it inserts a new node below the presently selected node, and at the
same level as that node, or at the child level if it has a child
vissible.
The ``delete-node`` command deletes a node and all its children; it is
initially unbound.  If you want to retain the children you must
promote all the children before you do the delete.

Cloning nodes ----
A cloned node wil become a regular node
again whenever deletion makes it the only instance left.
A cloned node is a copy of a node that changes when the original
changes. One may also think of it as a single node that is hooked into
the outline at multiple positions.  Because that single node brings
along all its desendants, changes are maintained across all the the
clones of a node, along with changes to its offspring (children,
grandchildren, etc.), i.e. any changes are simultaneously made to the
corresponding offspring of all of those clones. A small red arrow in
the icon box marks cloned nodes. You can think of the arrow as
pointing out that there are other paths to get to this same node.
There is no real distinction between the "original" node and any of
its clones.  Any headline or body update of a clone headed subtree
affects all of its clones simultaneously.  A cloned node becomes a
regular node whenever deletion of its other clones makes it the only
one left. Clones are useful for making alternate views of a program.
See `Clones and views`_ for full details.

The command ``clone-node``, (Clone Node in the Outline menu, bound to
Control-`) creates a clone as the immediate sibling of a selected
node. You have to place it where you want it by either using move
commands, or cutting and paste the clone.





-- 
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.

Reply via email to