Potential Bug in DocBook XML 4.4CR2, docbook.cat file

[Tristan Fiedler <fiedler@cshl.edu>]

Hi All,

Using docbook-xml-4.4CR2, found the following potential bug :   (I  
fixed it by changing each occurrence of 'iso-' in the docbook.cat to  
'iso'  (ie removed hyphen).

Original problem :


I noticed that two different filenames are used :  isoamsa.ent   and  
iso-amsa.ent

docbook-xml-4.4CR2/catalog.xml:        uri="ent/isoamsa.ent"/>
docbook-xml-4.4CR2/dbcentx.mod:"ent/isoamsa.ent">
docbook-xml-4.4CR2/ent/isoamsa.ent:     File isoamsa.ent produced by  
the XSL script entities.xsl
docbook-xml-4.4CR2/ent/isoamsa.ent:     Version: $Id: isoamsa.ent,v 1.2  
2003/12/08 15:14:43 davidc Exp $
docbook-xml-4.4CR2/ent/isoamsa.ent:       System identifier:  
http://www.w3.org/2003/entities/iso8879/isoamsa.ent
docbook-xml-4.4CR2/ent/isoamsa.ent:          
"http://www.w3.org/2003/entities/iso8879/isoamsa.ent";


versus


docbook-xml-4.4CR2/docbook.cat:       "ent/iso-amsa.ent"


When I edit the second line below from iso-amsa.ent to isoamsa.ent (as  
shown), the problem appears solved, but the next file 'iso-amsb.ent' is  
not found.

 From docbook.cat in docbook-xml-4.4CR2 :

PUBLIC "ISO 8879:1986//ENTITIES Added Math Symbols: Arrow  
Relations//EN//XML"
        "ent/isoamsa.ent"

PUBLIC "ISO 8879:1986//ENTITIES Added Math Symbols: Binary  
Operators//EN//XML"
        "ent/iso-amsb.ent"

-------------------------------------------

New error :

Resolved public: ISO 8879:1986//ENTITIES Added Math Symbols: Arrow  
Relations//EN//XML
          
file:/Users/fiedler/Celegans_DocBook/software/docbook-xml-4.4CR2/ent/ 
isoamsa.ent
Resolved public: ISO 8879:1986//ENTITIES Added Math Symbols: Binary  
Operators//EN//XML
          
file:/Users/fiedler/Celegans_DocBook/software/docbook-xml-4.4CR2/ent/ 
iso-amsb.ent
Failed to create InputSource:  
file:/Users/fiedler/Celegans_DocBook/software/docbook-xml-4.4CR2/ent/ 
iso-amsb.ent
Error on line 312 column 1 of  
file:/Users/fiedler/Celegans_DocBook/Samples/Mosaics/ 
GeneticMosaics_test1.xml:
   Error reported by XML parser: Cannot read from  
file:/Users/fiedler/Celegans_DocBook/Samples/Mosaics/ent/isoamsb.ent  
(/Users/fiedler/Celegans_DocBook/Samples/Mosaics/ent/isoamsb.ent (No  
such file or directory))
Transformation failed: Run-time errors were reported


-----------------------------------------

Does this need to done for each of these 'hyphenated' .ent files in  
docbook.cat?
When I changed each 'iso-' to 'iso' , Saxon was able to properly create  
the desired html output :

Mosaics$ java com.icl.saxon.StyleSheet -x  
org.apache.xml.resolver.tools.ResolvingXMLReader -y  
org.apache.xml.resolver.tools.ResolvingXMLReader -r  
org.apache.xml.resolver.tools.CatalogResolver -u -o classyMos.html  
GeneticMosaics_test1.xml docbook.xsl

Tristan
------------------------------
Tristan J. Fiedler
Postdoctoral Fellow - Stein Lab
Cold Spring Harbor Laboratory
On Dec 8, 2004, at 7:03 PM, Tristan Fiedler wrote:

> Hi DocBook gurus,
>
> Using Bob Stayton's XSL online  guide, I have set up the catalog.xml  
> and CatalogManager.properties files.  However, somewhere the path to  
> htmltblx.mod is incorrect.  When I run :
>
> Mosaics$ java com.icl.saxon.StyleSheet -x  
> org.apache.xml.resolver.tools.ResolvingXMLReader -y  
> org.apache.xml.resolver.tools.ResolvingXMLReader -r  
> org.apache.xml.resolver.tools.CatalogResolver -u -o classyMos.html  
> GeneticMosaics_test1.xml docbook.xsl
>
> I get this error :
>
> Error on line 3599 column 1 of  
> file:/Users/fiedler/Celegans_DocBook/Samples/Mosaics/ 
> GeneticMosaics_test1.xml:
>   Error reported by XML parser: Cannot read from  
> file:/Users/fiedler/Celegans_DocBook/Samples/Mosaics/htmltblx.mod  
> (/Users/fiedler/Celegans_DocBook/Samples/Mosaics/htmltblx.mod (No such  
> file or directory))
> Transformation failed: Run-time errors were reported
>
> I do indeed however have a file in my  docbook-xml-4.3 directory named  
> : htmltblx.mod
>
> The catalog file looks like :
>
> <?xml version="1.0"?>
> <!DOCTYPE catalog
>    PUBLIC "-//OASIS/DTD Entity Resolution XML Catalog V1.0//EN"
>     
> "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd";>
>
> <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
>
>   <!-- DTD and stylesheet files installed under /usr/share/xml -->
>   <group  xml:base="file:///Users/fiedler/Celegans_DocBook/software/" >
>
>     <!-- Resolve DTD URL system ID to local file -->
>     <rewriteSystem
>          
> systemIdStartString="http://www.oasis-open.org/docbook/xml/4.3b2/";
>         rewritePrefix="docbook-xml-4.3/" />
>     <!-- Resolve stylesheet URL to local file -->
>     <rewriteURI
>          
> uriStartString="http://docbook.sourceforge.net/release/xsl/current/";
>         rewritePrefix="docbook-xsl-1.67.2/" />
>
>     <!-- Resolve DTD PUBLIC identifiers -->
>
>     <public
>        publicId="-//OASIS//DTD DocBook XML V4.3//EN"
>        uri="docbook-xml-4.3/docbookx.dtd"/>
>
>     <!-- To resolve DTD SYSTEM identifiers. -->
>
>     <system
>        systemId="docbookx.dtd"
>        uri="docbook-xml-4.3/docbookx.dtd"/>
>
>     <!-- To resolve short stylesheet references -->
>     <uri
>         name="docbook.xsl"
>         uri="docbook-xsl-1.67.2/html/docbook.xsl" />
>     <uri
>         name="chunk.xsl"
>         uri="docbook-xsl-1.67.2/html/chunk.xsl" />
>     <uri
>         name="fo-docbook.xsl"
>         uri="docbook-xsl-1.67.2/fo/docbook.xsl" />
>
>   </group>
>
> </catalog>
>
>
> and the CatalogManager.properties file looks like :
>
> catalogs=catalog.xml;./docbook-xml-4.3/docbook.cat
> relative-catalogs=false
> static-catalog=yes
> catalog-class-name=org.apache.xml.resolver.Resolver
> verbosity=1
>
>
> If someone could suggest a solution, I would appreciate it.
>
>
> Cheers,
>
> Tristan
> ------------------------------
> Tristan J. Fiedler
> Postdoctoral Fellow - Stein Lab
> Cold Spring Harbor Laboratory