version 1.4, 2009/03/26 16:23:22 |
version 1.5, 2009/03/26 23:01:26 |
|
|
\&.SH Macro lines change control state. |
\&.SH Macro lines change control state. |
Other lines are interpreted within the current state. |
Other lines are interpreted within the current state. |
.Ed |
.Ed |
.\" PARAGRAPH |
|
.Pp |
|
Macros are character sequences whose structural rules are described |
|
later in this document. |
|
.\" SECTION |
.\" SECTION |
.Sh INPUT ENCODING |
.Sh INPUT ENCODING |
.Nm |
.Nm |
Line 64 documents may contain only graphable 7-bit ASCII chara |
|
Line 60 documents may contain only graphable 7-bit ASCII chara |
|
space character |
space character |
.Sq \ . |
.Sq \ . |
All manuals must have |
All manuals must have |
|
.Ux |
.Sq \en |
.Sq \en |
line termination. |
line termination. |
.Pp |
.Pp |
Blank lines are acceptable; where found, the output will also assert a |
Blank lines are acceptable; where found, the output will assert a |
vertical space. |
vertical space. |
.Pp |
.Pp |
The |
The |
|
|
.Sq \&.RI . |
.Sq \&.RI . |
When these macros are invoked without arguments, the subsequent line is |
When these macros are invoked without arguments, the subsequent line is |
considered a continuation of the macro. Thus: |
considered a continuation of the macro. Thus: |
.Bd -literal -offset indent |
|
\&.RI foo |
|
.Ed |
|
.Pp |
|
and |
|
.Bd -literal -offset indent |
.Bd -literal -offset indent |
\&.RI |
\&.RI |
foo |
foo |
.Ed |
.Ed |
.Pp |
.Pp |
are equivalent. If two consecutive lines exhibit the latter behaviour, |
is equivalent to |
an error is raised. Thus, the following is acceptable: |
.Sq \&.RI foo . |
|
If two consecutive lines exhibit the latter behaviour, |
|
an error is raised. Thus, the following is not acceptable: |
.Bd -literal -offset indent |
.Bd -literal -offset indent |
\&.RI |
\&.RI |
\&.I Hello, world. |
|
foo |
|
.Ed |
|
.Pp |
|
The following, however, is not: |
|
.Bd -literal -offset indent |
|
\&.RI |
|
\&.I |
\&.I |
Hello, world. |
Hello, world. |
.Ed |
.Ed |
.Pp |
.Pp |
The |
The |
.Sq \&.TP |
.Sq \&.TP |
macro has similar behaviour, but does not need an empty argument line in |
macro is similar, but does not need an empty argument line to trigger |
order to trigger scope. |
the behaviour. |
.\" PARAGRAPH |
.\" PARAGRAPH |
.Sh MACROS |
.Sh MACROS |
This section contains a complete list of all |
This section contains a complete list of all |
.Nm |
.Nm |
macros, arranged alphabetically, with the number of arguments. |
macros and corresponding number of arguments. |
.Pp |
.Pp |
.Bl -column "MacroX" "Arguments" -compact -offset indent |
.Bl -column "MacroX" "Arguments" -compact -offset indent |
.It Em Macro Ta Em Arguments |
.It Em Macro Ta Em Arguments |