[jboss-cvs] JBossRemoting/docs/guide/support/support/docbook-xsl/lib ...
Tom Elrod
tom.elrod at jboss.com
Wed Aug 2 12:35:06 EDT 2006
User: telrod
Date: 06/08/02 12:35:06
Modified: docs/guide/support/support/docbook-xsl/lib ChangeLog
lib.xml lib.xsl
Log:
JBREM-412 - updated docbook support so formatting of guide will be a little better.
Revision Changes Path
1.2 +0 -0 JBossRemoting/docs/guide/support/support/docbook-xsl/lib/ChangeLog
(In the diff below, changes in quantity of whitespace are not shown.)
1.2 +762 -897 JBossRemoting/docs/guide/support/support/docbook-xsl/lib/lib.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: lib.xml
===================================================================
RCS file: /cvsroot/jboss/JBossRemoting/docs/guide/support/support/docbook-xsl/lib/lib.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -b -r1.1 -r1.2
--- lib.xml 6 Oct 2005 03:27:24 -0000 1.1
+++ lib.xml 2 Aug 2006 16:35:06 -0000 1.2
@@ -4,59 +4,48 @@
<!DOCTYPE book
PUBLIC "-//DocBook Open Repository//DTD DocBook Literate Programming V0.0//EN" "http://docbook.sourceforge.net/release/litprog/current/dtd/ldocbook.dtd">
<book xmlns:src="http://nwalsh.com/xmlns/litprog/fragment" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
- <bookinfo>
- <title>XSL Library Template Reference</title>
- <releaseinfo role="cvs">$Id: lib.xml,v 1.1 2005/10/06 03:27:24 telrod Exp $
+<bookinfo>
+<title>XSL Library Template Reference</title>
+<releaseinfo role="cvs">$Id: lib.xml,v 1.2 2006/08/02 16:35:06 telrod Exp $
</releaseinfo>
- <corpauthor>DocBook Open Repository Team</corpauthor>
- <copyright>
+<corpauthor>DocBook Open Repository Team</corpauthor>
+<copyright>
<year>1999</year>
<year>2000</year>
<year>2001</year>
<year>2002</year>
<holder>Norman Walsh</holder>
- </copyright>
- </bookinfo>
+</copyright>
+</bookinfo>
- <preface>
- <title>Introduction</title>
+<preface><title>Introduction</title>
- <para>This is technical reference documentation for the DocBook XSL
- Stylesheets; it documents (some of) the parameters, templates, and
- other elements of the stylesheets.</para>
-
- <para>This is not intended to be
- <quote>user</quote>
- documentation.
- It is provided for developers writing customization layers for the
- stylesheets, and for anyone who's interested in
- <quote>how it
- works</quote>
- .
- </para>
-
- <para>Although I am trying to be thorough, this documentation is known
- to be incomplete. Don't forget to read the source, too :-)</para>
-
- </preface>
-
- <reference>
- <title>General Library Templates</title>
-
- <refentry id="dot.count">
- <refnamediv>
- <refname>dot.count</refname>
- <refpurpose>Returns the number of
- <quote>.</quote>
- characters in a string
- </refpurpose>
- </refnamediv>
+<para>This is technical reference documentation for the DocBook XSL
+Stylesheets; it documents (some of) the parameters, templates, and
+other elements of the stylesheets.</para>
- <refsect1>
- <title>Description</title>
+<para>This is not intended to be <quote>user</quote> documentation.
+It is provided for developers writing customization layers for the
+stylesheets, and for anyone who's interested in <quote>how it
+works</quote>.</para>
- <programlisting format="linespecific">
- <src:fragment id="dot.count.frag"><xsl:template name="dot.count">
+<para>Although I am trying to be thorough, this documentation is known
+to be incomplete. Don't forget to read the source, too :-)</para>
+
+</preface>
+
+<reference>
+<title>General Library Templates</title>
+
+<refentry id="dot.count">
+<refnamediv>
+<refname>dot.count</refname>
+<refpurpose>Returns the number of <quote>.</quote> characters in a string</refpurpose>
+</refnamediv>
+
+<refsect1><title>Description</title>
+
+<programlisting format="linespecific"><src:fragment id="dot.count.frag"><xsl:template name="dot.count">
<!-- Returns the number of "." characters in a string -->
<xsl:param name="string"/>
<xsl:param name="count"
@@ -74,28 +63,22 @@
<xsl:value-of select="$count"/>
</xsl:otherwise>
</xsl:choose>
- </xsl:template></src:fragment>
- </programlisting>
+</xsl:template></src:fragment></programlisting>
- </refsect1>
- </refentry>
+</refsect1>
+</refentry>
- <!-- ================================================================== -->
+<!-- ================================================================== -->
- <refentry id="copy-string">
- <refnamediv>
- <refname>copy-string</refname>
- <refpurpose>Returns
- <quote>count</quote>
- copies of a string
- </refpurpose>
- </refnamediv>
+<refentry id="copy-string">
+<refnamediv>
+<refname>copy-string</refname>
+<refpurpose>Returns <quote>count</quote> copies of a string</refpurpose>
+</refnamediv>
- <refsect1>
- <title>Description</title>
+<refsect1><title>Description</title>
- <programlisting format="linespecific">
- <src:fragment id="copy-string.frag"><xsl:template name="copy-string">
+<programlisting format="linespecific"><src:fragment id="copy-string.frag"><xsl:template name="copy-string">
<!-- returns 'count' copies of 'string' -->
<xsl:param name="string"/>
<xsl:param name="count"
@@ -119,37 +102,27 @@
<xsl:value-of select="$result"/>
</xsl:otherwise>
</xsl:choose>
- </xsl:template></src:fragment>
- </programlisting>
+</xsl:template></src:fragment></programlisting>
- </refsect1>
- </refentry>
+</refsect1>
+</refentry>
- <!-- ====================================================================== -->
+<!-- ====================================================================== -->
- <refentry id="string.subst">
- <refnamediv>
- <refname>string.subst</refname>
- <refpurpose>Substitute one text string for another in a string</refpurpose>
- </refnamediv>
-
- <refsect1>
- <title>Description</title>
-
- <para>The
- <function moreinfo="none">string.subst</function>
- template replaces all
- occurances of
- <parameter moreinfo="none">target</parameter>
- in
- <parameter moreinfo="none">string</parameter>
- with
- <parameter moreinfo="none">replacement</parameter>
- and returns the result.
- </para>
+<refentry id="string.subst">
+<refnamediv>
+<refname>string.subst</refname>
+<refpurpose>Substitute one text string for another in a string</refpurpose>
+</refnamediv>
- <programlisting format="linespecific">
- <src:fragment id="string.subst.frag"><xsl:template name="string.subst">
+<refsect1><title>Description</title>
+
+<para>The <function moreinfo="none">string.subst</function> template replaces all
+occurances of <parameter moreinfo="none">target</parameter> in <parameter moreinfo="none">string</parameter>
+with <parameter moreinfo="none">replacement</parameter> and returns the result.
+</para>
+
+<programlisting format="linespecific"><src:fragment id="string.subst.frag"><xsl:template name="string.subst">
<xsl:param name="string"/>
<xsl:param name="target"/>
<xsl:param name="replacement"/>
@@ -172,43 +145,30 @@
<xsl:value-of select="$string"/>
</xsl:otherwise>
</xsl:choose>
- </xsl:template></src:fragment>
- </programlisting>
+</xsl:template></src:fragment></programlisting>
- </refsect1>
- </refentry>
+</refsect1>
+</refentry>
- <!-- ================================================================== -->
+<!-- ================================================================== -->
- <refentry id="xpointer.idref">
- <refnamediv>
- <refname>xpointer.idref</refname>
- <refpurpose>Extract IDREF from an XPointer</refpurpose>
- </refnamediv>
-
- <refsect1>
- <title>Description</title>
-
- <para>The
- <function moreinfo="none">xpointer.idref</function>
- template returns the
- ID portion of an XPointer which is a pointer to an ID within the current
- document, or the empty string if it is not.
- </para>
- <para>In other words,
- <function moreinfo="none">xpointer.idref</function>
- returns
- <quote>foo</quote>
- when passed either
- <literal moreinfo="none">#foo</literal>
- or
- <literal moreinfo="none">#xpointer(id('foo'))</literal>
- , otherwise it returns
- the empty string.
- </para>
+<refentry id="xpointer.idref">
+<refnamediv>
+<refname>xpointer.idref</refname>
+<refpurpose>Extract IDREF from an XPointer</refpurpose>
+</refnamediv>
+
+<refsect1><title>Description</title>
+
+<para>The <function moreinfo="none">xpointer.idref</function> template returns the
+ID portion of an XPointer which is a pointer to an ID within the current
+document, or the empty string if it is not.</para>
+<para>In other words, <function moreinfo="none">xpointer.idref</function> returns
+<quote>foo</quote> when passed either <literal moreinfo="none">#foo</literal>
+or <literal moreinfo="none">#xpointer(id('foo'))</literal>, otherwise it returns
+the empty string.</para>
- <programlisting format="linespecific">
- <src:fragment id="xpointer.idref.frag"><xsl:template name="xpointer.idref">
+<programlisting format="linespecific"><src:fragment id="xpointer.idref.frag"><xsl:template name="xpointer.idref">
<xsl:param name="xpointer">http://...</xsl:param>
<xsl:choose>
<xsl:when test="starts-with($xpointer, '#xpointer(id(')">
@@ -223,41 +183,33 @@
</xsl:when>
<!-- otherwise it's a pointer to some other document -->
</xsl:choose>
- </xsl:template></src:fragment>
- </programlisting>
+</xsl:template></src:fragment></programlisting>
- </refsect1>
- </refentry>
+</refsect1>
+</refentry>
- <!-- ================================================================== -->
+<!-- ================================================================== -->
- <refentry id="length-magnitude">
- <refnamediv>
- <refname>length-magnitude</refname>
- <refpurpose>Return the unqualified dimension from a length specification</refpurpose>
- </refnamediv>
+<refentry id="length-magnitude">
+<refnamediv>
+<refname>length-magnitude</refname>
+<refpurpose>Return the unqualified dimension from a length specification</refpurpose>
+</refnamediv>
- <refsect1>
- <title>Description</title>
+<refsect1><title>Description</title>
- <para>The
- <function moreinfo="none">length-magnitude</function>
- template returns the
- unqualified length ("20" for "20pt") from a dimension.
- </para>
+<para>The <function moreinfo="none">length-magnitude</function> template returns the
+unqualified length ("20" for "20pt") from a dimension.
+</para>
- <programlisting format="linespecific">
- <src:fragment id="length-magnitude.frag"><xsl:template name="length-magnitude">
+<programlisting format="linespecific"><src:fragment id="length-magnitude.frag"><xsl:template name="length-magnitude">
<xsl:param name="length"
select="'0pt'"/>
<xsl:choose>
<xsl:when test="string-length($length) = 0"/>
- <xsl:when test="substring($length,1,1) = '0' or substring($length,1,1) = '1' or
- substring($length,1,1) = '2' or substring($length,1,1) = '3' or substring($length,1,1) = '4' or
- substring($length,1,1) = '5' or substring($length,1,1) = '6' or substring($length,1,1) = '7' or
- substring($length,1,1) = '8' or substring($length,1,1) = '9' or substring($length,1,1) = '.'">
+ <xsl:when test="substring($length,1,1) = '0' or substring($length,1,1) = '1' or substring($length,1,1) = '2' or substring($length,1,1) = '3' or substring($length,1,1) = '4' or substring($length,1,1) = '5' or substring($length,1,1) = '6' or substring($length,1,1) = '7' or substring($length,1,1) = '8' or substring($length,1,1) = '9' or substring($length,1,1) = '.'">
<xsl:value-of select="substring($length,1,1)"/>
<xsl:call-template name="length-magnitude">
<xsl:with-param name="length"
@@ -265,34 +217,26 @@
</xsl:call-template>
</xsl:when>
</xsl:choose>
- </xsl:template></src:fragment>
- </programlisting>
+</xsl:template></src:fragment></programlisting>
+
+</refsect1>
+</refentry>
+
+<!-- ================================================================== -->
- </refsect1>
- </refentry>
+<refentry id="length-units">
+<refnamediv>
+<refname>length-units</refname>
+<refpurpose>Return the units from a length specification</refpurpose>
+</refnamediv>
- <!-- ================================================================== -->
+<refsect1><title>Description</title>
- <refentry id="length-units">
- <refnamediv>
- <refname>length-units</refname>
- <refpurpose>Return the units from a length specification</refpurpose>
- </refnamediv>
-
- <refsect1>
- <title>Description</title>
-
- <para>The
- <function moreinfo="none">length-units</function>
- template returns the
- units ("pt" for "20pt") from a length. If no units are supplied on the
- length, the
- <parameter moreinfo="none">defauilt.units</parameter>
- are returned.
- </para>
+<para>The <function moreinfo="none">length-units</function> template returns the
+units ("pt" for "20pt") from a length. If no units are supplied on the
+length, the <parameter moreinfo="none">defauilt.units</parameter> are returned.</para>
- <programlisting format="linespecific">
- <src:fragment id="length-units.frag"><xsl:template name="length-units">
+<programlisting format="linespecific"><src:fragment id="length-units.frag"><xsl:template name="length-units">
<xsl:param name="length"
select="'0pt'"/>
<xsl:param name="default.units"
@@ -316,34 +260,27 @@
<xsl:value-of select="$units"/>
</xsl:otherwise>
</xsl:choose>
- </xsl:template></src:fragment>
- </programlisting>
+</xsl:template></src:fragment></programlisting>
- </refsect1>
- </refentry>
+</refsect1>
+</refentry>
- <!-- ================================================================== -->
+<!-- ================================================================== -->
- <refentry id="length-spec">
- <refnamediv>
- <refname>length-spec</refname>
- <refpurpose>Return a fully qualified length specification</refpurpose>
- </refnamediv>
-
- <refsect1>
- <title>Description</title>
-
- <para>The
- <function moreinfo="none">length-spec</function>
- template returns the
- qualified length from a dimension. If an unqualified length is given,
- the
- <parameter moreinfo="none">default.units</parameter>
- will be added to it.
- </para>
+<refentry id="length-spec">
+<refnamediv>
+<refname>length-spec</refname>
+<refpurpose>Return a fully qualified length specification</refpurpose>
+</refnamediv>
- <programlisting format="linespecific">
- <src:fragment id="length-spec.frag"><xsl:template name="length-spec">
+<refsect1><title>Description</title>
+
+<para>The <function moreinfo="none">length-spec</function> template returns the
+qualified length from a dimension. If an unqualified length is given,
+the <parameter moreinfo="none">default.units</parameter> will be added to it.
+</para>
+
+<programlisting format="linespecific"><src:fragment id="length-spec.frag"><xsl:template name="length-spec">
<xsl:param name="length"
select="'0pt'"/>
<xsl:param name="default.units"
@@ -362,8 +299,7 @@
<xsl:value-of select="$magnitude"/>
<xsl:choose>
- <xsl:when test="$units='cm' or $units='mm' or $units='in' or $units='pt' or $units='pc' or
- $units='px' or $units='em'">
+ <xsl:when test="$units='cm' or $units='mm' or $units='in' or $units='pt' or $units='pc' or $units='px' or $units='em'">
<xsl:value-of select="$units"/>
</xsl:when>
<xsl:when test="$units = ''">
@@ -377,50 +313,38 @@
</xsl:message>
</xsl:otherwise>
</xsl:choose>
- </xsl:template></src:fragment>
- </programlisting>
+</xsl:template></src:fragment></programlisting>
- </refsect1>
- </refentry>
+</refsect1>
+</refentry>
- <!-- ================================================================== -->
+<!-- ================================================================== -->
- <refentry id="length-in-points">
- <refnamediv>
- <refname>length-in-points</refname>
- <refpurpose>Returns the size, in points, of a specified length</refpurpose>
- </refnamediv>
-
- <refsect1>
- <title>Description</title>
-
- <para>The
- <function moreinfo="none">length-in-points</function>
- template converts a length
- specification to points and returns that value as an unqualified
- number.
- </para>
-
- <caution>
- <para>There is no way for the template to infer the size of an
- <literal moreinfo="none">em</literal>
- . It relies on the default
- <parameter moreinfo="none">em.size</parameter>
- which is initially
- <literal moreinfo="none">10</literal>
- (for 10pt).
- </para>
-
- <para>Similarly, converting pixesl to points relies on the
- <parameter moreinfo="none">pixels.per.inch</parameter>
- parameter which is initially
- <literal moreinfo="none">90</literal>
- .
- </para>
- </caution>
+<refentry id="length-in-points">
+<refnamediv>
+<refname>length-in-points</refname>
+<refpurpose>Returns the size, in points, of a specified length</refpurpose>
+</refnamediv>
+
+<refsect1><title>Description</title>
+
+<para>The <function moreinfo="none">length-in-points</function> template converts a length
+specification to points and returns that value as an unqualified
+number.
+</para>
+
+<caution>
+<para>There is no way for the template to infer the size of an
+<literal moreinfo="none">em</literal>. It relies on the default <parameter moreinfo="none">em.size</parameter>
+which is initially <literal moreinfo="none">10</literal> (for 10pt).</para>
+
+<para>Similarly, converting pixesl to points relies on the
+<parameter moreinfo="none">pixels.per.inch</parameter> parameter which is initially
+<literal moreinfo="none">90</literal>.
+</para>
+</caution>
- <programlisting format="linespecific">
- <src:fragment id="length-in-points.frag"><xsl:template name="length-in-points">
+<programlisting format="linespecific"><src:fragment id="length-in-points.frag"><xsl:template name="length-in-points">
<xsl:param name="length"
select="'0pt'"/>
<xsl:param name="em.size"
@@ -469,46 +393,34 @@
</xsl:message>
</xsl:otherwise>
</xsl:choose>
- </xsl:template></src:fragment>
- </programlisting>
+</xsl:template></src:fragment></programlisting>
+
+</refsect1>
+</refentry>
+
+<!-- ================================================================== -->
- </refsect1>
- </refentry>
+<refentry id="pi-attribute">
+<refnamediv>
+<refname>pi-attribute</refname>
+<refpurpose>Extract a pseudo-attribute from a PI</refpurpose>
+</refnamediv>
- <!-- ================================================================== -->
+<refsect1><title>Description</title>
- <refentry id="pi-attribute">
- <refnamediv>
- <refname>pi-attribute</refname>
- <refpurpose>Extract a pseudo-attribute from a PI</refpurpose>
- </refnamediv>
-
- <refsect1>
- <title>Description</title>
-
- <para>The
- <function moreinfo="none">pi-attribute</function>
- template extracts a pseudo-attribute
- from a processing instruction. For example, given the PI
- <quote>
- <literal moreinfo="none"><?foo bar="1" baz='red'?></literal>
- </quote>
- ,
- </para>
- <programlisting format="linespecific"><xsl:call-template name="pi-attribute">
+<para>The <function moreinfo="none">pi-attribute</function> template extracts a pseudo-attribute
+from a processing instruction. For example, given the PI
+<quote><literal moreinfo="none"><?foo bar="1" baz='red'?></literal></quote>,</para>
+<programlisting format="linespecific"><xsl:call-template name="pi-attribute">
<xsl:with-param name="pis" select="processing-instruction('foo')"/>
<xsl:with-param name="attribute" select="'baz'"/>
- </xsl:call-template></programlisting>
- <para>will return
- <quote>red</quote>
- . This template returns the first matching
- attribute that it finds. Presented with processing instructions that
- contain badly formed pseudo-attributes (missing or unbalanced quotes,
- for example), the template may silently return erroneous results.
- </para>
+</xsl:call-template></programlisting>
+<para>will return <quote>red</quote>. This template returns the first matching
+attribute that it finds. Presented with processing instructions that
+contain badly formed pseudo-attributes (missing or unbalanced quotes,
+for example), the template may silently return erroneous results.</para>
- <programlisting format="linespecific">
- <src:fragment id="pi-attribute.frag"><xsl:template name="pi-attribute">
+<programlisting format="linespecific"><src:fragment id="pi-attribute.frag"><xsl:template name="pi-attribute">
<xsl:param name="pis"
select="processing-instruction('')"/>
<xsl:param name="attribute">filename</xsl:param>
@@ -543,32 +455,26 @@
</xsl:choose>
</xsl:otherwise>
</xsl:choose>
- </xsl:template></src:fragment>
- </programlisting>
+</xsl:template></src:fragment></programlisting>
- </refsect1>
- </refentry>
+</refsect1>
+</refentry>
- <!-- ================================================================== -->
+<!-- ================================================================== -->
- <refentry id="lookup.key">
- <refnamediv>
- <refname>lookup.key</refname>
- <refpurpose>Retrieve the value associated with a particular key in a table</refpurpose>
- </refnamediv>
-
- <refsect1>
- <title>Description</title>
-
- <para>Given a table of space-delimited key/value pairs,
- the
- <function moreinfo="none">lookup.key</function>
- template extracts the value associated
- with a particular key.
- </para>
+<refentry id="lookup.key">
+<refnamediv>
+<refname>lookup.key</refname>
+<refpurpose>Retrieve the value associated with a particular key in a table</refpurpose>
+</refnamediv>
- <programlisting format="linespecific">
- <src:fragment id="lookup.key.frag"><xsl:template name="lookup.key">
+<refsect1><title>Description</title>
+
+<para>Given a table of space-delimited key/value pairs,
+the <function moreinfo="none">lookup.key</function> template extracts the value associated
+with a particular key.</para>
+
+<programlisting format="linespecific"><src:fragment id="lookup.key.frag"><xsl:template name="lookup.key">
<xsl:param name="key"
select="''"/>
<xsl:param name="table"
@@ -598,31 +504,26 @@
</xsl:otherwise>
</xsl:choose>
</xsl:if>
- </xsl:template></src:fragment>
- </programlisting>
+</xsl:template></src:fragment></programlisting>
+
+</refsect1>
+</refentry>
+
+<!-- ================================================================== -->
- </refsect1>
- </refentry>
+<refentry id="xpath.location">
+<refnamediv>
+<refname>xpath.location</refname>
+<refpurpose>Calculate the XPath child-sequence to the current node</refpurpose>
+</refnamediv>
- <!-- ================================================================== -->
+<refsect1><title>Description</title>
- <refentry id="xpath.location">
- <refnamediv>
- <refname>xpath.location</refname>
- <refpurpose>Calculate the XPath child-sequence to the current node</refpurpose>
- </refnamediv>
-
- <refsect1>
- <title>Description</title>
-
- <para>The
- <function moreinfo="none">xpath.location</function>
- template calculates the
- absolute path from the root of the tree to the current element node.
- </para>
+<para>The <function moreinfo="none">xpath.location</function> template calculates the
+absolute path from the root of the tree to the current element node.
+</para>
- <programlisting format="linespecific">
- <src:fragment id="xpath.location.frag"><xsl:template name="xpath.location">
+<programlisting format="linespecific"><src:fragment id="xpath.location.frag"><xsl:template name="xpath.location">
<xsl:param name="node"
select="."/>
<xsl:param name="path"
@@ -648,33 +549,27 @@
<xsl:value-of select="$next.path"/>
</xsl:otherwise>
</xsl:choose>
- </xsl:template></src:fragment>
- </programlisting>
+</xsl:template></src:fragment></programlisting>
- </refsect1>
- </refentry>
+</refsect1>
+</refentry>
- <!-- ================================================================== -->
+<!-- ================================================================== -->
- <refentry id="comment-escape-string">
- <refnamediv>
- <refname>comment-escape-string</refname>
- <refpurpose>Prepare a string for inclusion in an XML comment</refpurpose>
- </refnamediv>
-
- <refsect1>
- <title>Description</title>
-
- <para>The
- <function moreinfo="none">comment-escape-string</function>
- template returns a string
- that has been transformed so that it can safely be output as an XML comment.
- Internal occurrences of "--" will be replaced with "- -" and a leading and/or
- trailing space will be added to the string, if necessary.
- </para>
+<refentry id="comment-escape-string">
+<refnamediv>
+<refname>comment-escape-string</refname>
+<refpurpose>Prepare a string for inclusion in an XML comment</refpurpose>
+</refnamediv>
- <programlisting format="linespecific">
- <src:fragment id="comment-escape-string"><xsl:template name="comment-escape-string">
+<refsect1><title>Description</title>
+
+<para>The <function moreinfo="none">comment-escape-string</function> template returns a string
+that has been transformed so that it can safely be output as an XML comment.
+Internal occurrences of "--" will be replaced with "- -" and a leading and/or
+trailing space will be added to the string, if necessary.</para>
+
+<programlisting format="linespecific"><src:fragment id="comment-escape-string"><xsl:template name="comment-escape-string">
<xsl:param name="string"
select="''"/>
@@ -690,32 +585,23 @@
<xsl:if test="substring($string, string-length($string), 1) = '-'">
<xsl:text> </xsl:text>
</xsl:if>
- </xsl:template></src:fragment>
- </programlisting>
+</xsl:template></src:fragment></programlisting>
+
+</refsect1>
+</refentry>
+
+<refentry id="comment-escape-string.recursive">
+<refnamediv>
+<refname>comment-escape-string.recursive</refname>
+<refpurpose>Internal function used by comment-escape-string</refpurpose>
+</refnamediv>
- </refsect1>
- </refentry>
+<refsect1><title>Description</title>
- <refentry id="comment-escape-string.recursive">
- <refnamediv>
- <refname>comment-escape-string.recursive</refname>
- <refpurpose>Internal function used by comment-escape-string</refpurpose>
- </refnamediv>
-
- <refsect1>
- <title>Description</title>
-
- <para>The
- <function moreinfo="none">comment-escape-string.recursive</function>
- template is used
- by
- <function moreinfo="none">comment-escape-string</function>
- .
- </para>
-
- <programlisting format="linespecific">
- <src:fragment id="comment-escape-string.recursive"><xsl:template
- name="comment-escape-string.recursive">
+<para>The <function moreinfo="none">comment-escape-string.recursive</function> template is used
+by <function moreinfo="none">comment-escape-string</function>.</para>
+
+<programlisting format="linespecific"><src:fragment id="comment-escape-string.recursive"><xsl:template name="comment-escape-string.recursive">
<xsl:param name="string"
select="''"/>
<xsl:choose>
@@ -731,57 +617,46 @@
<xsl:value-of select="$string"/>
</xsl:otherwise>
</xsl:choose>
- </xsl:template></src:fragment>
- </programlisting>
- </refsect1>
- </refentry>
-
- </reference>
-
- <reference>
- <title>Relative URI Functions</title>
-
- <partintro>
- <title>Introduction</title>
-
- <para>These functions manipulate relative URI references.</para>
-
- <para>The following assumptions must hold true:</para>
-
- <orderedlist inheritnum="ignore" continuation="restarts">
- <listitem>
- <para>All URIs are relative.</para>
- </listitem>
- <listitem>
- <para>No URI contains the
- <quote>
- <literal moreinfo="none">../</literal>
- </quote>
- sequence
- which would effectively move
- <quote>up</quote>
- the hierarchy.
- </para>
- </listitem>
- </orderedlist>
-
- <para>If these assumptions do not hold, the results are unpredictable.</para>
-
- </partintro>
-
- <refentry id="count.uri.path.depth">
- <refnamediv>
- <refname>count.uri.path.depth</refname>
- <refpurpose>Count the number of path components in a relative URI</refpurpose>
- </refnamediv>
+</xsl:template></src:fragment></programlisting>
+</refsect1>
+</refentry>
+
+</reference>
+
+<reference>
+<title>Relative URI Functions</title>
+
+<partintro><title>Introduction</title>
- <refsect1>
- <title>Description</title>
+<para>These functions manipulate relative URI references.</para>
- <para>This function counts the number of path components in a relative URI.</para>
+<para>The following assumptions must hold true:</para>
- <programlisting format="linespecific">
- <src:fragment id="count.uri.path.depth.frag"><xsl:template name="count.uri.path.depth">
+<orderedlist inheritnum="ignore" continuation="restarts">
+<listitem>
+<para>All URIs are relative.</para>
+</listitem>
+<listitem>
+<para>No URI contains the <quote><literal moreinfo="none">../</literal></quote> sequence
+which would effectively move <quote>up</quote> the hierarchy.</para>
+</listitem>
+</orderedlist>
+
+<para>If these assumptions do not hold, the results are unpredictable.</para>
+
+</partintro>
+
+<refentry id="count.uri.path.depth">
+<refnamediv>
+<refname>count.uri.path.depth</refname>
+<refpurpose>Count the number of path components in a relative URI</refpurpose>
+</refnamediv>
+
+<refsect1><title>Description</title>
+
+<para>This function counts the number of path components in a relative URI.</para>
+
+<programlisting format="linespecific"><src:fragment id="count.uri.path.depth.frag"><xsl:template name="count.uri.path.depth">
<xsl:param name="filename"
select="''"/>
<xsl:param name="count"
@@ -800,25 +675,22 @@
<xsl:value-of select="$count"/>
</xsl:otherwise>
</xsl:choose>
- </xsl:template></src:fragment>
- </programlisting>
+</xsl:template></src:fragment></programlisting>
- </refsect1>
- </refentry>
+</refsect1>
+</refentry>
- <refentry id="trim.common.uri.paths">
- <refnamediv>
- <refname>trim.common.uri.paths</refname>
- <refpurpose>Trim common leading path components from a relative URI</refpurpose>
- </refnamediv>
+<refentry id="trim.common.uri.paths">
+<refnamediv>
+<refname>trim.common.uri.paths</refname>
+<refpurpose>Trim common leading path components from a relative URI</refpurpose>
+</refnamediv>
- <refsect1>
- <title>Description</title>
+<refsect1><title>Description</title>
- <para>This function trims common leading path components from a relative URI.</para>
+<para>This function trims common leading path components from a relative URI.</para>
- <programlisting format="linespecific">
- <src:fragment id="trim.common.uri.paths.frag"><xsl:template name="trim.common.uri.paths">
+<programlisting format="linespecific"><src:fragment id="trim.common.uri.paths.frag"><xsl:template name="trim.common.uri.paths">
<xsl:param name="uriA"
select="''"/>
<xsl:param name="uriB"
@@ -827,8 +699,7 @@
select="'A'"/>
<xsl:choose>
- <xsl:when test="contains($uriA, '/') and contains($uriB, '/') and substring-before($uriA, '/') =
- substring-before($uriB, '/')">
+ <xsl:when test="contains($uriA, '/') and contains($uriB, '/') and substring-before($uriA, '/') = substring-before($uriB, '/')">
<xsl:call-template name="trim.common.uri.paths">
<xsl:with-param name="uriA"
select="substring-after($uriA, '/')"/>
@@ -849,26 +720,21 @@
</xsl:choose>
</xsl:otherwise>
</xsl:choose>
- </xsl:template></src:fragment>
- </programlisting>
+</xsl:template></src:fragment></programlisting>
+
+</refsect1>
+</refentry>
+
+</reference>
- </refsect1>
- </refentry>
+<appendix><title>The Stylesheet</title>
- </reference>
+<para>The <filename moreinfo="none">lib.xsl</filename> stylesheet is just a wrapper
+around these functions.</para>
- <appendix>
- <title>The Stylesheet</title>
-
- <para>The
- <filename moreinfo="none">lib.xsl</filename>
- stylesheet is just a wrapper
- around these functions.
- </para>
-
- <src:fragment id="top">
- <!-- ********************************************************************
- $Id: lib.xml,v 1.1 2005/10/06 03:27:24 telrod Exp $
+<src:fragment id="top">
+<!-- ********************************************************************
+ $Id: lib.xml,v 1.2 2006/08/02 16:35:06 telrod Exp $
********************************************************************
This file is part of the XSL DocBook Stylesheet distribution.
@@ -879,28 +745,27 @@
******************************************************************** -->
- <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
exclude-result-prefixes="src"
version="1.0">
- <src:fragref linkend="dot.count.frag"/>
- <src:fragref linkend="copy-string.frag"/>
- <src:fragref linkend="string.subst.frag"/>
- <src:fragref linkend="xpointer.idref.frag"/>
- <src:fragref linkend="length-magnitude.frag"/>
- <src:fragref linkend="length-units.frag"/>
- <src:fragref linkend="length-spec.frag"/>
- <src:fragref linkend="length-in-points.frag"/>
- <src:fragref linkend="pi-attribute.frag"/>
- <src:fragref linkend="lookup.key.frag"/>
- <src:fragref linkend="xpath.location.frag"/>
- <src:fragref linkend="comment-escape-string"/>
- <src:fragref linkend="comment-escape-string.recursive"/>
- <src:fragref linkend="count.uri.path.depth.frag"/>
- <src:fragref linkend="trim.common.uri.paths.frag"/>
+<src:fragref linkend="dot.count.frag"/>
+<src:fragref linkend="copy-string.frag"/>
+<src:fragref linkend="string.subst.frag"/>
+<src:fragref linkend="xpointer.idref.frag"/>
+<src:fragref linkend="length-magnitude.frag"/>
+<src:fragref linkend="length-units.frag"/>
+<src:fragref linkend="length-spec.frag"/>
+<src:fragref linkend="length-in-points.frag"/>
+<src:fragref linkend="pi-attribute.frag"/>
+<src:fragref linkend="lookup.key.frag"/>
+<src:fragref linkend="xpath.location.frag"/>
+<src:fragref linkend="comment-escape-string"/>
+<src:fragref linkend="comment-escape-string.recursive"/>
+<src:fragref linkend="count.uri.path.depth.frag"/>
+<src:fragref linkend="trim.common.uri.paths.frag"/>
- </xsl:stylesheet>
- </src:fragment>
+</xsl:stylesheet></src:fragment>
- </appendix>
+</appendix>
</book>
\ No newline at end of file
1.2 +356 -361 JBossRemoting/docs/guide/support/support/docbook-xsl/lib/lib.xsl
(In the diff below, changes in quantity of whitespace are not shown.)
Index: lib.xsl
===================================================================
RCS file: /cvsroot/jboss/JBossRemoting/docs/guide/support/support/docbook-xsl/lib/lib.xsl,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -b -r1.1 -r1.2
--- lib.xsl 6 Oct 2005 03:27:24 -0000 1.1
+++ lib.xsl 2 Aug 2006 16:35:06 -0000 1.2
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- ********************************************************************
- $Id: lib.xsl,v 1.1 2005/10/06 03:27:24 telrod Exp $
+ $Id: lib.xsl,v 1.2 2006/08/02 16:35:06 telrod Exp $
********************************************************************
This file is part of the XSL DocBook Stylesheet distribution.
@@ -12,11 +12,10 @@
******************************************************************** -->
-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
- exclude-result-prefixes="src" version="1.0">
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:src="http://nwalsh.com/xmlns/litprog/fragment" exclude-result-prefixes="src" version="1.0">
- <xsl:template name="dot.count">
+<xsl:template name="dot.count">
<!-- Returns the number of "." characters in a string -->
<xsl:param name="string"/>
<xsl:param name="count" select="0"/>
@@ -31,10 +30,10 @@
<xsl:value-of select="$count"/>
</xsl:otherwise>
</xsl:choose>
- </xsl:template>
+</xsl:template>
- <xsl:template name="copy-string">
+<xsl:template name="copy-string">
<!-- returns 'count' copies of 'string' -->
<xsl:param name="string"/>
<xsl:param name="count" select="0"/>
@@ -55,10 +54,10 @@
<xsl:value-of select="$result"/>
</xsl:otherwise>
</xsl:choose>
- </xsl:template>
+</xsl:template>
- <xsl:template name="string.subst">
+<xsl:template name="string.subst">
<xsl:param name="string"/>
<xsl:param name="target"/>
<xsl:param name="replacement"/>
@@ -72,17 +71,16 @@
<xsl:with-param name="replacement" select="$replacement"/>
</xsl:call-template>
</xsl:variable>
- <xsl:value-of
- select="concat(substring-before($string, $target), $replacement, $rest)"/>
+ <xsl:value-of select="concat(substring-before($string, $target), $replacement, $rest)"/>
</xsl:when>
<xsl:otherwise>
<xsl:value-of select="$string"/>
</xsl:otherwise>
</xsl:choose>
- </xsl:template>
+</xsl:template>
- <xsl:template name="xpointer.idref">
+<xsl:template name="xpointer.idref">
<xsl:param name="xpointer">http://...</xsl:param>
<xsl:choose>
<xsl:when test="starts-with($xpointer, '#xpointer(id(')">
@@ -95,26 +93,25 @@
</xsl:when>
<!-- otherwise it's a pointer to some other document -->
</xsl:choose>
- </xsl:template>
+</xsl:template>
- <xsl:template name="length-magnitude">
+<xsl:template name="length-magnitude">
<xsl:param name="length" select="'0pt'"/>
<xsl:choose>
<xsl:when test="string-length($length) = 0"/>
- <xsl:when
- test="substring($length,1,1) = '0' or substring($length,1,1) = '1' or substring($length,1,1) = '2' or substring($length,1,1) = '3' or substring($length,1,1) = '4' or substring($length,1,1) = '5' or substring($length,1,1) = '6' or substring($length,1,1) = '7' or substring($length,1,1) = '8' or substring($length,1,1) = '9' or substring($length,1,1) = '.'">
+ <xsl:when test="substring($length,1,1) = '0' or substring($length,1,1) = '1' or substring($length,1,1) = '2' or substring($length,1,1) = '3' or substring($length,1,1) = '4' or substring($length,1,1) = '5' or substring($length,1,1) = '6' or substring($length,1,1) = '7' or substring($length,1,1) = '8' or substring($length,1,1) = '9' or substring($length,1,1) = '.'">
<xsl:value-of select="substring($length,1,1)"/>
<xsl:call-template name="length-magnitude">
<xsl:with-param name="length" select="substring($length,2)"/>
</xsl:call-template>
</xsl:when>
</xsl:choose>
- </xsl:template>
+</xsl:template>
- <xsl:template name="length-units">
+<xsl:template name="length-units">
<xsl:param name="length" select="'0pt'"/>
<xsl:param name="default.units" select="'px'"/>
<xsl:variable name="magnitude">
@@ -135,10 +132,10 @@
<xsl:value-of select="$units"/>
</xsl:otherwise>
</xsl:choose>
- </xsl:template>
+</xsl:template>
- <xsl:template name="length-spec">
+<xsl:template name="length-spec">
<xsl:param name="length" select="'0pt'"/>
<xsl:param name="default.units" select="'px'"/>
@@ -154,8 +151,7 @@
<xsl:value-of select="$magnitude"/>
<xsl:choose>
- <xsl:when
- test="$units='cm' or $units='mm' or $units='in' or $units='pt' or $units='pc' or $units='px' or $units='em'">
+ <xsl:when test="$units='cm' or $units='mm' or $units='in' or $units='pt' or $units='pc' or $units='px' or $units='em'">
<xsl:value-of select="$units"/>
</xsl:when>
<xsl:when test="$units = ''">
@@ -163,16 +159,16 @@
</xsl:when>
<xsl:otherwise>
<xsl:message>
- <xsl:text>Unrecognized unit of measure:</xsl:text>
+ <xsl:text>Unrecognized unit of measure: </xsl:text>
<xsl:value-of select="$units"/>
<xsl:text>.</xsl:text>
</xsl:message>
</xsl:otherwise>
</xsl:choose>
- </xsl:template>
+</xsl:template>
- <xsl:template name="length-in-points">
+<xsl:template name="length-in-points">
<xsl:param name="length" select="'0pt'"/>
<xsl:param name="em.size" select="10"/>
<xsl:param name="pixels.per.inch" select="90"/>
@@ -211,16 +207,16 @@
</xsl:when>
<xsl:otherwise>
<xsl:message>
- <xsl:text>Unrecognized unit of measure:</xsl:text>
+ <xsl:text>Unrecognized unit of measure: </xsl:text>
<xsl:value-of select="$units"/>
<xsl:text>.</xsl:text>
</xsl:message>
</xsl:otherwise>
</xsl:choose>
- </xsl:template>
+</xsl:template>
- <xsl:template name="pi-attribute">
+<xsl:template name="pi-attribute">
<xsl:param name="pis" select="processing-instruction('')"/>
<xsl:param name="attribute">filename</xsl:param>
<xsl:param name="count">1</xsl:param>
@@ -249,10 +245,10 @@
</xsl:choose>
</xsl:otherwise>
</xsl:choose>
- </xsl:template>
+</xsl:template>
- <xsl:template name="lookup.key">
+<xsl:template name="lookup.key">
<xsl:param name="key" select="''"/>
<xsl:param name="table" select="''"/>
@@ -277,10 +273,10 @@
</xsl:otherwise>
</xsl:choose>
</xsl:if>
- </xsl:template>
+</xsl:template>
- <xsl:template name="xpath.location">
+<xsl:template name="xpath.location">
<xsl:param name="node" select="."/>
<xsl:param name="path" select="''"/>
@@ -302,14 +298,14 @@
<xsl:value-of select="$next.path"/>
</xsl:otherwise>
</xsl:choose>
- </xsl:template>
+</xsl:template>
- <xsl:template name="comment-escape-string">
+<xsl:template name="comment-escape-string">
<xsl:param name="string" select="''"/>
<xsl:if test="starts-with($string, '-')">
- <xsl:text></xsl:text>
+ <xsl:text> </xsl:text>
</xsl:if>
<xsl:call-template name="comment-escape-string.recursive">
@@ -317,12 +313,12 @@
</xsl:call-template>
<xsl:if test="substring($string, string-length($string), 1) = '-'">
- <xsl:text></xsl:text>
+ <xsl:text> </xsl:text>
</xsl:if>
- </xsl:template>
+</xsl:template>
- <xsl:template name="comment-escape-string.recursive">
+<xsl:template name="comment-escape-string.recursive">
<xsl:param name="string" select="''"/>
<xsl:choose>
<xsl:when test="contains($string, '--')">
@@ -336,10 +332,10 @@
<xsl:value-of select="$string"/>
</xsl:otherwise>
</xsl:choose>
- </xsl:template>
+</xsl:template>
- <xsl:template name="count.uri.path.depth">
+<xsl:template name="count.uri.path.depth">
<xsl:param name="filename" select="''"/>
<xsl:param name="count" select="0"/>
@@ -354,17 +350,16 @@
<xsl:value-of select="$count"/>
</xsl:otherwise>
</xsl:choose>
- </xsl:template>
+</xsl:template>
- <xsl:template name="trim.common.uri.paths">
+<xsl:template name="trim.common.uri.paths">
<xsl:param name="uriA" select="''"/>
<xsl:param name="uriB" select="''"/>
<xsl:param name="return" select="'A'"/>
<xsl:choose>
- <xsl:when
- test="contains($uriA, '/') and contains($uriB, '/') and substring-before($uriA, '/') = substring-before($uriB, '/')">
+ <xsl:when test="contains($uriA, '/') and contains($uriB, '/') and substring-before($uriA, '/') = substring-before($uriB, '/')">
<xsl:call-template name="trim.common.uri.paths">
<xsl:with-param name="uriA" select="substring-after($uriA, '/')"/>
<xsl:with-param name="uriB" select="substring-after($uriB, '/')"/>
@@ -382,7 +377,7 @@
</xsl:choose>
</xsl:otherwise>
</xsl:choose>
- </xsl:template>
+</xsl:template>
</xsl:stylesheet>
More information about the jboss-cvs-commits
mailing list