View Specs
View specifications (view specs, for short) are short codes used to control the view of a koutline. The view specs in effect for an outline are always displayed in the modeline of the outline’s window, following the outline buffer name, unless the variable, kvspec:string, has been set to ‘nil’ to disable view spec display. The modeline display appears as <|viewspec> to aid rapid visual location. The | (pipe character) is also used in links that specify view specs to indicate the start of a view spec sequence. See Klinks.
The current view spec is saved whenever the outline is saved. The next time the outline is read in, the same view spec will be applied.
The rest of this section documents the view spec characters that are presently supported and explains how to invoke a view spec. There is no user-level means of adding your own view spec characters, so all other character codes are reserved for future use.
{C-c C-v} prompts for a new view spec setting in which the following codes are valid. Any invalid characters in a view spec are ignored. Characters are evaluated in an order meant to do the right thing, even when you use conflicting view spec characters. The standard initial view spec is <|ben>.
a
Show all cell levels and all lines in cells.
b
Turn on blank lines between cells. Without this character, blank lines will be turned off. You may also use the {C-c b} key binding to toggle blank lines on and off independently of any other view settings.
cN
Hide any lines greater than N in each cell. 0 means don’t cutoff any lines.
e
Show ellipses when some content of a cell or its subtree is hidden. This cannot be turned off.
lN
Hide cells at levels deeper than N. 0 means don’t hide any cells.
n
Turn on the default label type, as given by the variable, kview:default-label-type. Normally, this is alphanumeric labels.
n0
n1
Display alpha labels, e.g. 1d3
n.
Display legal labels, e.g. 1.4.3
As a test, use {C-h h k e} to display the example koutline. Then use {C-c C-v} to set a view spec of ‘c2l1’. This will turn off blank lines, clip each cell after its second line, and hide all cells below level one.