<refentry id="insert.xref.page.number.para">

  <refmeta>

    <refentrytitle>insert.xref.page.number.para</refentrytitle>

    <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> 

    <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>

    <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>

  </refmeta>

  <refnamediv>

    <refname><parameter>insert.xref.page.number.para</parameter></refname>

    <refpurpose>Turns page numbers in xrefs to paragraphs on and

    off</refpurpose>

  </refnamediv>

  <refsynopsisdiv>

    <programlisting><xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="text" href="syn/insert.xref.page.number.para.xml"/></programlisting>

  </refsynopsisdiv>

  <refsection><info><title>Description</title></info>

  <para>The value of this parameter determines if

  cross references (<tag>xref</tag>s) to paragraphs in

  printed output will include page number citations.

  </para>

  <para>Historically, cross references to paragraphs

  included page number citations unconditionally, regardless

  of the <parameter>insert.xref.page.number</parameter>

  value.</para>

  <variablelist>

  <varlistentry>

  <term>yes</term>

  <listitem><para>Page number references will be generated

  for paragraphs.</para></listitem>

  </varlistentry>

  <varlistentry>

  <term>maybe</term>

  <listitem><para>Whether page number references are generated

  for an <tag>xref</tag> element referring to a paragraph will

  be controlled by the <parameter>insert.xref.page.number</parameter>

  rules.</para></listitem>

  </varlistentry>

  </variablelist>

  </refsection>

</refentry>