Added IDs in a bunch of places in embedded template docs that

could use them.

diff --git a/xsl/common/common.xsl b/xsl/common/common.xsl
index cc1e630ad0ac0d3842469b78a2dd08c3a8ff8b5f..573ad733b3c57460f525bdf4bb4c65ee85a6b0d7 100644 (file)
--- a/xsl/common/common.xsl
+++ b/xsl/common/common.xsl
@@ -25,7 +25,7 @@ $Id$
 </releaseinfo>
 <author><surname>Walsh</surname>
 <firstname>Norman</firstname></author>
-<copyright><year>1999</year><year>2007</year>
+<copyright><year>1999-2007</year>
 <holder>Norman Walsh</holder>
 </copyright>
 </referenceinfo>
@@ -98,12 +98,12 @@ manvolnum
 <doc:template name="is.component" xmlns="">
 <refpurpose>Tests if a given node is a component-level element</refpurpose>
 
-<refdescription>
+<refdescription id="is.component-desc">
 <para>This template returns '1' if the specified node is a component
 (Chapter, Appendix, etc.), and '0' otherwise.</para>
 </refdescription>
 
-<refparameter>
+<refparameter id="is.component-params">
 <variablelist>
 <varlistentry><term>node</term>
 <listitem>
@@ -113,7 +113,7 @@ manvolnum
 </variablelist>
 </refparameter>
 
-<refreturn>
+<refreturn id="is.component-returns">
 <para>This template returns '1' if the specified node is a component
 (Chapter, Appendix, etc.), and '0' otherwise.</para>
 </refreturn>
@@ -138,12 +138,12 @@ manvolnum
 <doc:template name="is.section" xmlns="">
 <refpurpose>Tests if a given node is a section-level element</refpurpose>
 
-<refdescription>
+<refdescription id="is.section-desc">
 <para>This template returns '1' if the specified node is a section
 (Section, Sect1, Sect2, etc.), and '0' otherwise.</para>
 </refdescription>
 
-<refparameter>
+<refparameter id="is.section-params">
 <variablelist>
 <varlistentry><term>node</term>
 <listitem>
@@ -153,7 +153,7 @@ manvolnum
 </variablelist>
 </refparameter>
 
-<refreturn>
+<refreturn id="is.section-returns">
 <para>This template returns '1' if the specified node is a section
 (Section, Sect1, Sect2, etc.), and '0' otherwise.</para>
 </refreturn>
@@ -181,7 +181,7 @@ manvolnum
 <doc:template name="section.level" xmlns="">
 <refpurpose>Returns the hierarchical level of a section</refpurpose>
 
-<refdescription>
+<refdescription id="section.level-desc">
 <para>This template calculates the hierarchical level of a section.
 The element <sgmltag>sect1</sgmltag> is at level 1, <sgmltag>sect2</sgmltag> is
 at level 2, etc.</para>
@@ -189,7 +189,7 @@ at level 2, etc.</para>
 <para>Recursive sections are calculated down to the fifth level.</para>
 </refdescription>
 
-<refparameter>
+<refparameter id="section.level-params">
 <variablelist>
 <varlistentry><term>node</term>
 <listitem>
@@ -200,7 +200,7 @@ Defaults to the context node.</para>
 </variablelist>
 </refparameter>
 
-<refreturn>
+<refreturn id="section.level-returns">
 <para>The section level, <quote>1</quote>, <quote>2</quote>, etc.
 </para>
 </refreturn>
@@ -258,12 +258,12 @@ Defaults to the context node.</para>
 <doc:template name="qanda.section.level" xmlns="">
 <refpurpose>Returns the hierarchical level of a QandASet</refpurpose>
 
-<refdescription>
+<refdescription id="qanda.section.level-desc">
 <para>This template calculates the hierarchical level of a QandASet.
 </para>
 </refdescription>
 
-<refreturn>
+<refreturn id="qanda.section.level-returns">
 <para>The level, <quote>1</quote>, <quote>2</quote>, etc.
 </para>
 </refreturn>
