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

Diff for /mandoc/man.1 between version 1.17 and 1.32

version 1.17, 2016/07/01 20:24:04 version 1.32, 2017/08/19 22:05:38
Line 3 
Line 3 
 .\" Copyright (c) 1989, 1990, 1993  .\" Copyright (c) 1989, 1990, 1993
 .\"     The Regents of the University of California.  All rights reserved.  .\"     The Regents of the University of California.  All rights reserved.
 .\" Copyright (c) 2003, 2007, 2008, 2014 Jason McIntyre <jmc@openbsd.org>  .\" Copyright (c) 2003, 2007, 2008, 2014 Jason McIntyre <jmc@openbsd.org>
 .\" Copyright (c) 2010, 2011, 2014, 2015 Ingo Schwarze <schwarze@openbsd.org>  .\" Copyright (c) 2010, 2011, 2014-2017 Ingo Schwarze <schwarze@openbsd.org>
 .\"  .\"
 .\" Redistribution and use in source and binary forms, with or without  .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions  .\" modification, are permitted provided that the following conditions
Line 41 
Line 41 
 .Nm man  .Nm man
 .Op Fl acfhklw  .Op Fl acfhklw
 .Op Fl C Ar file  .Op Fl C Ar file
 .Op Fl I Cm os Ns = Ns Ar name  
 .Op Fl K Ar encoding  
 .Op Fl M Ar path  .Op Fl M Ar path
 .Op Fl m Ar path  .Op Fl m Ar path
 .Op Fl O Ar option Ns = Ns Ar value  
 .Op Fl S Ar subsection  .Op Fl S Ar subsection
 .Op Fl s Ar section  .Op Oo Fl s Oc Ar section
 .Op Fl T Ar output  
 .Op Fl W Ar level  
 .Op Ar section  
 .Ar name ...  .Ar name ...
 .Sh DESCRIPTION  .Sh DESCRIPTION
 The  The
Line 69  machine architecture
Line 63  machine architecture
 The options are as follows:  The options are as follows:
 .Bl -tag -width Ds  .Bl -tag -width Ds
 .It Fl a  .It Fl a
 Display all of the manual pages for a specified  Display all matching manual pages.
 .Ar section  Normally, only the first page found is displayed.
 and  
 .Ar name  
 combination.  
 Normally, only the first manual 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 88  Copy the manual page to the standard output instead of
Line 78  Copy the manual page to the standard output instead of
 .Xr more 1  .Xr more 1
 to paginate it.  to paginate it.
 This is done by default if the standard output is not a terminal device.  This is done by default if the standard output is not a terminal device.
   .Pp
   When using
   .Fl c ,
   most terminal devices are unable to show the markup.
   To print the output of
   .Nm
   to the terminal with markup but without using a pager, pipe it to
   .Xr ul 1 .
   To remove the markup, pipe the output to
   .Xr col 1
   .Fl b
   instead.
 .It Fl f  .It Fl f
 A synonym for  A synonym for
 .Xr whatis 1 .  .Xr whatis 1 .
Line 95  It searches for
Line 97  It searches for
 .Ar name  .Ar name
 in manual page names and displays the header lines from all matching pages.  in manual page names and displays the header lines from all matching pages.
 The search is case insensitive and matches whole words only.  The search is case insensitive and matches whole words only.
 This overrides any earlier  
 .Fl k  
 and  
 .Fl l  
 options.  
 .It Fl I Cm os Ns = Ns Ar name  
 Override the default operating system  
 .Ar name  
 for the  
 .Xr mdoc 7  
 .Ic \&Os  
 and for the  
 .Xr man 7  
 .Ic \&TH  
 macro.  
 .It Fl h  .It Fl h
 Display only the SYNOPSIS lines of the requested manual pages.  Display only the SYNOPSIS lines of the requested manual pages.
 Implies  Implies
 .Fl a  .Fl a
 and  and
 .Fl c .  .Fl c .
 .It Fl K Ar encoding  
 Specify the input encoding.  
 The supported  
 .Ar encoding  
 arguments are  
 .Cm us-ascii ,  
 .Cm iso-8859-1 ,  
 and  
 .Cm utf-8 .  
 By default, the encoding is automatically detected as described in the  
 .Xr mandoc 1  
 manual.  
 .It Fl k  .It Fl k
 A synonym for  A synonym for
 .Xr apropos 1 .  .Xr apropos 1 .
