Re: indexing

[Ali Abdin <ALIABDIN aucegypt edu>]

> Greg -
> There is a brief discussion of docbook indexing tags on Norman Walsh's
> web site:
> 
> http://nwalsh.com/docbook/dsssl/doc/indexing.html
> 
> It also explains how to automatically build an index from marked-up
> sgml using a perl script called collateindex.pl.
> 
> The script is the cygnus stylesheets package:
> ftp://sourceware.cygnus.com:/pub/docbook-tools/docware/SOURCES/
> stylesheets.tgz
> 
> I've just been playing with it a bit this afternoon, and it seems
> rather cumbersome - not really practical for production work. Building
> an index is a multiple-step process, and I've had to use jade directly
> to make it work rather than db2html. Also, it seems to link to the
> beginning of the section rather than the spot where your indexterm
> occurs. 

I believe having it point to the 'section' rather than the index term is 
a 'feature' not a bug - If we ever get something like that, that is how 
it will work (wether it is intuitive or not).
 
> But it does offer a way to build an index to see how it
> looks at the end of your document.