format all manual pages below a directory
catman utility assumes that all files below
srcdir are manual pages in
format and formats all of them, storing the formatted versions in the same
relative paths below dstdir. Subdirectories of
dstdir are created as needed. Existing files are not
explicitly deleted, but possibly overwritten.
The options are as follows:
catman utility exits 0 on success,
and >0 if an error occurs.
Possible errors include:
Except for memory exhaustion and similar system-level failures,
failures while trying to open, read, parse, or format individual manual
pages, to save individual formatted files to the file system, or even to
create directories do not cause
catman utility first appeared in
FreeBSD 1.0. Other, incompatible implementations
appeared in NetBSD 1.0 and in man-db
This version appeared in version 1.14.1 of the mandoc toolkit.
catman implementation was a short shell script
by Christoph Robitschko in July 1993.
The NetBSD implementations were written by J. T. Conklin <email@example.com> in 1993, Christian E. Hopps <firstname.lastname@example.org> in 1994, and Dante Profeta <email@example.com> in 1999; the man-db implementation by Graeme W. Wilford in 1994; and the FreeBSD implementations by Wolfram Schneider <firstname.lastname@example.org> in 1995 and John Rochester <email@example.com> in 2002.
The concept of the present version was designed and implemented by Michael Stapelberg <firstname.lastname@example.org> in 2017. Option and argument handling and directory iteration was added by Ingo Schwarze <email@example.com>.
catman are incompatible with each other
because each caters to the needs of a specific operating system, for example
regarding directory structures and file naming conventions.
This version is more flexible than the others in so far as it does not assume any particular directory structure or naming convention. That flexibility comes at the price of not being able to change the names and relative paths of the source files when reusing them to store the formatted files, of not supporting any configuration file formats or environment variables, and of being unable to scan for and remove junk files in dstdir.