Line 137  an expression can be provided using the syntax describ
Line 112  an expression can be provided using the syntax describ
 .Xr apropos 1  .Xr apropos 1
 manual.  manual.
 By default, it displays the header lines of all matching pages.  By default, it displays the header lines of all matching pages.
 This overrides any earlier  
 .Fl f  
 and  
 .Fl l  
 options.  
 .It Fl l  .It Fl l
 A synonym for  A synonym for
 .Xr mandoc 1  .Xr mandoc 1
Line 153  No search is done and
Line 123  No search is done and
 .Ar file ,  .Ar file ,
 .Ar path ,  .Ar path ,
 .Ar section ,  .Ar section ,
   .Ar subsection ,
 and  and
 .Ar subsection  
 are ignored.  
 This overrides any earlier  
 .Fl f ,  
 .Fl k ,  
 and  
 .Fl w  .Fl w
 options.  are ignored.
 .It Fl M Ar path  .It Fl M Ar path
 Override the list of standard directories which  Override the list of standard directories which
 .Nm  .Nm
Line 188  the directories specified using the
Line 153  the directories specified using the
 option or the  option or the
 .Ev MANPATH  .Ev MANPATH
 environment variable.  environment variable.
 .It Fl O Ar option Ns = Ns Ar value  
 Comma-separated output options.  
 For each output format, the available options are described in the  
 .Xr mandoc 1  
 manual.  
 .It Fl S Ar subsection  .It Fl S Ar subsection
 Restricts the directories that  Only show pages for the specified
 .Nm  
 will search to those of a specific  
 .Xr machine 1  .Xr machine 1
 architecture.  architecture.
 .Ar subsection  .Ar subsection
Line 238  System maintenance and operation commands.
Line 196  System maintenance and operation commands.
 .It 9  .It 9
 Kernel internals.  Kernel internals.
 .El  .El
 .It Fl T Ar output  .Pp
 Select the output format.  If not specified and a match is found in more than one section,
 The default is  the first match is selected from the following list:
 .Cm locale .  1, 8, 6, 2, 3, 5, 7, 4, 9, 3p.
 The other output modes  
 .Cm ascii ,  
 .Cm html ,  
 .Cm lint ,  
 .Cm man ,  
 .Cm pdf ,  
 .Cm ps ,  
 .Cm tree ,  
 and  
 .Cm utf8  
 are described in the  
 .Xr mandoc 1  
 manual.  
 .It Fl W Ar level  
 Specify the minimum message  
 .Ar level  
 to be reported on the standard error output and to affect the exit status.  
 The  
 .Ar level  
 can be  
 .Cm warning ,  
 .Cm error ,  
 or  
 .Cm unsupp ;  
 .Cm all  
 is an alias for  
 .Cm warning .  
 By default,  
 .Nm  
 is silent.  
 See the  
 .Xr mandoc 1  
 manual for details.  
 .It Fl w  .It Fl w
 List the pathnames of the manual pages which  List the pathnames of all matching manual pages instead of displaying
 .Nm  any of them.
 would display for the specified  
 .Ar section  
 and  
 .Ar name  
 combination.  
 .El  .El
 .Pp  .Pp
   The options
   .Fl IKOTW
   are also supported and are documented in
   .Xr mandoc 1 .
   The options
   .Fl fkl
   are mutually exclusive and override each other.
   .Pp
 Guidelines for writing  Guidelines for writing
 man pages can be found in  man pages can be found in
 .Xr mdoc 7 .  .Xr mdoc 7 .
Line 294  for example
Line 222  for example
 .Pa cat1/foo.0  .Pa cat1/foo.0
 and  and
 .Pa man1/foo.1 ,  .Pa man1/foo.1 ,
 exist in the same directory, and at least one of them is selected,  exist in the same directory, only the unformatted version is used.
 only the newer one is used.  
 However, if both the  
 .Fl a  
 and the  
 .Fl w  
 options are specified, both file names are printed.  
 .Sh ENVIRONMENT  .Sh ENVIRONMENT
 .Bl -tag -width MANPATHX  .Bl -tag -width MANPATHX
 .It Ev MACHINE  .It Ev MACHINE
