texinfo ChangeLog doc/texinfo.txi

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       10/09/16 23:51:20

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 

Log message:
        (Customizing {Layout,Content} of Special Elements): rename+edit

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1140&r2=1.1141
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.315&r2=1.316

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1140
retrieving revision 1.1141
diff -u -b -r1.1140 -r1.1141
--- ChangeLog   15 Sep 2010 22:39:24 -0000      1.1140
+++ ChangeLog   16 Sep 2010 23:51:18 -0000      1.1141
@@ -1,3 +1,8 @@
+2010-09-16  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (Customizing {Layout,Content} of Special Elements):
+       rename+edit.
+
 2010-09-16  Patrice Dumas  <address@hidden>
 
        * texi2html/texi2html.pl (line_warn, line_error, format_line_number):

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.315
retrieving revision 1.316
diff -u -b -r1.315 -r1.316
--- doc/texinfo.txi     14 Sep 2010 22:13:35 -0000      1.315
+++ doc/texinfo.txi     16 Sep 2010 23:51:18 -0000      1.316
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.315 2010/09/14 22:13:35 karl Exp $
address@hidden $Id: texinfo.txi,v 1.316 2010/09/16 23:51:18 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.
 
@@ -18498,7 +18498,7 @@
 * Output Elements::                The main unit of output documents.
 * Navigation Panel Customization:: Customizing navigation buttons and more.
 * Customizing HTML Page Layout::   Customizing page headers, footers, sections.
-* Customizing HTML Special Elements::
+* Customizing Special Elements::
 * File and target names::
 * Headings formatting::
 * Formatting insertions text and simple commands::
@@ -20184,30 +20184,40 @@
 program that generated the output are output in the footer.
 
 
address@hidden Customizing HTML Special Elements
address@hidden Customizing HTML Special Elements
address@hidden Customizing Special Elements
address@hidden Customizing Special Elements
 
 Various function references allow you to customize both the content
 and layout of the HTML output of the special elements (@pxref{Output
 Elements Defined}).
 
 @menu
-* Special elements content::
-* Special elements layout::
+* Content: Customizing Content of Special Elements.
+* Layout: Customizing Layout of Special Elements.
 @end menu
 
address@hidden Special elements content
address@hidden Customizing the content of the special elements pages
 
-The label for the special elements, except for the Top element
-is formatted according to the function reference @code{$misc_element_label}:
address@hidden Customizing Content of Special Elements
address@hidden Customizing Content of Special Elements
 
address@hidden {Function Reference} $misc_element_label misc_element_label 
$identifier $page_name
address@hidden is the identifier associated with the special element.
address@hidden is the special element name.  It should return a label that
-can be used for references to the special element.
address@hidden Customizing special elements content
address@hidden Special elements content, customizing
address@hidden Content of special elements, customizing
+
+The label for the special elements (@pxref{Output Elements Defined}),
+except for the top element, is formatted according to the function
+reference @code{$misc_element_label}:
+
address@hidden {Function Reference} $misc_element_label misc_element_label @
+           $identifier $page_name
address@hidden is the identifier associated with the special
+element.  @var{$page_name} is the special element name.  The function
+should return a label that can be used for references to the special
+element.
 @end deftypefn
 
+The following sections describe the details for each special element.
+
 @menu
 * Top element text::
 * Contents and Overview text::
@@ -20216,6 +20226,7 @@
 * Title page text::
 @end menu
 
+
 @node Top element text
 @subsubsection Top element text formatting
 
@@ -20449,35 +20460,46 @@
 The resulting title page output is used in the document if 
 @code{USE_TITLEPAGE_FOR_TITLE} and @code{SHOW_TITLE} are set.
 
address@hidden Special elements layout
address@hidden Customizing the layout of the special element pages
 
-The formatting of each of the special pages, or section in case 
-the document is not split, is controlled by a function.
-The associated function reference is called accordingly:
address@hidden Customizing Layout of Special Elements
address@hidden Customizing Layout of Special Elements
+
address@hidden Customizing special elements layout
address@hidden Special elements layout, customizing
address@hidden Layout of special elements, customizing
+
+The formatting of each of the special elements is controlled by a
+function, as listed in the following table:
 
 @ftable @code
 @item print_Top
 @item print_Top_header
 @item print_Top_footer
-Formatting of top element page or section. It is also used for the formatting
-of the top element text (@pxref{Top element text}).
+Formatting of the top element.  It is also used for the formatting of
+the top element text (@pxref{Top element text}).
+
 @item print_Toc
-Formatting of table of contents page or section.
+Formatting of the table of contents element.
+
 @item print_Overview
-Formatting of short table of contents page or section.
+Formatting of the short table of contents element.
+
 @item print_About
-Formatting of about (help) page or section.
+Formatting of about (help) element.
+
 @item print_Footnotes
-Formatting of footnotes section or page in case footnotes are on a 
-separated page or the document is not split.
+Formatting of the footnote elements.
 @end ftable
 
-In the default case, @code{$print_Top} calls @code{$print_Top_header} for
-the header and @code{$print_Top_footer} for the footer of top element.
-All the other function call @code{$print_misc} which in turn calls
address@hidden for the headers and @code{$print_misc_footer} 
-for the footers.
address@hidden print_misc
address@hidden print_misc_header
address@hidden print_misc_footer
+In the default case, @code{$print_Top} calls @code{$print_Top_header}
+for the header and @code{$print_Top_footer} for the footer of top
+element.  All the other function call @code{$print_misc} which in turn
+calls @code{$print_misc_header} for the headers and
address@hidden for the footers.
+
 
 @node File and target names
 @section Customizing the file and target names
@@ -21310,9 +21332,9 @@
 @end deftypefn
 
 The following function is only used when footnotes are at the bottom
-of a page and the document is split. 
-For customization of the footnotes page in case they are on a separated 
-page or section, @ref{Special elements layout}.  The footnotes location 
+of a page and the document is split.  For customization of the
+footnotes page in case they are on a separated page or section,
address@hidden Layout of Special Elements}.  The footnotes location
 is determined by @code{footnotestyle}.
 
 @deffn {Function Reference} foot_section \@@footnotes_lines
@@ -24551,7 +24573,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.315 2010/09/14 22:13:35 karl Exp $
+$Id: texinfo.txi,v 1.316 2010/09/16 23:51:18 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}
@@ -24630,7 +24652,7 @@
 
 @verbatim
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.315 2010/09/14 22:13:35 karl Exp $
address@hidden $Id: texinfo.txi,v 1.316 2010/09/16 23:51:18 karl Exp $
 @comment %**start of header
 @setfilename sample.info
 @include version.texi