version 1.122, 2010/06/07 11:01:15 |
version 1.126, 2010/06/12 11:41:50 |
|
|
whether in a macro or free-form text line, is ignored to the end of |
whether in a macro or free-form text line, is ignored to the end of |
line. A macro line with only a control character and comment escape, |
line. A macro line with only a control character and comment escape, |
.Sq \&.\e" , |
.Sq \&.\e" , |
is also ignored. Macro lines with only a control charater and optionally |
is also ignored. Macro lines with only a control character and optionally |
whitespace are stripped from input. |
whitespace are stripped from input. |
.Ss Reserved Characters |
.Ss Reserved Characters |
Within a macro line, the following characters are reserved: |
Within a macro line, the following characters are reserved: |
Line 167 also defined a set of package-specific |
|
Line 167 also defined a set of package-specific |
|
.Dq predefined strings , |
.Dq predefined strings , |
which, like |
which, like |
.Sx Special Characters , |
.Sx Special Characters , |
demark special output characters and strings by way of input codes. |
mark special output characters and strings by way of input codes. |
Predefined strings are escaped with the slash-asterisk, |
Predefined strings are escaped with the slash-asterisk, |
.Sq \e* : |
.Sq \e* : |
single-character |
single-character |
Line 471 dissimilar macros are pair-wise invoked (except for |
|
Line 471 dissimilar macros are pair-wise invoked (except for |
|
before |
before |
.Sx \&Fo |
.Sx \&Fo |
or |
or |
.Sx \&Fn ) , |
.Sx \&Fn ) , |
they are separated by a vertical space, unless in the case of |
they are separated by a vertical space, unless in the case of |
.Sx \&Fo , |
.Sx \&Fo , |
.Sx \&Fn , |
.Sx \&Fn , |
|
|
.Sx \&Aq . |
.Sx \&Aq . |
.Ss \&Ap |
.Ss \&Ap |
Inserts an apostrophe without any surrounding white-space. |
Inserts an apostrophe without any surrounding white-space. |
This is generally used as a grammatic device when referring to the verb |
This is generally used as a grammatical device when referring to the verb |
form of a function: |
form of a function: |
.Bd -literal -offset indent |
.Bd -literal -offset indent |
\&.Fn execve Ap d |
\&.Fn execve Ap d |
Line 1094 As a scaling unit following the syntax described in |
|
Line 1094 As a scaling unit following the syntax described in |
|
As the calculated string length of the opaque string. |
As the calculated string length of the opaque string. |
.El |
.El |
.Pp |
.Pp |
If unset, it will revert to the value of |
If not provided an argument, it will be ignored. |
.Ar 8n |
|
as described in |
|
.Sx Scaling Widths . |
|
.It Fl compact |
.It Fl compact |
Do not assert a vertical space before the block. |
Do not assert a vertical space before the block. |
.It Fl file Ar file |
.It Fl file Ar file |
|
|
Subsequent this, only the |
Subsequent this, only the |
.Sq \&Ta |
.Sq \&Ta |
pseudo-macro may be used to delimit phrases. |
pseudo-macro may be used to delimit phrases. |
Furthermore, note that quoted sections propogate over tab-delimited |
Furthermore, note that quoted sections propagate over tab-delimited |
phrases on an |
phrases on an |
.Sx \&It , |
.Sx \&It , |
for example, |
for example, |
Line 2102 This is also used for indicating global variables in t |
|
Line 2099 This is also used for indicating global variables in t |
|
section, in which case a variable name is also specified. |
section, in which case a variable name is also specified. |
Note that it accepts |
Note that it accepts |
.Sx Block partial-implicit |
.Sx Block partial-implicit |
syntax when invoked as the first macro in the |
syntax when invoked as the first macro in the |
.Em SYNOPSIS |
.Em SYNOPSIS |
section, else it accepts ordinary |
section, else it accepts ordinary |
.Sx In-line |
.Sx In-line |
Line 2169 Heirloom troff, the other significant troff implementa |
|
Line 2166 Heirloom troff, the other significant troff implementa |
|
.Pp |
.Pp |
.Bl -dash -compact |
.Bl -dash -compact |
.It |
.It |
|
Old groff fails to assert a newline before |
|
.Sx \&Bd Fl ragged compact . |
|
.It |
groff behaves inconsistently when encountering |
groff behaves inconsistently when encountering |
.Pf non- Sx \&Fa |
.Pf non- Sx \&Fa |
children of |
children of |
|
|
.Sx \&Fn |
.Sx \&Fn |
in the |
in the |
.Em SYNOPSIS : |
.Em SYNOPSIS : |
at times newline(s) are suppressed dependong on whether a prior |
at times newline(s) are suppressed depending on whether a prior |
.Sx \&Fn |
.Sx \&Fn |
has been invoked. |
has been invoked. |
In mandoc, this is not the case. |
In mandoc, this is not the case. |
Line 2243 In quoted literals, groff allowed pair-wise double-quo |
|
Line 2243 In quoted literals, groff allowed pair-wise double-quo |
|
standalone double-quote in formatted output. |
standalone double-quote in formatted output. |
This idiosyncratic behaviour is not applicable in mandoc. |
This idiosyncratic behaviour is not applicable in mandoc. |
.It |
.It |
Display types |
Display offsets |
.Sx \&Bd |
.Sx \&Bd |
.Fl center |
.Fl offset Ar center |
and |
and |
.Fl right |
.Fl offset Ar right |
are aliases for |
are disregarded in mandoc. |
.Fl left |
Furthermore, the |
in manodc. Furthermore, the |
|
.Fl file Ar file |
.Fl file Ar file |
argument is ignored. |
argument is not supported in mandoc. |
Lastly, since text is not right-justified in mandoc (or even groff), |
Lastly, since text is not right-justified in mandoc (or even groff), |
.Fl ragged |
.Fl ragged |
and |
and |