Index locators
Typically, an <indexterm>
element instructs a processor to
generate an index entry with a locator.
The nesting of <indexterm>
elements and the presence of
<index-see>
elements determines whether locators are rendered
in the generated index entries:
- An
<indexterm>
element that does not contain child<indexterm>
elements (or an<index-see>
element) contributes a locator to the generated index entry. - An
<indexterm>
element that contains child<indexterm>
elements contributes to the hierarchy of the multilevel index entry that is generated. Only the final nested<indexterm>
element contributes a locator to the generated index entry. - If an
<indexterm>
element also contains one or more<index-see>
elements, no locator is included in the generated index entry. - If an
<indexterm>
element also contains one or more<index-see-also>
elements, the<indexterm>
element contributes a locator to the generated index entry, and<index-see-also>
element provides only a redirection.