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 hi‐
38              erarchies, this option can be used to include them in the output
39              of manpath.  To include NewOS's manual page hierarchies use  the
40              option -m NewOS.
41
42              The system specified can be a combination of comma delimited op‐
43              erating system names.  To include the native operating  system's
44              manual page hierarchies, the system name man must be included in
45              the argument string.  This option will override the $SYSTEM  en‐
46              vironment 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  de‐
64              termining  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 de‐
70              termined  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

BUGS

88       https://savannah.nongnu.org/bugs/?group=man-db
89
90
91
922.9.3                             2020-06-22                        MANPATH(1)