[6996] texinfo.tex comment changes

[Gavin D. Smith]

Revision: 6996
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=6996
Author:   gavin
Date:     2016-02-07 10:54:06 +0000 (Sun, 07 Feb 2016)
Log Message:
-----------
texinfo.tex comment changes

Modified Paths:
--------------
    trunk/ChangeLog
    trunk/doc/texinfo.tex

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2016-02-07 10:23:34 UTC (rev 6995)
+++ trunk/ChangeLog     2016-02-07 10:54:06 UTC (rev 6996)
@@ -1,3 +1,17 @@
+2016-02-07  Gavin Smith  <address@hidden>
+
+       * doc/texinfo.tex (\throughcharactersdefs): Rename to 
+       \passthroughcharacters, and change comment.
+       (\nonasciistringdefs): Change comment.
+       (\documentencoding) <UTF-8>: Change comment.
+       (\DeclareUnicodeCharacterUTFviii): Change comment.
+       (\nativeunicodechardefsthru, \DeclareUnicodeCharacterNativeThru):
+       Change comment, and move definition.
+       (\DeclareUnicodeCharacterNativeAtU): Change comment, and move 
+       definition.
+       (\setcharscatcodeothernonglobal): Comment changed.
+       (\DeclareUnicodeCharacterNative): Move definition.
+
 2016-02-07  Masamichi Hosoda  <address@hidden>
 
         * doc/texinfo.tex:

Modified: trunk/doc/texinfo.tex
===================================================================
--- trunk/doc/texinfo.tex       2016-02-07 10:23:34 UTC (rev 6995)
+++ trunk/doc/texinfo.tex       2016-02-07 10:54:06 UTC (rev 6996)
@@ -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{2016-02-07.10}
+\def\texinfoversion{2016-02-07.11}
 %
 % Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995,
 % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
@@ -9630,7 +9630,7 @@
        % For native Unicode (XeTeX and LuaTeX)
        \nativeunicodechardefs
      \else
-       % For UTF-8 byte sequence (pdfTeX)
+       % For UTF-8 byte sequence (TeX, eTeX and pdfTeX)
        \setnonasciicharscatcode\active
        % since we already invoked \utfeightchardefs at the top level
        % (below), do not re-invoke it, then our check for duplicated
@@ -9966,7 +9966,7 @@
   \fi
 }
 
-% For UTF-8 byte sequence (pdfTeX)
+% For UTF-8 byte sequence (TeX, e-TeX and pdfTeX)
 % Definition macro to replace the Unicode character
 % Definition macro that is used by @U command
 %
@@ -10037,37 +10037,6 @@
 \endgroup
 
 % For native Unicode (XeTeX and LuaTeX)
-% Definition macro to replace the Unicode character
-%
-\def\DeclareUnicodeCharacterNative#1#2{%
-  \catcode"#1=\active
-  \begingroup
-    \uccode`\~="#1\relax
-    \uppercase{\gdef~}{#2}%
-  \endgroup}
-
-% For native Unicode (XeTeX and LuaTeX)
-% Definition macro not to replace (through) the Unicode character
-%
-\def\DeclareUnicodeCharacterNativeThru#1#2{%
-  \catcode"#1=\active
-  \begingroup
-    \uccode`\.="#1\relax
-    \uppercase{\endgroup \def\UTFNativeTmp{.}}%
-  \begingroup
-    \uccode`\~="#1\relax
-    \uppercase{\endgroup \edef~}{\UTFNativeTmp}%
-}
-
-% For native Unicode (XeTeX and LuaTeX)
-% Definition macro that is used by @U command
-%
-\def\DeclareUnicodeCharacterNativeAtU#1#2{%
-  \def\UTFAtUTmp{#2}
-  \expandafter\globallet\csname uni:#1\endcsname \UTFAtUTmp
-}
-
-% For native Unicode (XeTeX and LuaTeX)
 % Definition macro that is set catcode other non global
 %
 \def\DeclareUnicodeCharacterNativeOther#1#2{%
@@ -10767,6 +10736,16 @@
   \unicodechardefs
 }
 
+% For native Unicode (XeTeX and LuaTeX)
+% Definition macro to replace the Unicode character
+%
+\def\DeclareUnicodeCharacterNative#1#2{%
+  \catcode"#1=\active
+  \begingroup
+    \uccode`\~="#1\relax
+    \uppercase{\gdef~}{#2}%
+  \endgroup}
+
 % Native Unicode (XeTeX and LuaTeX) character replacing definitions
 % It makes the setting that replace the Unicode characters.
 \def\nativeunicodechardefs{%
@@ -10774,13 +10753,34 @@
   \unicodechardefs
 }
 
