Menus Need Short Nodes
A reader can easily see a menu that is close to the beginning of the
node. The node should be short. As a practical matter, you should
locate a menu within 20 lines of the beginning of the node. Otherwise,
a reader with a terminal that displays only a few lines may miss the
menu and its associated text.
The short text before a menu may look awkward in a printed manual. To
avoid this, you can write a menu near the beginning of its node and
follow the menu by an `@node' line, and then an `@heading' line located
within `@ifinfo' and `@end ifinfo'. This way, the menu, `@node' line,
and title appear only in the Info file, not the printed document.
For example, the preceding two paragraphs follow an Info-only menu,
`@node' line, and heading, and look like this:
* Menu Location:: Put a menu in a short node.
* Writing a Menu:: What is a menu?
* Menu Parts:: A menu entry has three parts.
* Less Cluttered Menu Entry:: Two part menu entry.
* Menu Example:: Two and three part entries.
* Other Info Files:: How to refer to a different
@node Menu Location, Writing a Menu, , Menus
@heading Menus Need Short Nodes
The Texinfo file for this document contains more than a dozen
examples of this procedure. One is at the beginning of this chapter;
another is at the beginning of the "Cross References" chapter.
Next: Writing a Menu Prev: Menus Up: Menus
[ Dokumentation lokal installierter Software ]