texinfo update (Wed Jan 16 13:23:01 EST 2008)

[Karl Berry]

Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.798
retrieving revision 1.799
diff -u -r1.798 -r1.799
--- ChangeLog   13 Jan 2008 18:50:21 -0000      1.798
+++ ChangeLog   16 Jan 2008 18:19:33 -0000      1.799
@@ -1,3 +1,12 @@
+2008-01-16  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (Makeinfo Pointer Creation): mention the 
+       need for @detailmenu here, too.
+
+2008-01-14  Karl Berry  <address@hidden>
+
+       * NEWS: install-info NEWS details.
+
 2008-01-13  Bruno Haible  <address@hidden>
 
        * util/gendocs.sh (curdate): Execute 'date' command in the locale
Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.212
retrieving revision 1.213
diff -u -r1.212 -r1.213
--- doc/texinfo.txi     12 Jan 2008 17:04:28 -0000      1.212
+++ doc/texinfo.txi     16 Jan 2008 18:19:33 -0000      1.213
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.212 2008/01/12 17:04:28 karl Exp $
address@hidden $Id: texinfo.txi,v 1.213 2008/01/16 18:19:33 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.
 
@@ -3702,6 +3702,8 @@
 The second part contains nodes for the indices.
 
 @item
address@hidden detailmenu
address@hidden Detailed menu
 The third and subsequent parts contain a listing of the other, lower
 level nodes, often ordered by chapter.  This way, rather than go
 through an intermediary menu, an inquirer can go directly to a
@@ -4862,11 +4864,20 @@
 your Texinfo document is hierarchically organized (@pxref{makeinfo
 Pointer Creation}).
 
-You may insert spaces before each name if you wish; the spaces are
-ignored.  You must write the name of the node and (if present) the names
-of the `Next', `Previous', and `Up' pointers all on the same line.
-Otherwise, the formatters fail.  (@inforef{Top, info, info}, for more
-information about nodes in Info.)
address@hidden address@hidden, in HTML output}
+Whether the node pointers are specified implicitly or explicitly, the
+HTML output from @command{makeinfo} for each node includes links to
+the `Next', `Previous', and `Up' nodes.  The HTML also uses the
address@hidden attribute with the values @samp{n}, @samp{p}, and
address@hidden respectively.  This allows people using web browsers to
+follow the nagivation using (typically) @address@hidden, e.g.,
address@hidden for the `Next' node, from anywhere within the node.
+
+You may insert spaces before each name on the @code{@@node} line if
+you wish; the spaces are ignored.  You must write the name of the node
+and (if present) the names of the `Next', `Previous', and `Up'
+pointers all on the same line.  Otherwise, the formatters fail.
+(@inforef{Top, info, info}, for more information about nodes in Info.)
 
 Usually, you write one of the chapter-structuring command lines
 immediately after an @code{@@node} line---for example, an
@@ -5174,8 +5185,9 @@
 @cindex Pointer creation with @code{makeinfo}
 @cindex Automatic pointer creation with @code{makeinfo}
 
-The @code{makeinfo} program has a feature for automatically determining
-node pointers for a hierarchically organized document.
+The @code{makeinfo} program has a feature for automatically
+determining node pointers for a hierarchically organized document.  We
+highly recommend using it.
 
 When you take advantage of this feature, you do not need to write the
 `Next', `Previous', and `Up' pointers after the name of a node.
@@ -5191,7 +5203,14 @@
 node) in a menu that is one or more hierarchical levels above the
 node's hierarchical level.
 
-This implicit node pointer insertion feature in @code{makeinfo}
address@hidden Detail menu
address@hidden detailmenu
+If you use a detailed menu in your master menu (@pxref{Master Menu
+Parts}), mark it with the @code{@@detailmenu @@address@hidden@} @@end
+detailmenu} environment, or @command{makeinfo} will get confused,
+typically about the last and/or first node in the document.
+
+This implicit node pointer creation feature in @code{makeinfo}
 relieves you from the need to update menus and pointers manually or
 with Texinfo mode commands.  (@xref{Updating Nodes and Menus}.)
 
@@ -5202,17 +5221,7 @@
 document to be printed).  The special procedure for handling the short
 text before a menu (@pxref{Menus}) also disables this
 feature, for that group of nodes.  In those cases, you will need to
-explicitly specify the pointers.
-
address@hidden address@hidden, in HTML output}
-Whether the nodes are specified implicitly or explicitly, the HTML
-output from @command{makeinfo} includes links to the `Next',
-`Previous', and `Up' nodes.  The HTML also uses the @code{accesskey}
-attribute with the values @samp{n}, @samp{p}, and @samp{u}
-respectively.  This allows people using web browsers to follow
-the nagivation using (typically) @address@hidden, e.g.,
address@hidden for the `Next' node, from anywhere within the node.
-
+explicitly specify all pointers.
 
 @node anchor
 @section @code{@@anchor}: Defining Arbitrary Cross-reference Targets
@@ -18990,7 +18999,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.212 2008/01/12 17:04:28 karl Exp $
+$Id: texinfo.txi,v 1.213 2008/01/16 18:19:33 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}
@@ -19064,7 +19073,7 @@
 
 @verbatim
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.212 2008/01/12 17:04:28 karl Exp $
address@hidden $Id: texinfo.txi,v 1.213 2008/01/16 18:19:33 karl Exp $
 @comment %**start of header
 @setfilename sample.info
 @include version.texi
P ChangeLog
P doc/texinfo.txi