-% Native Unicode (XeTeX and LuaTeX) character ``through'' definitions
+% For native Unicode (XeTeX and LuaTeX)
+% Definition macro not to make the Unicode character expand to a non-active 
+% token with the same character code.  Used when writing to auxiliary files.
+%
+\def\DeclareUnicodeCharacterNativeThru#1#2{%
+  \catcode"#1=\active
+  \begingroup
+    \uccode`\.="#1\relax
+    \uppercase{\endgroup \def\UTFNativeTmp{.}}%
+  \begingroup
+    \uccode`\~="#1\relax
+    \uppercase{\endgroup \edef~}{\UTFNativeTmp}%
+}
+
+% Native Unicode (XeTeX and LuaTeX) character ``through'' definitions.
 % It makes the setting that does not replace the Unicode characters.
 \def\nativeunicodechardefsthru{%
   \let\DeclareUnicodeCharacter\DeclareUnicodeCharacterNativeThru
   \unicodechardefs
 }
 
+% For native Unicode (XeTeX and LuaTeX).  Make the character token expand
+% to the sequences given in \unicodechardefs for printing.
+\def\DeclareUnicodeCharacterNativeAtU#1#2{%
+  \def\UTFAtUTmp{#2}
+  \expandafter\globallet\csname uni:#1\endcsname \UTFAtUTmp
+}
+
 % Native Unicode (XeTeX and LuaTeX) @U command definitions
 \def\nativeunicodechardefsatu{%
   \let\DeclareUnicodeCharacter\DeclareUnicodeCharacterNativeAtU
@@ -10793,7 +10793,8 @@
   \unicodechardefs
 }
 
-% Catcode (non-ascii or native Unicode) are set to other non global.
+% Catcode (non-ASCII or native Unicode) are set to \other (non-global
+% assignments).
 \def\setcharscatcodeothernonglobal{%
   \iftxiusebytewiseio
     \setnonasciicharscatcodenonglobal\other
@@ -10807,8 +10808,8 @@
    \relax
 }
 
-% Non-ASCII bytes ``through'' definitions.
-% It makes the setting that does not replace the non-ASCII byte.
+% Redefine the active definitions of non-ASCII characters to expand to
+% non-active tokens with the same character code.
 \def\nonasciistringdefs{%
   \setnonasciicharscatcode\active
   \def\defstringchar##1{\def##1{\string##1}}%
@@ -10854,9 +10855,9 @@
   \defstringchar^^fc\defstringchar^^fd\defstringchar^^fe\defstringchar^^ff%
 }
 
-% Character ``through'' definitions.
-% It makes the setting that does not replace the characters.
-\def\throughcharactersdefs{%
+% Write characters literally, instead of using active definitions for
+% printing the correct glyphs.
+\def\passthroughcharacters{%
   \iftxiusebytewiseio
     \nonasciistringdefs
   \else
@@ -11219,7 +11220,7 @@
 %
 address@hidden = @active
  @address@hidden
-   @throughcharactersdefs
+   @passthroughcharacters
    @address@hidden
    @let"address@hidden
    @address@hidden %$ font-lock fix