mandoc/mandoc.1 - diff

Return to mandoc.1 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mandoc.1 between version 1.108 and 1.112

version 1.108, 2014/08/22 04:52:55

version 1.112, 2014/09/12 00:10:26

Line 23

.Nd format and display UNIX manuals

.Sh SYNOPSIS

.Nm mandoc

.Op Fl acV

.Op Fl acfhklV

.Sm off

.Op Fl I Cm os Li = Ar name

.Sm on

Line 51 and produces

.Fl T Ns Cm ascii

output.

.Pp

The arguments are as follows:

The options are as follows:

.Bl -tag -width Ds

.It Fl a

If the standard output is a terminal device and

Line 68 to paginate them.

This is the default.

It can be specified to override

.Fl a .

.It Fl f

A synonym for

.Xr whatis 1 .

This overrides any earlier

.Fl k

and

.Fl l

options.

.Sm off

.It Fl I Cm os Li = Ar name

.Sm on

Line 77 for the

Line 85 for the

.Xr mdoc 7

.Sq \&Os

macro.

.It Fl h

Display only the SYNOPSIS lines.

Implies

.Fl a .

.It Fl k

A synonym for

.Xr apropos 1 .

This overrides any earlier

.Fl f

and

.Fl l

options.

.It Fl l

A synonym for

.Fl a .

Also reverts any earlier

.Fl f

and

.Fl k

options.

.It Fl m Ns Ar format

Input format.

See

Line 137 If multiple files are specified,

Line 165 If multiple files are specified,

.Nm

will halt with the first failed parse.

.El

.Pp

.Fl f

and

.Fl k

mode,

.Nm

also supports the options

.Fl CMmOSsw

described in the

.Xr apropos 1

manual.

.Ss Input Formats

The

.Nm

Line 726 The same standard section title occurs more than once.

Line 766 The same standard section title occurs more than once.

.Pq mdoc

A standard section header occurs in a section of the manual

where it normally isn't useful.

.It Sy "unusual Xr order"

.Pq mdoc

In the SEE ALSO section, an

.Ic \&Xr

macro with a lower section number follows one with a higher number,

or two

.Ic \&Xr

macros refering to the same section are out of alphabetical order.

.It Sy "unusual Xr punctuation"

.Pq mdoc

In the SEE ALSO section, punctuation between two

.Ic \&Xr

macros differs from a single comma, or there is trailing punctuation

after the last

.Ic \&Xr

macro.

.It Sy "AUTHORS section without An macro"

.Pq mdoc

An AUTHORS sections contains no

.Ic \&An

macros, or only empty ones.

Probably, there are author names lacking markup.

.El

.Ss "Warnings related to macros and nesting"

.Bl -ohang

CVSweb