[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
texinfo ChangeLog doc/texinfo.txi
From: |
Karl Berry |
Subject: |
texinfo ChangeLog doc/texinfo.txi |
Date: |
Sun, 18 Sep 2011 23:24:26 +0000 |
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