From: Michael Smith <xmldoc@users.sourceforge.net>
Date: Tue, 17 Jul 2007 13:52:28 +0000 (+0000)
Subject: Make pi.xsl files valid against our litprog grammar.
X-Git-Tag: release/1.79.1~6^2~1941
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=fa2ebdd92d6d2928352a6b587d3fb21a4f1f9789;p=docbook-dsssl

Make pi.xsl files valid against our litprog grammar.
---

diff --git a/xsl/common/pi.xsl b/xsl/common/pi.xsl
index 2233d34a5..5c3df8815 100644
--- a/xsl/common/pi.xsl
+++ b/xsl/common/pi.xsl
@@ -4,6 +4,7 @@
   xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
   xmlns:date="http://exslt.org/dates-and-times"
   xmlns:exsl="http://exslt.org/common"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
   exclude-result-prefixes="doc date exsl"
   extension-element-prefixes="date exsl"
   version='1.0'>
@@ -18,13 +19,11 @@
 
      ******************************************************************** -->
 
-<doc:reference xmlns="">
-  <info>
+<doc:reference xmlns=""><info><title>Common Processing Instruction Reference</title>
     <releaseinfo role="meta">
       $Id$
     </releaseinfo>
   </info>
-  <title>Common Processing Instruction Reference</title>
   <partintro id="partintro">
     <title>Introduction</title>
     <para>This is generated reference documentation for all
@@ -42,7 +41,7 @@
 </doc:reference>
 
 <!-- ==================================================================== -->
-<doc:template name="dbchoice_choice" xmlns="">
+<doc:pi name="dbchoice_choice" xmlns="">
   <refpurpose>Generates a localized choice separator</refpurpose>
   <refdescription id="select.choice.separator-desc">
     <para>Use the <tag class="xmlpi">dbchoice choice</tag> PI to
@@ -78,7 +77,7 @@
       </varlistentry>
     </variablelist>
   </refparameter>
-</doc:template>
+</doc:pi>
 <xsl:template name="pi.dbchoice_choice">
   <xsl:param name="node" select="."/>
   <xsl:call-template name="pi-attribute">
@@ -106,8 +105,8 @@
             output</para>
         <note>
           <para>For details of the content of the format string,
-            see <ulink role="tcg" url="Datetime.html"
-              >Date and time</ulink>.</para>
+            see <link role="tcg" xlink:href="Datetime.html"
+              >Date and time</link>.</para>
         </note>
         </listitem>
       </varlistentry>
@@ -206,9 +205,9 @@
     <para><parameter>tex.math.delims</parameter></para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="TexMath.html"
-        >DBTeXMath</ulink></para>
+    <para><link role="tcg"
+        xlink:href="TexMath.html"
+        >DBTeXMath</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbtex_delims">
diff --git a/xsl/fo/pi.xsl b/xsl/fo/pi.xsl
index 35eedbe58..9686e55a6 100644
--- a/xsl/fo/pi.xsl
+++ b/xsl/fo/pi.xsl
@@ -1,7 +1,9 @@
 <?xml version='1.0'?>
-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+<xsl:stylesheet
+  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
   xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
   xmlns:fo="http://www.w3.org/1999/XSL/Format"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
   exclude-result-prefixes="doc"
   version='1.0'>
 
@@ -15,13 +17,11 @@
 
      ******************************************************************** -->
 
-<doc:reference xmlns="">
-  <info>
+<doc:reference xmlns=""><info><title>FO Processing Instruction Reference</title>
     <releaseinfo role="meta">
       $Id$
     </releaseinfo>
   </info>
-  <title>FO Processing Instruction Reference</title>
 
   <partintro id="partintro">
     <title>Introduction</title>
@@ -64,9 +64,9 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="BGcolor.html"
-        >Background color</ulink></para>
+    <para><link role="tcg"
+        xlink:href="BGcolor.html"
+        >Background color</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo_background-color">
@@ -96,9 +96,9 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="BGtableColor.html#CellBGColor"
-        >Cell background color</ulink></para>
+    <para><link role="tcg"
+        xlink:href="BGtableColor.html#CellBGColor"
+        >Cell background color</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo_bgcolor">
@@ -137,8 +137,8 @@
     </para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink url="SideFloats.html#SidebarFloats" >A sidebar as
