catman(1M-ucb)          (BSD Compatibility Package)          catman(1M-ucb)

NAME
     catman - create the "cat" files for the online man pages

SYNOPSIS
     /usr/ucb/catman [-nptw] [-M directory] [-T tmac.an] [sections]

DESCRIPTION
     The catman commands create the preformatted versions of the online man
     pages from the nroff(1M) input files. Each man 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(1)
     database.

     If a parameter does not start with a -, it is taken to be a list of
     manual sections to look in. For example

          catman 123

     only updates manual sections 1, 2, and 3.

OPTIONS
     -n   Does not (re)create the whatis(1) database.

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

     -t   Creates troffed entries in the appropriate fmt subdirectories
          instead of nroffing into the cat subdirectories.

     -w   Only creates the whatis(1) database. No manual reformatting is
          done.

     -M   Updates man pages located in the specified directory
          (/usr/share/man by default).

     -T   Uses tmac.an in place of the standard man page macros.

DIAGNOSTICS
     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 /usr/share/man directory.

     opendir:man?: No such file or directory
          A harmless warning message indicating that one of the directories
          catman normally looks for is missing.

     *.*: No such file or directory
          A harmless warning message indicating catman came across an empty
          directory.



Page 1                       Reliant UNIX 5.44                Printed 11/98

catman(1M-ucb)          (BSD Compatibility Package)          catman(1M-ucb)

ENVIRONMENT
     TROFF   The name of the formatter to use when the -t flag is given. If
             not set, troff(1M) is used.

CAVEAT
     This catman command will not create preformatted DC/OSx man pages. It
     is included for users who have BSD man pages.

FILES
     /usr/share/man
          Default manual directory location

     /usr/share/man/man?/*.*
          Raw (nroff input) manual sections

     /usr/share/man/cat?/*.*
          Preformatted nroffed man pages

     /usr/share/man/fmt?/*.*
          Preformatted troffed man pages

     /usr/share/man/whatis
          whatis(1) database location

     /usr/ucblib/makewhatis
          Command script to make whatis(1) database

SEE ALSO
     man(1), whatis(1), man(1-ucb), nroff(1M), troff(1M), man(5), troff(5).

























Page 2                       Reliant UNIX 5.44                Printed 11/98