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

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

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

<para>
<sgmltag>RefEntry</sgmltag>s are small units of reference documentation
describing a single topic. The <sgmltag>RefName</sgmltag> identifies
the topic.  Often this is the name of the command or function
that the reference page describes.
</para>
<para>
Some reference pages describe a whole family of very closely related
commands or functions.  In this case, a <sgmltag>RefEntry</sgmltag> will
have multiple <sgmltag>RefName</sgmltag>s, one for each command or function.
When a <sgmltag>RefEntry</sgmltag> has several <sgmltag>RefName</sgmltag>s, it is
likely to have a <sgmltag>RefDescriptor</sgmltag> that identifies the 
whole family of functions.
</para>

<refsect2><title>Processing expectations</title>
<para>
&format.context;
</para>
<para>
Formatting reference pages may require a fairly sophisticated
processing system.  Much of the meta-information about a
reference page (its name, type, purpose, title, and
classification) is stored in wrappers near the beginning of
the <sgmltag>RefEntry</sgmltag>.
</para>
<para>
Common presentational features, such as titles and running
headers, may require data from several of these wrappers plus
some generated text. Other formatting often requires that
these elements be reordered.
</para>
</refsect2>

<refsect2 role='fu' revision="4.0"><title>&FutureChanges;</title>
<para>
<!--do not index this occurance-->
&fu.interfacedefinition;
</para>
</refsect2>


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

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