-        side float</ulink></para>
+    <para><link xlink:href="SideFloats.html#SidebarFloats" >A sidebar as
+        side float</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo_float-type">
@@ -176,8 +176,8 @@
     <para><parameter>glossary.as.blocks</parameter></para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink url="Glossaries.html#GlossaryFormatPrint" >Glossary
-        formatting in print</ulink></para>
+    <para><link xlink:href="Glossaries.html#GlossaryFormatPrint" >Glossary
+        formatting in print</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo_glossary-presentation">
@@ -215,8 +215,8 @@
     <para><parameter>glosslist.as.blocks</parameter> </para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink url="Glossaries.html#GlossaryFormatPrint" >Glossary
-        formatting in print</ulink></para>
+    <para><link xlink:href="Glossaries.html#GlossaryFormatPrint" >Glossary
+        formatting in print</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo_glosslist-presentation">
@@ -254,8 +254,8 @@
     </para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink url="Glossaries.html#GlossaryFormatPrint" >Glossary
-        formatting in print</ulink></para>
+    <para><link xlink:href="Glossaries.html#GlossaryFormatPrint" >Glossary
+        formatting in print</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo_glossterm-width">
@@ -298,8 +298,8 @@
     <para>formal.object.properties</para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink url="PageBreaking.html#KeepTogetherPI"
-        >Keep-together processing instruction</ulink></para>
+    <para><link xlink:href="PageBreaking.html#KeepTogetherPI"
+        >Keep-together processing instruction</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo_keep-together">
@@ -329,9 +329,9 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="QandAformat.html"
-        >Q and A formatting</ulink></para>
+    <para><link role="tcg"
+        xlink:href="QandAformat.html"
+        >Q and A formatting</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo_label-width">
@@ -368,9 +368,9 @@
     <para><parameter>linenumbering.everyNth</parameter></para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="AnnotateListing.html#LineNumbering"
-        >Line numbering</ulink></para>
+    <para><link role="tcg"
+        xlink:href="AnnotateListing.html#LineNumbering"
+        >Line numbering</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo_linenumbering.everyNth">
@@ -406,9 +406,9 @@
     <para><parameter>linenumbering.separator</parameter></para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="AnnotateListing.html#LineNumbering"
-        >Line numbering</ulink></para>
+    <para><link role="tcg"
+        xlink:href="AnnotateListing.html#LineNumbering"
+        >Line numbering</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo_linenumbering.separator">
@@ -444,9 +444,9 @@
     <para><parameter>linenumbering.width</parameter></para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="AnnotateListing.html#LineNumbering"
-        >Line numbering</ulink></para>
+    <para><link role="tcg"
+        xlink:href="AnnotateListing.html#LineNumbering"
+        >Line numbering</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo_linenumbering.width">
@@ -499,9 +499,9 @@
     </itemizedlist>
   </refsee>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="Variablelists.html#ListIndents"
-        >Variable list formatting in print</ulink></para>
+    <para><link role="tcg"
+        xlink:href="Variablelists.html#ListIndents"
+        >Variable list formatting in print</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo_list-presentation">
@@ -667,8 +667,8 @@
     </para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink url="SideFloats.html#SidebarFloats" >A sidebar as
-        side float</ulink></para>
+    <para><link xlink:href="SideFloats.html#SidebarFloats" >A sidebar as
+        side float</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo_sidebar-width">
@@ -704,9 +704,9 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="Orderedlists.html#ListStartNum"
-        >List starting number</ulink></para>
+    <para><link role="tcg"
+        xlink:href="Orderedlists.html#ListStartNum"
+        >List starting number</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo_start">
@@ -740,9 +740,9 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="Tables.html#TableWidth"
-        >Table width</ulink></para>
+    <para><link role="tcg"
+        xlink:href="Tables.html#TableWidth"
+        >Table width</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo_table-width">
@@ -773,9 +773,9 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="Variablelists.html#ListIndents"
-        >Variable list formatting in print</ulink></para>
+    <para><link role="tcg"
+        xlink:href="Variablelists.html#ListIndents"
+        >Variable list formatting in print</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo_term-width">
@@ -812,12 +812,12 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="QandAtoc.html"
-        >Q and A list of questions</ulink>,
-      <ulink role="tcg"
-        url="QandAformat.html"
-        >Q and A formatting</ulink></para>
+    <para><link role="tcg"
+        xlink:href="QandAtoc.html"
+        >Q and A list of questions</link>,
+      <link role="tcg"
+        xlink:href="QandAformat.html"
+        >Q and A formatting</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo_toc">
@@ -855,9 +855,9 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="PageBreaking.html#SoftPageBreaks"
-        >Soft page breaks</ulink></para>
+    <para><link role="tcg"
+        xlink:href="PageBreaking.html#SoftPageBreaks"
+        >Soft page breaks</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbfo-need">
diff --git a/xsl/html/pi.xsl b/xsl/html/pi.xsl
index b62d28f9f..b7fab1fc0 100644
--- a/xsl/html/pi.xsl
+++ b/xsl/html/pi.xsl
@@ -1,6 +1,7 @@
 <?xml version='1.0'?>
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
                 xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
