version 1, including all changes.
.
| Rev |
Author |
# |
Line |
| 1 |
perry |
1 |
manpath |
| |
|
2 |
!!!manpath |
| |
|
3 |
NAME |
| |
|
4 |
SYNOPSIS |
| |
|
5 |
DESCRIPTION |
| |
|
6 |
OPTIONS |
| |
|
7 |
ENVIRONMENT |
| |
|
8 |
FILES |
| |
|
9 |
SEE ALSO |
| |
|
10 |
AUTHOR |
| |
|
11 |
---- |
| |
|
12 |
!!NAME |
| |
|
13 |
|
| |
|
14 |
|
| |
|
15 |
manpath - determine search path for manual pages |
| |
|
16 |
!!SYNOPSIS |
| |
|
17 |
|
| |
|
18 |
|
| |
|
19 |
__manpath__ [[__-qgdc__] [[__-m__ |
| |
|
20 |
''system''[[,...]] |
| |
|
21 |
!!DESCRIPTION |
| |
|
22 |
|
| |
|
23 |
|
| |
|
24 |
If $__MANPATH__ is set, __manpath__ will simply |
| |
|
25 |
display its contents and issue a warning. If not, |
| |
|
26 |
__manpath__ will determine a suitable manual page |
| |
|
27 |
hierarchy search path and display the results. |
| |
|
28 |
|
| |
|
29 |
|
| |
|
30 |
The colon-delimited path is determined using information |
| |
|
31 |
gained from the man_db configuration file - |
| |
|
32 |
(''/etc/manpath.config'') and the user's |
| |
|
33 |
environment. |
| |
|
34 |
!!OPTIONS |
| |
|
35 |
|
| |
|
36 |
|
| |
|
37 |
__-q, --quiet__ |
| |
|
38 |
|
| |
|
39 |
|
| |
|
40 |
Do not issue warnings. |
| |
|
41 |
|
| |
|
42 |
|
| |
|
43 |
__-d, --debug__ |
| |
|
44 |
|
| |
|
45 |
|
| |
|
46 |
Produce debugging information. |
| |
|
47 |
|
| |
|
48 |
|
| |
|
49 |
__-c, --catpath__ |
| |
|
50 |
|
| |
|
51 |
|
| |
|
52 |
Produce a catpath as opposed to a manpath. Once the manpath |
| |
|
53 |
is determined, each path element is converted to its |
| |
|
54 |
relative catpath. |
| |
|
55 |
|
| |
|
56 |
|
| |
|
57 |
__-g, --global__ |
| |
|
58 |
|
| |
|
59 |
|
| |
|
60 |
Produce a manpath consisting of all paths named as `global' |
| |
|
61 |
within the man_db configuration file. |
| |
|
62 |
|
| |
|
63 |
|
| |
|
64 |
__-m__ ''system''[[,...]__, |
| |
|
65 |
--systems=__''system''[[,...] |
| |
|
66 |
|
| |
|
67 |
|
| |
|
68 |
If this system has access to other operating system's manual |
| |
|
69 |
hierarchies, this option can be used to include them in the |
| |
|
70 |
output of __manpath__. To include NewOS's manual page |
| |
|
71 |
hierarchies use the option __-m NewOS__. |
| |
|
72 |
|
| |
|
73 |
|
| |
|
74 |
The ''system'' specified can be a combination of comma |
| |
|
75 |
delimited operating system names. To include the native |
| |
|
76 |
operating system's manual page hierarchies, the system name |
| |
|
77 |
__man__ must be included in the argument string. This |
| |
|
78 |
option will override the $__SYSTEM__ environment |
| |
|
79 |
variable. |
| |
|
80 |
|
| |
|
81 |
|
| |
|
82 |
__-h, --help__ |
| |
|
83 |
|
| |
|
84 |
|
| |
|
85 |
Print a help message and exit. |
| |
|
86 |
|
| |
|
87 |
|
| |
|
88 |
__-V, --version__ |
| |
|
89 |
|
| |
|
90 |
|
| |
|
91 |
Display version and author information. |
| |
|
92 |
!!ENVIRONMENT |
| |
|
93 |
|
| |
|
94 |
|
| |
|
95 |
__MANPATH__ |
| |
|
96 |
|
| |
|
97 |
|
| |
|
98 |
If $__MANPATH__ is set, __manpath__ displays its value |
| |
|
99 |
rather than determining it on the fly. If $__MANPATH__ is |
| |
|
100 |
prefixed by a colon, then the value of the variable is |
| |
|
101 |
appended to the list determined from the content of the |
| |
|
102 |
configuration files. If the colon comes at the end of the |
| |
|
103 |
value in the variable, then the determined list is appended |
| |
|
104 |
to the content of the variable. If the value of the variable |
| |
|
105 |
contains a double colon (__::__), then the determined |
| |
|
106 |
list is inserted in the middle of the value, between the two |
| |
|
107 |
colons. |
| |
|
108 |
|
| |
|
109 |
|
| |
|
110 |
__SYSTEM__ |
| |
|
111 |
|
| |
|
112 |
|
| |
|
113 |
If $__SYSTEM__ is set, it will have the same effect as if |
| |
|
114 |
it had been specified as the argument to the __-m__ |
| |
|
115 |
option. |
| |
|
116 |
!!FILES |
| |
|
117 |
|
| |
|
118 |
|
| |
|
119 |
''/etc/manpath.config'' |
| |
|
120 |
|
| |
|
121 |
|
| |
|
122 |
System configuration file. |
| |
|
123 |
!!SEE ALSO |
| |
|
124 |
|
| |
|
125 |
|
| |
|
126 |
apropos(1), whatis(1), |
| |
|
127 |
man(1). |
| |
|
128 |
!!AUTHOR |
| |
|
129 |
|
| |
|
130 |
|
| |
|
131 |
Wilf. (G.Wilford@ee.surrey.ac.uk). |
| |
|
132 |
Fabrizio Polacco (fpolacco@debian.org). |
| |
|
133 |
---- |