version 1.37, 2010/05/09 15:08:16 |
version 1.47, 2011/08/18 08:58:44 |
|
|
.It \e(Re Ta \(Re Ta real |
.It \e(Re Ta \(Re Ta real |
.It \e(pd Ta \(pd Ta partial differential |
.It \e(pd Ta \(pd Ta partial differential |
.It \e(-h Ta \(-h Ta Planck constant over 2\(*p |
.It \e(-h Ta \(-h Ta Planck constant over 2\(*p |
|
.It \e[12] Ta \[12] Ta one-half |
|
.It \e[14] Ta \[14] Ta one-fourth |
|
.It \e[34] Ta \[34] Ta three-fourths |
.El |
.El |
.Pp |
.Pp |
Ligatures: |
Ligatures: |
|
|
.It \e(ts Ta \(ts Ta sigma terminal |
.It \e(ts Ta \(ts Ta sigma terminal |
.El |
.El |
.Sh PREDEFINED STRINGS |
.Sh PREDEFINED STRINGS |
These are not recommended for use, as they differ across |
Predefined strings are inherited from the macro packages of historical |
implementations: |
troff implementations. |
|
They are |
|
.Em not recommended |
|
for use, as they differ across implementations. |
|
Manuals using these predefined strings are almost certainly not |
|
portable. |
.Pp |
.Pp |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.It Em Input Ta Em Rendered Ta Em Description |
.It Em Input Ta Em Rendered Ta Em Description |
Line 512 implementations: |
|
Line 520 implementations: |
|
.It \e*(>= Ta \*(>= Ta greater-than-equal |
.It \e*(>= Ta \*(>= Ta greater-than-equal |
.It \e*(aa Ta \*(aa Ta acute |
.It \e*(aa Ta \*(aa Ta acute |
.It \e*(ga Ta \*(ga Ta grave |
.It \e*(ga Ta \*(ga Ta grave |
|
.It \e*(Px Ta \*(Px Ta POSIX standard name |
|
.It \e*(Ai Ta \*(Ai Ta ANSI standard name |
.El |
.El |
.Sh COMPATIBILITY |
.Sh UNICODE CHARACTERS |
This section documents compatibility of |
The escape sequence |
.Nm |
|
with older or existing versions of |
|
.Xr groff 1 . |
|
.Pp |
.Pp |
The following render differently in |
.Dl \e[uXXXX] |
.Fl T Ns Ar ascii |
|
output mode: |
|
.Bd -ragged -offset indent |
|
\e(ss, \e(nm, \e(nb, \e(nc, \e(ib, \e(ip, \e(pp, \e[sum], \e[product], |
|
\e[coproduct], \e(gr, \e(-h, \e(a. |
|
.Ed |
|
.Pp |
.Pp |
The following render differently in |
is interpreted as a Unicode codepoint. |
.Fl T Ns Ar html |
The codepoint must be in the range above U+0080 and less than U+10FFFF. |
output mode: |
For compatibility, points must be zero-padded to four characters; if |
.Bd -ragged -offset indent |
greater than four characters, no zero padding is allowed. |
\e(~=, \e(nb, \e(nc |
Unicode surrogates are not allowed. |
.Ed |
.\" .Pp |
|
.\" Unicode glyphs attenuate to the |
|
.\" .Sq \&? |
|
.\" character if invalid or not rendered by current output media. |
|
.Sh NUMBERED CHARACTERS |
|
For backward compatibility with existing manuals, |
|
.Xr mandoc 1 |
|
also supports the |
.Pp |
.Pp |
Finally, the following have been omitted by being poorly documented or |
.Dl \eN\(aq Ns Ar number Ns \(aq |
having no known representation: |
.Pp |
.Bd -ragged -offset indent |
escape sequence, inserting the character |
\e[radicalex], \e[sqrtex], \e(ru |
.Ar number |
.Ed |
from the current character set into the output. |
|
Of course, this is inherently non-portable and is already marked |
|
as deprecated in the Heirloom roff manual. |
|
For example, do not use \eN'34', use \e(dq, or even the plain |
|
.Sq \(dq |
|
character where possible. |
|
.Sh COMPATIBILITY |
|
This section documents compatibility between mandoc and other other |
|
troff implementations, at this time limited to GNU troff |
|
.Pq Qq groff . |
|
.Pp |
|
.Bl -dash -compact |
|
.It |
|
The \eN\(aq\(aq escape sequence is limited to printable characters; in |
|
groff, it accepts arbitrary character numbers. |
|
.It |
|
In |
|
.Fl T Ns Cm ascii , |
|
the |
|
\e(ss, \e(nm, \e(nb, \e(nc, \e(ib, \e(ip, \e(pp, \e[sum], \e[product], |
|
\e[coproduct], \e(gr, \e(\-h, and \e(a. special characters render |
|
differently between mandoc and groff. |
|
.It |
|
In |
|
.Fl T Ns Cm html |
|
and |
|
.Fl T Ns Cm xhtml , |
|
the \e(~=, \e(nb, and \e(nc special characters render differently |
|
between mandoc and groff. |
|
.It |
|
The |
|
.Fl T Ns Cm ps |
|
and |
|
.Fl T Ns Cm pdf |
|
modes format like |
|
.Fl T Ns Cm ascii |
|
instead of rendering glyphs as in groff. |
|
.It |
|
The \e[radicalex], \e[sqrtex], and \e(ru special characters have been omitted |
|
from mandoc either because they are poorly documented or they have no |
|
known representation. |
|
.El |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr mandoc 1 |
.Xr mandoc 1 |
.Sh AUTHORS |
.Sh AUTHORS |
The |
The |
.Nm |
.Nm |
manual page was written by |
manual page was written by |
.An Kristaps Dzonsons Aq kristaps@bsd.lv . |
.An Kristaps Dzonsons , |
|
.Mt kristaps@bsd.lv . |
|
.Sh CAVEATS |
|
The |
|
.Sq \e*(Ba |
|
escape mimics the behaviour of the |
|
.Sq \&| |
|
character in |
|
.Xr mdoc 7 ; |
|
thus, if you wish to render a vertical bar with no side effects, use |
|
the |
|
.Sq \e(ba |
|
escape. |