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

Diff for /mandoc/man.1 between version 1.7 and 1.16

version 1.7, 2014/11/11 02:43:41 version 1.16, 2015/09/21 09:59:02
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 Ingo Schwarze <schwarze@openbsd.org>  .\" Copyright (c) 2010, 2011, 2014, 2015 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 39 
Line 39 
 .Nd display manual pages  .Nd display manual pages
 .Sh SYNOPSIS  .Sh SYNOPSIS
 .Nm man  .Nm man
 .Op Fl acfhklVw  .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 Fl s Ar section
   .Op Fl T Ar output
   .Op Fl W Ar level
 .Op Ar section  .Op Ar section
 .Ar name ...  .Ar name ...
 .Sh DESCRIPTION  .Sh DESCRIPTION
Line 95  This overrides any earlier
Line 100  This overrides any earlier
 and  and
 .Fl l  .Fl l
 options.  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 146  must be a colon
Line 173  must be a colon
 separated list of directories.  separated list of directories.
 This search path may also be set using the environment variable  This search path may also be set using the environment variable
 .Ev MANPATH .  .Ev MANPATH .
 The subdirectories to be searched, and their search order,  
 are specified by the  
 .Dq _subdir  
 line in the  
 .Nm  
 configuration file.  
 .It Fl m Ar path  .It Fl m Ar path
 Augment the list of standard directories which  Augment the list of standard directories which
 .Nm  .Nm
Line 167  the directories specified using the
Line 188  the directories specified using the
 option or the  option or the
 .Ev MANPATH  .Ev MANPATH
 environment variable.  environment variable.
 The subdirectories to be searched, and their search order,  .It Fl O Ar option Ns = Ns Ar value
 are specified by the  Comma-separated output options.
 .Dq _subdir  For each output format, the available options are described in the
 line in the  .Xr mandoc 1
 .Nm  manual.
 configuration file.  
 .It Fl S Ar subsection  .It Fl S Ar subsection
 Restricts the directories that  Restricts the directories that
 .Nm  .Nm
Line 242  specifies the possible
Line 262  specifies the possible
 .Ar section  .Ar section
 values, and their search order.  values, and their search order.
 Additional sections may be specified.  Additional sections may be specified.
 .It Fl V  .It Fl T Ar output
 Print version and exit.  Select the output format.
   The default is
   .Cm locale .
   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 the manual pages which
 .Nm  .Nm
Line 254  and
Line 309  and
 combination.  combination.
 .El  .El
 .Pp  .Pp
 The  
 .Nm  
 utility also supports the options  
 .Fl IKOTW  
 described in the  
 .Xr mandoc 1  
 manual.  
 .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 301  Any non-empty value of the environment variable
Line 348  Any non-empty value of the environment variable
 .Ev MANPAGER  .Ev MANPAGER
 will be used instead of the standard pagination program,  will be used instead of the standard pagination program,
 .Xr more 1 .  .Xr more 1 .
   If
   .Xr less 1
   is used, the interactive
   .Ic :t
   command can be used to go to the definitions of various terms, for
   example command line options, command modifiers, internal commands,
   and environment variables.
 .It Ev MANPATH  .It Ev MANPATH
 The standard search path used by  The standard search path used by
 .Nm  .Nm
Line 311  variable.
Line 365  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.
 The subdirectories to be searched, as well as their search order,  
 are specified by the  
 .Dq _subdir  
 line in the  
 .Nm  
 configuration file.  
 .It Ev PAGER  .It Ev PAGER
 Specifies the pagination program to use when  Specifies the pagination program to use when
 .Ev MANPAGER  .Ev MANPAGER
 is not defined.  is not defined.
 If neither PAGER nor MANPAGER is defined,  If neither PAGER nor MANPAGER is defined,
 .Pa /usr/bin/more Fl s  .Xr more 1
   .Fl s
 will be used.  will be used.
 .El  .El
 .Sh FILES  .Sh FILES
Line 355  utility is compliant with the
Line 404  utility is compliant with the
 specification.  specification.
 .Pp  .Pp
 The flags  The flags
 .Op Fl aCcfhMmSsw ,  .Op Fl aCcfhIKlMmOSsTWw ,
 as well as the environment variables  as well as the environment variables
 .Ev MACHINE ,  .Ev MACHINE ,
 .Ev MANPAGER ,  .Ev MANPAGER ,

Legend:
Removed from v.1.7  
changed lines
  Added in v.1.16

CVSweb