NAME

       manpath - determine search path for manual pages

SYNOPSIS

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

DESCRIPTION

       If $MANPATH is set, manpath will simply display its contents and issue a warning.  If not,
       manpath will determine a suitable manual  page  hierarchy  search  path  and  display  the
       results.

       The   colon-delimited  path  is  determined  using  information  gained  from  the  man-db
       configuration file - (/etc/manpath.config) and the user's environment.

OPTIONS

       -q, --quiet
              Do not issue warnings.

       -d, --debug
              Print debugging information.

       -c, --catpath
              Produce a catpath as opposed to a manpath.  Once the manpath  is  determined,  each
              path element is converted to its relative catpath.

       -g, --global
              Produce  a  manpath  consisting  of  all  paths named as `global' within the man-db
              configuration file.

       -m system[,...], --systems=system[,...]
              If this system has access to other  operating  system's  manual  hierarchies,  this
              option  can  be  used to include them in the output of manpath.  To include NewOS's
              manual page hierarchies use the option -m NewOS.

              The system specified can be a  combination  of  comma  delimited  operating  system
              names.   To  include  the  native  operating  system's manual page hierarchies, the
              system name man must be included in the argument string.  This option will override
              the $SYSTEM environment variable.

       -C file, --config-file=file
              Use this user configuration file rather than the default of ~/.manpath.

       -?, --help
              Print a help message and exit.

       --usage
              Print a short usage message and exit.

       -V, --version
              Display version information.

ENVIRONMENT

       MANPATH
              If  $MANPATH  is  set, manpath displays its value rather than determining it on the
              fly.  If $MANPATH is prefixed by a  colon,  then  the  value  of  the  variable  is
              appended  to  the  list determined from the content of the configuration files.  If
              the colon comes at the end of the value in the variable, then the  determined  list
              is  appended to the content of the variable.  If the value of the variable contains
              a double colon (::), then the determined list is inserted  in  the  middle  of  the
              value, between the two colons.

       SYSTEM If  $SYSTEM is set, it will have the same effect as if it had been specified as the
              argument to the -m option.

FILES

       /etc/manpath.config  man-db configuration file.

SEE ALSO

       apropos(1), man(1), whatis(1)

AUTHOR

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