Hi Eli, Karl, * Eli Zaretskii wrote on Fri, Jul 30, 2010 at 08:29:48AM CEST: > > From: [email protected] (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 \...@refill 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 <[email protected]> * 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 -...@cindex hello +@@cindex hello Hello, there! @end example
