===================================================================
RCS file: /cvs/mandoc/mandoc_char.7,v
retrieving revision 1.60
retrieving revision 1.61
diff -u -p -r1.60 -r1.61
--- mandoc/mandoc_char.7	2015/03/27 00:57:28	1.60
+++ mandoc/mandoc_char.7	2015/03/27 01:01:28	1.61
@@ -1,4 +1,4 @@
-.\"	$Id: mandoc_char.7,v 1.60 2015/03/27 00:57:28 schwarze Exp $
+.\"	$Id: mandoc_char.7,v 1.61 2015/03/27 01:01:28 schwarze Exp $
 .\"
 .\" Copyright (c) 2003 Jason McIntyre <jmc@openbsd.org>
 .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
@@ -142,6 +142,28 @@ Note that on text lines, literal double-quote characte
 verbatim.
 All other quote-like characters can be used verbatim as well,
 even on request and macro lines.
+.Ss Accents
+In output modes supporting such special output characters, for example
+.Fl T Cm pdf ,
+some
+.Xr roff 7
+formatters convert the following ASCII input characters to the
+following Unicode special output characters:
+.Bl -column x(ga U+2018 -offset indent
+.It \(ga Ta U+2018 Ta left single quotation mark
+.It \(aq Ta U+2019 Ta right single quotation mark
+.It \(ti Ta U+02DC Ta small tilde
+.El
+.Pp
+In prose, this automatic substitution is often desirable;
+but when these characters have to be displayed as plain ASCII
+characters, for example in source code samples, they require
+escaping to render as follows:
+.Bl -column x(ga U+2018 -offset indent
+.It \e(ga Ta U+0060 Ta grave accent
+.It \e(aq Ta U+0027 Ta apostrophe
+.It \e(ti Ta U+007E Ta tilde
+.El
 .Ss Periods
 The period
 .Pq Sq \&.