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.