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

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

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

<para>
The <sgmltag>BeginPage</sgmltag> element marks the location of an
actual page break in a print version of the document, as opposed
to where a page break might appear in a further rendition of the
document.  This information may be used, for example, to allow
support staff using an online system to coordinate with a user
referring to a page number in a printed manual.
</para>

<refsect2><title>Processing expectations</title>
<para>
The break identified by <sgmltag>BeginPage</sgmltag> may be displayed
in an online version of the document or used for legacy
purposes, but it is not expected to cause a page
break when the document is processed by an &SGML; system.
</para>
</refsect2>



&beginpage.parents.gen;
</refsect1>
<refsect1 condition='ref.elem.attrdesc'><title>Attributes</title>
<variablelist>
<varlistentry><term>pagenum</term>
<listitem>
<para>
<sgmltag class="attribute">PageNum</sgmltag> contains the page number of the page
in the printed document which begins at the location of the 
<sgmltag>BeginPage</sgmltag> element.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1><title>Examples</title>

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

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

