On Index files
Libraries are great. They make sure I don't have to do some specific work.
Libraries with proper API documentation are even better. They make sure I don't have waste half a day just to figure out how to use the damn library.
If the API documentation is really well done, it has an index with
all functions supported by the library so that one can easily find the
function you're looking for. In order to make this index more easily
searchable by the use of vgrep, such an
index is commonly organized in an alphabetical manner, grouped per
letter of the alphabet (so that you'd find a function foo()
under the letter F, and a function bar()
under the letter
B.
However, if it's part of your API to prefix all your functions with a
common prefix (say, g_
or gtk_
) and you
don't skip that common prefix in the alphabetic grouping of your index
file, you're just being
silly.