Experimental support for xrefstyle

diff --git a/xsl/common/l10n.xsl b/xsl/common/l10n.xsl
index 768587f4374c5245c231c6f93ec70a114bcbc87c..70328af170a8d4646d51da54682978edec18b87d 100644 (file)
--- a/xsl/common/l10n.xsl
+++ b/xsl/common/l10n.xsl
@@ -272,6 +272,9 @@
 <xsl:template name="gentext.template">
   <xsl:param name="context" select="'default'"/>
   <xsl:param name="name" select="'default'"/>
+  <xsl:param name="purpose"/>
+  <xsl:param name="xrefstyle"/>
+  <xsl:param name="referrer"/>
   <xsl:param name="lang">
     <xsl:call-template name="l10n.language"/>
   </xsl:param>
@@ -309,10 +312,18 @@
   </xsl:if>
 
   <xsl:variable name="local.template.node"
-                select="$local.context.node/l:template[@name=$name][1]"/>
+                select="($local.context.node/l:template[@name=$name
+                                                        and @style
+                                                        and @style=$xrefstyle]
+                        |$local.context.node/l:template[@name=$name
+                                                        and not(@style)])[1]"/>
 
   <xsl:variable name="template.node"
-                select="$context.node/l:template[@name=$name][1]"/>
+                select="($context.node/l:template[@name=$name
+                                                  and @style
+                                                  and @style=$xrefstyle]
+                        |$context.node/l:template[@name=$name
+                                                  and not(@style)])[1]"/>
 
   <xsl:choose>
     <xsl:when test="$local.template.node">

diff --git a/xsl/fo/xref.xsl b/xsl/fo/xref.xsl
index 5cc8e070beb3d452528816f4966f31a735ca9886..5448fa3d10481f24266c14fc9eeebcd104e2aa5c 100644 (file)
--- a/xsl/fo/xref.xsl
+++ b/xsl/fo/xref.xsl
@@ -71,7 +71,19 @@
          </xsl:when>
 
           <xsl:otherwise>
-            <xsl:apply-templates select="$target" mode="xref-to"/>
+            <xsl:apply-templates select="$target" mode="xref-to">
+              <xsl:with-param name="referrer" select="."/>
+              <xsl:with-param name="xrefstyle">
+                <xsl:choose>
+                  <xsl:when test="$use.role.as.xrefstyle != 0">
+                    <xsl:value-of select="@role"/>
+                  </xsl:when>
+                  <xsl:otherwise>
+                    <xsl:value-of select="@xrefstyle"/>
+                  </xsl:otherwise>
+                </xsl:choose>
+              </xsl:with-param>
+            </xsl:apply-templates>
           </xsl:otherwise>
         </xsl:choose>
       </fo:basic-link>
@@ -87,26 +99,35 @@
 <!--- ==================================================================== -->
 
 <xsl:template match="*" mode="xref-to">
-  <xsl:param name="target" select="."/>
-  <xsl:param name="refelem" select="local-name($target)"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
 
   <xsl:message>
     <xsl:text>Don't know what gentext to create for xref to: "</xsl:text>
-    <xsl:value-of select="$refelem"/>
+    <xsl:value-of select="name(.)"/>
     <xsl:text>"</xsl:text>
   </xsl:message>
   <xsl:text>???</xsl:text>
 </xsl:template>
 
 <xsl:template match="title" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
   <!-- if you xref to a title, xref to the parent... -->
   <xsl:choose>
     <!-- FIXME: how reliable is this? -->
     <xsl:when test="contains(local-name(parent::*), 'info')">
-      <xsl:apply-templates select="parent::*[2]" mode="xref-to"/>
+      <xsl:apply-templates select="parent::*[2]" mode="xref-to">
+        <xsl:with-param name="referrer" select="$referrer"/>
+        <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+      </xsl:apply-templates>
     </xsl:when>
     <xsl:otherwise>
-      <xsl:apply-templates select="parent::*" mode="xref-to"/>
+      <xsl:apply-templates select="parent::*" mode="xref-to">
+        <xsl:with-param name="referrer" select="$referrer"/>
+        <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+      </xsl:apply-templates>
     </xsl:otherwise>
   </xsl:choose>
 </xsl:template>
