Re: info --index not finding all indexed entries

[Ralf Wildenhues]

Hi Eli, Karl,

* Eli Zaretskii wrote on Fri, Jul 30, 2010 at 08:29:48AM CEST:
> > From: address@hidden (Karl Berry)
> > 
> > * AM_INIT_AUTOMAKE <1>:                  Public Macros.       (line  16)
> > * AM_INIT_AUTOMAKE:                      Requirements.        (line   6)
> 
> Which means the Automake manual needs to be fixed.  Having more than
> one index entry in different places is not a good idea, and this
> thread is just another instance of the proof.

I wasn't aware that this is considered a bad idea in general, and I'm
not quite convinced yet: checked now, the Automake manual contains more
than hundred duplicate entries, the Autoconf roughly 60, the Texinfo
manual at least three dozen.  Are those all bugs?  Neither the 'Index
Entries' nor the 'Indexing Commands' node of the Texinfo manual mention
that duplicates should be avoided.

See below for another reason a hard rule against it might not be ideal.

> One of the entries should be qualified, like
> 
>   @findex AM_INIT_AUTOMAKE, how to ...

While this which is definitely nicer to have, sometimes you may simply
have more than one relevant place in a manual.

Meanwhile, I found this little typo, see patch below.

Also, while editing texinfo.txi I found instances of @refill which I
didn't know, so I did
  info texinfo --index refill
  info texinfo --index address@hidden

neither of which worked, so I'm wondering why the 'Command List' node
doesn't use @ftable instead of @table; of course that would add more
duplicates to the indices and thus runs a bit contrary to your
suggestion above, but for me it would definitely be helpful.

Cheers, and thanks for the feedback!
Ralf

2010-07-30  Ralf Wildenhues  <address@hidden>

        * doc/texinfo.txi (Indexing Commands): Fix typo.

Index: doc/texinfo.txi
===================================================================
RCS file: /cvsroot/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.273
diff -u -r1.273 texinfo.txi
--- doc/texinfo.txi     27 Jul 2010 23:39:37 -0000      1.273
+++ doc/texinfo.txi     30 Jul 2010 08:27:31 -0000
@@ -10041,7 +10041,7 @@
 indexed.  For instance:
 
 @example
address@hidden hello
+@@cindex hello
 Hello, there!
 @end example