texinfo ChangeLog NEWS doc/texinfo.tex doc/texi...

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       11/02/24 17:20:38

Modified files:
        .              : ChangeLog NEWS 
        doc            : texinfo.tex texinfo.txi 
        doc/refcard    : txirefcard.tex 

Log message:
        new commands @codequote{backtick,undirected} on|off

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1218&r2=1.1219
http://cvs.savannah.gnu.org/viewcvs/texinfo/NEWS?cvsroot=texinfo&r1=1.200&r2=1.201
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.tex?cvsroot=texinfo&r1=1.343&r2=1.344
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.372&r2=1.373
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/refcard/txirefcard.tex?cvsroot=texinfo&r1=1.16&r2=1.17

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1218
retrieving revision 1.1219
diff -u -b -r1.1218 -r1.1219
--- ChangeLog   23 Feb 2011 21:24:42 -0000      1.1218
+++ ChangeLog   24 Feb 2011 17:20:38 -0000      1.1219
@@ -1,5 +1,12 @@
 2011-02-23  Karl Berry  <address@hidden>
 
+       * texinfo.tex (\codequotebacktick, \codequoteundirected): new commands.
+       * NEWS,
+       * doc/refcard/txirefcard.tex,
+       * doc/texinfo.txi (Inserting Quote Characters): document them.
+
+2011-02-23  Karl Berry  <address@hidden>
+
        * texinfo.tex (\xrefautomaticsectiontitle): new command.
        * NEWS,
        * doc/refcard/txirefcard.tex,

Index: NEWS
===================================================================
RCS file: /sources/texinfo/texinfo/NEWS,v
retrieving revision 1.200
retrieving revision 1.201
diff -u -b -r1.200 -r1.201
--- NEWS        23 Feb 2011 21:24:42 -0000      1.200
+++ NEWS        24 Feb 2011 17:20:38 -0000      1.201
@@ -1,4 +1,4 @@
-$Id: NEWS,v 1.200 2011/02/23 21:24:42 karl Exp $
+$Id: NEWS,v 1.201 2011/02/24 17:20:38 karl Exp $
 This NEWS file records noteworthy changes, very tersely.
 See the manual for detailed information.
 
@@ -30,6 +30,8 @@
   . new command @urefbreakstyle to control breaking of @url/@uref in TeX.
   . new command @xrefautomaticsectiontitle to allow using section titles
     in cross references by default, instead of node names.
+  . new commands @codequoteundirected and @codequotebacktick, for a
+    better interface than the @set variables.
   . new diacritic command @ogonek.
   . new commands for Icelandic letters eth and thorn: @DH{} @dh{} @TH{} @th{}.
   . DEL (0x7f = 0177 = 127) is a true comment character (catcode 14 in TeX).

Index: doc/texinfo.tex
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.tex,v
retrieving revision 1.343
retrieving revision 1.344
diff -u -b -r1.343 -r1.344
--- doc/texinfo.tex     23 Feb 2011 21:24:43 -0000      1.343
+++ doc/texinfo.tex     24 Feb 2011 17:20:38 -0000      1.344
@@ -3,7 +3,7 @@
 % Load plain if necessary, i.e., if running under initex.
 \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi
 %
-\def\texinfoversion{2011-02-23.13}
+\def\texinfoversion{2011-02-24.09}
 %
 % Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995,
 % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
@@ -2296,12 +2296,11 @@
 
 \let\markupsetuplqkbd \markupsetnoligaturesquoteleft
 
-% Allow an option to not replace quotes with a regular directed right
-% quote/apostrophe (char 0x27), but instead use the undirected quote
-% from cmtt (char 0x0d).  The undirected quote is ugly, so don't make it
-% the default, but it works for pasting with more pdf viewers (at least
-% evince), the lilypond developers report.  xpdf does work with the
-% regular 0x27.
+% Allow an option to not use regular directed right quote/apostrophe
+% (char 0x27), but instead the undirected quote from cmtt (char 0x0d).
+% The undirected quote is ugly, so don't make it the default, but it
+% works for pasting with more pdf viewers (at least evince), the
+% lilypond developers report.  xpdf does work with the regular 0x27.
 %
 \def\codequoteright{%
   \expandafter\ifx\csname SETtxicodequoteundirected\endcsname\relax
@@ -2325,6 +2324,36 @@
   \else \char'22 \fi
 }
 
