[6986] move example from NEWS to manual

[Gavin D. Smith]

Revision: 6986
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=6986
Author:   gavin
Date:     2016-02-06 08:36:20 +0000 (Sat, 06 Feb 2016)
Log Message:
-----------
move example from NEWS to manual

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

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2016-02-06 07:55:15 UTC (rev 6985)
+++ trunk/ChangeLog     2016-02-06 08:36:20 UTC (rev 6986)
@@ -7,6 +7,9 @@
        an unwanted comma after the cross-reference when processing with 
        TeX.
 
+       * NEWS, doc/texinfo.texi (Cross Reference Parts): Move example 
+       of comma insertion.  Suggestion from Karl Berry.
+
 2016-02-05  Gavin Smith  <address@hidden>
 
        * doc/texinfo.tex (\xrefX): Check for some commands following 

Modified: trunk/NEWS
===================================================================
--- trunk/NEWS  2016-02-06 07:55:15 UTC (rev 6985)
+++ trunk/NEWS  2016-02-06 08:36:20 UTC (rev 6986)
@@ -22,12 +22,8 @@
   . For processing with TeX, a comma is automatically provided following
     a cross-reference command (such as @xref) when needed to separate
     the page number from following text, so you don't need to add one
-    yourself.  This gives you the choice of whether to have a comma
-    there in Info or HTML output.  For example,
-    "@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.  Behavior when followed by punctuation, as always
+    yourself.  See the `Parts of a Cross Reference' node in the manual
+    for details.  Behavior when followed by punctuation, as always
     recommended previously, is unchanged.
 
 * texi2any:

Modified: trunk/doc/texinfo.texi
===================================================================
--- trunk/doc/texinfo.texi      2016-02-06 07:55:15 UTC (rev 6985)
+++ trunk/doc/texinfo.texi      2016-02-06 08:36:20 UTC (rev 6986)
@@ -4835,11 +4835,24 @@
 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
address@hidden 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
+comma or period).  This gives you the choice of whether to have a comma
+there in Info or HTML output.  For example,
+
address@hidden
+@@address@hidden address@hidden for more information
address@hidden example
+
address@hidden produces
address@hidden Another Section, page @var{ppp}, for more information'} in the 
+printed output, and
address@hidden@samp{*Note Another Section:: for more information}} in the Info 
+output.
+
+If an unwanted comma is added, follow the argument
 with a command such as @samp{@@:}.  For example,
 @address@hidden@@address@hidden@}@@: --- for the details}} produces