GNU Info

(texinfo)First Node

---

Next: makeinfo top command Prev: Node Line Requirements Up: node

---

Enter node , (file) or (file)node

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 contains the main
or master menu for the document, and a short summary of the document
(Note: Top Node Summary).

  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.  If the
file is to be installed directly in the Info directory file, use
`(dir)' as the parent of the Top node; this is short for `(dir)top',
and specifies the Top node in the `dir' file, which contains the main
menu for the Info system as a whole.  For example, the `@node Top' line
of this manual looks like this:

     @node Top, Copying, , (dir)

(You can use the Texinfo updating commands or the `makeinfo' utility to
insert these pointers automatically.)

  Do not define the `Previous' node of the Top node to be `(dir)', as
it causes confusing behavior for users: if you are in the Top node and
hits <DEL> to go backwards, you wind up in the middle of the some other
entry in the `dir' file, which has nothing to do with what you were
reading.

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