[Clfs-dev] r7105

[Alexander E. Patrakov]

M.Canales.es wrote:
> The expected version is defined on the xsl:import statements placed on the top 
> level stylesheets/ files (see the LFS-6.2 stylesheets for an example), and a 
> sane system must not remap an explicit DB-XSL version to a different one via 
> XML catalogs (that is fine for compatible DTDs releases, but never for XSL 
> versions), thus that should not be an issue.
>   

Hm. Debian Lenny currently has only one version of DocBook XSL packaged 
(namely, 1.72.0 with Debian-specific changes). I am sure that there are 
some packages that build documentation using XSL.

You are right that Debian does not remap DB-XSL versions via XML catalogs:

$ grep xsl /etc/xml/catalog
<delegateURI 
uriStartString="http://docbook.sourceforge.net/release/xsl/" 
catalog="file:///etc/xml/docbook-xsl.xml"/>
<delegateSystem 
systemIdStartString="http://docbook.sourceforge.net/release/xsl/" 
catalog="file:///etc/xml/docbook-xsl.xml"/>

$ cat /etc/xml/docbook-xsl.xml
<?xml version="1.0"?>
<!DOCTYPE catalog PUBLIC "-//OASIS//DTD XML Catalogs V1.0//EN"
  "file:///usr/share/xml/schema/xml-core/catalog.dtd">
<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
<delegateURI 
uriStartString="http://docbook.sourceforge.net/release/xsl/" 
catalog="file:///usr/share/xml/docbook/stylesheet/nwalsh/catalog.xml"/>
<delegateSystem 
systemIdStartString="http://docbook.sourceforge.net/release/xsl/" 
catalog="file:///usr/share/xml/docbook/stylesheet/nwalsh/catalog.xml"/>
</catalog>

$ cat /usr/share/xml/docbook/stylesheet/nwalsh/catalog.xml
<?xml version="1.0" encoding="utf-8"?>
<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
<!-- XML Catalog file for DocBook XSL Stylesheets v1.72.0 -->
<!--                                                      -->
<!-- ******* adjusted for the Debian distribution ******* -->

  <rewriteURI
    uriStartString="http://docbook.sourceforge.net/release/xsl/current/"
    rewritePrefix="file:///usr/share/xml/docbook/stylesheet/nwalsh/"/>

  <rewriteSystem
    
systemIdStartString="http://docbook.sourceforge.net/release/xsl/current/"
    rewritePrefix="file:///usr/share/xml/docbook/stylesheet/nwalsh/"/>

  <rewriteURI
    uriStartString="http://docbook.sourceforge.net/release/xsl/1.72.0/"
    rewritePrefix="file:///usr/share/xml/docbook/stylesheet/nwalsh/"/>

  <rewriteSystem
    systemIdStartString="http://docbook.sourceforge.net/release/xsl/1.72.0/"
    rewritePrefix="file:///usr/share/xml/docbook/stylesheet/nwalsh/"/>

</catalog>

The question is how they manage to continue building packages with 
documentation successfully when DocBook XSL is upgraded. For the 
"gimp-help-2" package, the answer is that the "current" version of 
stylesheets is used by default, instead of the explicit number. If you 
know a package that doesn't use the "current" version, tell me its name, 
and I will look how Debian deals with this situation.

-- 
Alexander E. Patrakov