mandoc/mandoc.1 - diff

Return to mandoc.1 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mandoc.1 between version 1.217 and 1.222

version 1.217, 2017/07/20 15:26:41

version 1.222, 2018/03/16 15:05:44

Line 1

.\" $Id$

.\"

.\" Permission to use, copy, modify, and distribute this software for any

.\" purpose with or without fee is hereby granted, provided that the above

Line 118 With

all input files are interpreted as

.Xr man 7 .

By default, the input language is automatically detected for each file:

if the the first macro is

if the first macro is

.Ic \&Dd

.Ic \&Dt ,

Line 315 and seven for

.Xr man 7 .

Increasing this is not recommended; it may result in degraded formatting,

for example overfull lines or ugly line breaks.

.It Cm mdoc

Format

.Xr man 7

input files in

.Xr mdoc 7

output style.

Specifically, this suppresses the two additional blank lines near the

top and the bottom of each page, and it implies

.Fl O Cm indent Ns =5 .

One useful application is for checking that

.Fl T Cm man

output formats in the same way as the

.Xr mdoc 7

source it was generated from.

.It Cm width Ns = Ns Ar width

The output width is set to

.Ar width .

Line 741 Please use your good judgement to decide whether any p

Line 755 Please use your good judgement to decide whether any p

.Cm style

suggestion really justifies a change to the input file.

.It Cm base

A convertion used in the base system of a specific operating system

A convention used in the base system of a specific operating system

is not adhered to.

These are not markup mistakes, and neither the quality of formatting

nor portability are in danger.

Line 861 A single manual page contains two copies of the RCS id

Line 875 A single manual page contains two copies of the RCS id

the same operating system.

Consider deleting the later instance and moving the first one up

to the top of the page.

.It Sy "typo in section name"

.It Sy "possible typo in section name"

.Pq mdoc

Fuzzy string matching revealed that the argument of an

.Ic \&Sh

Line 938 An

Line 952 An

request occurs even though the document already switched to no-fill mode

and did not switch back to fill mode yet.

It has no effect.

.It Sy "verbatim \(dq--\(dq, maybe consider using \e(em"

.Pq mdoc

Even though the ASCII output device renders an em-dash as

.Qq \-\- ,

that is not a good way to write it in an input file

because it renders poorly on all other output devices.

.It Sy "function name without markup"

.Pq mdoc

A word followed by an empty pair of parentheses occurs on a text line.

CVSweb