version 1.58, 2009/08/20 13:22:48 |
version 1.62, 2009/10/18 19:01:24 |
Line 73 whitespace are stripped from input. |
|
Line 73 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: |
|
.Pp |
.Bl -tag -width Ds -offset indent -compact |
.Bl -tag -width Ds -offset indent -compact |
.It \&. |
.It \&. |
.Pq period |
.Pq period |
Line 208 considered literal text. Thus, the following produces |
|
Line 209 considered literal text. Thus, the following produces |
|
.Pp |
.Pp |
In free-form mode, quotes are regarded as opaque text. |
In free-form mode, quotes are regarded as opaque text. |
. |
. |
|
.Ss Scaling Widths |
|
Many macros support scaled widths for their arguments, such as |
|
stipulating a two-inch list indentation with the following: |
|
.Bd -literal -offset indent |
|
\&.Bl -tag -width 2i |
|
.Ed |
. |
. |
|
.Pp |
|
The syntax for scaled widths is |
|
.Sq Li [+-]?[0-9]*.[0-9]*[:unit:] , |
|
where a decimal must be preceded or proceeded by at least one digit. |
|
Negative numbers, while accepted, are truncated to zero. The following |
|
scaling units are accepted: |
|
.Pp |
|
.Bl -tag -width Ds -offset indent -compact |
|
.It c |
|
centimetre |
|
.It i |
|
inch |
|
.It P |
|
pica (~1/6 inch) |
|
.It p |
|
point (~1/72 inch) |
|
.It f |
|
synonym for |
|
.Sq u |
|
.It v |
|
default vertical span |
|
.It m |
|
width of rendered |
|
.Sq m |
|
.Pq em |
|
character |
|
.It n |
|
width of rendered |
|
.Sq n |
|
.Pq en |
|
character |
|
.It u |
|
default horizontal span |
|
.It M |
|
mini-em (~1/100 em) |
|
.El |
|
.Pp |
|
Using anything other than |
|
.Sq m , |
|
.Sq n , |
|
.Sq u , |
|
or |
|
.Sq v |
|
is necessarily non-portable across output media. See |
|
.Sx COMPATIBILITY . |
|
. |
|
. |
.Sh MANUAL STRUCTURE |
.Sh MANUAL STRUCTURE |
Each |
Each |
.Nm |
.Nm |
|
|
The |
The |
\&.Nm |
\&.Nm |
utility processes files ... |
utility processes files ... |
|
\&.\e\*q .Sh IMPLEMENTATION NOTES |
\&.\e\*q The next is for sections 1 & 8 only. |
\&.\e\*q The next is for sections 1 & 8 only. |
\&.\e\*q .Sh EXIT STATUS |
\&.\e\*q .Sh EXIT STATUS |
\&.\e\*q The next is for sections 2, 3, & 9 only. |
\&.\e\*q The next is for sections 2, 3, & 9 only. |
|
|
column indicates that the macro may be called subsequent to the initial |
column indicates that the macro may be called subsequent to the initial |
line-macro. If a macro is not callable, then its invocation after the |
line-macro. If a macro is not callable, then its invocation after the |
initial line macro is interpreted as opaque text, such that |
initial line macro is interpreted as opaque text, such that |
.Sq \&.Fl Sh |
.Sq \&.Fl \&Sh |
produces |
produces |
.Sq Fl Sh . |
.Sq Fl \&Sh . |
. |
. |
.Pp |
.Pp |
The |
The |
|
|
. |
. |
.Pp |
.Pp |
.Bl -dash -compact |
.Bl -dash -compact |
|
.It |
|
Negative scaling units are now truncated to zero instead of creating |
|
interesting conditions, such as with |
|
.Sq \&sp -1i . |
|
Furthermore, the |
|
.Sq f |
|
scaling unit, while accepted, is rendered as the default unit. |
.It |
.It |
The |
The |
.Sq \-split |
.Sq \-split |