mandoc/mdoc.7 - diff

Return to mdoc.7 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mdoc.7 between version 1.46 and 1.48

version 1.46, 2009/07/17 14:51:04

version 1.48, 2009/07/18 23:31:04

Line 144 These are not.

.\" PARAGRAPH------------

.Pp

In macro lines, whitespace delimits arguments and is discarded. If

arguments are quoted, whitespace is conditionally retained within the

arguments are quoted, whitespace within the quotes is retained.

quotes.

.\" TODO: which do and which don't?

.\" PARAGRAPH------------

.Pp

Blank lines are only permitted within literal contexts, as are lines

Line 159 or when in a literal context.

Line 157 or when in a literal context.

Macro arguments may be quoted with a double-quote to group

space-delimited terms or to retain blocks of whitespace. A quoted

argument begins with a double-quote preceded by whitespace. The next

double-quote terminates the term, regardless of surrounding whitespace.

double-quote not pair-wise adjacent to another double-quote terminates

the literal, regardless of surrounding whitespace.

.\" PARAGRAPH------------

.Pp

This produces tokens

.Sq a" ,

.Sq b c ,

.Sq de ,

and

.Sq fg" .

Note that any quoted term, be it argument or macro, is indiscriminately

considered literal text. Thus, the following produces

.Sq \&Em a :

.Bd -literal -offset indent

\&.Em "Em a"

.Ed

.\" PARAGRAPH------------

.Pp

In free-form mode, quotes are regarded as opaque text.

.\" SECTION---------------------------------------------

.Sh MANUAL STRUCTURE

Line 441 file re-write

Line 454 file re-write

.\" PARAGRAPH------------

.Pp

.Bl -dash -compact

.\" LIST-ITEM

.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.

.\" LIST-ITEM

.It

The

CVSweb