=================================================================== RCS file: /cvs/mandoc/man.1,v retrieving revision 1.4 retrieving revision 1.9 diff -u -p -r1.4 -r1.9 --- mandoc/man.1 2014/08/30 18:08:10 1.4 +++ mandoc/man.1 2014/12/18 21:11:46 1.9 @@ -1,5 +1,4 @@ -.\" $Id: man.1,v 1.4 2014/08/30 18:08:10 schwarze Exp $ -.\" $OpenBSD: man.1,v 1.4 2014/08/30 18:08:10 schwarze Exp $ +.\" $Id: man.1,v 1.9 2014/12/18 21:11:46 schwarze Exp $ .\" .\" Copyright (c) 1989, 1990, 1993 .\" The Regents of the University of California. All rights reserved. @@ -32,7 +31,7 @@ .\" .\" @(#)man.1 8.2 (Berkeley) 1/2/94 .\" -.Dd $Mdocdate: August 30 2014 $ +.Dd $Mdocdate: December 18 2014 $ .Dt MAN 1 .Os .Sh NAME @@ -42,10 +41,15 @@ .Nm man .Op Fl acfhklVw .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 O Ar option Ns = Ns Ar value .Op Fl S Ar subsection .Op Fl s Ar section +.Op Fl T Ar output +.Op Fl W Ar level .Op Ar section .Ar name ... .Sh DESCRIPTION @@ -96,10 +100,31 @@ This overrides any earlier 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 +macro. .It Fl h -Display only the -.Dq SYNOPSIS -lines of the requested manual pages. +Display only the SYNOPSIS lines of the requested manual pages. +Implies +.Fl a +and +.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 A synonym for .Xr apropos 1 . @@ -172,6 +197,11 @@ are specified by the line in the .Nm configuration file. +.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 Restricts the directories that .Nm @@ -241,8 +271,44 @@ specifies the possible .Ar section values, and their search order. Additional sections may be specified. +.It Fl T Ar output +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 V Print version and exit. +.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 fatal . +The default is +.Cm fatal ; +.Cm all +is an alias for +.Cm warning . +See the +.Xr mandoc 1 +manual for details. .It Fl w List the pathnames of the manual pages which .Nm @@ -253,14 +319,6 @@ and combination. .El .Pp -The -.Nm -utility also supports the options -.Fl IOTW -described in the -.Xr mandoc 1 -manual. -.Pp Guidelines for writing man pages can be found in .Xr mdoc 7 . @@ -354,7 +412,7 @@ utility is compliant with the specification. .Pp The flags -.Op Fl aCcfhMmSsw , +.Op Fl aCcfhIKlMmOSsTVWw , as well as the environment variables .Ev MACHINE , .Ev MANPAGER ,