<refentry id="footnoteref.element">
<?dbhtml filename="footnoteref.html"?>
<refentryinfo>
<pubdate>$Date$</pubdate>
<releaseinfo>$Revision$</releaseinfo>
</refentryinfo>

<refmeta>
<indexterm><primary>elements</primary>
<secondary>footnoteref</secondary></indexterm>
<refentrytitle>footnoteref</refentrytitle>
<refmiscinfo>Element</refmiscinfo>
</refmeta>
<refnamediv>
<refname>footnoteref</refname>
<refpurpose>&footnoteref.purpose;</refpurpose>
</refnamediv>

&footnoteref.synopsis.gen;
<refsect1 condition='ref.description'><title>Description</title>

<para>
This element forms an <acronym>IDREF</acronym> link to a <sgmltag>Footnote</sgmltag>.  It generates
the same mark or link as the <sgmltag>Footnote</sgmltag> to which it points.
</para>

<para>
In technical documentation, <sgmltag>FootnoteRef</sgmltag> occurs most frequently
in tables.
</para>

<refsect2><title>Processing expectations</title>
<para>
The <sgmltag>FootnoteRef</sgmltag> element usually generates the same mark
as the <sgmltag>Footnote</sgmltag> to which it points, although its mark can
be influenced by the <sgmltag class="attribute">Label</sgmltag> attribute.
</para>

<para>
Neither &SGML; nor &XML; provide a mechnism (at this time) for asserting
that some <acronym>IDREF</acronym> links must point to specific classes of elements.
If a <sgmltag>FootnoteRef</sgmltag> points to something other than a
<sgmltag>Footnote</sgmltag>, the parser will not report it as an error.
It is an error nonetheless. Processing is undefined.
</para>
</refsect2>



&footnoteref.parents.gen;
</refsect1>
<refsect1 condition='ref.elem.attrdesc'><title>Attributes</title>
<variablelist>
<varlistentry><term>label</term>
<listitem>
<para>
<sgmltag class='attribute'>Label</sgmltag> identifies the desired footnote mark.
</para>
</listitem>
</varlistentry>
<varlistentry><term>linkend</term>
<listitem>
<para>
<sgmltag class="attribute">Linkend</sgmltag> points to the 
<sgmltag>Footnote</sgmltag> referenced.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1><title>Examples</title>

<informalexample role="example-source">
<programlisting>&footnoteref.example.1.txt;</programlisting>
</informalexample>

<anchor id="ex.os.footnoteref.1" role="HACK-ex.out.start"/>
&footnoteref.example.1.gen;
<anchor id="ex.oe.footnoteref.1" role="HACK-ex.out.end"/>

&footnoteref.example.seealso.gen;
</refsect1>
</refentry>

