texinfo ChangeLog doc/texinfo.txi

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       11/09/18 23:24:25

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 

Log message:
        parens only disallowed when looks like an external manual ref

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1250&r2=1.1251
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.382&r2=1.383

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1250
retrieving revision 1.1251
diff -u -b -r1.1250 -r1.1251
--- ChangeLog   18 Sep 2011 18:50:24 -0000      1.1250
+++ ChangeLog   18 Sep 2011 23:24:25 -0000      1.1251
@@ -1,5 +1,10 @@
 2011-09-18  Karl Berry  <address@hidden>
 
+       * doc/texinfo.txi (Node Line Requirements): parens are 
+       disallowed specifically when confused with external manuals,
+       not always.  Discussion in thread of 18 Sep 2011 09:16:27,
+       and bug http://savannah.gnu.org/bugs/?33373.
+
        * doc/texinfo.txi (HTML Xref Command Expansion): be more
        specific about quotation cmds being replaced, not quote chars.
 

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.382
retrieving revision 1.383
diff -u -b -r1.382 -r1.383
--- doc/texinfo.txi     18 Sep 2011 18:50:24 -0000      1.382
+++ doc/texinfo.txi     18 Sep 2011 23:24:25 -0000      1.383
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.382 2011/09/18 18:50:24 karl Exp $
address@hidden $Id: texinfo.txi,v 1.383 2011/09/18 23:24:25 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.
 
@@ -5228,9 +5228,11 @@
 @cindex Characters, invalid in node name
 @cindex Invalid characters in node names
 @cindex Node names, invalid characters in
-Unfortunately, you cannot use periods, commas, colons or parentheses
-within a node name; these confuse the Texinfo processors.  Perhaps
-this limitation will be removed some day, too.
+Unfortunately, you cannot use periods, commas, or colons within a node
+name; these confuse the Texinfo processors.  Also, a node name may not
+start with a left parenthesis and contain a right parenthesis, as in
address@hidden(not)allowed}; this specifies an external manual in Info.
+Perhaps these limitations will be removed some day, too.
 
 @need 700
 For example, the following is a section title in this manual:
@@ -23211,7 +23213,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.382 2011/09/18 18:50:24 karl Exp $
+$Id: texinfo.txi,v 1.383 2011/09/18 23:24:25 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}
@@ -23290,7 +23292,7 @@
 
 @verbatim
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.382 2011/09/18 18:50:24 karl Exp $
address@hidden $Id: texinfo.txi,v 1.383 2011/09/18 23:24:25 karl Exp $
 @comment %**start of header
 @setfilename sample.info
 @include version.texi