aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPaul Eggert <eggert@cs.ucla.edu>2016-01-10 00:20:03 -0800
committerPaul Eggert <eggert@cs.ucla.edu>2016-01-10 00:20:51 -0800
commit97ee300903cdc0a0052d09ed7c3f7779a303d625 (patch)
tree89696568fbeb77720ed27b157ec8c24f81a517b0
parent812618055e5645473dc6d991b5954e40fc4dc2b5 (diff)
downloadglibc-97ee300903cdc0a0052d09ed7c3f7779a303d625.zip
glibc-97ee300903cdc0a0052d09ed7c3f7779a303d625.tar.gz
glibc-97ee300903cdc0a0052d09ed7c3f7779a303d625.tar.bz2
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.
-rw-r--r--ChangeLog16
-rw-r--r--manual/libc.texinfo7
2 files changed, 23 insertions, 0 deletions
diff --git a/ChangeLog b/ChangeLog
index 515d173..5392b11 100644
--- 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 573c30f..c4138db 100644
--- 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