Line 322  is case insensitive.
Line 244  is case insensitive.
 .It Ev MANPAGER  .It Ev MANPAGER
 Any non-empty value of the environment variable  Any non-empty value of the environment variable
 .Ev MANPAGER  .Ev MANPAGER
 will be used instead of the standard pagination program,  is used instead of the standard pagination program,
 .Xr more 1 .  .Xr more 1 .
 If  If
 .Xr less 1  .Xr less 1
Line 330  is used, the interactive
Line 252  is used, the interactive
 .Ic :t  .Ic :t
 command can be used to go to the definitions of various terms, for  command can be used to go to the definitions of various terms, for
 example command line options, command modifiers, internal commands,  example command line options, command modifiers, internal commands,
 and environment variables.  environment variables, function names, preprocessor macros,
   .Xr errno 2
   values, and some other emphasized words.
   Some terms may have defining text at more than one place.
   In that case, the
   .Xr less 1
   interactive commands
   .Ic t
   and
   .Ic T
   can be used to move to the next and to the previous place providing
   information about the term last searched for with
   .Ic :t .
 .It Ev MANPATH  .It Ev MANPATH
 The standard search path used by  The standard search path used by
 .Nm  .Nm
 may be overridden by specifying a path in the  may be changed by specifying a path in the
 .Ev MANPATH  .Ev MANPATH
 environment  environment variable.
 variable.  
 The format of the path 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.
   Overridden by
   .Fl M ,
   ignored if
   .Fl l
   is specified.
   .Pp
   If
   .Ev MANPATH
   begins with a colon, it is appended to the default list;
   if it ends with a colon, it is prepended to the default list;
   or if it contains two adjacent colons,
   the standard search 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 348  is not defined.
Line 296  is not defined.
 If neither PAGER nor MANPAGER is defined,  If neither PAGER nor MANPAGER is defined,
 .Xr more 1  .Xr more 1
 .Fl s  .Fl s
 will be used.  is used.
 .El  .El
 .Sh FILES  .Sh FILES
 .Bl -tag -width /etc/man.conf -compact  .Bl -tag -width /etc/man.conf -compact
Line 357  default man configuration file
Line 305  default man configuration file
 .El  .El
 .Sh EXIT STATUS  .Sh EXIT STATUS
 .Ex -std man  .Ex -std man
   See
   .Xr mandoc 1
   for details.
   .Sh EXAMPLES
   Format a page for pasting extracts into an email message \(em
   avoid printing any UTF-8 characters, reduce the width to ease
   quoting in replies, and remove markup:
   .Pp
   .Dl $ man -T ascii -O width=65 pledge | col -b
   .Pp
   Read a typeset page in a PDF viewer:
   .Pp
   .Dl $ MANPAGER=mupdf man -T pdf lpd
 .Sh SEE ALSO  .Sh SEE ALSO
 .Xr apropos 1 ,  .Xr apropos 1 ,
 .Xr intro 1 ,  .Xr col 1 ,
 .Xr whatis 1 ,  .Xr mandoc 1 ,
   .Xr ul 1 ,
 .Xr whereis 1 ,  .Xr whereis 1 ,
 .Xr intro 2 ,  
 .Xr intro 3 ,  
 .Xr intro 4 ,  
 .Xr intro 5 ,  
 .Xr man.conf 5 ,  .Xr man.conf 5 ,
 .Xr intro 6 ,  .Xr mdoc 7
 .Xr intro 7 ,  
 .Xr mdoc 7 ,  
 .Xr intro 8 ,  
 .Xr intro 9  
 .Sh STANDARDS  .Sh STANDARDS
 The  The
 .Nm  .Nm
Line 419  in
Line 373  in
 .Fl C  .Fl C
 in  in
 .Nx 1.0 ;  .Nx 1.0 ;
 and  
 .Fl s  .Fl s
 and  and
 .Fl S  .Fl S
 in  in
 .Ox 2.3 .  .Ox 2.3 ;
   and
   .Fl I ,
   .Fl K ,
   .Fl l ,
   .Fl O ,
   and
   .Fl W
   in
   .Ox 5.7 .
   The
   .Fl T
   option first appeared in
   .At III
   and was also added in
   .Ox 5.7 .

Legend:
Removed from v.1.17  
changed lines
  Added in v.1.32

CVSweb