version 1.46, 2009/07/17 14:51:04 |
version 1.48, 2009/07/18 23:31:04 |
|
|
.\" PARAGRAPH------------ |
.\" PARAGRAPH------------ |
.Pp |
.Pp |
In macro lines, whitespace delimits arguments and is discarded. If |
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------------ |
.\" PARAGRAPH------------ |
.Pp |
.Pp |
Blank lines are only permitted within literal contexts, as are lines |
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 |
Macro arguments may be quoted with a double-quote to group |
space-delimited terms or to retain blocks of whitespace. A quoted |
space-delimited terms or to retain blocks of whitespace. A quoted |
argument begins with a double-quote preceded by whitespace. The next |
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------------ |
.\" PARAGRAPH------------ |
.Pp |
.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. |
In free-form mode, quotes are regarded as opaque text. |
.\" SECTION--------------------------------------------- |
.\" SECTION--------------------------------------------- |
.Sh MANUAL STRUCTURE |
.Sh MANUAL STRUCTURE |
|
|
.\" PARAGRAPH------------ |
.\" PARAGRAPH------------ |
.Pp |
.Pp |
.Bl -dash -compact |
.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 |
.\" LIST-ITEM |
.It |
.It |
The |
The |