version 1.4, 2010/05/17 02:01:05 |
version 1.8, 2010/06/01 11:54:23 |
Line 90 The syntax of this macro is the same as that of |
|
Line 90 The syntax of this macro is the same as that of |
|
.Sx \&ig , |
.Sx \&ig , |
except that a leading argument must be specified. |
except that a leading argument must be specified. |
It is ignored, as are its children. |
It is ignored, as are its children. |
|
.Ss \&ds |
|
Define a string. |
|
This macro is intended to have two arguments, |
|
the name of the string to define and its content. |
|
Currently, it is ignored including its arguments, |
|
and the number of arguments is not checked. |
.Ss \&de1 |
.Ss \&de1 |
The syntax of this macro is the same as that of |
The syntax of this macro is the same as that of |
.Sx \&ig , |
.Sx \&ig , |
except that a leading argument must be specified. |
except that a leading argument must be specified. |
It is ignored, as are its children. |
It is ignored, as are its children. |
|
.Ss \&el |
|
The |
|
.Qq else |
|
half of an if/else conditional. |
|
Pops a result off the stack of conditional evaluations pushed by |
|
.Sx \&ie |
|
and uses it as its conditional. |
|
If no stack entries are present (e.g., due to no prior |
|
.Sx \&ie |
|
calls) |
|
then false is assumed. |
|
The syntax of this macro is similar to |
|
.Sx \&if |
|
except that the conditional is missing. |
|
.Ss \&ie |
|
The |
|
.Qq if |
|
half of an if/else conditional. |
|
The result of the conditional is pushed into a stack used by subsequent |
|
invocations of |
|
.Sx \&el , |
|
which may be separated by any intervening input (or not exist at all). |
|
Its syntax is equivalent to |
|
.Sx \&if . |
.Ss \&if |
.Ss \&if |
Begins a conditional that always evaluates to false. |
Begins a conditional. |
|
Right now, the conditional evaluates to true |
|
if and only if it starts with the letter |
|
.Sy n , |
|
indicating processing in |
|
.Xr nroff 1 |
|
style as opposed to |
|
.Xr troff 1 |
|
style. |
If a conditional is false, its children are not processed, but are |
If a conditional is false, its children are not processed, but are |
syntactically interpreted to preserve the integrity of the input |
syntactically interpreted to preserve the integrity of the input |
document. |
document. |
Line 169 macro is discarded. |
|
Line 207 macro is discarded. |
|
Furthermore, if an explicit closing sequence |
Furthermore, if an explicit closing sequence |
.Sq \e} |
.Sq \e} |
is specified in a free-form line, the entire line is accepted within the |
is specified in a free-form line, the entire line is accepted within the |
scope of the prior macro, not only the text preceding the close. |
scope of the prior macro, not only the text preceding the close, with the |
|
.Sq \e} |
|
collapsing into a zero-width space. |
.Ss \&ig |
.Ss \&ig |
Ignore input. |
Ignore input. |
Accepts the following syntax: |
Accepts the following syntax: |
Line 211 the subsequent invocation of |
|
Line 251 the subsequent invocation of |
|
.Sx \&if |
.Sx \&if |
will first signify the end of comment, then be invoked as a macro. |
will first signify the end of comment, then be invoked as a macro. |
This behaviour really shouldn't be counted upon. |
This behaviour really shouldn't be counted upon. |
|
.Ss \&rm |
|
Remove a request, macro or string. |
|
This macro is intended to have one argument, |
|
the name of the request, macro or string to be undefined. |
|
Currently, it is ignored including its arguments, |
|
and the number of arguments is not checked. |
|
.Ss \&tr |
|
Output character translation. |
|
This macro is intended to have one argument, |
|
consisting of an even number of characters. |
|
Currently, it is ignored including its arguments, |
|
and the number of arguments is not checked. |
.Sh COMPATIBILITY |
.Sh COMPATIBILITY |
This section documents compatibility between mandoc and other other |
This section documents compatibility between mandoc and other other |
troff implementations, at this time limited to GNU troff |
troff implementations, at this time limited to GNU troff |