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

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       10/08/05 00:09:06

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

Log message:
        (Setting and Getting Configuration Variables): edit

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1088&r2=1.1089
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.278&r2=1.279
http://cvs.savannah.gnu.org/viewcvs/texinfo/util/htmlxref.cnf?cvsroot=texinfo&r1=1.7&r2=1.8

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1088
retrieving revision 1.1089
diff -u -b -r1.1088 -r1.1089
--- ChangeLog   2 Aug 2010 18:28:27 -0000       1.1088
+++ ChangeLog   5 Aug 2010 00:09:05 -0000       1.1089
@@ -1,3 +1,8 @@
+2010-08-04  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (Setting and Getting Configuration Variables):
+       capitalize+edit.
+
 2010-08-02  Karl Berry  <address@hidden>
 
        * doc/texinfo.txi (Initialization File Basics): capitalize+edit.

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.278
retrieving revision 1.279
diff -u -b -r1.278 -r1.279
--- doc/texinfo.txi     2 Aug 2010 18:28:27 -0000       1.278
+++ doc/texinfo.txi     5 Aug 2010 00:09:06 -0000       1.279
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.278 2010/08/02 18:28:27 karl Exp $
address@hidden $Id: texinfo.txi,v 1.279 2010/08/05 00:09:06 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.
 
@@ -656,7 +656,7 @@
 
 * Loading Initialization Files::   Initialization files and their search paths.
 * Initialization File Basics::     General information on init files.
-* Elements::                          The main division of output document.
+* Output Elements::                The main unit of output documents.
 * Special elements::                  Customizing special elements text and 
                                       layout.
 * File and target names::
@@ -18524,7 +18524,7 @@
 @menu
 * Loading Initialization Files::   Initialization files and their search paths.
 * Initialization File Basics::     General information on init files.
-* Elements::                          The main division of output document.
+* Output Elements::                The main unit of output documents.
 * Navigation panel customization::
 * Page layout customization::
 * Special elements::                  Customizing special elements text and 
@@ -18608,6 +18608,7 @@
 @section Initialization File Basics
 
 @cindex Initialization file basics
address@hidden Perl, used for initialization files
 
 Initialization files are written in Perl, and by convention have
 extension @file{.init}.  Many initialization files are included in the
@@ -18687,7 +18688,7 @@
 help with that (@pxref{Calling functions at different stages}).
 
 @menu
-* Setting and getting configuration variable value::
+* Setting/getting configuration variables::
 * Global informations::       Accessing global informations, like date, 
                               address@hidden
 * Getting flag values::
@@ -18706,54 +18707,69 @@
 @end menu
 
 
address@hidden Setting and getting configuration variable value
address@hidden Setting and getting configuration variable value
address@hidden Setting and Getting Configuration Variables
address@hidden Setting and Getting Configuration Variables
+
address@hidden Configuration variables, setting/getting
+
+The basic operations on configuration variables are to set and
+retrieve their values.
 
 To set the value of a configuration variable from an initialization file,
-you should use the function:
+you should use @code{set_from_init_file}:
+
 @defun set_from_init_file ($variable_name, $variable_value)
 @var{$variable_name} is a string containing the name of the variable 
-you want to set, and @var{$variable_value} is the value you want to set.
address@hidden may be @samp{undef}.  For example
+you want to set, and @var{$variable_value} is the value to which you
+want to set it.  @var{$variable_value} may be @samp{undef}.
address@hidden defun
+
+For example,
+
 @example
 set_from_init_file('documentlanguage', 'fr');
 @end example
-should override the @code{@@documentlanguage} from the document.
-It will be overriden by @option{--document-language} on the 
-command-line.
 
-Another example, 
address@hidden overrides the @code{@@documentlanguage} from the
+document.  It would be overridden by @option{--document-language} on
+the command line.
+
+Another example:
+
 @example
 set_from_init_file('SPLIT', 'chapter');
 @end example
-should override the default splitting of the document.  It will be
-overriden by the @option{--split} option on the command-line.
 
