mandoc/mdoc.7 - diff

Return to mdoc.7 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mdoc.7 between version 1.132 and 1.136

version 1.132, 2010/07/06 10:55:50

version 1.136, 2010/07/19 09:19:22

Line 52 manuals must have

line terminators.

.Ss Comments

Text following a

.Sq \e" ,

.Sq \e\*q ,

whether in a macro or free-form text line, is ignored to the end of

line. A macro line with only a control character and comment escape,

.Sq \&.\e" ,

.Sq \&.\e\*q ,

is also ignored. Macro lines with only a control character and optionally

whitespace are stripped from input.

.Ss Reserved Characters

Line 135 If

is specified outside of any font scope, such as in unenclosed, free-form

text, it will affect the remainder of the document.

.Pp

Text may also be sized with the

Note this form is

.Sq \es

escape, whose syntax is one of

.Sq \es+-n

for one-digit numerals;

.Sq \es(+-nn

.Sq \es+-(nn

for two-digit numerals; and

.Sq \es[+-N] ,

.Sq \es+-[N] ,

.Sq \es'+-N' ,

.Sq \es+-'N'

for arbitrary-digit numerals:

.Pp

.D1 \es+1bigger\es-1

.D1 \es[+10]much bigger\es[-10]

.D1 \es+(10much bigger\es-(10

.D1 \es+'100'much much bigger\es-'100'

.Pp

Note these forms are

.Em not

recommended for

.Nm ,

Line 1178 See also

Line 1157 See also

and

.Sx \&Sy .

.Ss \&Bk

Begins a keep block, containing a collection of macros or text

Begins a collection of macros or text not breaking the line.

to be kept together in the output.

Its syntax is as follows:

.Pp

.D1 Pf \. Sx \&Bk Fl words

.Pp

Currently, the only argument implemented is

.Fl words ,

requesting to keep together all words of the contained text

on the same output line.

Subsequent arguments are ignored.

The

.Fl words

argument is required.

.Pp

Examples:

Each line within a keep block is kept intact, so the following example

will not break within each

.Sx \&Op

macro line:

.Bd -literal -offset indent

\&.Bk \-words

\&.Op o Ar output_file

\&.Op Fl f Ar flags

\&.Op Fl o Ar output

\&.Ek

.Ed

.Pp