Fix doc quoting problems with Texinfo 5

Without this change, in the info file output, Texinfo 5 quotes code
in text with undirected single quotes 'like this' and generates
code examples that with many PDF readers cannot be cut out of PDFs
and pasted into code.
* manual/libc.texinfo: Configure the libc manual like the GNU
Emacs manual, by using @documentencoding and setting
txicodequoteundirected and txicodequotebacktick.  This way,
Texinfo 5 quotes code in text with directed single quotes ‘like
this’ and produces examples that can be cut out of PDFs.  This
change causes Texinfo 5 to generate info files that contain UTF-8
characters in the set {'‘', '’', '“', '”', 'Ä', 'ä', 'ö', '−',
'–', '—', '©', '⇒', '•', '…'}, which is OK nowadays.

diff --git a/ChangeLog b/ChangeLog
index 515d173402b362629f19edaad0cca7806974896e..5392b11f5179fa77cbcd4002b2104e9d37fb7da6 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,19 @@
+2016-01-10  Paul Eggert  <eggert@cs.ucla.edu>
+
+       Fix doc quoting problems with Texinfo 5
+       Without this change, in the info file output, Texinfo 5 quotes code
+       in text with undirected single quotes 'like this' and generates
+       code examples that with many PDF readers cannot be cut out of PDFs
+       and pasted into code.
+       * manual/libc.texinfo: Configure the libc manual like the GNU
+       Emacs manual, by using @documentencoding and setting
+       txicodequoteundirected and txicodequotebacktick.  This way,
+       Texinfo 5 quotes code in text with directed single quotes ‘like
+       this’ and produces examples that can be cut out of PDFs.  This
+       change causes Texinfo 5 to generate info files that contain UTF-8
+       characters in the set {'‘', '’', '“', '”', 'Ä', 'ä', 'ö', '−',
+       '–', '—', '©', '⇒', '•', '…'}, which is OK nowadays.
+
 2016-01-08  Tulio Magno Quites Machado Filho  <tuliom@linux.vnet.ibm.com>
 
        * sysdeps/unix/sysv/linux/powerpc/htm.h (__libc_tbegin,

diff --git a/manual/libc.texinfo b/manual/libc.texinfo
index 573c30f51ba5d6e2bb534efc62a217ebe2fcf7e7..c4138db00858800a8f79f8946f2686d9067ebf8d 100644 (file)
--- a/manual/libc.texinfo
+++ b/manual/libc.texinfo
@@ -2,6 +2,13 @@
 @comment %**start of header (This is for running Texinfo on a region.)
 @setfilename libc.info
 @settitle The GNU C Library
+@documentencoding UTF-8
+@c '@codequotebacktick on' and '@codequoteundirected on' require
+@c Texinfo 5.0 or later, so use the older equivalent @set variables
+@c supported in Texinfo 4.11 and later.
+@set txicodequoteundirected
+@set txicodequotebacktick
+
 @c setchapternewpage odd
 
 @include macros.texi