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

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

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

<para><sgmltag>BiblioMSet</sgmltag> is a <quote>cooked</quote> wrapper for a
collection of bibliographic information.
</para>

<para>
The purpose of this wrapper is
to assert the relationship that binds the collection.  For example, in a
<sgmltag>BiblioMixed</sgmltag> entry for an article in a journal, you might
use two <sgmltag>BiblioMSet</sgmltag>s to wrap the fields related to the article
and the fields related to the journal.
</para>

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

<para>
<sgmltag>BiblioMSet</sgmltag>s are <quote>cooked.</quote> In
addition to named fields, they can contain interspersed <literal>#PCDATA</literal>
to provide punctuation and other formatting information.
</para>

<para>
The processing
system is generally expected to present each and every element in the set,
all interspersed <literal>#PCDATA</literal>, in the order in which it 
occurs.
</para>
</refsect2>

<refsect2 role='fu' revision="4.0"><title>&FutureChanges;</title>
<para>
<indexterm><primary>DocBook DTD</primary><secondary>Changes for <acronym>V4.0</acronym></secondary>
</indexterm>
<sgmltag>AuthorBlurb</sgmltag> and <sgmltag>Affiliation</sgmltag> will be removed
from the inline content of <sgmltag>BiblioMSet</sgmltag> in DocBook <acronym>V4.0</acronym>.
A new wrapper element will be created to associate this information with
authors, editors, and other contributors.
</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>
<sgmltag>BiblioSet</sgmltag> will be removed from the content model of
<sgmltag>BiblioMSet</sgmltag>.  Allowing a <quote>raw</quote> container inside
a <quote>cooked</quote> one confuses processing expectations.
</para>
</refsect2>


&bibliomset.parents.gen;
&bibliomset.children.gen;
</refsect1>
<refsect1 condition='ref.elem.attrdesc'><title>Attributes</title>
<variablelist>
<varlistentry><term>relation</term>
<listitem>
<para>
<sgmltag class="attribute">Relation</sgmltag> identifies the relationship between
the various elements in the <sgmltag>BiblioMSet</sgmltag>.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 condition='ref.elem.seealso'><title>See Also</title>
&bibliomset.seealso.gen;
</refsect1>
<refsect1><title>Examples</title>

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

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

