Description

Link is a general purpose hypertext element.
Usually, Link surrounds the text that should be made
"hot," (unlike XRef which must generate the text) but
the EndTerm attribute can be used to copy
text from another element.

Processing expectations

Formatted inline.

If the Link element specifies an
EndTerm, and then the
content of the element pointed to by EndTerm
should be repeated at the location of the Link and used
as the "hot" text instead of the Link
content, which should be suppressed.

Linking elements must not be nested within other linking
elements (including themselves). Because DocBook is harmonizing
towards XML, this restriction cannot easily be enforced by the DTD. The
processing of nested linking elements is undefined.

Future Changes

The InterfaceDefinition
element will be discarded in DocBook V4.0. It will no longer be available
in the content model of this element.

See Also

Examples

<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<sect1><title>Examples of <sgmltag>Link</sgmltag></title>
<para>
In this sentence <link linkend=nextsect>this</link> word is
hot and points to the following section.
</para>
<para>
There is also a link to the section called
<quote><link linkend=nextsect endterm="nextsect.title"></link></quote>
in this sentence.
</para>
<sect2 id=nextsect><title id=nextsect.title>A Subsection</title>
<para>
This section only exists to be the target of a couple of links.
</para>
</sect2>
</sect1>