When you install an Info file onto your system, you can use the program
install-info to update the Info directory file `dir'.
Normally the makefile for the package runs
after copying the Info file into its proper installed location.
In order for the Info file to work with
install-info, you should
use the commands
@direntry in the
Texinfo source file. Use
@direntry to specify the menu entry to
add to the Info directory file, and use
@dircategory to specify
which part of the Info directory to put it in. Here is how these
commands are used in this manual:
@dircategory Texinfo documentation system @direntry * Texinfo: (texinfo). The GNU documentation format. * install-info: (texinfo)Invoking install-info. ... ... @end direntry
Here's what this produces in the Info file:
INFO-DIR-SECTION Texinfo documentation system START-INFO-DIR-ENTRY * Texinfo: (texinfo). The GNU documentation format. * install-info: (texinfo)Invoking install-info. ... ... END-INFO-DIR-ENTRY
install-info program sees these lines in the Info file, and
that is how it knows what to do.
Always use the
@dircategory commands near
the beginning of the Texinfo input, before the first
command. If you use them later on in the input,
will not notice them.
If you use
@dircategory more than once in the Texinfo source,
each usage specifies one category; the new menu entry is added to the
Info directory file in each of the categories you specify. If you use
@direntry more than once, each usage specifies one menu entry;
each of these menu entries is added to the directory in each of the
Go to the first, previous, next, last section, table of contents.