39-doc-index.patch

[Akim Demaille]

Well, yet another limitation I wish makeinfo could denunciate.  I
stupidly lost time on this :( And the Texinfo documentation does
clearly display this limitation, nor do the standalone reader and
XEmacs info mode documentations.

The only trace I could find is:

       File: texinfo,  Node: Indexing Commands

       Defining the Entries of an Index
       ================================

         You are not actually required to use the predefined indices for their
       canonical purposes.  For example, suppose you wish to index some C
       preprocessor macros.  You could put them in the function index along
       with actual functions, just by writing address@hidden' commands for them;
       then, when you print the "Function Index" as an unnumbered chapter, you
       could give it the title `Function and Macro Index' and all will be
       consistent for the reader.  Or you could put the macros in with the
       data types by writing address@hidden' commands for them, and give that 
index
====>  a suitable title so the reader will understand.  (*Note Printing
       Indices & Menus::.)

not clear whether you refer to the mechanical or human reader.


There might be some documentation about this somewhere, but I really
think makeinfo ought to help me.


Index: ChangeLog
from  Akim Demaille  <address@hidden>

        Info readers seem to need `Index' in the index node title :(

        * doc/autoconf.texi: Reverse the 2001-08-15 change which
        simplified index node names.

Index: doc/autoconf.texi
--- doc/autoconf.texi Mon, 20 Aug 2001 08:46:25 +0200 akim
+++ doc/autoconf.texi Mon, 20 Aug 2001 08:51:25 +0200 akim
@@ -164,13 +164,13 @@ @node Top, Introduction, (dir), (dir)
 * Questions::                   Questions about Autoconf, with answers
 * History::                     History of Autoconf
 * Copying This Manual::         How to make copies of this manual
-* Environment Variables::       Index of environment variables used
-* Output Variables::            Index of variables set in output files
-* Preprocessor Symbols::        Index of C preprocessor symbols defined
-* Autoconf Macros::             Index of Autoconf macros
-* M4 Macros::                   Index of M4, M4sugar, and M4sh macros
-* Autotest Macros::             Index of Autotest macros
-* Programs and Functions::      Index of those with portability problems
+* Environment Variable Index::  Index of environment variables used
+* Output Variable Index::       Index of variables set in output files
+* Preprocessor Symbol Index::   Index of C preprocessor symbols defined
+* Autoconf Macro Index::        Index of Autoconf macros
+* M4 Macro Index::              Index of M4, M4sugar, and M4sh macros
+* Autotest Macro Index::        Index of Autotest macros
+* Program & Function Index::    Index of those with portability problems
 * Concept Index::               General index

 @detailmenu --- The Detailed Node Listing ---
@@ -500,7 +500,7 @@ shouted: ``And the Chaos, where do you t
 on.  @xref{The GNU build system}, for more information.

 Autoconf imposes some restrictions on the names of macros used with
address@hidden in C programs (@pxref{Preprocessor Symbols}).
address@hidden in C programs (@pxref{Preprocessor Symbol Index}).

 Autoconf requires @sc{gnu} M4 in order to generate the scripts.  It uses
 features that some @sc{unix} versions of M4, including @sc{gnu} M4 1.3,
@@ -1908,7 +1908,7 @@ @node Preset Output Variables, Installat

 Some output variables are preset by the Autoconf macros.  Some of the
 Autoconf macros set additional output variables, which are mentioned in
-the descriptions for those macros.  @xref{Output Variables}, for a
+the descriptions for those macros.  @xref{Output Variable Index}, for a
 complete list of output variables.  @xref{Installation Directory
 Variables}, for the list of the preset ones related to installation
 directories.  Below are listed the other preset ones.  They all are
@@ -11850,7 +11850,7 @@ @node Deuteronomy,  , Numbers, History

 @c ========================================================== Appendices

address@hidden Copying This Manual, Environment Variables, History, Top
address@hidden Copying This Manual, Environment Variable Index, History, Top
 @appendix Copying This Manual

 @menu
@@ -11859,7 +11859,7 @@ @node Copying This Manual, Environment V

 @include fdl.texi

address@hidden Environment Variables, Output Variables, Copying This Manual, Top
address@hidden Environment Variable Index, Output Variable Index, Copying This 
Manual, Top
 @unnumbered Environment Variable Index

 This is an alphabetical list of the environment variables that Autoconf
@@ -11867,7 +11867,7 @@ @node Environment Variables, Output Vari

 @printindex ev

address@hidden Output Variables, Preprocessor Symbols, Environment Variables, 
Top
address@hidden Output Variable Index, Preprocessor Symbol Index, Environment 
Variable Index, Top
 @unnumbered Output Variable Index

 This is an alphabetical list of the variables that Autoconf can
@@ -11877,7 +11877,7 @@ substitute into files that it creates, t

 @printindex ov

address@hidden Preprocessor Symbols, Autoconf Macros, Output Variables, Top
address@hidden Preprocessor Symbol Index, Autoconf Macro Index, Output Variable 
Index, Top
 @unnumbered Preprocessor Symbol Index

 This is an alphabetical list of the C preprocessor symbols that the
@@ -11886,7 +11886,7 @@ @node Preprocessor Symbols, Autoconf Mac

 @printindex cv

address@hidden Autoconf Macros, M4 Macros, Preprocessor Symbols, Top
address@hidden Autoconf Macro Index, M4 Macro Index, Preprocessor Symbol Index, 
Top
 @unnumbered Autoconf Macro Index

 This is an alphabetical list of the Autoconf macros.  To make the list
@@ -11894,7 +11894,7 @@ @node Autoconf Macros, M4 Macros, Prepro

 @printindex ac

address@hidden M4 Macros, Autotest Macros, Autoconf Macros, Top
address@hidden M4 Macro Index, Autotest Macro Index, Autoconf Macro Index, Top
 @unnumbered M4 Macro Index

 This is an alphabetical list of the M4, M4sugar, and M4sh macros.  To
@@ -11903,7 +11903,7 @@ @node M4 Macros, Autotest Macros, Autoco

 @printindex ms

address@hidden Autotest Macros, Programs and Functions, M4 Macros, Top
address@hidden Autotest Macro Index, Program & Function Index, M4 Macro Index, 
Top
 @unnumbered Autotest Macro Index

 This is an alphabetical list of the Autotest macros.  To make the list
@@ -11911,15 +11911,15 @@ @node Autotest Macros, Programs and Func

 @printindex at

address@hidden Programs and Functions, Concept Index, Autotest Macros, Top
address@hidden Programs and Functions Index
address@hidden Program & Function Index, Concept Index, Autotest Macro Index, 
Top
address@hidden Program and Function Index

 This is an alphabetical list of the programs and functions which
 portability is discussed in this document.

 @printindex pr

address@hidden Concept Index,  , Programs and Functions, Top
address@hidden Concept Index,  , Program & Function Index, Top
 @unnumbered Concept Index

 This is an alphabetical list of the files, tools, and concepts