texinfo ChangeLog doc/texinfo.txi

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       10/08/25 18:49:36

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 

Log message:
        (Init File Global Information): split into subnodes, add Program String 
Customization

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1115&r2=1.1116
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.294&r2=1.295

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1115
retrieving revision 1.1116
diff -u -b -r1.1115 -r1.1116
--- ChangeLog   21 Aug 2010 16:26:18 -0000      1.1115
+++ ChangeLog   25 Aug 2010 18:49:36 -0000      1.1116
@@ -1,3 +1,8 @@
+2010-08-25  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (Init File Global Information): split into subnodes,
+       and merge in `Program String Customization'.
+
 2010-08-21  Karl Berry  <address@hidden>
 
        * doc/texinfo.txi (Init File Formatting of Commands): edit.

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.294
retrieving revision 1.295
diff -u -b -r1.294 -r1.295
--- doc/texinfo.txi     21 Aug 2010 16:26:18 -0000      1.294
+++ doc/texinfo.txi     25 Aug 2010 18:49:36 -0000      1.295
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.294 2010/08/21 16:26:18 karl Exp $
address@hidden $Id: texinfo.txi,v 1.295 2010/08/25 18:49:36 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.
 
@@ -18637,7 +18637,6 @@
 * texi2any's Three Passes::       @command{texi2any} works in three passes.
 * Init File Calling at Different Stages::  Calling functions at various times.
 * Init File Formatting of Commands:: Overriding default formatting completely.
-* Program string customization::
 * Customizing generalized block command opening:: 
 * Four contexts::             Four different contexts for command expansion: 
                               normal text, preformatted text, strings and math.
@@ -18828,9 +18827,6 @@
 @node Init File Global Information
 @subsection Init File Global Information
 
address@hidden Init files, and global information
address@hidden Global information, in init files
-
 @c @ignore
 @c FIXME those are still undocumented
 @c 'split_level' 
@@ -18843,9 +18839,28 @@
 @c %hyphenation
 @c @end ignore
 
address@hidden Init files, and global information
address@hidden Global information, in init files
+
+Much global information about the document is available as the basis
+for customization in init files.
+
address@hidden
+* Title String Variables::           @code{@@author}, @code{@@title}, etc.
+* Command Line String Variables::    Input and output file names, etc.
+* Global Document String Variables:: @code{@@copying}, CSS, TOC, etc.
+* Index String Variables::           @code{defindex}, @code{@@synindex}, etc.
+* Program String Customization::     For the About element and footers.
address@hidden menu
+
address@hidden Title String Variables
address@hidden Title String Variables
+
address@hidden Title string variables
+
 For title-related @@-commands, such as @code{@@title},
address@hidden@@titlefont}, @code{@@author}, and @code{@@top}, some
-information is available, with diverse formatting.
address@hidden@@titlefont}, and @code{@@author}, a variety of information is
+available, with diverse formatting.
 
 @code{@@author} and @code{@@subtitle} are multiline title-related
 commands, since they may appear more than once.  Multiline
@@ -18868,16 +18883,11 @@
 hash, where @var{command} is the title @@-command:
 
 @table @code
address@hidden @var{command}
-The corresponding text formatted.
-
 @item @var{command}_texi
 The original Texinfo code.
 
address@hidden @var{command}_line_nr
-An opaque structure corresponding with the line where the @@-comand
-appeared.  Not available for @code{@@titlefont}, multiline
-title-related commands and derived information.
address@hidden @var{command}
+The corresponding text formatted.
 
 @item @var{command}_no_texi
 The text formatted as simple plain text.
@@ -18886,6 +18896,11 @@
 The text formatted as a string without formatting elements
 (@pxref{Four contexts}).
 
address@hidden @var{command}_line_nr
+An opaque structure corresponding with the line where the @@-comand
+appeared.  Not available for @code{@@titlefont}, multiline
+title-related commands and derived information.
+
 @end table
 
 For multiline commands, the following array references are associated
@@ -18906,8 +18921,14 @@
 
 @end table
 
-The @code{%Texi2HTML::THISDOC} hash holds other global information.
-Here are some entries related to the command-line processing:
+
address@hidden Command Line String Variables
address@hidden Command Line String Variables
+
address@hidden Command-line string variables
+
+These entries in the @code{%Texi2HTML::THISDOC} hash are related to
+the command-line processing:
 
 @table @code
 @item destination_directory
@@ -18970,7 +18991,14 @@
 
 @end table
 
-Here are entries for other global document information:
+
address@hidden Global Document String Variables
address@hidden Global Document String Variables
+
address@hidden Global document strings
+
+These entries in the @code{%Texi2HTML::THISDOC} hash provide other
+global document information.
 
 @table @code
 @item copying_comment
@@ -19006,7 +19034,14 @@
 
 @end table
 
-Here are index-related entries:
+
address@hidden Index String Variables
address@hidden Index String Variables
+
address@hidden Index strings
+
+These entries in the @code{%Texi2HTML::THISDOC} hash provide other
+index-related information.
 
 @table @code
 @item defindex 
@@ -19035,6 +19070,25 @@
 
 @end table
 
+
address@hidden Program String Customization
address@hidden Program String Customization
+
address@hidden Program string customization
address@hidden Customization of program string
address@hidden PROGRAM_NAME_IN_FOOTER
+
+The following function reference may be used to construct a string
+advertising the program used to generate the output.  It may be used
+in the @code{About} element, and in the footers if
address@hidden is set.
+
address@hidden {Function Reference} $program_string_formatted program_string
+This function reference should return the formatted program
+string.
address@hidden deftypefn
+
+
 @cindex Init file flag values
 @cindex Flag values, in init files
 @cindex @code{@@set} values, in init files
@@ -19286,19 +19340,6 @@
 @end deftypefn
 
 
address@hidden Program string customization
address@hidden Program string customization
-
-There is a function reference that may be used to construct a string 
-advertizing the program used to generate the manual. It may 
-be used in the About element, and in the footers if
address@hidden is set.
-
address@hidden {Function Reference} $program_string_formatted program_string
-This function reference should return the formatted program
-string.
address@hidden deftypefn
-
 @node Customizing generalized block command opening
 @subsection Customizing generalized block command opening
 
@@ -24384,7 +24425,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.294 2010/08/21 16:26:18 karl Exp $
+$Id: texinfo.txi,v 1.295 2010/08/25 18:49:36 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}
@@ -24463,7 +24504,7 @@
 
 @verbatim
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.294 2010/08/21 16:26:18 karl Exp $
address@hidden $Id: texinfo.txi,v 1.295 2010/08/25 18:49:36 karl Exp $
 @comment %**start of header
 @setfilename sample.info
 @include version.texi