@@ -827,7 +827,7 @@ Defaults to the context node.</para>
 <doc:template name="select.mediaobject" xmlns="">
 <refpurpose>Selects and processes an appropriate media object from a list</refpurpose>
 
-<refdescription>
+<refdescription id="select.mediaobject-desc">
 <para>This template takes a list of media objects (usually the
 children of a mediaobject or inlinemediaobject) and processes
 the "right" object.</para>
@@ -839,7 +839,7 @@ in the list is appropriate.</para>
 <para>If no acceptable object is located, nothing happens.</para>
 </refdescription>
 
-<refparameter>
+<refparameter id="select.mediaobject-params">
 <variablelist>
 <varlistentry><term>olist</term>
 <listitem>
@@ -849,7 +849,7 @@ in the list is appropriate.</para>
 </variablelist>
 </refparameter>
 
-<refreturn>
+<refreturn id="select.mediaobject-returns">
 <para>Calls &lt;xsl:apply-templates&gt; on the selected object.</para>
 </refreturn>
 </doc:template>
@@ -876,7 +876,7 @@ in the list is appropriate.</para>
 <doc:template name="select.mediaobject.index" xmlns="">
 <refpurpose>Selects the position of the appropriate media object from a list</refpurpose>
 
-<refdescription>
+<refdescription id="select.mediaobject.index-desc">
 <para>This template takes a list of media objects (usually the
 children of a mediaobject or inlinemediaobject) and determines
 the "right" object. It returns the position of that object
@@ -896,7 +896,7 @@ of media objects is that the first acceptable graphic should be used.
 <para>If no acceptable object is located, no index is returned.</para>
 </refdescription>
 
-<refparameter>
+<refparameter id="select.mediaobject.index-params">
 <variablelist>
 <varlistentry><term>olist</term>
 <listitem>
@@ -912,7 +912,7 @@ recursive process.</para>
 </variablelist>
 </refparameter>
 
-<refreturn>
+<refreturn id="select.mediaobject.index-returns">
 <para>Returns the position in the original list of the selected object.</para>
 </refreturn>
 </doc:template>
@@ -1044,12 +1044,12 @@ recursive process.</para>
 <doc:template name="is.acceptable.mediaobject" xmlns="">
 <refpurpose>Returns '1' if the specified media object is recognized</refpurpose>
 
-<refdescription>
+<refdescription id="is.acceptable.mediaobject-desc">
 <para>This template examines a media object and returns '1' if the
 object is recognized as a graphic.</para>
 </refdescription>
 
-<refparameter>
+<refparameter id="is.acceptable.mediaobject-params">
 <variablelist>
 <varlistentry><term>object</term>
 <listitem>
@@ -1059,7 +1059,7 @@ object is recognized as a graphic.</para>
 </variablelist>
 </refparameter>
 
-<refreturn>
+<refreturn id="is.acceptable.mediaobject-returns">
 <para>0 or 1</para>
 </refreturn>
 </doc:template>
@@ -1190,7 +1190,7 @@ object is recognized as a graphic.</para>
 
 <doc:template name="check.id.unique" xmlns="">
 <refpurpose>Warn users about references to non-unique IDs</refpurpose>
-<refdescription>
+<refdescription id="check.id.unique-desc">
 <para>If passed an ID in <varname>linkend</varname>,
 <function>check.id.unique</function> prints
 a warning message to the user if either the ID does not exist or
@@ -1230,7 +1230,7 @@ the ID is not unique.</para>
 
 <doc:template name="check.idref.targets" xmlns="">
 <refpurpose>Warn users about incorrectly typed references</refpurpose>
-<refdescription>
+<refdescription id="check.idref.targets-desc">
 <para>If passed an ID in <varname>linkend</varname>,
 <function>check.idref.targets</function> makes sure that the element
 pointed to by the link is one of the elements listed in
@@ -1486,7 +1486,7 @@ pointed to by the link is one of the elements listed in
 <doc:template name="copyright.years" xmlns="">
 <refpurpose>Print a set of years with collapsed ranges</refpurpose>
 
