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

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

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

<para>
Meta-information for a Book.
</para>

<refsect2><title>Processing expectations</title>
<para>
&format.suppress; Many of the elements in this wrapper may be
used in presentation, but they are not generally printed as part
of the formatting of the wrapper. It merely serves to identify
where they occur.
</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>BookInfo</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>
<para>
<sgmltag>BookBiblio</sgmltag> will be discarded.
</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">contents</sgmltag> attribute will be
removed.
</para>
</refsect2>

&bookinfo.parents.gen;
&bookinfo.children.gen;
</refsect1>
<refsect1 condition='ref.elem.attrdesc'><title>Attributes</title>
<variablelist>
<varlistentry><term>contents</term>
<listitem>
<para>
<sgmltag class="attribute">Contents</sgmltag>, if specified, should contain a list
of all the IDs of the chapter-level subelements of the <sgmltag>Book</sgmltag>,
in their natural order.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 condition='ref.elem.seealso'><title>See Also</title>
&bookinfo.seealso.gen;
</refsect1>
<refsect1><title>Examples</title>

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

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

