mandoc/mandoc_char.7 - diff

Return to mandoc_char.7 CVS log

Up to [cvsweb.bsd.lv] / mandoc

-version 1.67, 2017/06/14 20:57:07
+version 1.68, 2018/03/15 18:10:31
 Line 35  documents.
 Line 35  documents.
 Line 35  documents.
  .Pp
  The rendering depends on the
  .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 ,
- 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
  In particular, in English manual pages, do not use special-character
  escape sequences to represent national language characters in author