◇◆

xreflabel Cross-Reference Label

Any element with an @xml:id may be cross-referenced using a <xref> element; generally, this is all that is necessary to generate a cross-reference, since several of these elements (including <figure>, <equation> and <table>) receive labels automatically.
On occasion, however, it may be useful or necessary to provide text for a cross-reference label explicitly; for these cases, use this attribute.
In particular, any <bibliomixed> element that is referenced from the text using a <xref> should be provided with a @xreflabel.

Usage/Remarks

Authoring Note
The authoring model does not permit the use of @xreflabel with the elements <itemizedlist>, <orderedlist>, <listitem>, <variablelist>, <varlistentry>, and <programlisting>. Use of @xreflabel with these elements is available in the production model, but only then for backwards-compatibility should prior proceedings years’ production be necessary. (Model versions, predating 2010, permitted @xreflabel’s use with these elements.)
OPTIONAL on many elements; click for list and usage

<appendix>, <bibliomixed>, <equation>, <figure>, <footnote>, <itemizedlist>, <listitem>, <note>, <orderedlist>, <programlisting>, <section>, <table>, <variablelist>, <varlistentry>

Value Meaning
Text, numbers, or special characters The text that is to be used for a cross-reference
Restriction This attribute may be specified if the element is used.
Tagged Samples
Author-provided text to display for cross-references (to a bibliographic entry) 
...
<section xml:id="mul3">
  <title>Native Inhabitants of the New World</title>
  <para>Upon establishing the Roanoke colony, the settlers encouraged relations with the 
    native inhabitants, of which there appear to have been a diverse group, including 
    Croatans, Mangoaks, Chaonists, and Sequotanes, as well as Roanoke from which the 
    region took its name. [<xref linkend="lane1586"/>, <xref linkend="dunbar1960"/>] 
    ...</para>
  </section>
...
<bibliography>
  <title>Bibliography</title>
  ...
  <bibliomixed xml:id="dunbar1960" xreflabel="Dunbar 1960">Dunbar, Gary S. ...</bibliomixed>
  <bibliomixed xml:id="lane1586" xreflabel="Lane">Lane, Ralph. ...</bibliomixed>
</bibliography>
...
Author-provided text to display for cross-references (to an appendix) 
...
<section>
  ...
  <para>The second expedition, organized by John White in 1587, fared better. It sailed with 
    seven ships filled with Devon families intent upon establishing a colony in that part of 
    Virginia called Roanoke, a word deriving from the speech of native peoples. (<emphasis 
    role="ital">See</emphasis> <xref linkend="mul-app2"/>.) ...</para>
</section>
...
<appendix xml:id="mul-app2" xreflabel="Appendix II">
  <title>The Roanoke Colony, 1587</title>
  ...
</appendix>
...