+                xmlns:xlink="http://www.w3.org/1999/xlink"
                 exclude-result-prefixes="doc"
                 version='1.0'>
 
@@ -59,9 +60,9 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="BGcolor.html"
-        >Background color</ulink></para>
+    <para><link role="tcg"
+        xlink:href="BGcolor.html"
+        >Background color</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_background-color">
@@ -91,9 +92,9 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="BGtableColor.html#CellBGColor"
-        >Cell background color</ulink></para>
+    <para><link role="tcg"
+        xlink:href="BGtableColor.html#CellBGColor"
+        >Cell background color</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_bgcolor">
@@ -129,11 +130,11 @@
     <para><parameter>html.cellpadding</parameter></para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="CellSpacing.html"
-        >Cell spacing and cell padding</ulink>,
-      <ulink role="tcg" url="QandAformat.html"
-        >Q and A formatting</ulink></para>
+    <para><link role="tcg"
+        xlink:href="CellSpacing.html"
+        >Cell spacing and cell padding</link>,
+      <link role="tcg" xlink:href="QandAformat.html"
+        >Q and A formatting</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_cellpadding">
@@ -169,12 +170,12 @@
     <para><parameter>html.cellspacing</parameter></para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="CellSpacing.html"
-        >Cell spacing and cell padding</ulink>,
-      <ulink role="tcg"
-        url="QandAformat.html"
-        >Q and A formatting</ulink></para>
+    <para><link role="tcg"
+        xlink:href="CellSpacing.html"
+        >Cell spacing and cell padding</link>,
+      <link role="tcg"
+        xlink:href="QandAformat.html"
+        >Q and A formatting</link></para>
     </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_cellspacing">
@@ -205,9 +206,9 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="CSSTableCells.html"
-        >Table styles in HTML output</ulink></para>
+    <para><link role="tcg"
+        xlink:href="CSSTableCells.html"
+        >Table styles in HTML output</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_class">
@@ -244,9 +245,9 @@
     <para><parameter>base.dir</parameter></para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="Chunking.html#dbhtmlDirPI"
-        >dbhtml dir processing instruction</ulink></para>
+    <para><link role="tcg"
+        xlink:href="Chunking.html#dbhtmlDirPI"
+        >dbhtml dir processing instruction</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_dir">
@@ -280,9 +281,9 @@
     <para><parameter>use.id.as.filename</parameter></para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="Chunking.html#DbhtmlFilenames"
-        >dbhtml filenames</ulink></para>
+    <para><link role="tcg"
+        xlink:href="Chunking.html#DbhtmlFilenames"
+        >dbhtml filenames</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_filename">
@@ -358,9 +359,9 @@
     <para><parameter>img.src.path</parameter></para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="GraphicsLocations.html#UsingFileref"
-        >Using fileref</ulink></para>
+    <para><link role="tcg"
+        xlink:href="GraphicsLocations.html#UsingFileref"
+        >Using fileref</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_img.src.path">
@@ -390,9 +391,9 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="QandAformat.html"
-        >Q and A formatting</ulink></para>
+    <para><link role="tcg"
+        xlink:href="QandAformat.html"
+        >Q and A formatting</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_label-width">
@@ -429,9 +430,9 @@
     <para><parameter>linenumbering.everyNth</parameter></para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="AnnotateListing.html#LineNumbering"
-        >Line numbering</ulink></para>
+    <para><link role="tcg"
+        xlink:href="AnnotateListing.html#LineNumbering"
+        >Line numbering</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_linenumbering.everyNth">
@@ -467,9 +468,9 @@
     <para><parameter>linenumbering.separator</parameter></para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="AnnotateListing.html#LineNumbering"