@@ -119,67 +140,93 @@
                      |productionset|qandadiv|refsynopsisdiv|segmentedlist
                      |set|setindex|sidebar|tip|toc|variablelist|warning"
               mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
   <!-- catch-all for things with (possibly optional) titles -->
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="author|editor|othercredit|personname" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
   <xsl:call-template name="person.name"/>
 </xsl:template>
 
 <xsl:template match="authorgroup" mode="xref-to">
-  <xsl:call-template name="person.name.list"/>
-</xsl:template>
-
-<xsl:template match="figure" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
-</xsl:template>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
 
-<xsl:template match="example" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:call-template name="person.name.list"/>
 </xsl:template>
 
-<xsl:template match="table" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
-</xsl:template>
+<xsl:template match="figure|example|table|equation" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
 
-<xsl:template match="equation" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="procedure" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="cmdsynopsis" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
   <xsl:apply-templates select="(.//command)[1]" mode="xref"/>
 </xsl:template>
 
 <xsl:template match="funcsynopsis" mode="xref-to">
-  <xsl:apply-templates select="(.//function)[1]" mode="xref"/>
-</xsl:template>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
 
-<xsl:template match="dedication" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
-</xsl:template>
-
-<xsl:template match="preface" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:apply-templates select="(.//function)[1]" mode="xref"/>
 </xsl:template>
 
-<xsl:template match="chapter" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
-</xsl:template>
+<xsl:template match="dedication|preface|chapter|appendix" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
 
