version 1.66, 2017/06/02 12:43:52 |
version 1.68, 2018/03/15 18:10:31 |
|
|
.Pp |
.Pp |
The rendering depends on the |
The rendering depends on the |
.Xr mandoc 1 |
.Xr mandoc 1 |
output mode; in ASCII output, most characters are completely |
output mode; it can be inspected by calling |
unintelligible. |
.Xr man 1 |
For that reason, using any of the special characters documented here, |
on the |
except those discussed in the |
.Nm |
|
manual page with different |
|
.Fl T |
|
arguments. |
|
In ASCII output, the rendering of some characters may be hard |
|
to interpret for the reader. |
|
Many are rendered as descriptive strings like |
|
.Qq <integral> , |
|
.Qq <degree> , |
|
or |
|
.Qq <Gamma> , |
|
which may look ugly, and many are replaced by similar ASCII characters. |
|
In particular, accented characters are usually shown without the accent. |
|
For that reason, try to avoid using any of the special characters |
|
documented here except those discussed in the |
.Sx DESCRIPTION , |
.Sx DESCRIPTION , |
is strongly discouraged; they are supported merely for backwards |
unless they are essential for explaining the subject matter at hand, |
compatibility with existing documents. |
for example when documenting complicated mathematical functions. |
.Pp |
.Pp |
In particular, in English manual pages, do not use special-character |
In particular, in English manual pages, do not use special-character |
escape sequences to represent national language characters in author |
escape sequences to represent national language characters in author |
|
|
.It \e(ba Ta \(ba Ta bar |
.It \e(ba Ta \(ba Ta bar |
.It \e(br Ta \(br Ta box rule |
.It \e(br Ta \(br Ta box rule |
.It \e(ul Ta \(ul Ta underscore |
.It \e(ul Ta \(ul Ta underscore |
|
.It \e(ru Ta \(ru Ta underscore (width 0.5m) |
.It \e(rn Ta \(rn Ta overline |
.It \e(rn Ta \(rn Ta overline |
.It \e(bb Ta \(bb Ta broken bar |
.It \e(bb Ta \(bb Ta broken bar |
.It \e(sl Ta \(sl Ta forward slash |
.It \e(sl Ta \(sl Ta forward slash |