CATMAN(8) System Manager's Manual CATMAN(8)
catman - create the cat files for the manual
/usr/etc/catman [-nptw] [-M directory ] [-T tmac.an ] [ sections ]
catman creates the preformatted versions of the on-line manual from the
nroff(1) input files. Each manual page is examined and those whose
preformatted versions are missing or out of date are recreated. If any
changes are made, catman recreates the whatis database.
If there is one parameter not starting with a `-', it is taken to be a
list of manual sections to look in. For example
only updates manual sections 1, 2, and 3.
If an unformatted source file contains only a line of the form `.so
manx/yyy.x', a symbolic link is made in the catx or fmtx directory to
the appropriate preformatted manual page. This feature allows easy
distribution of the preformatted manual pages among a group of associ-
ated machines with rdist(1), since it makes the directories of prefor-
matted manual pages self-contained and independent of the unformatted
-n Do not (re)create the whatis database.
-p Print what would be done instead of doing it.
-t Create troffed entries in the appropriate fmt subdirectories
instead of nroffing into the cat subdirectories.
-w Only create the whatis database that is used by whatis(1) and
the man(1) -f and -k options. No manual reformatting is done.
-M Update manual pages located in the specified directory (/usr/man
-T Use tmac.an in place of the standard manual page macros.
TROFF The name of the formatter to use when the -t flag is given. If
not set, `troff' is used.
/usr/[share]/man default manual directory location
raw (nroff input) manual sections
preformatted nroffed manual pages
preformatted troffed manual pages
whatis database location
/usr/lib/makewhatis command script to make whatis database
apropos(1), man(1), nroff(1), rdist(1), troff(1), whatis(1)
If the -n option is specified, the /usr/man/whatis database is not cre-
ated and the apropos, whatis, `man -f', and `man -k' commands will
man?/xxx.? (.so'ed from man?/yyy.?): No such file or directory
The file outside the parentheses is missing, and is referred to
by the file inside them.
target of .so in man?/xxx.? must be relative to /usr/man
catman only allows references to filenames that are relative to
the directory /usr/man.
opendir:man?: No such file or directory
A harmless warning message indicating that one of the directo-
ries catman normally looks for is missing.
*.*: No such file or directory
A harmless warning message indicating catman came across an
9 September 1987 CATMAN(8)