version 1.35, 2019/03/09 15:55:01 |
version 1.36, 2020/01/07 11:16:33 |
|
|
.Nm |
.Nm |
utility |
utility |
displays the |
displays the |
manual pages entitled |
manual page entitled |
.Ar name . |
.Ar name . |
Pages may be selected according to |
Pages may be selected according to |
a specific category |
a specific category |
Line 64 The options are as follows: |
|
Line 64 The options are as follows: |
|
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Fl a |
.It Fl a |
Display all matching manual pages. |
Display all matching manual pages. |
Normally, only the first page found is displayed. |
|
.It Fl C Ar file |
.It Fl C Ar file |
Use the specified |
Use the specified |
.Ar file |
.Ar file |
|
|
This option implies |
This option implies |
.Fl a . |
.Fl a . |
.It Fl M Ar path |
.It Fl M Ar path |
Override the list of standard directories which |
Override the list of directories to search for manual pages. |
.Nm |
|
searches for manual pages. |
|
The supplied |
The supplied |
.Ar path |
.Ar path |
must be a colon |
must be a colon |
.Pq Ql \&: |
.Pq Ql \&: |
separated list of directories. |
separated list of directories. |
This search path may also be set using the environment variable |
This option also overrides the environment variable |
.Ev MANPATH . |
.Ev MANPATH |
|
and any directories specified in the |
|
.Xr man.conf 5 |
|
file. |
.It Fl m Ar path |
.It Fl m Ar path |
Augment the list of standard directories which |
Augment the list of directories to search for manual pages. |
.Nm |
|
searches for manual pages. |
|
The supplied |
The supplied |
.Ar path |
.Ar path |
must be a colon |
must be a colon |
.Pq Ql \&: |
.Pq Ql \&: |
separated list of directories. |
separated list of directories. |
These directories will be searched before the standard directories or |
These directories will be searched before those specified using the |
the directories specified using the |
|
.Fl M |
.Fl M |
option or the |
option, the |
.Ev MANPATH |
.Ev MANPATH |
environment variable. |
environment variable, the |
|
.Xr man.conf 5 |
|
file, or the default directories. |
.It Fl S Ar subsection |
.It Fl S Ar subsection |
Only show pages for the specified |
Only show pages for the specified |
.Xr machine 1 |
.Xr machine 1 |
Line 197 System maintenance and operation commands. |
|
Line 196 System maintenance and operation commands. |
|
.It 9 |
.It 9 |
Kernel internals. |
Kernel internals. |
.El |
.El |
.Pp |
|
If not specified and a match is found in more than one section, |
|
the first match is selected from the following list: |
|
1, 8, 6, 2, 3, 5, 7, 4, 9, 3p. |
|
.It Fl w |
.It Fl w |
List the pathnames of all matching manual pages instead of displaying |
List the pathnames of all matching manual pages instead of displaying |
any of them. |
any of them. |
|
|
.Fl fkl |
.Fl fkl |
are mutually exclusive and override each other. |
are mutually exclusive and override each other. |
.Pp |
.Pp |
Guidelines for writing |
The search starts with the |
man pages can be found in |
.Fl m |
.Xr mdoc 7 . |
argument if provided, then continues with the |
|
.Fl M |
|
argument, the |
|
.Ev MANPATH |
|
variable, the |
|
.Ic manpath |
|
entries in the |
|
.Xr man.conf 5 |
|
file, or with |
|
.Pa /usr/share/man : Ns Pa /usr/X11R6/man : Ns Pa /usr/local/man |
|
by default. |
|
Within each of these, directories are searched in the order provided. |
|
Within each directory, the search proceeds according to the following |
|
list of sections: 1, 8, 6, 2, 3, 5, 7, 4, 9, 3p. |
|
The first match found is shown. |
.Pp |
.Pp |
The |
The |
.Xr mandoc.db 5 |
.Xr mandoc.db 5 |
Line 236 The database is kept up to date with |
|
Line 245 The database is kept up to date with |
|
which is run by the |
which is run by the |
.Xr weekly 8 |
.Xr weekly 8 |
maintenance script. |
maintenance script. |
|
.Pp |
|
Guidelines for writing |
|
man pages can be found in |
|
.Xr mdoc 7 . |
.Sh ENVIRONMENT |
.Sh ENVIRONMENT |
.Bl -tag -width MANPATHX |
.Bl -tag -width MANPATHX |
.It Ev MACHINE |
.It Ev MACHINE |
Line 286 manual opens a manual page at the definition of a spec |
|
Line 299 manual opens a manual page at the definition of a spec |
|
.Ar term |
.Ar term |
rather than at the beginning. |
rather than at the beginning. |
.It Ev MANPATH |
.It Ev MANPATH |
The standard search path used by |
Override the standard search path which is either specified in |
.Nm |
.Xr man.conf 5 |
may be changed by specifying a path in the |
or the default path. |
|
The format of |
.Ev MANPATH |
.Ev MANPATH |
environment variable. |
is a colon |
The format of the path is a colon |
|
.Pq Ql \&: |
.Pq Ql \&: |
separated list of directories. |
separated list of directories. |
Invalid paths are ignored. |
Invalid directories are ignored. |
Overridden by |
Overridden by |
.Fl M , |
.Fl M , |
ignored if |
ignored if |
|
|
.Pp |
.Pp |
If |
If |
.Ev MANPATH |
.Ev MANPATH |
begins with a colon, it is appended to the default list; |
begins with a colon, it is appended to the standard path; |
if it ends with a colon, it is prepended to the default list; |
if it ends with a colon, it is prepended to the standard path; |
or if it contains two adjacent colons, |
or if it contains two adjacent colons, |
the standard search path is inserted between the colons. |
the standard path is inserted between the colons. |
If none of these conditions are met, it overrides the |
|
standard search path. |
|
.It Ev PAGER |
.It Ev PAGER |
Specifies the pagination program to use when |
Specifies the pagination program to use when |
.Ev MANPAGER |
.Ev MANPAGER |
|
|
.Sh FILES |
.Sh FILES |
.Bl -tag -width /etc/man.conf -compact |
.Bl -tag -width /etc/man.conf -compact |
.It Pa /etc/man.conf |
.It Pa /etc/man.conf |
default man configuration file |
default |
|
.Nm |
|
configuration file |
.El |
.El |
.Sh EXIT STATUS |
.Sh EXIT STATUS |
.Ex -std man |
.Ex -std man |