mandoc/man.7 - diff

Return to man.7 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/man.7 between version 1.44 and 1.52

version 1.44, 2009/11/02 09:53:15

version 1.52, 2009/11/12 08:21:05

Line 67 line termination.

Blank lines are acceptable; where found, the output will assert a

vertical space.

.Pp

The

.Sq \ec

escape is common in historical

.Nm

documents; if encountered at the end of a word, it ensures that the

subsequent word isn't off-set by whitespace.

.Ss Comments

Text following a

.Sq \e\*" ,

Line 109 and

Line 101 and

.Ss Text Decoration

Terms may be text-decorated using the

.Sq \ef

escape followed by an indicator: B (bold), I, (italic), or P and R

escape followed by an indicator: B (bold), I, (italic), R (Roman), or P

(Roman, or reset).

(revert to previous mode):

.Pp

.D1 \efBbold\efR \efIitalic\efP

.Pp

A numerical representation 3, 2, or 1 (bold, italic, and Roman,

respectively) may be used instead. A text decoration is only valid, if

specified in free-form text, until the next macro invocation; if

specified within a macro, it's only valid until the macro closes scope.

.Pp

Text may also be sized with the

.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

Both

.Sq \es

and

.Sq \ef

attributes are forgotten when exiting a subsequent (or current) macro

invocation.

.Ss Whitespace

Line 547 and

Line 574 and

render in italics. Whitespace between arguments is omitted in output.

.Pp

Examples:

.Bd -filled -offset indent

.Pf \. Sx \&BI

bold italic bold italic

.Ed

.Pp

.D1 \&.BI bold italic bold italic

.Pp

The output of this example will be emboldened

.Dq bold

and italicised

Line 604 If specified, it's saved for later paragraph left-marg

Line 629 If specified, it's saved for later paragraph left-marg

saved or default width is used.

.Pp

See also

.Sx IP ,

.Sx \&IP ,

.Sx LP ,

.Sx \&LP ,

.Sx P ,

.Sx \&P ,

.Sx PP ,

.Sx \&PP ,

and

.Sx TP .

.Sx \&TP .

.Ss \&I

Line 661 argument is used as a leading term, flushed to the lef

Line 686 argument is used as a leading term, flushed to the lef

useful for bulleted paragraphs and so on.

.Pp

See also

.Sx HP ,

.Sx \&HP ,

.Sx LP ,

.Sx \&LP ,

.Sx P ,

.Sx \&P ,

.Sx PP ,

.Sx \&PP ,

and

.Sx TP .

.Sx \&TP .

.Ss \&IR

Line 692 subsequent paragraph, sub-section, section, or end of

Line 717 subsequent paragraph, sub-section, section, or end of

paragraph left-margin width is re-set to the default.

.Pp

See also

.Sx HP ,

.Sx \&HP ,

.Sx IP ,

.Sx \&IP ,

.Sx P ,

.Sx \&P ,

.Sx PP ,

.Sx \&PP ,

and

.Sx TP .

.Sx \&TP .

.Ss \&P

Line 705 Synonym for

Line 730 Synonym for

.Sx \&LP .

.Pp

See also

.Sx HP ,

.Sx \&HP ,

.Sx IP ,

.Sx \&IP ,

.Sx LP ,

.Sx \&LP ,

.Sx PP ,

.Sx \&PP ,

and

.Sx TP .

.Sx \&TP .

.Ss \&PP

Line 718 Synonym for

Line 743 Synonym for

.Sx \&LP .

.Pp

See also

.Sx HP ,

.Sx \&HP ,

.Sx IP ,

.Sx \&IP ,

.Sx LP ,

.Sx \&LP ,

.Sx P ,

.Sx \&P ,

and

.Sx TP .

.Sx \&TP .

.Ss \&R

Line 841 string replaces the default rendered volume, which is

Line 866 string replaces the default rendered volume, which is

manual section.

.Pp

Examples:

.Bd -filled -offset indent

.Pp

\&.TH CVS 5 "1992-02-12" GNU

.D1 \&.TH CVS 5 "1992-02-12" GNU

.Ed

.Ss \&TP

Line 864 If specified, it's saved for later paragraph left-marg

Line 888 If specified, it's saved for later paragraph left-marg

unspecified, the saved or default width is used.

.Pp

See also

.Sx HP ,

.Sx \&HP ,

.Sx IP ,

.Sx \&IP ,

.Sx LP ,

.Sx \&LP ,

.Sx P ,

.Sx \&P ,

and

.Sx PP .

.Sx \&PP .

.Ss \&PD

Line 893 End literal mode begun by

Line 917 End literal mode begun by

.Ss \&i

Italicise arguments. If no arguments are specified, all subsequent text

Italicise arguments. Synonym for

is italicised.

.Sx \&I .

.Pp

See also

.Sx \&B ,

Line 950 See also

Line 974 See also

This section documents compatibility with other roff implementations, at

this time limited to

.Xr groff 1 .

.Bl -hyphen

.Pp

.Bl -dash -compact

.It

The

.Xr groff 1

.Sx \&i

macro will italicise all subsequent text if a line argument is not

provided. This behaviour is not implemented.

.It

In quoted literals, groff allowed pair-wise double-quotes to produce a

standalone double-quote in formatted output. This idiosyncratic

behaviour is no longer applicable.

.It

The

.Sq sp

.Sx \&sp

macro does not accept negative numbers.

.It

Blocks of whitespace are stripped from both macro and free-form text

CVSweb