texinfo ChangeLog doc/texinfo.txi util/htmlxref...

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       10/09/07 18:51:18

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 
        util           : htmlxref.cnf 

Log message:
        (Output Element Labels): rename + edit

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1125&r2=1.1126
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.301&r2=1.302
http://cvs.savannah.gnu.org/viewcvs/texinfo/util/htmlxref.cnf?cvsroot=texinfo&r1=1.10&r2=1.11

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1125
retrieving revision 1.1126
diff -u -b -r1.1125 -r1.1126
--- ChangeLog   7 Sep 2010 00:11:14 -0000       1.1125
+++ ChangeLog   7 Sep 2010 18:51:17 -0000       1.1126
@@ -1,3 +1,7 @@
+2010-09-07  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (Output Element Labels): rename + edit.
+
 2010-09-06  Karl Berry  <address@hidden>
 
        * doc/texinfo.tex (\dosmartslant): localize font switch to \ttsl.

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.301
retrieving revision 1.302
diff -u -b -r1.301 -r1.302
--- doc/texinfo.txi     6 Sep 2010 23:44:26 -0000       1.301
+++ doc/texinfo.txi     7 Sep 2010 18:51:17 -0000       1.302
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.301 2010/09/06 23:44:26 karl Exp $
address@hidden $Id: texinfo.txi,v 1.302 2010/09/07 18:51:17 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.
 
@@ -19556,16 +19556,15 @@
 @cindex Output elements
 @cindex Elements, main unit of output documents
 
-We will call the main unit of output documents an @dfn{element}
-(nodes, to a first approximation).  An element's association with
-output files is determined by the split options (@pxref{Splitting
-Output}).  This section describes precisely how elements work, with
-details for customization.
+We will call the main unit of output documents an @dfn{element}.  An
+element's association with output files is determined by the split
+options (@pxref{Splitting Output}).  This section describes precisely
+how these output elements work, with details for customization.
 
 @menu
-* Output Elements Defined::
-* Elements informations::
-* Elements lines::
+* Defined: Output Elements Defined.
+* Labels: Output Element Labels.
+* Lines: Elements lines.
 @end menu
 
 
@@ -19598,8 +19597,8 @@
 the document has a @code{@@top} section (@pxref{makeinfo top}), it is
 the element associated with that section; otherwise, it is the element
 associated with the document's @code{@@node Top} (@pxref{The Top
-Node}).  If by chance there is no @code{@@node Top}, the first element
-in the document is the top element.
+Node}).  If there is no @code{@@node Top}, the first element in the
+document is the top element.
 
 The top element may end up formatted differently from normal elements
 if there is a @code{@@top} section or the @code{@@node Top} is not
@@ -19652,8 +19651,8 @@
 @end table
 
 It is common not to have anything but normal elements, especially in
-case of monolithic output.  In the case of HTML output, special
-elements may be present.
+case of monolithic output.  It is usually with HTML output that
+special elements may be present.
 
 The main component of elements is sections if @code{USE_SECTIONS} is
 set or @code{USE_NODES} is set to 0; conversely, the main component is
@@ -19671,75 +19670,98 @@
 elements.
 
 
address@hidden Elements informations
address@hidden Elements informations
address@hidden Output Element Labels
address@hidden Output Element Labels
 
address@hidden Output element labels
address@hidden Element labels
 
-The following items are associated with elements.  Each of these
-is associated with a name and a reference to the 
-element they represent, when such an element exists. 
-The element is either a global element (for example the first element)
-or an element relative to the current
-element (for example the next element).  The relative elements are 
-found with respect with the document
-structure defined by the section structuring commands (@code{@@chapter}, 
address@hidden@@address@hidden) or by the nodes (in that case the node 
-directions are specified on node line or in menu organization), as explained
-above (@pxref{Two Paths}).
-These items are called @dfn{element labels}.  They may be associated with 
-a button (@pxref{Button specifications}), and used in the formatting functions 
-(@pxref{Elements informations}).
+A variety of data items, called @dfn{element labels}, are associated
+with elements.  They may be used in the formatting functions, and/or
+associated with a button (@pxref{Button specifications}).
+
+Each element label has a name and a reference to the element they
+represent, when such an element exists.  The element is either a
+global element (for example, the first element) or relative to the
+current element (for example, the next element).  Such relative
+elements are determined with respect to the document structure defined
+by the section structuring commands (@code{@@chapter},
address@hidden@@address@hidden) or by the nodes if the node pointers are
+specified on @code{@@node} lines or in menus, as explained above
+(@pxref{Two Paths}).
 
-Here is the list:
+Here is the list of element labels:
 
 @table @emph
 @item @samp{@ }
-An empty button
+An empty button.
+
 @item Top
-Top element. The associated name is @code{TOP_HEADING} if that variable is 
+Top element.  The associated name is @code{$TOP_HEADING} if that variable is 
 defined. This variable is not set by default.
address@hidden Contents
-Table of contents
+
 @item About
-About (help) page
+About (help) page.
+
address@hidden Contents
+Table of contents.
+
 @item Overview
-Overview, short table of contents
address@hidden First
-First element in reading order
address@hidden Last
-Last element in reading order
+Overview: short table of contents.
+
 @item Index
