version 1.55, 2010/01/07 19:10:09 |
version 1.56, 2010/03/22 05:59:32 |
Line 423 subsequent lines until closed by another block macro. |
|
Line 423 subsequent lines until closed by another block macro. |
|
.Ss Line Macros |
.Ss Line Macros |
Line macros are generally scoped to the current line, with the body |
Line macros are generally scoped to the current line, with the body |
consisting of zero or more arguments. If a macro is scoped to the next |
consisting of zero or more arguments. If a macro is scoped to the next |
line and the line arguments are empty, the next line is used instead, |
line and the line arguments are empty, the next line, which must be |
else the general syntax is used. Thus: |
text, is used instead. Thus: |
.Bd -literal -offset indent |
.Bd -literal -offset indent |
\&.I |
\&.I |
foo |
foo |
|
|
.Pp |
.Pp |
is equivalent to |
is equivalent to |
.Sq \&.I foo . |
.Sq \&.I foo . |
If next-line macros are invoked consecutively, only the last is used; in |
If next-line macros are invoked consecutively, only the last is used. |
other words, if a next-line macro is preceded by a block macro, it is |
If a next-line macro is followed by a non-next-line macro, an error is |
ignored. |
raised (unless in the case of |
|
.Sx \&br , |
|
.Sx \&sp , |
|
or |
|
.Sx \&na ) . |
|
.Pp |
|
The syntax is as follows: |
.Bd -literal -offset indent |
.Bd -literal -offset indent |
\&.YO \(lBbody...\(rB |
\&.YO \(lBbody...\(rB |
\(lBbody...\(rB |
\(lBbody...\(rB |
Line 488 macros should not be used. They're included for compa |
|
Line 494 macros should not be used. They're included for compa |
|
.Ss Block Macros |
.Ss Block Macros |
Block macros are comprised of a head and body. Like for in-line macros, |
Block macros are comprised of a head and body. Like for in-line macros, |
the head is scoped to the current line and, in one circumstance, the |
the head is scoped to the current line and, in one circumstance, the |
next line; the body is scoped to subsequent lines and is closed out by a |
next line (the next-line stipulations for line macros apply here as |
subsequent block macro invocation. |
well). |
|
.Pp |
|
The syntax is as follows: |
.Bd -literal -offset indent |
.Bd -literal -offset indent |
\&.YO \(lBhead...\(rB |
\&.YO \(lBhead...\(rB |
\(lBhead...\(rB |
\(lBhead...\(rB |