Commit | Line | Data |
---|---|---|
882cb044 KS |
1 | .\" Copyright (c) 1989 The Regents of the University of California. |
2 | .\" All rights reserved. | |
3 | .\" | |
91cff1e1 | 4 | .\" %sccs.include.redist.man% |
882cb044 | 5 | .\" |
91cff1e1 | 6 | .\" @(#)man.conf.5 5.4 (Berkeley) %G% |
882cb044 KS |
7 | .\" |
8 | .TH MAN.CONF 5 "" | |
9 | .SH NAME | |
011519cd | 10 | man.conf \- man command's configuration file |
882cb044 | 11 | .SH DESCRIPTION |
011519cd KB |
12 | .IR Man (1), |
13 | .IR apropos (1), | |
14 | and | |
15 | .IR whatis (1) | |
16 | search for manual pages or their database files as specified by the | |
882cb044 | 17 | .I man.conf |
011519cd KB |
18 | file. |
19 | Manual pages are expected to be preformatted (see | |
20 | .IR nroff (1)) | |
21 | and named with a trailing ``.0''. | |
22 | .PP | |
882cb044 KS |
23 | The |
24 | .I man.conf | |
011519cd KB |
25 | file contains two types of lines. |
26 | .PP | |
27 | The first type of line is a ``section'' line, which contains a | |
28 | section name followed by a directory path. | |
29 | Lines in this format specify that manual pages for the section | |
30 | may be found in the directory. | |
011519cd KB |
31 | .PP |
32 | Directories named with a trailing slash character (``/'') are expected | |
33 | to contain subdirectories (see the keyword ``_subdir'' below) instead | |
34 | of manual pages. | |
35 | These subdirectories are searched instead of the directory. | |
36 | .PP | |
37 | All directories (either explicitly specified or named with a trailing | |
38 | slash) may contain subdirectories. | |
39 | .IR Man (1) | |
40 | automatically searches any subdirectory with the same name as the | |
41 | current machine type before the directory is searched. | |
42 | No specification of these subdirectories is necessary in the | |
43 | .I man.conf | |
44 | file. | |
45 | .PP | |
46 | Section names are unrestricted except for the reserved words specified | |
47 | below; in general, however, it is best to avoid anything beginning with | |
48 | an underscore (``_'') in order to avoid future incompatibilities. | |
49 | .PP | |
50 | The section named ``_default'' is the list of directories to be | |
51 | searched if no section is specified. | |
882cb044 | 52 | .PP |
011519cd KB |
53 | The second type of line is preceded with a ``keyword''. |
54 | The possible keywords and their meanings are as follows: | |
55 | .sp | |
56 | .TP | |
57 | _subdir | |
58 | The list (in search order) of subdirectories which will be searched in | |
59 | any directory named with a trailing slash (``/'') character. | |
60 | .TP | |
61 | _version | |
62 | The version of the configuration file. | |
63 | .TP | |
64 | _whatdb | |
65 | The full pathname (not just a directory path) for a database to be used | |
66 | by the | |
67 | .IR apropos (1) | |
68 | and | |
69 | .IR whatis (1) | |
70 | commands. | |
71 | .PP | |
1e76b432 KB |
72 | Multiple specifications for all types of lines (except for ``_version'') |
73 | are cumulative and the entries are used in the order listed in the file; | |
74 | multiple entries may be listed per line, as well. | |
75 | .PP | |
011519cd KB |
76 | Empty lines or lines whose first non-whitespace character is a hash |
77 | mark (``#'') are ignored. | |
78 | .SH EXAMPLES | |
79 | Given the following | |
80 | .I man.conf file: | |
81 | .sp | |
82 | .nf | |
83 | .RS | |
84 | _version BSD.1 | |
85 | _subdir cat1 cat2 cat3 | |
86 | _default /usr/share/man/ | |
87 | sect3 /usr/share/man/cat3 | |
88 | .fi | |
89 | .RE | |
90 | .sp | |
91 | The default | |
882cb044 | 92 | .IR mktemp (3) |
011519cd KB |
93 | manual page should be stored in ``/usr/share/man/cat3/mktemp.0''. |
94 | Any VAX architecture specific version of it should be stored in | |
95 | ``cat3/vax/mktemp.0''. | |
96 | .PP | |
97 | The command ``man mktemp'' would search the subdirectories ``cat1'' | |
98 | ``cat2'', and ``cat3'', in ``/usr/share/man'', in that order, for | |
99 | ``mktemp.0''. | |
100 | If a subdirectory with the same name as the current machine type | |
101 | existed in any of them, it would be searched as well. | |
102 | .PP | |
103 | The command ``man sect3 mktemp'' would only search ``/usr/share/man/cat3'' | |
104 | and any possible per machine subdirectory. | |
882cb044 KS |
105 | .SH FILES |
106 | /etc/man.conf standard manual directory search path | |
107 | .SH "SEE ALSO" | |
011519cd | 108 | apropos(1), machine(1), man(1), whatis(1), whereis(1) |