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 `@findex' 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 `@tindex' 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 <[EMAIL PROTECTED]>
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
-@code{#if} in C programs (@pxref{Preprocessor Symbols}).
+@code{#if} 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
-@node Copying This Manual, Environment Variables, History, Top
+@node 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
-@node Environment Variables, Output Variables, Copying This Manual, Top
+@node 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
-@node Output Variables, Preprocessor Symbols, Environment Variables, Top
+@node 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
-@node Preprocessor Symbols, Autoconf Macros, Output Variables, Top
+@node 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
-@node Autoconf Macros, M4 Macros, Preprocessor Symbols, Top
+@node 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
-@node M4 Macros, Autotest Macros, Autoconf Macros, Top
+@node 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
-@node Autotest Macros, Programs and Functions, M4 Macros, Top
+@node 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
-@node Programs and Functions, Concept Index, Autotest Macros, Top
-@unnumbered Programs and Functions Index
+@node Program & Function Index, Concept Index, Autotest Macro Index, Top
+@unnumbered Program and Function Index
This is an alphabetical list of the programs and functions which
portability is discussed in this document.
@printindex pr
-@node Concept Index, , Programs and Functions, Top
+@node Concept Index, , Program & Function Index, Top
@unnumbered Concept Index
This is an alphabetical list of the files, tools, and concepts
