1MANPATH(1)                    Manual pager utils                    MANPATH(1)
2
3
4

NAME

6       manpath - determine search path for manual pages
7

SYNOPSIS

9       manpath [-qgdc?V] [-m system[,...]] [-C file]
10

DESCRIPTION

12       If  $MANPATH is set, manpath will simply display its contents and issue
13       a warning.  If not, manpath will determine a suitable manual page hier‐
14       archy search path and display the results.
15
16       The  colon-delimited  path  is determined using information gained from
17       the man-db configuration file - (/etc/man_db.conf) and the user's envi‐
18       ronment.
19

OPTIONS

21       -q, --quiet
22              Do not issue warnings.
23
24       -d, --debug
25              Print debugging information.
26
27       -c, --catpath
28              Produce  a catpath as opposed to a manpath.  Once the manpath is
29              determined, each path element is converted to its relative  cat‐
30              path.
31
32       -g, --global
33              Produce  a  manpath  consisting  of  all paths named as `global'
34              within the man-db configuration file.
35
36       -m system[,...], --systems=system[,...]
37              If this system has access to  other  operating  system's  manual
38              hierarchies, this option can be used to include them in the out‐
39              put of manpath.  To include NewOS's manual page hierarchies  use
40              the option -m NewOS.
41
42              The  system  specified  can  be a combination of comma delimited
43              operating system names.  To include the  native  operating  sys‐
44              tem's  manual  page  hierarchies,  the  system  name man must be
45              included in the argument string.  This option will override  the
46              $SYSTEM environment variable.
47
48       -C file, --config-file=file
49              Use  this  user  configuration  file  rather than the default of
50              ~/.manpath.
51
52       -?, --help
53              Print a help message and exit.
54
55       --usage
56              Print a short usage message and exit.
57
58       -V, --version
59              Display version information.
60

ENVIRONMENT

62       MANPATH
63              If $MANPATH is set,  manpath  displays  its  value  rather  than
64              determining  it on the fly.  If $MANPATH is prefixed by a colon,
65              then the value of the variable is appended to  the  list  deter‐
66              mined from the content of the configuration files.  If the colon
67              comes at the end of the value in the variable, then  the  deter‐
68              mined  list  is appended to the content of the variable.  If the
69              value of the variable contains a double  colon  (::),  then  the
70              determined  list is inserted in the middle of the value, between
71              the two colons.
72
73       SYSTEM If $SYSTEM is set, it will have the same effect  as  if  it  had
74              been specified as the argument to the -m option.
75

FILES

77       /etc/man_db.conf  man-db configuration file.
78

SEE ALSO

80       apropos(1), man(1), whatis(1)
81

AUTHOR

83       Wilf. (G.Wilford@ee.surrey.ac.uk).
84       Fabrizio Polacco (fpolacco@debian.org).
85       Colin Watson (cjwatson@debian.org).
86
87
88
892.7.6.1                           2016-12-12                        MANPATH(1)