Re: [Refdb-devel] Docs failing to build

[David N. <dav...@sw...>]

Hi Markus,
>  > This is turning out to be a most puzzling problem.
>   
>   Post the package versions of the related tools (libxml2,
>   libxslt2, fop, docbook-stylesheets and so on). I'd like to have
>   Michael look at this, as he seems to be running Debian as well.
>   

libavalon-framework-java: 4.2.0-3
libbsf-java: 1:2.3.0+cvs20050308a-1
libbatik-java: 1.6-2
liblogkit-java: 1.2.2-8
libxalan2-java: 2.6.0-6
libxerces2-java: 2.6.2-4
libxml2: 2.6.26.dfsg-3
libxslt1.1: 1.1.17-3
fop: 1:0.20.5-8
docbook-xsl: 1.70.1.dfsg.1-0.2
xml-core: 0.09-0.1

I'm running very recent Debian/testing with all packages up-to-date.  
Let me know if you want any other package versions.

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

I have discovered the cause of the problem... but am no closer to 
understanding it.  It has to do with the /doc directory's xsltproc line.

The makefile ends up executing the following command (excepting the 
backslash, of course):

    xsltproc -o refdb-manual.fo --nonet --xinclude \
    ../doc/include/manual-fo.xsl ../doc/refdb-manual.xml

The FO file thus created will fail on conversion to PDF with fop.  If, 
in the xsltproc command, you strip out both instances of '../doc/' you 
end up with the following command:

    xsltproc -o refdb-manual.fo --nonet --xinclude \
    include/manual-fo.xsl refdb-manual.xml

The FO file thus created is different to the one created using the 
previous command.  This FO file will be converted successfully by fop to 
PDF.

The FO files thus generated are different.  I do not yet understand why 
xsltproc generates different output from the same input and essentially 
similar commands.

I have created a tarzipped archive containing both versions of FO output 
-- one which will successfully convert to PDF (created by a command with 
'../doc/' stripped out) and one which fails to convert to PDF (created 
by a command retaining '../doc/').  This archive can be accessed at 
<www.nebauer.org/fo-files.tar.gz>.

Regards,
David.