see — Part of an index term directing the reader instead to another entry in the index
see ::= (text | | | | | | | | | | | | | | | | )*
The use of
see in an
indexterm indicates that the reader should be
directed elsewhere in the index when encountering this term.
The content of
see identifies another term in
the index which the reader should consult instead
of the current term.
Suppressed. This element provides data for processing but it is not rendered in the primary flow of text.
It is possible for multiple
together, to form an illogical index. For example, given the following
<indexterm><primary>Extensible Markup Language</primary> <see>XML</see></indexterm> <indexterm><primary>Extensible Markup Language</primary> <secondary>definition of</secondary> </indexterm>
there’s no way to construct a logical index because an entry in
the index should never have both a
see and other
DocBook cannot detect these errors. You will have to rely on an external process to find them.