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

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

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

<para>
This element is a wrapper around the contents of a footnote.
</para>
<para>Additional references to the same
footnote may be generated with <sgmltag>FootnoteRef</sgmltag>.
</para>

<refsect2><title>Processing expectations</title>
<para>
The <sgmltag>Footnote</sgmltag> element usually generates a mark (a superscript
symbol or number) at the place in the
flow of the document in which it occurs.  The body of the footnote is then
presented elsewhere, typically at the bottom of the page.
</para>

<para>
Alternative presentations are also possible.  In print environments that
do not support footnotes at the bottom of the page, they may be presented
as end notes occurring at the end of the component that contains the
<sgmltag>Footnote</sgmltag>.  Online systems may choose to present them inline
or as <quote>pop-ups,</quote> or links, or any combination thereof.
</para>
</refsect2>




&footnote.parents.gen;
&footnote.children.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>
</variablelist>
</refsect1>
<refsect1><title>Examples</title>

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

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

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

