A/UX® Programmer's Reference Sections

man(5) man(5)
EXAMPLES
The man macros are provided to process manual pages already
on-line at a given location and to enable users to make their own
manual pages. The preceding section demonstrated the usage of
the macros themselves; the following section provides examples
of command lines typically used to process the completed files.
man macros are designed to run with either nroff or troff.
The first command line will process a file using only macros and
nroff requests:
nroff -TIp -man file I lp
The file is piped to the local line printer, lp.
The next command line will process a file containing tables as
well as macros and nroff requests:
tbl I nroff -TIp -man file I col I lp
Notice that before it is sent to the line printer, the output is first
filtered through col, to process the reverse line feeds used by
tbl.
The final example is a command line that processes an unusual
manual page, one using pic. If the manual pages created with
man are intended for an on-line facility, components requiring
troff, such as pic (or grap) should be avoided since the average
installation of terminals will not be able to process typeset documents.
pic file I tbl I troff -Taps -man I typesetter
grap precedes pic because it is a preprocessor to pic; the reverse
order, of course, will not format correctly. The file contains
one or more tables, requiring tbl, but col is no longer necessary
because typeset documents do not use reverse line feeds with
which to make tables. The -T flag option for specifying the output
device (terminal type) takes the argument aps here, readying
the document for processing on the APS-5 phototypesetter.
CAVEATS
Special macros, strings, and number registers exist, internal to
man, in addition to those mentioned above. Except for names
predefined by troff(1) and number registers d, m, and y, all
such internal names are of the form XA, where X is one of ) , ],
and }, and A stands for any alphanumeric character.
February, 1990
Revision C
3