1CATMAN(8)                     Manual pager utils                     CATMAN(8)
2
3
4

NAME

6       catman - create or update the pre-formatted manual pages
7

SYNOPSIS

9       catman [-d?V] [-M path] [-C file] [section] ...
10

DESCRIPTION

12       catman  is  used  to  create  an up to date set of pre-formatted manual
13       pages known as cat pages.  Cat pages are generally much faster to  dis‐
14       play  than  the original manual pages, but require extra storage space.
15       The decision to support cat pages is that of the  local  administrator,
16       who must provide suitable directories to contain them.
17
18       The  options  available  to  catman are the manual page hierarchies and
19       sections to pre-format.  The default hierarchies are those specified as
20       system  hierarchies  in  the man-db configuration file, and the default
21       sections are either the colon-delimited  contents  of  the  environment
22       variable  $MANSECT or the standard set compiled into man if $MANSECT is
23       undefined.  Supplying catman with a set of whitespace-delimited section
24       names will override both of the above.
25
26       catman makes use of the index database cache associated with each hier‐
27       archy to determine which files need to be formatted.
28

OPTIONS

30       -d, --debug
31              Print debugging information.
32
33       -M path, --manpath=path
34              Specify  an  alternate  colon-delimited  manual  page  hierarchy
35              search  path.  By default, this is all paths indicated as system
36              hierarchies in the man-db configuration file.
37
38       -C file, --config-file=file
39              Use this user configuration file  rather  than  the  default  of
40              ~/.manpath.
41
42       -?, --help
43              Print a help message and exit.
44
45       --usage
46              Print a short usage message and exit.
47
48       -V, --version
49              Display version information.
50

ENVIRONMENT

52       MANSECT
53              If  $MANSECT is set, its value is a colon-delimited list of sec‐
54              tions and it is used  to  determine  which  manual  sections  to
55              search and in what order.  The default is "1 1p 8 2 3 3p 3pm 4 5
56              6 7 9 0p n l p o 1x 2x 3x 4x 5x 6x 7x 8x", unless overridden  by
57              the SECTION directive in /etc/man_db.conf.
58
59       MANPATH
60              If $MANPATH is set, its value is interpreted as the colon-delim‐
61              ited manual page hierarchy search path to use.
62
63              See the SEARCH PATH section of manpath(5) for the default behav‐
64              iour and details of how this environment variable is handled.
65

FILES

67       /etc/man_db.conf
68              man-db configuration file.
69
70       /usr/man/index.(bt|db|dir|pag)
71              A traditional global index database cache.
72
73       /var/catman/index.(bt|db|dir|pag)
74              An alternate or FSSTND compliant global index database cache.
75

SEE ALSO

77       man(1), manpath(5), mandb(8)
78

AUTHOR

80       Wilf. (G.Wilford@ee.surrey.ac.uk).
81       Fabrizio Polacco (fpolacco@debian.org).
82       Colin Watson (cjwatson@debian.org).
83

BUGS

85       https://gitlab.com/man-db/man-db/-/issues
86       https://savannah.nongnu.org/bugs/?group=man-db
87
88
89
902.11.2                            2023-01-08                         CATMAN(8)