NAME

catman − create the cat files for the manual

SYNOPSIS

/etc/catman [ −p ] [ −n ] [ −w ] [ −z ] [ sections ]

DESCRIPTION

Catman creates the formatted versions of the online manual from the nroff(1) source files.  Each manual entry in the man*.Z and man* directories is examined and those whose formatted versions are missing or out-of-date are recreated.  Catman formats the most recent of the entries, compresses it and puts it into the cat*.Z directory.  If any changes are made, catman will recreate the /usr/lib/whatis database. 

Before running catman, remove any cat* directories that may exist.  If the -z option is used, cat*.Z directories should be removed instead.  If both cat*.Z and cat* directories exist, man(1) will update both directories and more space will be used.

If there are parameters not starting with a "−", they are taken to be a list of manual sections to look in.  For example:

catman 123

will cause the updating to happen only to manual sections 1, 2, and 3. 

Options

−n Prevents creation of /usr/lib/whatis. 

−p Prints what would be done instead of doing it. 

−w Causes only the /usr/lib/whatis database to be created.  No manual reformatting is done. 

−z Puts the formatted entries in the cat* directories rather than in the cat*.Z directories. 

AUTHOR

Catman was developed by HP and the University of California, Berkeley. 

FILES

/usr/man/man*[.Z]/*raw (nroff(1) source) manual pages [compressed]
/usr/man/cat*[.Z]/*formatted manual pages [compressed]
/usr/local/man/man*[.Z]/*
/usr/local/man/cat*[.Z]/*
/usr/contrib/man/man*[.Z]/*
/usr/contrib/man/cat*[.Z]/*
/usr/lib/mkwhatiscommands to make whatis database

SEE ALSO

man(1), compress(1), fixman(1). 

Hewlett-Packard Company  —  HP-UX Release 7.0: Sept 1989