texinfo ChangeLog doc/texinfo.txi

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       11/10/13 23:27:05

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 

Log message:
        (Three Arguments): same requirements as node names

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1261&r2=1.1262
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.387&r2=1.388

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1261
retrieving revision 1.1262
diff -u -b -r1.1261 -r1.1262
--- ChangeLog   13 Oct 2011 00:06:51 -0000      1.1261
+++ ChangeLog   13 Oct 2011 23:27:04 -0000      1.1262
@@ -1,3 +1,7 @@
+2011-10-13  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (Three Arguments): same requirements as node names.
+
 2011-10-13  Patrice Dumas  <address@hidden>
 
        * info-stnd.texi: change @itemx to a missing @item.

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.387
retrieving revision 1.388
diff -u -b -r1.387 -r1.388
--- doc/texinfo.txi     1 Oct 2011 20:39:06 -0000       1.387
+++ doc/texinfo.txi     13 Oct 2011 23:27:04 -0000      1.388
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.387 2011/10/01 20:39:06 pertusus Exp $
address@hidden $Id: texinfo.txi,v 1.388 2011/10/13 23:27:04 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.
 
@@ -6192,12 +6192,10 @@
 reference is printed.  Use a third argument when the node name is
 unsuitable because of syntax or meaning.
 
-Remember to avoid placing a comma within the title or topic section of
-a cross reference, or within any other section.  The formatters divide
-cross references into arguments according to the commas; a comma
-within a title or other section will divide it into two arguments.  In
-a reference, you need to write a title such as ``Clouds, Mist, and
-Fog'' without the commas.
+The third argument to the xref commands must observe the same
+restrictions as node names described in @ref{Node Line Requirements}.
+The issue you're most likely to run into is that commas, periods, and
+colons cannot be used.
 
 Also, remember to write a comma or period after the closing brace of an
 @code{@@xref} to terminate the cross reference.  In the following
@@ -6239,8 +6237,8 @@
 @end quotation
 
 If a third argument is given and the second one is empty, then the
-third argument serves both.  (Note how two commas, side by side, mark
-the empty second argument.)@refill
+third argument serves for both.  (Note how two commas, side by side, mark
+the empty second argument.)
 
 @example
 @group
@@ -21092,7 +21090,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.387 2011/10/01 20:39:06 pertusus Exp $
+$Id: texinfo.txi,v 1.388 2011/10/13 23:27:04 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}
@@ -21163,7 +21161,7 @@
 
 @verbatim
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.387 2011/10/01 20:39:06 pertusus Exp $
address@hidden $Id: texinfo.txi,v 1.388 2011/10/13 23:27:04 karl Exp $
 @comment %**start of header
 @setfilename sample.info
 @include version.texi