-The first chapter with @code{@@printindex}.  The associated name 
-is @code{$INDEX_CHAPTER}, if the variable is set.  This variable is not set
-by default.
+The first chapter with @code{@@printindex}.  The associated name is
address@hidden, if the variable is set.  This variable is not
+set by default.
+
 @item This
-The current element
address@hidden Back
-Preceding element in reading order
address@hidden FastBack
-Beginning of this chapter or previous chapter if the element is a chapter
address@hidden Prev
-Previous section on the same level 
address@hidden NodePrev
-Previous node
+The current element.
+
 @item Forward 
-Next element in reading order
+Next element in reading order.
+
address@hidden First
+First element in reading order.
+
address@hidden Last
+Last element in reading order.
+
address@hidden Back
+Previous element in reading order.
+
 @item FastForward
-Next chapter
+Next chapter.
+
address@hidden FastBack
+Beginning of this chapter, or previous chapter if the element is a chapter.
+
 @item Next
-Next section on the same level
+Next section at the same level.
+
address@hidden Prev
+Previous section at the same level.
+
address@hidden Up
+Up section.
+
 @item NodeNext
-Next node
+Next node.
+
 @item Following
-Next node in node reading order
address@hidden Up
-Up section
+Next node in node reading order.
+
address@hidden NodePrev
+Previous node.
+
 @item NodeUp
-Up node
address@hidden FileNext
-Forward element first in the next page (or file)
address@hidden FilePrev
-Backward element first in the previous page (or file)
+Up node.
+
address@hidden NextFile
+Forward element first in the next page (or file).
+
address@hidden PrevFile
+Backward element first in the previous page (or file).
+
 @end table
 
 
@@ -19845,8 +19867,9 @@
 The function is called with argument a boolean true if the navigation 
 panel should be vertical.  Should return the formatted button text.
 @item reference on a scalar
-The scalar value is printed. For some possibly
-usefull scalars, @ref{Elements informations}.
+The scalar value is printed. For some possibly useful scalars,
address@hidden Element Labels}.
+
 @item reference on an array
 In this case the first array element should be a reference on text and the 
 second element an element label.  In that case a link to the 
@@ -20296,17 +20319,17 @@
 used. The text is added before or after the main about text.
 @item %BUTTONS_GOTO
 
-The keys of this hash are element labels (@pxref{Elements informations}).  
-The value is the text associated with the element label in the about text.
-In the default case, the element of the hash are defined dynamically in 
-that the @code{init_out} function reference (@pxref{Output Initialization}).
+The keys of this hash are element labels (@pxref{Output Element
+Labels}).  The value is the text associated with the element label in
+the about text.  In the default case, the element of the hash are
+defined dynamically in that the @code{init_out} function reference
+(@pxref{Output Initialization}).
 
 
 @item %BUTTONS_EXAMPLE
-
-The keys of this hash are  element labels (@pxref{Elements informations}). 
-The value is the text associated with the element label in the about 
-example, typically a section number.
+The keys of this hash are element labels (@pxref{Output Element
+Labels}).  The value is the text associated with the element label in
+the about example, typically a section number.
 
 @end table
 
@@ -24449,7 +24472,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.301 2010/09/06 23:44:26 karl Exp $
+$Id: texinfo.txi,v 1.302 2010/09/07 18:51:17 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}
@@ -24528,7 +24551,7 @@
 
 @verbatim
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.301 2010/09/06 23:44:26 karl Exp $
address@hidden $Id: texinfo.txi,v 1.302 2010/09/07 18:51:17 karl Exp $
 @comment %**start of header
 @setfilename sample.info
 @include version.texi

Index: util/htmlxref.cnf
===================================================================
RCS file: /sources/texinfo/texinfo/util/htmlxref.cnf,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -b -r1.10 -r1.11
--- util/htmlxref.cnf   6 Sep 2010 23:44:27 -0000       1.10
+++ util/htmlxref.cnf   7 Sep 2010 18:51:18 -0000       1.11
@@ -1,6 +1,6 @@
 # htmlxref.cnf - reference file for Texinfo files on the web.
 
-htmlxrefversion=2010-09-06.16; # UTC
+htmlxrefversion=2010-09-07.17; # UTC
 
 # Copyright 2010 Free Software Foundation, Inc.
 # 
@@ -64,6 +64,9 @@
 gnat_ugn_unw   node    http://gcc.gnu.org/onlinedocs/gnat_ugn_unw/
 libgomp                node    http://gcc.gnu.org/onlinedocs/libgomp/
 
+gettext                mono    ${GS}/gettext/manual/gettext.html
+gettext                node    ${GS}/gettext/manual/html_node/
+
 gnubg          mono    ${GS}/gnubg/manual/gnubg.html
 gnubg          node    ${GS}/gnubg/manual/html_node/
 
@@ -104,6 +107,8 @@
 
 ocrad          mono    ${GS}/ocrad/manual/ocrad_manual.html
 
+recode         mono    http://recode.progiciels-bpi.ca/manual/index.html
+
 standards      mono    ${G}/prep/standards/standards.html
 standards      node    ${G}/prep/standards/html_node/