www.delorie.com/gnu/docs/hyperbole/hyperbole_42.html

search

	Buy GNU books!

Hyperbole User Manual

7.5.2 Relocating and Copying

Demotion is the act of moving a tree down one or more levels in the outline. The new tree will become either the successor or the first child of the cell which precedes it in the outline. Promotion is the inverse operation. Note that trees (cells and their entire substructure) are promoted and demoted, not individual cells.

Trees may be demoted or promoted by pressing {TAB} or {M-TAB} respectively, as in most outliners today. {M-0 TAB} and {M-0 M-TAB} demote and promote trees and additionally refill each cell that is not specially marked to prevent refilling. See section 7.5.4 Filling. A positive or negative prefix argument to these commands promotes or demotes the tree up to a maximum of the number of levels given by the argument. The outline may not support movement of the tree by the number of levels requested.

For maximum flexibility in rearranging outlines, there are commands that move or copy entire trees. Each of these commands prompts for the label of the root cell to move or copy and for second cell at the new location for the moved or copied tree. You can either accept the default provided, type in the cell label or when a mouse is available, simple double click with the Action Key on the contents of a cell. The Koutliner knows to use the cell's label in such cases.

In these following commands, words delimited with <> represent the arguments for which each command prompts. Note how the use of prefix arguments changes each command's behavior from insertion at the sibling level to insertion at the child level.

C-c c

Copy <tree> to be the successor of <cell>.

C-u C-c c

Copy <tree> to follow as the first child of <cell>.

C-c C-c

Copy <tree> to be the predecessor of <cell>.

C-u C-c C-c

Copy <tree> to be the first child of the parent of <cell>.

C-c m

Move <tree> to be the successor of <cell>.

C-u C-c m

Move <tree> to follow as the first child of <cell>.

C-c C-m

Move <tree> to precede <cell>.

C-u C-c C-m

Move <tree> to be the first child of the parent of <cell>.

If you have mouse support under Hyperbole, you can move entire trees with mouse clicks. Simply click the Assist Key within the indentation to the left of a cell and you will be prompted for a tree to move. Double click the Action Key within the contents the root cell of the tree to move and then double click within the contents of the root cell of the tree you want it to follow as a sucessor.

Copying and moving only work within a single outline right now, so don't try to use them to move trees across different outline files. You can, however, copy an outline tree to a non-outline buffer with:

C-c M-c

Copy <tree> to a non-koutline buffer.

C-c @

Copy a <tree> to an outgoing mail message.