[BACK]Return to man.1 CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/man.1 between version 1.35 and 1.36

version 1.35, 2019/03/09 15:55:01 version 1.36, 2020/01/07 11:16:33
Line 51  The
Line 51  The
 .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
Line 129  are ignored.
Line 128  are ignored.
 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.
Line 214  The options
Line 209  The options
 .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
Line 303  is specified.
Line 316  is specified.
 .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
Line 321  is used.
Line 332  is used.
 .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

Legend:
Removed from v.1.35  
changed lines
  Added in v.1.36

CVSweb