[6985] explain how to get rid of unwanted comma after an xref

[Gavin D. Smith]

Revision: 6985
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=6985
Author:   gavin
Date:     2016-02-06 07:55:15 +0000 (Sat, 06 Feb 2016)
Log Message:
-----------
explain how to get rid of unwanted comma after an xref

Modified Paths:
--------------
    trunk/ChangeLog
    trunk/NEWS
    trunk/doc/texinfo.texi

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2016-02-05 08:05:22 UTC (rev 6984)
+++ trunk/ChangeLog     2016-02-06 07:55:15 UTC (rev 6985)
@@ -1,3 +1,12 @@
+2016-02-06  Gavin Smith  <address@hidden>
+
+       * NEWS: Mention that behaviour is unchanged for comma or full 
+       stop following closing brace of @xref command.  Text from Karl Berry.
+       * NEWS: Change word 'makeinfo' to 'texi2any'.
+       * doc/texinfo.texi (Cross Reference Parts): Mention how to avoid 
+       an unwanted comma after the cross-reference when processing with 
+       TeX.
+
 2016-02-05  Gavin Smith  <address@hidden>
 
        * doc/texinfo.tex (\xrefX): Check for some commands following 

Modified: trunk/NEWS
===================================================================
--- trunk/NEWS  2016-02-05 08:05:22 UTC (rev 6984)
+++ trunk/NEWS  2016-02-06 07:55:15 UTC (rev 6985)
@@ -27,7 +27,8 @@
     "@xref{Another Section} for more information" produces
     "See Another Section, page NN, for more information" in the printed
     output, and "*Note Another Section:: for more information" in the
-    Info output.
+    Info output.  Behavior when followed by punctuation, as always
+    recommended previously, is unchanged.
 
 * texi2any:
   . Some Perl modules have been rewritten in C to increase speed.
@@ -35,7 +36,7 @@
     otherwise the pure Perl implementations are still used.
     Disable at build time with "configure --disable-perl-xs".  The 
     environment variable TEXINFO_XS controls how they are used by 
-    makeinfo.
+    texi2any.
   . Quotation marks are left out for node names and index entries in
     Info output where they would have been produced by commands such
     as @file or @option.

Modified: trunk/doc/texinfo.texi
===================================================================
--- trunk/doc/texinfo.texi      2016-02-05 08:05:22 UTC (rev 6984)
+++ trunk/doc/texinfo.texi      2016-02-06 07:55:15 UTC (rev 6985)
@@ -4827,7 +4827,7 @@
 @example
 @group
 @@address@hidden@var{node-name}, @var{online-label}, @var{printed-label},
address@hidden, @address@hidden
address@hidden, @address@hidden
 @end group
 @end example
 
@@ -4835,6 +4835,21 @@
 ignored.  To include a comma in one of the arguments, use
 @code{@@address@hidden@}} (@pxref{Inserting a Comma}).
 
address@hidden Unwanted comma after cross-reference
+When processing with TeX, a comma is automatically inserted after the
+page number for cross-references to within the same manual, unless the
+closing brace of the argument is followed by non-whitespace (such as a
+comma or period).  If an unwanted comma is added, follow the argument
+with a command such as @samp{@@:}.  For example,
address@hidden@samp{@@address@hidden@}@@: --- for the details}} produces
+
address@hidden
+See Hurricanes, page @var{ppp} --- for the details
address@hidden quotation
+
address@hidden instead of
address@hidden Hurricanes, page @var{ppp}, --- for the details'}.
+
 Cross references with one, two, three, four, and five arguments are
 described separately following the description of @code{@@xref}.