-<refdescription>
+<refdescription id="copyright.years-desc">
 <para>This template prints a list of year elements with consecutive
 years printed as a range. In other words:</para>
 
@@ -1508,7 +1508,7 @@ are expressed in full <quote>century+year</quote>
 (<quote>1999</quote> not <quote>99</quote>) notation.</para>
 </refdescription>
 
-<refparameter>
+<refparameter id="copyright.years-params">
 <variablelist>
 <varlistentry><term>years</term>
 <listitem>
@@ -1532,7 +1532,7 @@ year range is <quote>1991-1992</quote> but discretely it's
 </variablelist>
 </refparameter>
 
-<refreturn>
+<refreturn id="copyright.years-returns">
 <para>This template returns the formatted list of years.</para>
 </refreturn>
 </doc:template>
@@ -1664,7 +1664,7 @@ year range is <quote>1991-1992</quote> but discretely it's
 <doc:template name="find.path.params" xmlns="">
 <refpurpose>Search in a table for the "best" match for the node</refpurpose>
 
-<refdescription>
+<refdescription id="find.path.params-desc">
 <para>This template searches in a table for the value that most-closely
 (in the typical best-match sense of XSLT) matches the current (element)
 node location.</para>
@@ -1814,7 +1814,7 @@ node location.</para>
 <doc:template name="string.upper" xmlns="">
 <refpurpose>Converts a string to all uppercase letters</refpurpose>
 
-<refdescription>
+<refdescription id="string.upper-desc">
 <para>Given a string, this template does a language-aware conversion
 of that string to all uppercase letters, based on the values of the
 <literal>lowercase.alpha</literal> and
@@ -1825,7 +1825,7 @@ locale. It affects only those characters found in the values of
 unchanged.</para>
 </refdescription>
 
-<refparameter>
+<refparameter id="string.upper-params">
 <variablelist>
 <varlistentry><term>string</term>
 <listitem>
@@ -1855,7 +1855,7 @@ unchanged.</para>
 <doc:template name="string.lower" xmlns="">
 <refpurpose>Converts a string to all lowercase letters</refpurpose>
 
-<refdescription>
+<refdescription id="string.lower-desc">
 <para>Given a string, this template does a language-aware conversion
 of that string to all lowercase letters, based on the values of the
 <literal>uppercase.alpha</literal> and
@@ -1866,7 +1866,7 @@ locale. It affects only those characters found in the values of
 unchanged.</para>
 </refdescription>
 
-<refparameter>
+<refparameter id="string.lower-params">
 <variablelist>
 <varlistentry><term>string</term>
 <listitem>
@@ -1895,7 +1895,7 @@ unchanged.</para>
 
 <doc:template name="select.choice.separator" xmlns="">
   <refpurpose>Returns localized choice separator</refpurpose>
