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

search

	Buy GNU books!

Hyperbole User Manual

7.6.2 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 modeline display. The modeline display appears as <|viewspec> so that you can easily pick them out. The | (pipe character) is also used in links that specify view specs to indicate the start of a view spec sequence. See section 7.7 Links.

The current view spec is saved whenever the outline is saved. The next time the outline is read in, this will be the initial view.

The rest of this section documents the the view spec characters that are presently supported and explains how to invoke a view spec. There is no user-level way to add your own view spec characters, so all 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 can also use the {C-c b} key binding to toggle line numbers on and off independent 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.

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

Display idstamps.

n1

Display alpha labels.

n2

Display partial alpha labels (don't use this, as full alpha labels are better).

n.

Display legal labels.

n*

Display star labels. A level three cell would have three asterisks as a label, for example.

n~

Turn off labels. (n viewspec is removed from modeline).

As a test, use {C-h h o 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.