+% Commands to set the quote options.
+% 
+\parseargdef\codequoteundirected{%
+  \def\temp{#1}%
+  \ifx\temp\onword
+    \expandafter\let\csname SETtxicodequoteundirected\endcsname
+      = t%
+  \else\ifx\temp\offword
+    \expandafter\let\csname SETtxicodequoteundirected\endcsname
+      = \relax
+  \else
+    \errhelp = \EMsimple
+    \errmessage{Unknown @codequoteundirected value `\temp', must be on|off}%
+  \fi\fi
+}
+%
+\parseargdef\codequotebacktick{%
+  \def\temp{#1}%
+  \ifx\temp\onword
+    \expandafter\let\csname SETtxicodequotebacktick\endcsname
+      = t%
+  \else\ifx\temp\offword
+    \expandafter\let\csname SETtxicodequotebacktick\endcsname
+      = \relax
+  \else
+    \errhelp = \EMsimple
+    \errmessage{Unknown @codequotebacktick value `\temp', must be on|off}%
+  \fi\fi
+}
+
 % [Knuth] pp. 380,381,391, disable Spanish ligatures ?` and !` of \tt font.
 \def\noligaturesquoteleft{\relax\lq}
 
@@ -7436,7 +7465,7 @@
       = \relax
   \else
     \errhelp = \EMsimple
-    \errmessage{Unknown @xrefautomaticsectiontitle option `\temp',
+    \errmessage{Unknown @xrefautomaticsectiontitle value `\temp',
                 must be on|off}%
   \fi\fi
 }

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.372
retrieving revision 1.373
diff -u -b -r1.372 -r1.373
--- doc/texinfo.txi     23 Feb 2011 21:24:43 -0000      1.372
+++ doc/texinfo.txi     24 Feb 2011 17:20:38 -0000      1.373
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.372 2011/02/23 21:24:43 karl Exp $
address@hidden $Id: texinfo.txi,v 1.373 2011/02/24 17:20:38 karl Exp $
 @c Ordinarily, Texinfo files have the extension .texi.  But texinfo.texi
 @c clashes with texinfo.tex on 8.3 filesystems, so we use texinfo.txi.
 
@@ -10469,33 +10469,37 @@
 characters.  (The free PDF reader @command{xpdf} works fine, but other
 PDF readers, both free and nonfree, have problems.)
 
-If this is a concern for your document, Texinfo provides two special
-settings via @code{@@set}:
+If this is a concern for you, Texinfo provides these two commands:
 
address@hidden @code
address@hidden @@set txicodequoteundirected
-causes the output for the @code{'} character to be the undirected
-single quote, like this:
address@hidden txicodequoteundirected
address@hidden @code
address@hidden @@codequoteundirected @var{on-off}
address@hidden undirected single quote
+causes the output for the @code{'} character in code environments to
+be the undirected single quote, like this:
address@hidden on
 @code{'}.
address@hidden txicodequoteundirected
address@hidden off
 
address@hidden @@set txicodequotebacktick
-causes the output for the @code{`} character to be the standalone grave
-accent, like this:
address@hidden txicodequotebacktick
address@hidden @@codequotebacktick @var{on-off}
address@hidden backtick
address@hidden grave accent, standalone
+causes the output for the @code{`} character in code environments to
+be the backtick character (standalone grave accent), like this:
address@hidden on
 @code{`}.
address@hidden txicodequotebacktick
-
address@hidden off
 @end table
 
 If you want these settings for only part of the document,
address@hidden@@clear} will restore the normal behavior, as in
address@hidden@@address@hidden
address@hidden@@codequote... off} will restore the normal behavior, as in
address@hidden@@codequoteundirected off}.
 
 These settings affect @code{@@code}, @code{@@example}, @code{@@samp},
 @code{verb}, and @code{@@verbatim}; they do not affect @code{@@kbd}.
-(@xref{Useful Highlighting}.)
address@hidden Highlighting}.
+
+This feature used to be controlled by @code{@@set} variable names;
+they are still supported, but the command interface is preferred.
 
 
 @node Inserting Space
@@ -21466,6 +21470,11 @@
 or a program name.  Unquoted in Info output.  @xref{code, ,
 @code{@@code}}.
 
address@hidden @@codequotebacktick @var{on-off}
address@hidden @@codequoteundirected @var{on-off}
+Control output of @code{`} and @code{'} in code examples.
address@hidden Quote Characters}.
+
 @item @@address@hidden@}
 Insert a comma `,' character; only needed when a literal comma would
 be taken as an argument separator.  @xref{Inserting a Comma}.
@@ -23135,7 +23144,7 @@
 (@url{http://www.gnu.org/software/rcs}) version control systems, which
 expand it into a string such as:
 @example
-$Id: texinfo.txi,v 1.372 2011/02/23 21:24:43 karl Exp $
+$Id: texinfo.txi,v 1.373 2011/02/24 17:20:38 karl Exp $
 @end example
 (This is useful in all sources that use version control, not just manuals.)
 You may wish to include the @samp{$Id:} comment in the @code{@@copying}
@@ -23214,7 +23223,7 @@
 
 @verbatim
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.372 2011/02/23 21:24:43 karl Exp $
address@hidden $Id: texinfo.txi,v 1.373 2011/02/24 17:20:38 karl Exp $
 @comment %**start of header
 @setfilename sample.info
 @include version.texi

Index: doc/refcard/txirefcard.tex
===================================================================
RCS file: /sources/texinfo/texinfo/doc/refcard/txirefcard.tex,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -b -r1.16 -r1.17
--- doc/refcard/txirefcard.tex  23 Feb 2011 21:24:43 -0000      1.16
+++ doc/refcard/txirefcard.tex  24 Feb 2011 17:20:38 -0000      1.17
@@ -1,5 +1,5 @@
 % Texinfo reference card.
-% $Id: txirefcard.tex,v 1.16 2011/02/23 21:24:43 karl Exp $
+% $Id: txirefcard.tex,v 1.17 2011/02/24 17:20:38 karl Exp $
 %
 %**start of header
 % This file can be printed with 1, 2, or 3 columns per page (see below).
@@ -884,17 +884,20 @@
 \section{Document preferences}
 
 It is usually best to omit any of these settings from the Texinfo
-document, thus allowing users to override the defaults when processing
-the document according to their needs.
+document, thus allowing users to easily override the defaults when
+processing the document according to their desires.
 
address@hidden|off|odd}}{Specify whether chapters start on new pages, and if 
so, whether on odd-numbered (right-hand) new pages; also set the page headings 
accordingly.}
address@hidden|off|single|double}}{Turn page headings on or off, specify 
single-sided or double-sided page headings for printing.}
address@hidden|off}{Use undirected single quote for @code{'}; default off.}
address@hidden|off}{Use backtick (standalone grave accent) for @code{`}; 
default off.}
 address@hidden example-like environments by \var{indent} number of spaces 
(perhaps 0).}
 address@hidden|none}}{Indent first paragraphs after section headings, or not.}
address@hidden paragraphs by \var{indent} number of spaces (perhaps 0); 
preserve source file indentation if \var{indent} is the string \code{asis}.}
address@hidden|off|single|double}}{Turn page headings on or off, specify 
single-sided or double-sided page headings for printing.}
 address@hidden|distinct|example}}{Specify font for address@hidden: normal 
address@hidden font, a distinct (slanted) typewriter font, or a distinct font 
only within address@hidden and similar.}
address@hidden paragraphs by \var{indent} number of spaces (perhaps 0); 
preserve source file indentation if \var{indent} is the string \code{asis}.}
address@hidden|off|odd}}{Specify whether chapters start on new pages, and if 
so, whether on odd-numbered (right-hand) new pages; also set the page headings 
accordingly.}
 address@hidden|before|none}}{Specify how address@hidden should break at 
special characters; default \code{after}.}
 
+
 \section{Ending a Texinfo document}
 
 address@hidden reading the Texinfo source.  Any following text in the file is 
ignored.}