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

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       10/11/06 16:16:35

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

Log message:
        (Customizing Indices): rename+edit

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1173&r2=1.1174
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.342&r2=1.343
http://cvs.savannah.gnu.org/viewcvs/texinfo/util/htmlxref.cnf?cvsroot=texinfo&r1=1.29&r2=1.30

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1173
retrieving revision 1.1174
diff -u -b -r1.1173 -r1.1174
--- ChangeLog   5 Nov 2010 23:26:20 -0000       1.1173
+++ ChangeLog   6 Nov 2010 16:16:34 -0000       1.1174
@@ -1,3 +1,7 @@
+2010-11-06  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (Customizing Indices): rename+edit.
+
 2010-11-05  Karl Berry  <address@hidden>
 
        * doc/texi2oldapi.texi: new file archiving several API sections

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.342
retrieving revision 1.343
diff -u -b -r1.342 -r1.343
--- doc/texinfo.txi     5 Nov 2010 23:26:21 -0000       1.342
+++ doc/texinfo.txi     6 Nov 2010 16:16:35 -0000       1.343
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.342 2010/11/05 23:26:21 karl Exp $
address@hidden $Id: texinfo.txi,v 1.343 2010/11/06 16:16:35 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.
 
@@ -9063,7 +9063,7 @@
 
 @node ftable vtable
 @subsection @code{@@ftable} and @code{@@vtable}
address@hidden Tables with indexes
address@hidden Tables with indexing
 @cindex Indexing table entries automatically
 @findex ftable
 @findex vtable
@@ -9844,6 +9844,7 @@
 @samp{separate}, and the output is split, they are placed in a
 separate file.
 
+
 @node Indices
 @chapter Indices
 @cindex Indices
@@ -9855,10 +9856,10 @@
 consists of page numbers.  In an Info file, this information is a menu
 entry leading to the first node referenced.
 
-Texinfo provides several predefined kinds of index: an index
-for functions, an index for variables, an index for concepts, and so
-on.  You can combine indices or use them for other than their
-canonical purpose.  Lastly, you can define your own new indices.
+Texinfo provides several predefined kinds of index: an index for
+functions, an index for variables, an index for concepts, and so on.
+You can combine indices or use them for other than their canonical
+purpose.  Lastly, you can define your own new indices.
 
 @xref{Printing Indices & Menus}, for information on how to print
 indices.
@@ -9882,20 +9883,20 @@
 different ways people may look for something.  Different people
 @emph{do not} think of the same words when they look something up.  A
 helpful index will have items indexed under all the different words
-that people may use.  For example, one reader may think it obvious that
-the two-letter names for indices should be listed under ``Indices,
-two-letter names'', since the word ``Index'' is the general concept.
-But another reader may remember the specific concept of two-letter
-names and search for the entry listed as ``Two letter names for
-indices''.  A good index will have both entries and will help both
address@hidden
-
-Like typesetting, the construction of an index is a highly skilled,
-professional art, the subtleties of which are not appreciated until you
-need to do it address@hidden
+that people may use.  For example, one reader may think it obvious
+that the two-letter names for indices should be listed under
+``Indices, two-letter names, since ``Indices'' are the general
+concept.  But another reader may remember the specific concept of
+two-letter names and search for the entry listed as ``Two letter names
+for indices''.  A good index will have both entries and will help both
+readers.
+
+Like typesetting, the construction of an index is a skilled art, the
+subtleties of which may not be appreciated until you need to do it
+yourself.
 
address@hidden Indices & Menus}, for information about printing an index
-at the end of a book or creating an index menu in an Info address@hidden
address@hidden Indices & Menus}, for information about printing an
+index at the end of a book or creating an index menu in an Info file.
 
 
 @node Predefined Indices
@@ -10166,6 +10167,7 @@
 
 @node New Indices
 @section Defining New Indices
+
 @cindex Defining new indices
 @cindex Indices, defining new
 @cindex New index defining
@@ -18514,15 +18516,15 @@
 target format.
 
 @menu
-* Loading Init Files::             Initialization files and their search paths.
+* Loading Init Files::               Finding and writing initialization files.
 * Init File Basics::               What init files can contain and do.
 * 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.
