standards.info: Manual Structure Details
Go forward to NEWS File
Go backward to GNU Manuals
Go up to Documentation
Go to the top op standards
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 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
in a man page for). 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.
There will be automatic features for specifying a program name and
quickly reading just this part of its manual.
If one manual describes several programs, it should have such a node
for each program described.
Created Wed Sep 1 16:42:54 2004 on bee with info_to_html version 0.9.6.