Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ catman.bsd(8) — Domain/IX SR9.5

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

man(1)

whatis(1)

manx(7)

CATMAN(8)

NAME

catman − format the files for this manual

USAGE

/etc/catman [ −p ] [ −n ] [ −w ] [ −x ] section-number(s)

DESCRIPTION

The catman command creates the preformatted versions of the on-line manuals from the raw input files.  The command examines each manual page in the section-numbers specified on the command line and any pages with missing or out-of-date preformatted versions are recreated.  If any new pages are formatted, catman recreates the /usr/lib/whatis database, which contains the name, section number, and a brief description for each entry in the manuals. 

If you don’t specify section-number(s), catman checks all sections of the on-line manual for missing or out-of-date pages. 

OPTIONS

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

−p prints whatever updating would be done, without doing it. 

−w causes the command to create the /usr/lib/whatis database, without reformatting any manual pages. 

−x causes catman to use the manx macros (DOMAIN/IX additions to man) in formatting the files. The following pipeline is executed, where file is the name of the manual page source file(s).  tbl file(s) | eqn | nroff -manx | col | /etc/swapul

EXAMPLE

catman 123

creates any formatted files that are out-of-date or that don’t exist, in manual sections 1, 2, and 3 only. 

FILES

/usr/man/man?/*.* raw (nroff input) manual pages

/usr/man/cat?/*.* preformatted manual pages

/usr/lib/makewhatis commands to make whatis database

RELATED INFORMATION

man(1) whatis(1) manx(7)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026