Promoting and Demoting

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.

|-----------------------------+----------------------------|
| Promotion Outside Org Table | Demotion Outside Org Table |
|-----------------------------+----------------------------|
| M-TAB or Shift-TAB          | TAB                        |
| M-<left>                    | M-<right>                  |
| M-Shift-<left>              | M-Shift-<right>            |
| C-c C-,                     | C-c C-.                    |
| C-c C-<                     | C-c C->                    |
|-----------------------------+----------------------------|

Trees may be demoted or promoted by pressing TAB or {M-TAB}. {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 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, however, in which case the maximal possible adjustment is made.

{M-1 TAB} behaves specially. It toggles the function of TAB and {M-TAB} so that they insert a tab and remove the previous character, respectively. This is useful when one is formatting information within a single cell. When in this mode, {TAB} inserts a literal TAB character, by default. Set the variable, kotl-mode:indent-tabs-mode, to ‘nil’ if you want space characters used to form the tab. Use {M-1 TAB} to toggle the TAB and {M-TAB} keys back to promoting and demoting trees.

The Koutliner also supports Org Table editing, see Tables in the Org Mode Manual, via Org table minor mode. Use {M-x orgtbl-mode RET} to toggle this on and off. A press of the Action Key on a | symbol, also toggles this minor mode on or off.

Tree demotion and promotion keys match the defaults in Org mode and Outline mode, plus some easier to type ones. The tables below summarize which keys work whether inside an Org table or outside.

Note that you must use {M-0 TAB} and {M-0 M-TAB} to demote/promote Koutline trees when in a table since TAB and {M-TAB} move between fields within a table.

|----------------------------+-----------------------------|
| Promotion Inside Org Table | Demotion Inside Org Table   |
|----------------------------+-----------------------------|
| M-0 M-TAB                  | M-0 TAB                     |
| C-c C-,                    | C-c C-.                     |
| C-c C-<                    | C-c C->                     |
|----------------------------+-----------------------------|