<refentry id="bibliocoverage.element" revision='4.2'>
<?dbhtml filename="bibliocoverage.html"?>
<refentryinfo>
<pubdate>$Date$</pubdate>
<releaseinfo>$Revision$</releaseinfo>
</refentryinfo>

<refmeta>
<indexterm><primary>elements</primary>
<secondary>bibliocoverage</secondary></indexterm>
<refentrytitle>bibliocoverage</refentrytitle>
<refmiscinfo>Element</refmiscinfo>
</refmeta>

<refnamediv>
<refname>bibliocoverage</refname>
<refpurpose>&bibliocoverage.purpose;</refpurpose>
</refnamediv>

&bibliocoverage.synopsis.gen;

<refsect1 condition='ref.description'><title>Description</title>

<para>The <sgmltag>bibliocoverage</sgmltag> element satisfies coverage
element of the <ulink url="http://dublincore.org/">Dublin Core
Metadata Initiative</ulink>.</para>

<para>The Dublin Core defines coverage as <quote>the
extent or scope of the content of the resource.</quote> It goes on
to say:</para>

<blockquote>
<para>Coverage will typically include spatial location (a place name
or geographic coordinates), temporal period (a period label,
date, or date range) or jurisdiction (such as a named
administrative entity).
</para>
<para>Recommended best practice is to select a value from a
controlled vocabulary (for example, the
<ulink url="http://www.getty.edu/research/tools/vocabulary/tgn/">Thesaurus of Geographic
Names</ulink> [TGN]) and that, where appropriate, named places or time
periods be used in preference to numeric identifiers such as
sets of coordinates or date ranges.
</para>
</blockquote>

<para>DocBook 4.2 added <sgmltag>bibliocoverage</sgmltag>,
<sgmltag>bibliorelation</sgmltag>, and
<sgmltag>bibliosource</sgmltag> to make the DocBook meta-information wrappers
a complete superset of the Dublin Core.</para>

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

<para>This element is used for both spatial and temporal coverage, but the intent
is that only one is specified at a time. In other words, on any given instance
of the <sgmltag>bibliocoverage</sgmltag> element, specify either
a <sgmltag class="attribute">spatial</sgmltag> or a 
<sgmltag class="attribute">temporal</sgmltag> encoding, but not both.</para>

</refsect2>

&bibliocoverage.parents.gen;
&bibliocoverage.children.gen;

</refsect1>

<refsect1 condition='ref.elem.attrdesc'><title>Attributes</title>
<variablelist>
<varlistentry><term>spatial</term>
<listitem>
<para>Identifies the encoding scheme for the supplied spatial identifier.
See the <ulink url="http://dublincore.org/documents/dcmes-qualifiers/">Dublin
Core Qualifiers</ulink> for details about the meaning of each encoding.
</para>
</listitem>
</varlistentry>
<varlistentry><term>otherspatial</term>
<listitem>
<para>Used to identify the encoding scheme when
<sgmltag class="attribute">spatial</sgmltag> is set to
<literal>otherspatial</literal>.</para>
</listitem>
</varlistentry>
<varlistentry><term>temporal</term>
<listitem>
<para>Identifies the encoding scheme for the supplied temporal identifier.
See the <ulink url="http://dublincore.org/documents/dcmes-qualifiers/">Dublin
Core Qualifiers</ulink> for details about the meaning of each encoding.
</para>
</listitem>
</varlistentry>
<varlistentry><term>othertemporal</term>
<listitem>
<para>Used to identify the encoding scheme when
<sgmltag class="attribute">temporal</sgmltag> is set to
<literal>othertemporal</literal>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
</refentry>

