texinfo ChangeLog doc/texinfo.txi

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       12/04/14 00:21:06

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 

Log message:
        top node naming tweaks

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1347&r2=1.1348
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.432&r2=1.433

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1347
retrieving revision 1.1348
diff -u -b -r1.1347 -r1.1348
--- ChangeLog   13 Apr 2012 22:51:17 -0000      1.1347
+++ ChangeLog   14 Apr 2012 00:21:06 -0000      1.1348
@@ -1,6 +1,8 @@
 2012-04-13  Karl Berry  <address@hidden>
 
        * doc/texinfo.txi (Command Contexts): clarify @shortcaption, etc.
+       (Top Node Naming): revisit whole-manual xref text.
+       (Other Configuration Variables) [KEEP_TOP_EXTERNAL_REF]: Englishing.
 
        * tp/texi2any.pl (configured_version): add +dev to distinguish
        from installed.

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.432
retrieving revision 1.433
diff -u -b -r1.432 -r1.433
--- doc/texinfo.txi     13 Apr 2012 22:51:17 -0000      1.432
+++ doc/texinfo.txi     14 Apr 2012 00:21:06 -0000      1.433
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.432 2012/04/13 22:51:17 karl Exp $
address@hidden $Id: texinfo.txi,v 1.433 2012/04/14 00:21:06 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.
 
@@ -6456,14 +6456,15 @@
 @cindex Manual, referring to as a whole
 @cindex Referring to an entire manual
 
-Ordinarily, you must always name a node in a cross reference.  It's
-not unusual to want to refer to another manual as a whole, rather than
-a particular section within it.  In this case, giving any section name
-would just be a distraction.
-
-So, if the first argument is either @samp{Top} (capitalized just that
-way) or omitted entirely, and the third argument is omitted, the
-printed output includes no node or section name.  (The Info output
+Ordinarily, you must always name a node in a cross reference.
+However, it's not unusual to want to refer to another manual as a
+whole, rather than a particular section within it.  In this case,
+giving any section name is just a distraction.
+
+So, with cross references to other manuals (@pxref{Four and Five
+Arguments}), if the first argument is either @samp{Top} (capitalized
+just that way) or omitted entirely, and the third argument is omitted,
+the printed output includes no node or section name.  (The Info output
 includes @samp{Top} if it was given.)  For example,
 
 @example
@@ -17484,8 +17485,8 @@
 @code{@@insertcopying} were a user-defined macro.
 
 @item KEEP_TOP_EXTERNAL_REF
-For address@hidden  If set, do not ignore @samp{Top} node as first 
-argument for an external ref to a manual, (the default case).
+For address@hidden  If set, do not ignore @samp{Top} as the first 
+argument for an external ref to a manual, as is done by default.
 @xref{Top Node Naming}.
 
 @item L2H
@@ -21891,7 +21892,7 @@
 Revision Control System}) or other version control systems, which
 expand it into a string such as:
 @example
-$Id: texinfo.txi,v 1.432 2012/04/13 22:51:17 karl Exp $
+$Id: texinfo.txi,v 1.433 2012/04/14 00:21:06 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}