-        >Line numbering</ulink></para>
+    <para><link role="tcg"
+        xlink:href="AnnotateListing.html#LineNumbering"
+        >Line numbering</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_linenumbering.separator">
@@ -505,9 +506,9 @@
     <para><parameter>linenumbering.width</parameter></para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="AnnotateListing.html#LineNumbering"
-        >Line numbering</ulink></para>
+    <para><link role="tcg"
+        xlink:href="AnnotateListing.html#LineNumbering"
+        >Line numbering</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_linenumbering.width">
@@ -555,9 +556,9 @@
     </itemizedlist>
   </refsee>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="Variablelists.html#VarListFormatting"
-        >Variable list formatting in HTML</ulink></para>
+    <para><link role="tcg"
+        xlink:href="Variablelists.html#VarListFormatting"
+        >Variable list formatting in HTML</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_list-presentation">
@@ -588,9 +589,9 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="Variablelists.html#VarListFormatting"
-        >Variable list formatting in HTML</ulink></para>
+    <para><link role="tcg"
+        xlink:href="Variablelists.html#VarListFormatting"
+        >Variable list formatting in HTML</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_list-width">
@@ -620,9 +621,9 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="RowHeight.html"
-        >Row height</ulink></para>
+    <para><link role="tcg"
+        xlink:href="RowHeight.html"
+        >Row height</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_row-height">
@@ -658,9 +659,9 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="Orderedlists.html#ListStartNum"
-        >List starting number</ulink></para>
+    <para><link role="tcg"
+        xlink:href="Orderedlists.html#ListStartNum"
+        >List starting number</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_start">
@@ -695,11 +696,11 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="Variablelists.html#VarListFormatting"
-        >Variable list formatting in HTML</ulink>,
-      <ulink role="tcg" url="TableSummary.html"
-        >Table summary text</ulink></para>
+    <para><link role="tcg"
+        xlink:href="Variablelists.html#VarListFormatting"
+        >Variable list formatting in HTML</link>,
+      <link role="tcg" xlink:href="TableSummary.html"
+        >Table summary text</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_table-summary">
@@ -733,9 +734,9 @@
     <para><parameter>default.table.width</parameter></para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="Tables.html#TableWidth"
-        >Table width</ulink></para>
+    <para><link role="tcg"
+        xlink:href="Tables.html#TableWidth"
+        >Table width</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_table-width">
@@ -776,9 +777,9 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="Variablelists.html#VarListFormatting"
-        >Variable list formatting in HTML</ulink></para>
+    <para><link role="tcg"
+        xlink:href="Variablelists.html#VarListFormatting"
+        >Variable list formatting in HTML</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_term-presentation">
@@ -813,9 +814,9 @@
     <para><parameter>variablelist.term.separator</parameter></para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="Variablelists.html#VarListFormatting"
-        >Variable list formatting in HTML</ulink></para>
+    <para><link role="tcg"
+        xlink:href="Variablelists.html#VarListFormatting"
+        >Variable list formatting in HTML</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_term-separator">
@@ -846,9 +847,9 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="Variablelists.html#VarListFormatting"
-        >Variable list formatting in HTML</ulink></para>
+    <para><link role="tcg"
+        xlink:href="Variablelists.html#VarListFormatting"
+        >Variable list formatting in HTML</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_term-width">
@@ -885,12 +886,12 @@
     </variablelist>
   </refparameter>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="QandAtoc.html"
-        >Q and A list of questions</ulink>,
-      <ulink role="tcg"
-        url="QandAformat.html"
-        >Q and A formatting</ulink></para>
+    <para><link role="tcg"
+        xlink:href="QandAtoc.html"
+        >Q and A list of questions</link>,
+      <link role="tcg"
+        xlink:href="QandAformat.html"
+        >Q and A formatting</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml_toc">
@@ -1009,12 +1010,12 @@
     <para><parameter>textinsert.extension</parameter></para>
   </refsee>
   <refsee role="tcg">
-    <para><ulink role="tcg"
-        url="InsertExtHtml.html"
-        >Inserting external HTML code</ulink>,
-      <ulink
-        url="ExternalCode.html"
-        >External code files</ulink></para>
+    <para><link role="tcg"
+        xlink:href="InsertExtHtml.html"
+        >Inserting external HTML code</link>,
+      <link
+        xlink:href="ExternalCode.html"
+        >External code files</link></para>
   </refsee>
 </doc:pi>
 <xsl:template name="pi.dbhtml-include">