version 1.57, 2010/03/23 11:30:48 |
version 1.58, 2010/03/25 07:28:16 |
Line 458 The syntax is as follows: |
|
Line 458 The syntax is as follows: |
|
.It Sx \&I Ta n Ta next-line Ta \& |
.It Sx \&I Ta n Ta next-line Ta \& |
.It Sx \&IB Ta n Ta current Ta \& |
.It Sx \&IB Ta n Ta current Ta \& |
.It Sx \&IR Ta n Ta current Ta \& |
.It Sx \&IR Ta n Ta current Ta \& |
.It Sx \&PD Ta n Ta current Ta compat |
.\" .It Sx \&PD Ta n Ta current Ta compat |
.It Sx \&R Ta n Ta next-line Ta \& |
.It Sx \&R Ta n Ta next-line Ta \& |
.It Sx \&RB Ta n Ta current Ta \& |
.It Sx \&RB Ta n Ta current Ta \& |
.It Sx \&RI Ta n Ta current Ta \& |
.It Sx \&RI Ta n Ta current Ta \& |
.It Sx \&SB Ta n Ta next-line Ta \& |
.It Sx \&SB Ta n Ta next-line Ta \& |
.It Sx \&SM Ta n Ta next-line Ta \& |
.It Sx \&SM Ta n Ta next-line Ta \& |
.It Sx \&TH Ta >1, <6 Ta current Ta \& |
.It Sx \&TH Ta >1, <6 Ta current Ta \& |
.It Sx \&UC Ta n Ta current Ta compat |
.\" .It Sx \&UC Ta n Ta current Ta compat |
.It Sx \&br Ta 0 Ta current Ta compat |
.It Sx \&br Ta 0 Ta current Ta compat |
.It Sx \&fi Ta 0 Ta current Ta compat |
.It Sx \&fi Ta 0 Ta current Ta compat |
.It Sx \&i Ta n Ta current Ta compat |
.It Sx \&i Ta n Ta current Ta compat |
Line 473 The syntax is as follows: |
|
Line 473 The syntax is as follows: |
|
.It Sx \&nf Ta 0 Ta current Ta compat |
.It Sx \&nf Ta 0 Ta current Ta compat |
.It Sx \&r Ta 0 Ta current Ta compat |
.It Sx \&r Ta 0 Ta current Ta compat |
.It Sx \&sp Ta 1 Ta current Ta compat |
.It Sx \&sp Ta 1 Ta current Ta compat |
.It Sx \&Sp Ta 0 Ta current Ta compat |
.\" .It Sx \&Sp Ta 0 Ta current Ta compat |
.It Sx \&Vb Ta <1 Ta current Ta compat |
.\" .It Sx \&Vb Ta <1 Ta current Ta compat |
.It Sx \&Ve Ta 0 Ta current Ta compat |
.\" .It Sx \&Ve Ta 0 Ta current Ta compat |
.El |
.El |
. |
. |
.Pp |
.Pp |
Line 483 Macros marked as |
|
Line 483 Macros marked as |
|
.Qq compat |
.Qq compat |
are included for compatibility with the significant corpus of existing |
are included for compatibility with the significant corpus of existing |
manuals that mix dialects of roff. These macros should not be used for |
manuals that mix dialects of roff. These macros should not be used for |
portable manuals. |
portable |
|
.Nm |
|
manuals. |
. |
. |
. |
. |
.Ss Block Macros |
.Ss Block Macros |
|
|
No closure refers to an explicit block closing macro. |
No closure refers to an explicit block closing macro. |
. |
. |
.Pp |
.Pp |
|
As a rule, block macros may not be nested; thus, calling a block macro |
|
while another block macro scope is open, and the open scope is not |
|
implicitly closed, is syntactically incorrect. |
|
. |
|
.Pp |
.Bl -column -compact -offset indent "MacroX" "ArgumentsX" "Head ScopeX" "sub-sectionX" "compatX" |
.Bl -column -compact -offset indent "MacroX" "ArgumentsX" "Head ScopeX" "sub-sectionX" "compatX" |
.It Em Macro Ta Em Arguments Ta Em Head Scope Ta Em Body Scope Ta Em Notes |
.It Em Macro Ta Em Arguments Ta Em Head Scope Ta Em Body Scope Ta Em Notes |
.It Sx \&HP Ta <2 Ta current Ta paragraph Ta \& |
.It Sx \&HP Ta <2 Ta current Ta paragraph Ta \& |
|
|
.Sx \&P , |
.Sx \&P , |
and |
and |
.Sx \&PP . |
.Sx \&PP . |
|
.\" . |
|
.\" . |
|
.\" .Ss \&PD |
|
.\" Has no effect. Included for compatibility. |
|
.\" . |
|
.\" . |
|
.\" .Ss \&UC |
|
.\" Has no effect. Included for compatibility. |
. |
. |
. |
. |
.Ss \&PD |
|
Has no effect. Included for compatibility. |
|
. |
|
. |
|
.Ss \&UC |
|
Has no effect. Included for compatibility. |
|
. |
|
. |
|
.Ss \&br |
.Ss \&br |
Breaks the current line. Consecutive invocations have no further effect. |
Breaks the current line. Consecutive invocations have no further effect. |
.Pp |
.Pp |
Line 971 macro. Defaults to 1, if unspecified. |
|
Line 978 macro. Defaults to 1, if unspecified. |
|
See also |
See also |
.Sx \&br . |
.Sx \&br . |
. |
. |
.Ss \&Sp |
.\" .Ss \&Sp |
A synonym for |
.\" A synonym for |
.Sx \&sp |
.\" .Sx \&sp |
.Cm 0.5v . |
.\" .Cm 0.5v . |
|
.\" . |
|
.\" .Ss \&Vb |
|
.\" A synonym for |
|
.\" .Sx \&nf . |
|
.\" Accepts an argument (the height of the formatted space) which is |
|
.\" disregarded. |
|
.\" . |
|
.\" .Ss \&Ve |
|
.\" A synonym for |
|
.\" .Sx \&fi . |
|
.\" . |
. |
. |
.Ss \&Vb |
|
A synonym for |
|
.Sx \&nf . |
|
Accepts an argument (the height of the formatted space) which is |
|
disregarded. |
|
. |
|
.Ss \&Ve |
|
A synonym for |
|
.Sx \&fi . |
|
. |
|
. |
|
.Sh COMPATIBILITY |
.Sh COMPATIBILITY |
This section documents compatibility with other roff implementations, at |
This section documents areas of questionable portability between |
this time limited to |
implementations of the |
.Xr groff 1 . |
.Nm |
|
language. |
.Pp |
.Pp |
.Bl -dash -compact |
.Bl -dash -compact |
.It |
.It |
The |
In quoted literals, GNU troff allowed pair-wise double-quotes to produce |
.Xr groff 1 |
a standalone double-quote in formatted output. It is not known whether |
.Sx \&i |
this behaviour is exhibited by other formatters. |
macro will italicise all subsequent text if a line argument is not |
|
provided. This behaviour is not implemented. |
|
.It |
.It |
In quoted literals, groff allowed pair-wise double-quotes to produce a |
Blocks of whitespace are stripped from macro and free-form text lines |
standalone double-quote in formatted output. This idiosyncratic |
(except when in literal mode) in mandoc. This is not the case for GNU |
behaviour is no longer applicable. |
troff: for maximum portability, whitespace sensitive blocks should be |
|
enclosed in literal contexts. |
.It |
.It |
The |
The |
.Sx \&sp |
.Sx \&sp |
macro does not accept negative numbers. |
macro does not accept negative values in mandoc. In GNU troff, this |
.It |
would result in strange behaviour. |
Blocks of whitespace are stripped from both macro and free-form text |
|
lines (except when in literal mode), while groff would retain whitespace |
|
in free-form text lines. |
|
.El |
.El |
. |
. |
. |
. |