mandoc/mandoc.1 - diff

Return to mandoc.1 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mandoc.1 between version 1.190 and 1.196

version 1.190, 2017/05/30 20:25:32

version 1.196, 2017/06/08 00:23:30

Line 75 and for the

.Xr man 7

.Ic \&TH

macro.

This can also be used to perform style checks according to the

conventions of one operating system while running on a different

operating system; see

.Sx Style messages

for details.

.It Fl K Ar encoding

Specify the input encoding.

The supported

Line 219 See

Line 224 See

.It Fl T Cm lint

Parse only: produce no output.

Implies

.Fl W Cm warning .

.Fl W Cm style .

.It Fl T Cm locale

Encode output using the current locale.

This is the default.

Line 632 to exit at once, possibly in the middle of parsing or

Line 637 to exit at once, possibly in the middle of parsing or

Note that selecting

.Fl T Cm lint

output mode implies

.Fl W Cm warning .

.Fl W Cm style .

.Sh EXAMPLES

To page manuals to the terminal:

.Pp

Line 743 option or

Line 748 option or

.Fl T Cm lint

output mode.

.Ss Style messages

As indicated below, some style checks are only performed if a

specific operating system name occurs in the arguments of the

.Ic \&Os

macro, of the

.Fl Ios

command line option, or, if neither are present, in the return value

of the

.Xr uname 3

function.

.Bl -ohang

.It Sy "useless macro"

.Pq mdoc

Line 753 or

Line 767 or

.Ic \&Ud

macro was found.

Simply delete it: it serves no useful purpose.

.It Sy "consider using OS macro"

.Pq mdoc

A string was found in plain text or in a

.Ic \&Bx

macro that could be represented using

.Ic \&Ox ,

.Ic \&Nx ,

.Ic \&Fx ,

.Ic \&Dx .

.It Sy "errnos out of order"

.Pq mdoc, Nx

The

.Ic \&Er

items in a

.Ic \&Bl

list are not in alphabetical order.

.It Sy "duplicate errno"

.Pq mdoc, Nx

.Ic \&Bl

list contains two consecutive

.Ic \&It

entries describing the same

.Ic \&Er

number.

.It Sy "description line ends with a full stop"

.Pq mdoc

Do not use punctuation at the end of an

.Ic \&Nd

block.

.El

.Ss Warnings related to the document prologue

.Bl -ohang

Line 1354 or

Line 1399 or

.Ic \&Fn

macro contains an opening or closing parenthesis; that's probably wrong,

parentheses are added automatically.

.It Sy "unknown library name"

.Pq mdoc, not on Ox

.Ic \&Lb

macro has an unknown name argument and will be rendered as

.Qq library Dq Ar name .

.It Sy "invalid content in Rs block"

.Pq mdoc

Line 1701 whatever mode was active before the block.

Line 1752 whatever mode was active before the block.

.Ic \&Bl

macro fails to specify the list type.

.It Sy "argument is not numeric, using 1"

.Pq roff

The argument of a

.Ic \&ce

request is not a number.

.It Sy "missing manual name, using \(dq\(dq"

.Pq mdoc

The first call to

CVSweb