+* Navigation Panel Customization::   Navigation buttons and more.
+* Customizing HTML Page Layout::     Page headers, footers, sections.
 * Customizing Special Elements::     The top, toc, about, etc., elements.
 * Customizing Output-Related Names:: File names and target names.
 * Customizing HTML Headings::       Sectioning commands.
-* External index files::
+* Customizing Indices::              Manipulating index entries.
 * Customizing CSS::
 @end menu
 
@@ -20849,64 +20851,94 @@
 @end deftypefn
 
 
address@hidden External index files
address@hidden Generation of external files for index entries
address@hidden Customizing Indices
address@hidden Customizing Indices
+
address@hidden Customizing indices
address@hidden Indices, customizing
address@hidden IDX_SUMMARY
+To do something special with index entries outside of the Texinfo
+source document (@pxref{Indices}), you should first set the
+configuration variable @code{IDX_SUMMARY} true.  After that, various
+function references will be called for each non-empty index: one for
+initialization, one for each index entry, and one for finalization.
+
address@hidden {Function Reference} index_summary_file_begin $index_name @
+       $is_printed $manual_name
+This function is called once for each non-empty index used in the
+document, before any calls to @code{index_summary_file_entry}.
 
-In case you want to do something special with index 
-entries, outside of the document, you should first set the configuration 
-variable @code{IDX_SUMMARY} true.  After that some function reference 
-will be called for each non empty index.  For each index there are 3 
-function references, one called for initialization, one called for each 
-index entry and the last one called for finalization.
-
address@hidden {Function Reference} index_summary_file_begin $index_name 
$is_printed $manual_name
address@hidden is the two letters name for the index.  This function
-is called for each index appearing in the document, before 
address@hidden
address@hidden is true if there is a @code{@@printindex} for that index.
address@hidden is the manual basename.
address@hidden @var
address@hidden $index_name
+The two-letter name of the index. 
+
address@hidden $is_printed
+True if this index has a @code{@@printindex} command.
+
address@hidden $manual_name
+The manual basename.
address@hidden table
 @end deffn
 
address@hidden {Function Reference} index_summary_file_entry $index_name 
$entry_text $entry_reference $formatted_entry $texi_entry 
$entry_element_reference $entry_element_header $is_printed $manual_name
-This function is called for each entry of an index. @var{index_name} is the
-name of the index. @var{$entry_text} is the entry in plain text,
address@hidden is the index entry formatted, @var{$texi_entry} is the
-entry with texinfo commands. @var{$entry_reference} is the reference placed 
-at the index entry place, in the form @samp{file#id}.
address@hidden is the reference to the
-beginning of the element containing the index entry, in the form
address@hidden is the formatted header of the element containing 
-the index entry. 
address@hidden 
address@hidden is true if there is a @code{@@printindex} for that index.
address@hidden is the manual basename.
address@hidden {Function Reference} index_summary_file_entry $index_name @
+       $entry_text $entry_reference $formatted_entry $texi_entry @
+       $entry_element_reference $entry_element_header $is_printed $manual_name 
+This function is called for each entry of an index.
+
address@hidden @var
address@hidden $index_name
+The two-letter name of the index.
+
address@hidden $entry_text
address@hidden $formatted_entry
address@hidden $texi_entry
+The entry in plain text, formatted, and original source, respectively.
+
address@hidden $entry_reference
+The reference used for the index entry, in the form @samp{file#id}.
+
address@hidden $entry_element_reference
+The reference to the beginning of the element containing the index
+entry, also in the form @samp{file#id} (@pxref{Output Elements
+Defined}).
+
address@hidden $entry_element_header
+The formatted header of the element containing the index entry. 
+
address@hidden $is_printed
+True if this index has a @code{@@printindex} command.
+
address@hidden $manual_name
+The manual basename.
address@hidden table
 @end deffn
 
address@hidden {Function Reference} index_summary_file_end $index_name 
$is_printed $manual_name
address@hidden is the two letters name for the index.  This function
-is called for each index appearing in the document, after
address@hidden
address@hidden is true if there is a @code{@@printindex} for that index.
address@hidden is the manual basename.
address@hidden {Function Reference} index_summary_file_end $index_name 
$is_printed @
+       $manual_name
+This function is called once for each non-empty index used in the
+document, after all calls to @code{index_summary_file_entry}.  The
+arguments are the same as for @code{index_summary_file_begin}, above.
 @end deffn
 
+
 @node Customizing CSS
 @section Customizing the CSS lines
 
 @cindex @acronym{CSS}
 
address@hidden %css_map
address@hidden INLINE_CSS
 The @code{NO_CSS} configuration option turns CSS support off.
 Instead of CSS lines output at the document beginning, they may be added
 to each of the HTML attributes, if @code{INLINE_CSS} is set.
 The configuration variable variable holds the CSS
 specification lines in case CSS is not inline.
address@hidden %css_map
 It is possible to modify the CSS lines by modifying
 the entries or adding to the @code{%css_map} hash.  Each key is a CSS
 selector, the corresponding value is a style string.
 
-It is also possible to change completely the way @code{CSS_LINES}
-are generated by redefining the following function reference:
+It is also possible to change completely the way CSS lines are
+generated by redefining the following function reference:
 
 @deffn {Function Reference} css_lines \@@import_lines \@@rule_lines
 This function should be used to set the variable 
@@ -22789,7 +22821,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.342 2010/11/05 23:26:21 karl Exp $
+$Id: texinfo.txi,v 1.343 2010/11/06 16:16:35 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}
@@ -22868,7 +22900,7 @@
 
 @verbatim
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.342 2010/11/05 23:26:21 karl Exp $
address@hidden $Id: texinfo.txi,v 1.343 2010/11/06 16:16:35 karl Exp $
 @comment %**start of header
 @setfilename sample.info
 @include version.texi
