Re: Build failure: HTML manual

Hi Markus,
> I wanted to
> transform the manual with a different xslt processor (if the manual
> would cause a similar problem with a different processor on my system
> as well, I reckon the problem is with the driver file). However, I'm
> apparently not up to this task:
>
> - Saxon by itself does not seem to understand Xincludes
>
> - Saxon-Xerces does not fare any better
>
> - Xalan dies with an error


I found the following link gives a number of strategies for working 
around the incomplete implementation of xincludes in Saxon and Xalan:
    http://www.sagehill.net/docbookxsl/Xinclude.html#JavaXIncludes

The three strategies recommended are:
    - use Xerces
    - use xmllint as a preprocessor to resolve xincludes
    - use XIncluder as a preprocessor to resolve xincludes

When using xerces with Saxon or Xalan the Java command requires 
additional parameters.  Further parameters are needed if catalogs are 
used.  I have to say the Java commands required are god-awfully hideous.

There is a thread in the docbook-apps mailing list that addresses this 
issue.  It includes contributions from Bob Stayton and Dave Pawson.  
Since the thread navigation links on the site appear to be broken, here 
are the thread postings in chronological order:
    http://sources.redhat.com/ml/docbook-apps/2004-q1/msg00308.html
    http://sources.redhat.com/ml/docbook-apps/2004-q1/msg00312.html
    http://sources.redhat.com/ml/docbook-apps/2004-q1/msg00326.html
    http://sources.redhat.com/ml/docbook-apps/2004-q1/msg00328.html
    http://sources.redhat.com/ml/docbook-apps/2004-q1/msg00329.html

On the other hand, using xmllint to resolve xincludes before processing 
appears to be simplicity itself:
    xmllint --xinclude original.xml > resolved.xml

My apologies if you are already aware of this information.  Your email 
didn't specify exactly what strategies or commands you've tried.

Regards,
David.

-------------------------------------------------------------------------
Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642