Re: suggestion: put AC_ at the front of AC_ items in the index

[Akim Demaille]

 >> | Perhaps we should put the AC_ there.  Its absence really
 >> | isn't buying us much.
 >> 
 >> Well, the printed index would be much less elegant, as there would be
 >> the letter "A", and that's all.

 Paul> You're right, but what can I say?  Sometimes elegance is confusing --
 Paul> and in a functional manual, clarity is more important than elegance.

I don't know if you know/like Gary Larson, but there is one of his
comic books (I believe the "Wiener Dog Art" one) whose index is nice:

A: 

B:

C:

D:

E:

F:

G:

H:

I:

J:

K:

L:

M:

N:

O:

P:

Q:

R:

S:

T:
  The one about blah blah  51
  The one about foo        42
  etc.
  etc.
U:

V:

W:

X:

Y:

Z:



 >> The index does include the following piece of information:

 Paul> Yes, I've noticed that, but it's still a bit confusing, even for me.

 Paul> For example, when I am in GNU Emacs info mode, and type "i" followed
 Paul> by "AC_AIX" and then RET, Emacs responds "No `AC_AIX' in index".
 Paul> Strictly speaking this is correct, so I sigh and type "i" "AIX" RET
 Paul> and get to where I want.  But surely the vast majority of Autoconf
 Paul> users trying to decipher their configure.ac files would prefer the
 Paul> index to contain "AC_AIX", since that's what they see on their
 Paul> screens.

How about trying to keep the printed manual nice, and have the Info
index be AC_'d?