-  <refdescription>
+  <refdescription id="select.choice.separator-desc">
     <para>This template enables auto-generation of an appropriate
     localized "choice" separator (for example, "and" or "or") before
     the final item in an inline list (though it could also be useful
@@ -1961,7 +1961,7 @@ unchanged.</para>
 
 <doc:template name="evaluate.info.profile" xmlns="">
   <refpurpose>Evaluates an info profile</refpurpose>
-  <refdescription>
+  <refdescription id="evaluate.info.profile-desc">
     <para>This template evaluates an "info profile" matching the XPath
     expression given by the <parameter>profile</parameter>
     parameter. It relies on the XSLT <function>evaluate()</function>
@@ -1976,7 +1976,7 @@ unchanged.</para>
     expression is then evaluated using the XSLT
     <function>evaluate()</function> extension function.</para>
   </refdescription>
-  <refparameter>
+  <refparameter id="evaluate.info.profile-params">
     <variablelist>
        <varlistentry>
         <term>profile</term>
@@ -1993,7 +1993,7 @@ unchanged.</para>
     </variablelist>
   </refparameter>
 
-  <refreturn>
+  <refreturn id="evaluate.info.profile-returns">
     <para>Returns a node (the result of evaluating the
     <parameter>profile</parameter> parameter)</para>
   </refreturn>

diff --git a/xsl/common/labels.xsl b/xsl/common/labels.xsl
index cbede124c670eed13b87a06deae45f7d974399e5..eb6930d1fa32466604311abd809bde916b2db3b3 100644 (file)
--- a/xsl/common/labels.xsl
+++ b/xsl/common/labels.xsl
@@ -20,7 +20,7 @@
 
 <doc:mode mode="label.markup" xmlns="">
 <refpurpose>Provides access to element labels</refpurpose>
-<refdescription>
+<refdescription id="label.markup-desc">
 <para>Processing an element in the
 <literal role="mode">label.markup</literal> mode produces the
 element label.</para>
@@ -773,7 +773,7 @@ element label.</para>
 
 <doc:template name="label.this.section" xmlns="">
 <refpurpose>Returns true if $section should be labelled</refpurpose>
-<refdescription>
+<refdescription id="label.this.section-desc">
 <para>Returns true if the specified section should be labelled.
 By default, this template returns zero unless 
 the section level is less than or equal to the value of the
@@ -836,7 +836,7 @@ Custom stylesheets may override it to get more selective behavior.</para>
 
 <doc:template name="autolabel.format" xmlns="">
 <refpurpose>Returns format for autolabel parameters</refpurpose>
-<refdescription>
+<refdescription id="autolabel.format-desc">
 <para>Returns format passed as parameter if non zero. Supported
   format are 'arabic' or '1', 'loweralpha' or 'a', 'lowerroman' or 'i', 
   'upperlapha' or 'A', 'upperroman' or 'I', 'arabicindic' or '&#x661;'.

diff --git a/xsl/common/refentry.xsl b/xsl/common/refentry.xsl
index 140402c6ec4c299338ee6064c291b5900ea2944e..4373e4849cc0b11d8e02f523244faff09f1e3821 100644 (file)
--- a/xsl/common/refentry.xsl
+++ b/xsl/common/refentry.xsl
@@ -51,7 +51,7 @@
 <!-- ==================================================================== -->
 <doc:template name="get.refentry.metadata" xmlns="">
   <refpurpose>Gathers metadata from a refentry and its ancestors</refpurpose>
-  <refdescription>
+  <refdescription id="get.refentry.metadata-desc">
     <para>Reference documentation for particular commands, functions,
     etc., is sometimes viewed in isolation from its greater "context". For
     example, users view Unix man pages as, well, individual pages, not as
@@ -86,7 +86,7 @@
     </note>
 
   </refdescription>
-  <refparameter>
+  <refparameter id="get.refentry.metadata-params">
     <variablelist>
       <varlistentry>
         <term>refname</term>
@@ -110,7 +110,7 @@
       </varlistentry>
     </variablelist>
   </refparameter>
-  <refreturn>
+  <refreturn id="get.refentry.metadata-returns">
     <para>Returns a node set with the following elements. The
     descriptions are verbatim from the <literal>man(7)</literal> man
     page.
@@ -191,7 +191,7 @@
 <!-- ====================================================================== -->
 <doc:template name="get.refentry.title" xmlns="">
   <refpurpose>Gets title metadata for a refentry</refpurpose>
-  <refdescription>
+  <refdescription id="get.refentry.title-desc">
     <para>The <literal>man(7)</literal> man page describes this as "the
     title of the man page (e.g., <literal>MAN</literal>). This differs
     from <sgmltag>refname</sgmltag> in that, if the <sgmltag>refentry</sgmltag> has a
@@ -199,7 +199,7 @@
     otherwise, we just use first <sgmltag>refname</sgmltag> in the first
     <sgmltag>refnamediv</sgmltag> in the source.</para>
   </refdescription>
-  <refparameter>
+  <refparameter id="get.refentry.title-params">
     <variablelist>
       <varlistentry>
         <term>refname</term>
@@ -209,7 +209,7 @@
       </varlistentry>
     </variablelist>
   </refparameter>
-  <refreturn>
+  <refreturn id="get.refentry.title-returns">
   <para>Returns a <sgmltag>title</sgmltag> node.</para></refreturn>
 </doc:template>
 <xsl:template name="get.refentry.title">
@@ -229,7 +229,7 @@
 <!-- ==================================================================== -->
 <doc:template name="get.refentry.section" xmlns="">
   <refpurpose>Gets section metadata for a refentry</refpurpose>
-  <refdescription>
+  <refdescription id="get.refentry.section-desc">
     <para>The <literal>man(7)</literal> man page describes this as "the
     section number the man page should be placed in (e.g.,
     <literal>7</literal>)". If we do not find a <sgmltag>manvolnum</sgmltag>
@@ -239,7 +239,7 @@
     default to using <literal>1</literal> ["Executable programs or shell
     commands"].</para>
   </refdescription>
-  <refparameter>
+  <refparameter id="get.refentry.section-params">
     <variablelist>
       <varlistentry>
         <term>refname</term>
@@ -255,7 +255,7 @@
       </varlistentry>
     </variablelist>
   </refparameter>
-  <refreturn>
+  <refreturn id="get.refentry.section-returns">
   <para>Returns a string representing a section number.</para></refreturn>
 </doc:template>
 <xsl:template name="get.refentry.section">
@@ -313,12 +313,12 @@
 <!-- ==================================================================== -->
 <doc:template name="get.refentry.date" xmlns="">
   <refpurpose>Gets date metadata for a refentry</refpurpose>
-  <refdescription>
+  <refdescription id="get.refentry.date-desc">
     <para>The <literal>man(7)</literal> man page describes this as "the
     date of the last revision". If we cannot find a date in the source, we
     generate one.</para>
   </refdescription>
-  <refparameter>
+  <refparameter id="get.refentry.date-params">
     <variablelist>
       <varlistentry>
         <term>refname</term>
@@ -341,7 +341,7 @@
       </varlistentry>
     </variablelist>
   </refparameter>
-  <refreturn>
+  <refreturn id="get.refentry.date-returns">
     <para>Returns a <sgmltag>date</sgmltag> node.</para>
   </refreturn>
 </doc:template>
@@ -430,7 +430,7 @@
 <!-- ==================================================================== -->
 <doc:template name="get.refentry.source" xmlns="">
   <refpurpose>Gets source metadata for a refentry</refpurpose>
-  <refdescription>
+  <refdescription id="get.refentry.source-desc">
     <para>The <literal>man(7)</literal> man page describes this as "the
     source of the command", and provides the following examples:
     <itemizedlist>
@@ -490,7 +490,7 @@
     probably will be no <replaceable>Version</replaceable>.
     </para>
   </refdescription>
-  <refparameter>
+  <refparameter id="get.refentry.source-params">
     <variablelist>
       <varlistentry>
         <term>refname</term>
@@ -514,7 +514,7 @@
       </varlistentry>
     </variablelist>
   </refparameter>
-  <refreturn>
+  <refreturn id="get.refentry.source-returns">
     <para>Returns a <sgmltag>source</sgmltag> node.</para>
   </refreturn>
 </doc:template>
@@ -600,13 +600,13 @@
 <!-- ==================================================================== -->
 <doc:template name="get.refentry.source.name" xmlns="">
   <refpurpose>Gets source-name metadata for a refentry</refpurpose>
-  <refdescription>
+  <refdescription id="get.refentry.source.name-desc">
     <para>A "source name" is one part of a (potentially) two-part
     <replaceable>Name</replaceable>&#160;<replaceable>Version</replaceable>
     source field. For more details, see the documentation for the
     <function>get.refentry.source</function> template.</para>
   </refdescription>
-  <refparameter>
+  <refparameter id="get.refentry.source.name-params">
     <variablelist>
       <varlistentry>
         <term>refname</term>
@@ -630,7 +630,7 @@
       </varlistentry>
     </variablelist>
   </refparameter>
-  <refreturn>
+  <refreturn id="get.refentry.source.name-returns">
     <para>Depending on what output method is used for the
   current stylesheet, either returns a text node or possibly an element
   node, containing "source name" data.</para>
@@ -784,13 +784,13 @@
 <!-- ==================================================================== -->
 <doc:template name="get.refentry.version" xmlns="">
   <refpurpose>Gets version metadata for a refentry</refpurpose>
-  <refdescription>
+  <refdescription id="get.refentry.version-desc">
     <para>A "version" is one part of a (potentially) two-part
     <replaceable>Name</replaceable>&#160;<replaceable>Version</replaceable>
     source field. For more details, see the documentation for the
     <function>get.refentry.source</function> template.</para>
   </refdescription>
-  <refparameter>
+  <refparameter id="get.refentry.version-params">
     <variablelist>
       <varlistentry>
         <term>refname</term>
@@ -814,7 +814,7 @@
       </varlistentry>
     </variablelist>
   </refparameter>
-  <refreturn>
+  <refreturn id="get.refentry.version-returns">
     <para>Depending on what output method is used for the
   current stylesheet, either returns a text node or possibly an element
   node, containing "version" data.</para>
@@ -929,7 +929,7 @@
 <!-- ==================================================================== -->
 <doc:template name="get.refentry.manual" xmlns="">
   <refpurpose>Gets source metadata for a refentry</refpurpose>
-  <refdescription>
+  <refdescription id="get.refentry.manual-desc">
     <para>The <literal>man(7)</literal> man page describes this as "the
     title of the manual (e.g., <citetitle>Linux Programmer's
     Manual</citetitle>)". Here are some examples from existing man pages:
@@ -976,7 +976,7 @@
     </para>
 
   </refdescription>
-  <refparameter>
+  <refparameter id="get.refentry.manual-params">
     <variablelist>
       <varlistentry>
         <term>refname</term>
@@ -1000,7 +1000,7 @@
       </varlistentry>
     </variablelist>
   </refparameter>
-  <refreturn>
+  <refreturn id="get.refentry.manual-returns">
     <para>Returns a <sgmltag>manual</sgmltag> node.</para>
   </refreturn>
 </doc:template>
@@ -1138,7 +1138,7 @@
 <!-- ====================================================================== -->
 <doc:template name="get.refentry.metadata.prefs" xmlns="">
   <refpurpose>Gets user preferences for refentry metadata gathering</refpurpose>
-  <refdescription>
+  <refdescription id="get.refentry.metadata.prefs-desc">
     <para>The DocBook XSL stylesheets include several user-configurable
     global stylesheet parameters for controlling <sgmltag>refentry</sgmltag>
     metadata gathering. Those parameters are not read directly by the
@@ -1153,11 +1153,11 @@
     template is the only interface to collecting stylesheet parameters for
     controlling <sgmltag>refentry</sgmltag> metadata gathering.</para>
   </refdescription>
-  <refparameter>
+  <refparameter id="get.refentry.metadata.prefs-params">
     <para>There are no local parameters for this template; however, it
     does rely on a number of global parameters.</para>
   </refparameter>
-  <refreturn>
+  <refreturn id="get.refentry.metadata.prefs-returns">
     <para>Returns a <sgmltag>manual</sgmltag> node.</para>
   </refreturn>
 </doc:template>
@@ -1213,12 +1213,12 @@
 <!-- ====================================================================== -->
 <doc:template name="set.refentry.metadata" xmlns="">
   <refpurpose>Sets content of a refentry metadata item</refpurpose>
-  <refdescription>
+  <refdescription id="set.refentry.metadata-desc">
     <para>The <function>set.refentry.metadata</function> template is
     called each time a suitable source element is found for a certain
     metadata field.</para>
   </refdescription>
-  <refparameter>
+  <refparameter id="set.refentry.metadata-params">
     <variablelist>
       <varlistentry>
         <term>refname</term>
@@ -1248,7 +1248,7 @@
       </varlistentry>
     </variablelist>
   </refparameter>
-  <refreturn>
+  <refreturn id="set.refentry.metadata-returns">
   <para>Returns formatted contents of a selected source element.</para></refreturn>
 </doc:template>
 <xsl:template name="set.refentry.metadata">

diff --git a/xsl/common/subtitles.xsl b/xsl/common/subtitles.xsl
index 8d5d4b36de390412243881df8bfae5b8d914d736..618494a16f2db0802bad89b711d25744de76e04f 100644 (file)
--- a/xsl/common/subtitles.xsl
+++ b/xsl/common/subtitles.xsl
@@ -20,7 +20,7 @@
 
 <doc:mode mode="subtitle.markup" xmlns="">
 <refpurpose>Provides access to element subtitles</refpurpose>
-<refdescription>
+<refdescription id="subtitle.markup-desc">
 <para>Processing an element in the
 <literal role="mode">subtitle.markup</literal> mode produces the
 subtitle of the element.

diff --git a/xsl/common/table.xsl b/xsl/common/table.xsl
index a6ee83a758a3f85189a0628cdaf7c20e7dc9068d..5c743d831cc1998ae82c4fcbea3f099c887d1e5b 100644 (file)
--- a/xsl/common/table.xsl
+++ b/xsl/common/table.xsl
@@ -123,14 +123,14 @@
 
 <doc:template name="entry.colnum" xmlns="">
 <refpurpose>Determine the column number in which a given entry occurs</refpurpose>
-<refdescription>
+<refdescription id="entry.colnum-desc">
 <para>If an <sgmltag>entry</sgmltag> has a
 <sgmltag class="attribute">colname</sgmltag> or
 <sgmltag class="attribute">namest</sgmltag> attribute, this template
 will determine the number of the column in which the entry should occur.
 For other <sgmltag>entry</sgmltag>s, nothing is returned.</para>
 </refdescription>
-<refparameter>
+<refparameter id="entry.colnum-params">
 <variablelist>
 <varlistentry><term>entry</term>
 <listitem>
@@ -140,7 +140,7 @@ For other <sgmltag>entry</sgmltag>s, nothing is returned.</para>
 </variablelist>
 </refparameter>
 
-<refreturn>
+<refreturn id="entry.colnum-returns">
 <para>This template returns the column number if it can be determined,
 or 0 (the empty string)</para>
 </refreturn>

diff --git a/xsl/common/targets.xsl b/xsl/common/targets.xsl
index 91cf93962132cf4418cad6750aa90dc3190d8340..2834ef3f71e3fb9e6e4da83850243eb33f52e49d 100644 (file)
--- a/xsl/common/targets.xsl
+++ b/xsl/common/targets.xsl
@@ -20,7 +20,7 @@
 
 <doc:mode mode="collect.targets" xmlns="">
 <refpurpose>Collects information for potential cross reference targets</refpurpose>
-<refdescription>
+<refdescription id="collect.targets-desc">
 <para>Processing the root element in the
 <literal role="mode">collect.targets</literal> mode produces 
 a set of target database elements that can be used by

diff --git a/xsl/common/titles.xsl b/xsl/common/titles.xsl
index 4a349f7b03e85434bba3b0dea1ce610f82c1ec56..539079d0b5671fbe1b33f71f1760e8168fb4ec56 100644 (file)
--- a/xsl/common/titles.xsl
+++ b/xsl/common/titles.xsl
@@ -20,7 +20,7 @@
 
 <doc:mode mode="title.markup" xmlns="">
 <refpurpose>Provides access to element titles</refpurpose>
-<refdescription>
+<refdescription id="title.markup-desc">
 <para>Processing an element in the
 <literal role="mode">title.markup</literal> mode produces the
 title of the element. This does not include the label.

diff --git a/xsl/common/utility.xsl b/xsl/common/utility.xsl
index 7a19d3019f22a5ce8d5bc389a3ea52865ac2d2fc..380f6fa447b6a1f088ed494d3873614b2a2cdb9c 100644 (file)
--- a/xsl/common/utility.xsl
+++ b/xsl/common/utility.xsl
@@ -58,14 +58,14 @@ $Id: common.xsl 6867 2007-06-25 04:36:37Z xmldoc $
 <doc:template name="log.message" xmlns="">
   <refpurpose>Logs/emits formatted notes and warnings</refpurpose>
 
-  <refdescription>
+  <refdescription id="log.message-desc">
     <para>The <function>log.message</function> template is a utility
     template for logging/emitting formatted messages&#xa0;– that is,
     notes and warnings, along with a given log “level” and an
     identifier for the “source” that the message relates to.</para>
   </refdescription>
 
-  <refparameter>
+  <refparameter id="log.message-params">
     <variablelist>
       <varlistentry>
         <term>level</term>
@@ -141,7 +141,7 @@ $Id: common.xsl 6867 2007-06-25 04:36:37Z xmldoc $
       </varlistentry>
     </variablelist>
   </refparameter>
-  <refreturn>
+  <refreturn id="log.message-returns">
   <para>Outputs a message (generally, to standard error).</para></refreturn>
 </doc:template>
 <xsl:template name="log.message">
@@ -218,12 +218,12 @@ $Id: common.xsl 6867 2007-06-25 04:36:37Z xmldoc $
 <!-- ===================================== -->
 <doc:template name="get.doc.title" xmlns="">
   <refpurpose>Gets a title from the current document</refpurpose>
-  <refdescription>
+  <refdescription id="get.doc.title-desc">
     <para>The <function>get.doc.title</function> template is a
       utility template for returning the first title found in the
       current document.</para>
   </refdescription>
-  <refreturn>
+  <refreturn id="get.doc.title-returns">
   <para>Returns a string containing some identifying title for the
     current document .</para></refreturn>
 </doc:template>
@@ -245,7 +245,7 @@ $Id: common.xsl 6867 2007-06-25 04:36:37Z xmldoc $
 <!-- ===================================== -->
 <doc:template name="pad-string" xmlns="">
   <refpurpose>Right-pads or left-pads a string out to a certain length</refpurpose>
-  <refdescription>
+  <refdescription id="pad-string-desc">
     <para>This function takes string <parameter>padVar</parameter> and
       pads it out in the direction <parameter>rightLeft</parameter> to
       the string-length <parameter>length</parameter>, using string
@@ -262,7 +262,7 @@ $Id: common.xsl 6867 2007-06-25 04:36:37Z xmldoc $
           FAQ</ulink>.</para>
     </note>
   </refdescription>
-  <refreturn>
+  <refreturn id="pad-string-returns">
   <para>Returns a (padded) string.</para></refreturn>
 </doc:template>
 <xsl:template name="pad-string">

diff --git a/xsl/docsrc/pi/pi.xml b/xsl/docsrc/pi/pi.xml
index 549873a96297c9b9ae1afb2cdba9006d57c62b7b..00b4f5381d5168edbb8879204fe03996b3c68c7b 100644 (file)
--- a/xsl/docsrc/pi/pi.xml
+++ b/xsl/docsrc/pi/pi.xml
@@ -50,7 +50,7 @@ is controlled with following <quote>attributes</quote>.</para>
 <refpurpose>Filename for chunk</refpurpose>
 </refnamediv>
 
-<refsect1>
+<refsect1 id="dbhtml.filename-desc">
 <title>Description</title>
 
 <para>Sets the name for chunked file. PI must be child of element
@@ -62,7 +62,7 @@ role="html">use.id.as.filename</parameter> parameter.</para>
 
 </refsect1>
 
-<refsect1>
+<refsect1 id="dbhtml.filename-exampl">
 <title>Example</title>
 
 <programlisting><![CDATA[<section>
@@ -87,7 +87,7 @@ role="html">use.id.as.filename</parameter> parameter.</para>
 <refpurpose>Directory for chunk</refpurpose>
 </refnamediv>
 
-<refsect1>
+<refsect1 id="dbhtml.dir-desc">
 <title>Description</title>
 
 <para>Sets the directory for chunked file. PI must be child of element
@@ -100,7 +100,7 @@ chunk.</para>
 
 </refsect1>
 
-<refsect1>
+<refsect1 id="dbhtml.dir-example">
 <title>Example</title>
 
 <programlisting><![CDATA[<section>