freebsd-dev/gnu/usr.bin/man/manpath/manpath.man

69 lines
1.5 KiB
Groff
Raw Normal View History

1993-07-07 23:07:02 +00:00
.\" Man page for manpath
.\"
.\" Copyright (c) 1990, 1991, John W. Eaton.
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the README file that comes with the man 1.0
.\" distribution.
.\"
.\" John W. Eaton
.\" jwe@che.utexas.edu
.\" Department of Chemical Engineering
.\" The University of Texas at Austin
.\" Austin, Texas 78712
.\"
.Dd Jan 5, 1991
.Dt MANPATH 1
.Os
.Sh NAME
.Nm manpath
.Nd determine user's search path for man pages
.Sh SYNOPSIS
.Nm
.Op Fl q
.Sh DESCRIPTION
.Nm manpath
tries to determine the user's manpath from a set of system
1993-07-07 23:07:02 +00:00
defaults and the user's
.Ev PATH ,
1993-07-07 23:07:02 +00:00
echoing the result to the standard output. Warnings and errors are
written to the standard error.
If a directory in the user's path is not listed in the manpath.config
file, manpath looks for the subdirectories man or MAN. If they exist,
they are added to the search path.
.Pp
.Nm
manpath
is used by
.Nm man
1993-07-07 23:07:02 +00:00
to determine the search path, so user's normally don't need to set the
.Ev MANPATH
1993-07-07 23:07:02 +00:00
environment variable directly.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl q
1993-07-07 23:07:02 +00:00
Operate quietly. Only echo the final manpath.
.El
.Sh ENVIRONMENT
.Bl -tag -width MANPATH -compact
.It Ev MANPATH
1993-07-07 23:07:02 +00:00
If
.Ev MANPATH
1993-07-07 23:07:02 +00:00
is set,
.Nm manpath
1993-07-07 23:07:02 +00:00
echoes its value on the standard output and issues a warning on the
standard error.
.El
.Sh FILES
.Bl -tag -width %manpath_config_file% -compact
.It Pa %manpath_config_file%
1993-07-07 23:07:02 +00:00
System configuration file.
.El
.Sh SEE ALSO
.Xr apropos 1 ,
.Xr whatis 1 ,
.Xr man 1
.Sh BUGS
1993-07-07 23:07:02 +00:00
None known.