[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
texinfo ChangeLog doc/texinfo.txi util/htmlxref...
From: |
Karl Berry |
Subject: |
texinfo ChangeLog doc/texinfo.txi util/htmlxref... |
Date: |
Tue, 07 Sep 2010 18:51:18 +0000 |
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/