Return to mdoc.7 CVS log | Up to [cvsweb.bsd.lv] / mandoc |
version 1.73, 2009/11/02 11:39:40 | version 1.77, 2009/11/12 05:50:12 | ||
---|---|---|---|
|
|
||
.Ss Text Decoration | .Ss Text Decoration | ||
Terms may be text-decorated using the | Terms may be text-decorated using the | ||
.Sq \ef | .Sq \ef | ||
escape followed by an indicator: B (bold), I, (italic), or P and R | escape followed by an indicator: B (bold), I, (italic), R (Roman), or P | ||
(Roman, or reset). This form is not recommended for | (revert to previous mode): | ||
.Pp | |||
.D1 \efBbold\efR \efIitalic\efP | |||
.Pp | |||
A numerical representation 3, 2, or 1 (bold, italic, and Roman, | |||
respectively) may be used instead. A text decoration is valid within | |||
the current font scope only: if a macro opens a font scope alongside | |||
its own scope, such as | |||
.Sx \&Bf | |||
.Cm \&Sy , | |||
in-scope invocations of | |||
.Sq \ef | |||
are only valid within the font scope of the macro. If | |||
.Sq \ef | |||
is specified outside of any font scope, such as in unenclosed, free-form | |||
text, it will affect the remainder of the document. | |||
.Pp | |||
Text may also be sized with the | |||
.Sq \es | |||
escape, whose syntax is one of | |||
.Sq \es+-n | |||
for one-digit numerals; | |||
.Sq \es(+-nn | |||
or | |||
.Sq \es+-(nn | |||
for two-digit numerals; and | |||
.Sq \es[+-N] , | |||
.Sq \es+-[N] , | |||
.Sq \es'+-N' , | |||
or | |||
.Sq \es+-'N' | |||
for arbitrary-digit numerals: | |||
.Pp | |||
.D1 \es+1bigger\es-1 | |||
.D1 \es[+10]much bigger\es[-10] | |||
.D1 \es+(10much bigger\es-(10 | |||
.D1 \es+'100'much much bigger\es-'100' | |||
.Pp | |||
Note these forms are | |||
.Em not | |||
recommended for | |||
.Nm , | .Nm , | ||
which encourages semantic, not presentation, annotation. | which encourages semantic annotation. | ||
. | . | ||
. | . | ||
.Ss Predefined Strings | .Ss Predefined Strings | ||
|
|
||
.Pp | .Pp | ||
.Bl -dash -compact | .Bl -dash -compact | ||
.It | .It | ||
.Xr groff 1 | |||
behaves strangely (even between versions) when specifying | |||
.Sq \ef | |||
escapes within line-macro scopes. These aberrations have been | |||
normalised. | |||
.It | |||
Negative scaling units are now truncated to zero instead of creating | Negative scaling units are now truncated to zero instead of creating | ||
interesting conditions, such as with | interesting conditions, such as with | ||
.Sq \&sp -1i . | .Sx \&sp | ||
.Cm \-1i . | |||
Furthermore, the | Furthermore, the | ||
.Sq f | .Sq f | ||
scaling unit, while accepted, is rendered as the default unit. | scaling unit, while accepted, is rendered as the default unit. | ||
|
|
||
behaviour is no longer applicable. | behaviour is no longer applicable. | ||
.It | .It | ||
Display types | Display types | ||
.Sx \&Bd Fl center | .Sx \&Bd | ||
.Fl center | |||
and | and | ||
.Fl right | .Fl right | ||
are aliases for | are aliases for | ||
|
|
||
.Qq go orbital | .Qq go orbital | ||
but is a proper delimiter in this implementation. | but is a proper delimiter in this implementation. | ||
.It | .It | ||
.Sx \&It Fl nested | .Sx \&It | ||
.Fl nested | |||
is assumed for all lists (it wasn't in historic groff): any list may be | is assumed for all lists (it wasn't in historic groff): any list may be | ||
nested and | nested and | ||
.Fl enum | .Fl enum |