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

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

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

<para>
A set of keywords, provided by the author, editor, publisher, and so on, can
be stored in the document meta-information in a <sgmltag>KeywordSet</sgmltag>.
</para>

<para>
Keywords can form an important part of an automated indexing or searching
strategy for a collection of documents.
</para>

<refsect2><title>Processing expectations</title>
<para>
&format.context;  Keywords are rarely displayed to a reader. Usually, they
are reserved for searching and retrieval purposes.
</para>
<para>
Unlike <sgmltag>SubjectTerm</sgmltag>s, which should be drawn from a
controlled vocabulary, keywords may be chosen freely.
</para>

<para>
Although more than one <sgmltag>KeywordSet</sgmltag> may appear in the
meta-information for a document, neither a relationship nor a specific
facility for constructing a relationship is defined by DocBook.
</para>

<para>
Additionally, no relationship is defined between the
<sgmltag>KeywordSet</sgmltag>s of a document component and the
<sgmltag>KeywordSet</sgmltag>s of its parents or children.
</para>
</refsect2>


&keywordset.parents.gen;
&keywordset.children.gen;
</refsect1>
<refsect1 condition='ref.elem.seealso'><title>See Also</title>
&keywordset.seealso.gen;
</refsect1>
<refsect1><title>Examples</title>

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

