<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<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>