texinfo: First Node

@node

@top Command

Node Line Requirements

Back to Software Index

6.1.4 The First Node
--------------------

The first node of a Texinfo file is the "Top" node, except in an
included file (Note: Include Files).  The Top node should contain a
short summary, copying permissions, and a master menu.  Note: The Top
Node, for more information on the Top node contents and examples.

  Here is a description of the node pointers to be used in the Top node:

   * The Top node (which must be named 'top' or 'Top') should have as
     its 'Up' node the name of a node in another file, where there is a
     menu that leads to this file.  Specify the file name in
     parentheses.

     Usually, all Info files are installed in one system-wide Info tree
     (often constructed from multiple directories).  In this case, use
     '(dir)' as the parent of the Top node; this specifies the top-level
     node in the 'dir' file, which contains the main menu for the Info
     system as a whole.

   * The 'Next' node of the Top node should be the first chapter in your
     document.

  Note: Installing an Info File, for more information about installing
an Info file in the 'info' directory.

  It is usually best to leave the pointers off entirely and let the
tools implicitly define them, with this simple result:

     @node Top