-And, as a last example, 
address@hidden overrides the default splitting of the document.  It would be
+overridden by @option{--split} on the command line.
+
+A final example:
+
 @example
 set_from_init_file('NO_CSS', 1);
 @end example
-wil override the default value for @code{NO_CSS}.  It will be overriden by
address@hidden NO_CSS=1} on the command-line.
address@hidden defun
 
-To get the value of a variable, the function is @code{get_conf},
-in the @code{Texi2HTML::Config} namespace:
address@hidden overrides the default value for @code{NO_CSS}.  It would be
+overridden by @code{--set-init-variable NO_CSS=1} on the command line.
+
+To get the value of a variable, the function is @code{get_conf}:
+
 @defun get_conf ($variable_name)
address@hidden is  the name of the variable you want to know the 
-value.
address@hidden is the name of the variable; its value (possibly
address@hidden) is returned.
 @end defun
 
 For example:
 
 @example
-if (get_conf('footnotestyle') eq 'separate') @{ .... @}
+if (get_conf('footnotestyle') eq 'separate') @{ ... @}
 @end example
 
-The list of configuration variables associated with @@-commands is
-in @ref{Configuration variables for @@-commands}, the list and mapping
-of configuration variables associated with command line options is at 
address@hidden variables and options}.
+For the configuration variables associated with @@-commands, see
address@hidden variables for @@-commands}.  For the configuration
+variables associated with command line options, see @ref{Configuration
+variables and options}.
+
 
 @node Global informations
 @subsection Accessing global informations
@@ -19365,8 +19381,16 @@
 @end deffn
 
 
address@hidden Elements
address@hidden Elements and associated informations
address@hidden Output Elements
address@hidden Output Elements
+
address@hidden Output elements
address@hidden Elements, main division of output documents
+
+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 what they
+are and details for customization.
 
 @menu
 * The different elements::
@@ -19377,13 +19401,8 @@
 @node The different elements
 @subsection The different elements
 
-The main division of output document is the @dfn{element}.  Their
-association with output files is determined by the split options.
address@hidden output}.
 The elements are:
 
address@hidden The association of nodes with pages is
address@hidden determined by the splitting of the document. @xref{Splitting 
output}.
 @table @emph
 @item Normal elements
 These are normal sections and nodes.  In general nodes are associated 
@@ -24232,7 +24251,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.278 2010/08/02 18:28:27 karl Exp $
+$Id: texinfo.txi,v 1.279 2010/08/05 00:09:06 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}
@@ -24311,7 +24330,7 @@
 
 @verbatim
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.278 2010/08/02 18:28:27 karl Exp $
address@hidden $Id: texinfo.txi,v 1.279 2010/08/05 00:09:06 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.7
retrieving revision 1.8
diff -u -b -r1.7 -r1.8
--- util/htmlxref.cnf   2 Aug 2010 18:28:28 -0000       1.7
+++ util/htmlxref.cnf   5 Aug 2010 00:09:06 -0000       1.8
@@ -1,5 +1,6 @@
 # htmlxref.cnf - reference file for Texinfo files on the web.
-htmlxrefversion=2010-08-02.18; # UTC
+
+htmlxrefversion=2010-08-03.16; # UTC
 
 # Copyright 2010 Free Software Foundation, Inc.
 # 
@@ -9,6 +10,8 @@
 #
 # The latest version of this file is available at
 # http://ftpmirror.gnu.org/texinfo/htmlxref.cnf.
+# Email corrections or additions to address@hidden
+# The goal is for it to list all relevant GNU manuals, at least.
 #
 # Maintainers: for information on putting manuals on the web, including
 # automatically generating all the useful formats, see
@@ -24,6 +27,9 @@
 G = http://www.gnu.org
 GS = ${G}/software
 
+3dldf          mono    ${GS}/3dldf/manual/user_ref/3DLDF.html
+3dldf          node    ${GS}/3dldf/manual/user_ref/
+
 anubis         chapter ${GS}/anubis/manual/html_chapter/
 anubis         section ${GS}/anubis/manual/html_section/
 anubis         node    ${GS}/anubis/manual/html_node/