auto-index, HOWTO

[Stefan Seefeld <seefeld@sympatico.ca>]

I'm seeing unexpected behavior with automatic index generation, so I'd 
like to seek advice on how to write my document to get the behavior I want.

The attached document contains 4 indexterms. The final <index/> creates 
entries for all of them. However, the link is not to the anchor 
generated where the indexterm appears but the enclosing section, and the 
label is that section's title (i.e. three times the same in this case).

Is this intentional ? If so, is this behavior documented somewhere ?
(I'm using xsl-stylesheets-1.73.2)

It seems that, in order to generate unique labels, I'd have to make sure 
each indexterm is enclosed by its own (unique) section...

Thanks for any clarification.

		Stefan

-- 

       ...ich hab' noch einen Koffer in Berlin...
<article>
<title>A Bug</title>
<section>
  <title>struct Foo</title>
  <indexterm><primary>Foo</primary></indexterm>
  <para>A class.</para>
  <section>
    <title>Public Methods</title>
    <synopsis>Foo()</synopsis>
    <indexterm><primary>Foo()</primary></indexterm>
    <synopsis>~Foo()</synopsis>
    <indexterm><primary>~Foo()</primary></indexterm>
    <synopsis>do_something()</synopsis>
    <indexterm><primary>do_something()</primary></indexterm>
    <para>Do it.</para>
  </section>
</section>
<index/>
</article>