-<xsl:template match="appendix" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="bibliography" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="biblioentry|bibliomixed" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
   <!-- handles both biblioentry and bibliomixed -->
   <xsl:text>[</xsl:text>
   <xsl:choose>
@@ -224,58 +271,123 @@
 </xsl:template>
 
 <xsl:template match="glossary" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="index" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="listitem" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="section|simplesect
                      |sect1|sect2|sect3|sect4|sect5
                      |refsect1|refsect2|refsect3" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
   <!-- What about "in Chapter X"? -->
 </xsl:template>
 
 <xsl:template match="bridgehead" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
   <!-- What about "in Chapter X"? -->
 </xsl:template>
 
 <xsl:template match="qandaset" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="qandadiv" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="qandaentry" mode="xref-to">
-  <xsl:apply-templates select="question[1]" mode="object.xref.markup"/>
-</xsl:template>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
 
-<xsl:template match="question" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:apply-templates select="question[1]" mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
-<xsl:template match="answer" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
-</xsl:template>
+<xsl:template match="question|answer" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
 
-<xsl:template match="part" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
-<xsl:template match="reference" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+<xsl:template match="part|reference" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="refentry" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
   <xsl:choose>
     <xsl:when test="refmeta/refentrytitle">
       <xsl:apply-templates select="refmeta/refentrytitle"/>
@@ -288,14 +400,29 @@
 </xsl:template>
 
 <xsl:template match="refnamediv" mode="xref-to">
-  <xsl:apply-templates select="refname[1]" mode="xref-to"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="refname[1]" mode="xref-to">
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="refname" mode="xref-to">
-  <xsl:apply-templates mode="xref-to"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates mode="xref-to">
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="step" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
   <xsl:call-template name="gentext">
     <xsl:with-param name="key" select="'Step'"/>
   </xsl:call-template>
@@ -304,7 +431,13 @@
 </xsl:template>
 
 <xsl:template match="varlistentry" mode="xref-to">
-  <xsl:apply-templates select="term[1]" mode="xref-to"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="term[1]" mode="xref-to">
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="varlistentry/term" mode="xref-to">
@@ -313,11 +446,21 @@
 </xsl:template>
 
 <xsl:template match="co" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
   <xsl:apply-templates select="." mode="callout-bug"/>
 </xsl:template>
 
 <xsl:template match="book" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <!-- ==================================================================== -->
@@ -386,16 +529,49 @@
       </xsl:otherwise>
     </xsl:choose>
   </fo:basic-link>
+
   <xsl:if test="count(child::node()) != 0
                 and string(.) != @url
                 and $ulink.show != 0">
-    <fo:inline hyphenate="false">
-      <xsl:text> [</xsl:text>
-      <xsl:call-template name="hyphenate-url">
-        <xsl:with-param name="url" select="@url"/>
-      </xsl:call-template>
-      <xsl:text>]</xsl:text>
-    </fo:inline>
+    <!-- yes, show the URI -->
+    <xsl:choose>
+      <xsl:when test="$ulink.footnotes != 0 and not(ancestor::footnote)">
+        <xsl:variable name="ulink.fn.mark">
+          <fo:inline font-style="italic">
+            <!-- FIXME: this isn't going to be perfect! -->
+            <xsl:number level="any"
+                        from="chapter|appendix|preface|article|refentry"
+                        format="i"/>
+          </fo:inline>
+        </xsl:variable>
+
+        <fo:footnote>
+          <fo:inline baseline-shift="super" font-size="90%">
+            <xsl:copy-of select="$ulink.fn.mark"/>
+          </fo:inline>
+          <fo:footnote-body font-family="{$body.font.family}"
+                            font-size="{$footnote.font.size}">
+            <fo:block>
+              <fo:inline baseline-shift="super" font-size="90%">
+                <xsl:copy-of select="$ulink.fn.mark"/>
+              </fo:inline>
+              <fo:inline>
+                <xsl:value-of select="@url"/>
+              </fo:inline>
+            </fo:block>
+          </fo:footnote-body>
+        </fo:footnote>
+      </xsl:when>
+      <xsl:otherwise>
+        <fo:inline hyphenate="false">
+          <xsl:text> [</xsl:text>
+          <xsl:call-template name="hyphenate-url">
+            <xsl:with-param name="url" select="@url"/>
+          </xsl:call-template>
+          <xsl:text>]</xsl:text>
+        </fo:inline>
+      </xsl:otherwise>
+    </xsl:choose>
   </xsl:if>
 </xsl:template>
 
@@ -500,4 +676,63 @@
   <fo:page-number-citation ref-id="{@id}"/>
 </xsl:template>
 
+<!-- ==================================================================== -->
+
+<xsl:template match="*" mode="insert.title.markup">
+  <xsl:param name="purpose"/>
+  <xsl:param name="xrefstyle"/>
+  <xsl:param name="title"/>
+
+  <xsl:copy-of select="$title"/>
+</xsl:template>
+
+<xsl:template match="chapter" mode="insert.title.markup">
+  <xsl:param name="purpose"/>
+  <xsl:param name="xrefstyle"/>
+  <xsl:param name="title"/>
+
+  <xsl:choose>
+    <xsl:when test="$purpose = 'xref'">
+      <fo:inline font-style="italic">
+        <xsl:copy-of select="$title"/>
+      </fo:inline>
+    </xsl:when>
+    <xsl:otherwise>
+      <xsl:copy-of select="$title"/>
+    </xsl:otherwise>
+  </xsl:choose>
+</xsl:template>
+
+<xsl:template match="*" mode="insert.subtitle.markup">
+  <xsl:param name="purpose"/>
+  <xsl:param name="xrefstyle"/>
+  <xsl:param name="subtitle"/>
+
+  <xsl:copy-of select="$subtitle"/>
+</xsl:template>
+
+<xsl:template match="*" mode="insert.label.markup">
+  <xsl:param name="purpose"/>
+  <xsl:param name="xrefstyle"/>
+  <xsl:param name="label"/>
+
+  <xsl:copy-of select="$label"/>
+</xsl:template>
+
+<xsl:template match="*" mode="insert.pagenumber.markup">
+  <xsl:param name="purpose"/>
+  <xsl:param name="xrefstyle"/>
+  <xsl:param name="pagenumber"/>
+
+  <xsl:copy-of select="$pagenumber"/>
+</xsl:template>
+
+<xsl:template match="*" mode="insert.direction.markup">
+  <xsl:param name="purpose"/>
+  <xsl:param name="xrefstyle"/>
+  <xsl:param name="direction"/>
+
+  <xsl:copy-of select="$direction"/>
+</xsl:template>
+
 </xsl:stylesheet>

diff --git a/xsl/html/xref.xsl b/xsl/html/xref.xsl
index ff3e649ff8ec7254bd2df81f420954f4d427a45c..bd81ea00290cbcb8565223c380d9bfbe627948b5 100644 (file)
--- a/xsl/html/xref.xsl
+++ b/xsl/html/xref.xsl
@@ -94,7 +94,19 @@
                 <xsl:apply-templates select="$target" mode="xref-title"/>
               </xsl:attribute>
             </xsl:if>
-            <xsl:apply-templates select="$target" mode="xref-to"/>
+            <xsl:apply-templates select="$target" mode="xref-to">
+              <xsl:with-param name="referrer" select="."/>
+              <xsl:with-param name="xrefstyle">
+                <xsl:choose>
+                  <xsl:when test="$use.role.as.xrefstyle != 0">
+                    <xsl:value-of select="@role"/>
+                  </xsl:when>
+                  <xsl:otherwise>
+                    <xsl:value-of select="@xrefstyle"/>
+                  </xsl:otherwise>
+                </xsl:choose>
+              </xsl:with-param>
+            </xsl:apply-templates>
           </a>
 
           <xsl:apply-templates select="$target" mode="xref-to-suffix"/>
@@ -115,12 +127,12 @@
 <xsl:template match="*" mode="xref-to-suffix"/>
 
 <xsl:template match="*" mode="xref-to">
-  <xsl:param name="target" select="."/>
-  <xsl:param name="refelem" select="local-name($target)"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
 
   <xsl:message>
     <xsl:text>Don't know what gentext to create for xref to: "</xsl:text>
-    <xsl:value-of select="$refelem"/>
+    <xsl:value-of select="name(.)"/>
     <xsl:text>", ("</xsl:text>
     <xsl:value-of select="@id"/>
     <xsl:text>")</xsl:text>
@@ -129,14 +141,23 @@
 </xsl:template>
 
 <xsl:template match="title" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
   <!-- if you xref to a title, xref to the parent... -->
   <xsl:choose>
     <!-- FIXME: how reliable is this? -->
     <xsl:when test="contains(local-name(parent::*), 'info')">
-      <xsl:apply-templates select="parent::*[2]" mode="xref-to"/>
+      <xsl:apply-templates select="parent::*[2]" mode="xref-to">
+        <xsl:with-param name="referrer" select="$referrer"/>
+        <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+      </xsl:apply-templates>
     </xsl:when>
     <xsl:otherwise>
-      <xsl:apply-templates select="parent::*" mode="xref-to"/>
+      <xsl:apply-templates select="parent::*" mode="xref-to">
+        <xsl:with-param name="referrer" select="$referrer"/>
+        <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+      </xsl:apply-templates>
     </xsl:otherwise>
   </xsl:choose>
 </xsl:template>
@@ -149,36 +170,51 @@
                      |productionset|qandadiv|refsynopsisdiv|segmentedlist
                      |set|setindex|sidebar|tip|toc|variablelist|warning"
               mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
   <!-- catch-all for things with (possibly optional) titles -->
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="author|editor|othercredit|personname" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
   <xsl:call-template name="person.name"/>
 </xsl:template>
 
 <xsl:template match="authorgroup" mode="xref-to">
-  <xsl:call-template name="person.name.list"/>
-</xsl:template>
-
-<xsl:template match="figure" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
-</xsl:template>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
 
-<xsl:template match="example" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:call-template name="person.name.list"/>
 </xsl:template>
 
-<xsl:template match="table" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
-</xsl:template>
+<xsl:template match="figure|example|table|equation" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
 
-<xsl:template match="equation" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="procedure" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="cmdsynopsis" mode="xref-to">
@@ -189,28 +225,26 @@
   <xsl:apply-templates select="(.//function)[1]" mode="xref"/>
 </xsl:template>
 
-<xsl:template match="dedication" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
-</xsl:template>
-
-<xsl:template match="preface" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
-</xsl:template>
-
-<xsl:template match="article" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
-</xsl:template>
-
-<xsl:template match="chapter" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
-</xsl:template>
+<xsl:template match="dedication|preface|chapter|appendix|article" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
 
-<xsl:template match="appendix" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="bibliography" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="biblioentry|bibliomixed" mode="xref-to-prefix">
@@ -222,6 +256,9 @@
 </xsl:template>
 
 <xsl:template match="biblioentry|bibliomixed" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
   <!-- handles both biblioentry and bibliomixed -->
   <xsl:choose>
     <xsl:when test="string(.) = ''">
@@ -264,58 +301,123 @@
 </xsl:template>
 
 <xsl:template match="glossary" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="index" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="listitem" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="section|simplesect
                      |sect1|sect2|sect3|sect4|sect5
                      |refsect1|refsect2|refsect3" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
-  <!-- What about "in Chapter X"? -->
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
+  <!-- FIXME: What about "in Chapter X"? -->
 </xsl:template>
 
 <xsl:template match="bridgehead" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
-  <!-- What about "in Chapter X"? -->
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
+  <!-- FIXME: What about "in Chapter X"? -->
 </xsl:template>
 
 <xsl:template match="qandaset" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="qandadiv" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="qandaentry" mode="xref-to">
-  <xsl:apply-templates select="question[1]" mode="object.xref.markup"/>
-</xsl:template>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
 
-<xsl:template match="question" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:apply-templates select="question[1]" mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
-<xsl:template match="answer" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
-</xsl:template>
+<xsl:template match="question|answer" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
 
-<xsl:template match="part" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
-<xsl:template match="reference" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+<xsl:template match="part|reference" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="refentry" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
   <xsl:choose>
     <xsl:when test="refmeta/refentrytitle">
       <xsl:apply-templates select="refmeta/refentrytitle"/>
@@ -328,14 +430,26 @@
 </xsl:template>
 
 <xsl:template match="refnamediv" mode="xref-to">
-  <xsl:apply-templates select="refname[1]" mode="xref-to"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="refname[1]" mode="xref-to">
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="refname" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
   <xsl:apply-templates mode="xref-to"/>
 </xsl:template>
 
 <xsl:template match="step" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
   <xsl:call-template name="gentext">
     <xsl:with-param name="key" select="'Step'"/>
   </xsl:call-template>
@@ -344,20 +458,39 @@
 </xsl:template>
 
 <xsl:template match="varlistentry" mode="xref-to">
-  <xsl:apply-templates select="term[1]" mode="xref-to"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="term[1]" mode="xref-to">
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <xsl:template match="varlistentry/term" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
   <!-- to avoid the comma that will be generated if there are several terms -->
   <xsl:apply-templates/>
 </xsl:template>
 
 <xsl:template match="co" mode="xref-to">
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
   <xsl:apply-templates select="." mode="callout-bug"/>
 </xsl:template>
 
 <xsl:template match="book" mode="xref-to">
-  <xsl:apply-templates select="." mode="object.xref.markup"/>
+  <xsl:param name="referrer"/>
+  <xsl:param name="xrefstyle"/>
+
+  <xsl:apply-templates select="." mode="object.xref.markup">
+    <xsl:with-param name="purpose" select="'xref'"/>
+    <xsl:with-param name="xrefstyle" select="$xrefstyle"/>
+    <xsl:with-param name="referrer" select="$referrer"/>
+  </xsl:apply-templates>
 </xsl:template>
 
 <!-- ==================================================================== -->
@@ -689,4 +822,63 @@
   </xsl:message>
 </xsl:template>
 
+<!-- ==================================================================== -->
+
+<xsl:template match="*" mode="insert.title.markup">
+  <xsl:param name="purpose"/>
+  <xsl:param name="xrefstyle"/>
+  <xsl:param name="title"/>
+
+  <xsl:copy-of select="$title"/>
+</xsl:template>
+
+<xsl:template match="chapter" mode="insert.title.markup">
+  <xsl:param name="purpose"/>
+  <xsl:param name="xrefstyle"/>
+  <xsl:param name="title"/>
+
+  <xsl:choose>
+    <xsl:when test="$purpose = 'xref'">
+      <i>
+        <xsl:copy-of select="$title"/>
+      </i>
+    </xsl:when>
+    <xsl:otherwise>
+      <xsl:copy-of select="$title"/>
+    </xsl:otherwise>
+  </xsl:choose>
+</xsl:template>
+
+<xsl:template match="*" mode="insert.subtitle.markup">
+  <xsl:param name="purpose"/>
+  <xsl:param name="xrefstyle"/>
+  <xsl:param name="subtitle"/>
+
+  <xsl:copy-of select="$subtitle"/>
+</xsl:template>
+
+<xsl:template match="*" mode="insert.label.markup">
+  <xsl:param name="purpose"/>
+  <xsl:param name="xrefstyle"/>
+  <xsl:param name="label"/>
+
+  <xsl:copy-of select="$label"/>
+</xsl:template>
+
+<xsl:template match="*" mode="insert.pagenumber.markup">
+  <xsl:param name="purpose"/>
+  <xsl:param name="xrefstyle"/>
+  <xsl:param name="pagenumber"/>
+
+  <xsl:copy-of select="$pagenumber"/>
+</xsl:template>
+
+<xsl:template match="*" mode="insert.direction.markup">
+  <xsl:param name="purpose"/>
+  <xsl:param name="xrefstyle"/>
+  <xsl:param name="direction"/>
+
+  <xsl:copy-of select="$direction"/>
+</xsl:template>
+
 </xsl:stylesheet>