@@ -24750,9 +24782,9 @@
 @node Info Format Printindex
 @subsection Info Format: Printindex
 
address@hidden Indexes, in Info format
address@hidden Indices, in Info format
 
-Indexes in Info format are generally written as a menu
+Indices in Info format are generally written as a menu
 (@pxref{Indices}), but with an additional directive at the beginning
 marking this as an index node:
 

Index: util/htmlxref.cnf
===================================================================
RCS file: /sources/texinfo/texinfo/util/htmlxref.cnf,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -b -r1.29 -r1.30
--- util/htmlxref.cnf   3 Nov 2010 18:04:51 -0000       1.29
+++ util/htmlxref.cnf   6 Nov 2010 16:16:35 -0000       1.30
@@ -1,6 +1,6 @@
 # htmlxref.cnf - reference file for Texinfo files on the web.
 
-htmlxrefversion=2010-11-03.17; # UTC
+htmlxrefversion=2010-11-06.15; # UTC
 
 # Copyright 2010 Free Software Foundation, Inc.
 # 
@@ -34,6 +34,11 @@
 anubis         section ${GS}/anubis/manual/html_section/
 anubis         node    ${GS}/anubis/manual/html_node/
 
+anubis         section http://aspell.net/man-html/index.html
+
+auctex         mono    ${GS}/auctex/manual/auctex.html
+auctex         node    ${GS}/auctex/manual/auctex/
+
 autoconf       mono    ${GS}/autoconf/manual/autoconf.html
 autoconf       node    ${GS}/autoconf/manual/html_node/
 
@@ -342,11 +347,19 @@
 smalltalk-base node    ${GS}/smalltalk/manual-base/html_node/
 smalltalk-libs node    ${GS}/smalltalk/manual-libs/html_node/
 
+sourceinstall  mono    ${GS}/sourceinstall/manual/sourceinstall.html
+sourceinstall  node    ${GS}/sourceinstall/manual/html_node/
+
 standards      mono    ${G}/prep/standards/standards.html
 standards      node    ${G}/prep/standards/html_node/
 
 swbis          mono    ${GS}/swbis/manual.html
 
+tar            mono    ${GS}/tar/manual/tar.html
+tar            chapter ${GS}/tar/manual/html_chapter/
+tar            section ${GS}/tar/manual/html_section/
+tar            node    ${GS}/autoconf/manual/html_node/
+
 texinfo                mono    ${GS}/texinfo/manual/texinfo/texinfo.html
 texinfo                node    ${GS}/texinfo/manual/texinfo/html_node/
  #