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

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

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

<para>
An <sgmltag>AreaSet</sgmltag> contains one or more <sgmltag>Area</sgmltag>s.  These
areas are bound in a set in order to associate them with a single
<sgmltag>Callout</sgmltag> description.  See <sgmltag>Area</sgmltag> for a more
complete description of the areas.
</para>

<para>
For a complete description of callouts, see <sgmltag>Callout</sgmltag>.
</para>

<refsect2><title>Processing expectations</title>
<para>
&format.suppress;
</para>
</refsect2>

<refsect2 role='fu' revision="5.0"><title>&FutureChanges;</title>
<para>
<indexterm><primary>DocBook DTD</primary><secondary>Changes for <acronym>V5.0</acronym></secondary>
</indexterm>
The <sgmltag class='attribute'>Coords</sgmltag> attribute will
be removed in DocBook <acronym>V5.0</acronym>.
</para>
</refsect2>


&areaset.parents.gen;
&areaset.children.gen;
</refsect1>
<refsect1 condition='ref.elem.attrdesc'><title>Attributes</title>
<variablelist>
<varlistentry><term>coords</term>
<listitem>
<para>
<sgmltag class="attribute">Coords</sgmltag> provides the coordinates of the
<sgmltag>AreaSet</sgmltag>. The coordinates should be interpreted using the
<sgmltag class="attribute">Units</sgmltag> (or <sgmltag class="attribute">OtherUnits</sgmltag>)
specified. <emphasis>This attribute is erroneous since the enclosed
<sgmltag>Area</sgmltag>s must also provide <sgmltag class="attribute">Coords</sgmltag>.
It will go away in DocBook 4.0.</emphasis>
</para>
</listitem>
</varlistentry>
<varlistentry><term>label</term>
<listitem>
<para>
<sgmltag class='attribute'>Label</sgmltag> specifies an identifying number or string
that may be used in presentation.
</para>
</listitem>
</varlistentry>
<varlistentry><term>otherunits</term>
<listitem>
<para>
If none of the <sgmltag class="attribute">Units</sgmltag> are applicable, set
<sgmltag class="attribute">Units</sgmltag> to <literal>Other</literal> and set 
<sgmltag class="attribute">OtherUnits</sgmltag> to some application-specific
description of the desired units.
</para>
</listitem>
</varlistentry>
<varlistentry><term>units</term>
<listitem>
<para>
<sgmltag class="attribute">Units</sgmltag> indicate how
<sgmltag class="attribute">Coords</sgmltag> are to be interpreted.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1><title>Examples</title>

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

