--- /dev/null
+<refentry xmlns="http://docbook.org/ns/docbook"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:xi="http://www.w3.org/2001/XInclude"
+ xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ version="5.0" xml: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>insert.xref.page.number.para</refname>
+<refpurpose>Turns page numbers in xrefs to paragraphs on and off</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<src:fragment xml:id="insert.xref.page.number.para.frag">
+<xsl:param name="insert.xref.page.number.para">yes</xsl:param>
+</src:fragment>
+</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>
+