This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
[PROPOSED PATCH] Fix doc quoting problems with Texinfo 5
- From: Paul Eggert <eggert at cs dot ucla dot edu>
- To: libc-alpha at sourceware dot org
- Cc: Paul Eggert <eggert at cs dot ucla dot edu>
- Date: Thu, 10 Dec 2015 10:16:28 -0800
- Subject: [PROPOSED PATCH] Fix doc quoting problems with Texinfo 5
- Authentication-results: sourceware.org; auth=none
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.
---
ChangeLog | 14 ++++++++++++++
manual/libc.texinfo | 7 +++++++
2 files changed, 21 insertions(+)
diff --git a/ChangeLog b/ChangeLog
index 81e5791..6a71f9f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,19 @@
2015-12-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.
+
Split large string section; add truncation advice
* manual/examples/strncat.c: Remove.
This example was misleading, as the code would have undefined
diff --git a/manual/libc.texinfo b/manual/libc.texinfo
index 554f8b0..5d8ad07 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
--
2.1.0