6.3 Manual Structure Details

The title page of the manual should state the version of the programs or
packages documented in the manual. The Top node of the manual should
also contain this information. If the manual is changing more
frequently than or independent of the program, also state a version
number for the manual in both of these places.

Each program documented in the manual should have a node named
‘program Invocation’ or ‘Invoking program’. This
node (together with its subnodes, if any) should describe the program's
command line arguments and how to run it (the sort of information people
would look for in a man page). Start with an ‘@example’
containing a template for all the options and arguments that the program
uses.

Alternatively, put a menu item in some menu whose item name fits one of
the above patterns. This identifies the node which that item points to
as the node for this purpose, regardless of the node's actual name.

The ‘--usage’ feature of the Info reader looks for such a node
or menu item in order to find the relevant text, so it is essential
for every Texinfo file to have one.

If one manual describes several programs, it should have such a node for
each program described in the manual.