Re: Docs failing to build

Hi David,

David Nebauer writes:
 > This is turning out to be a most puzzling problem.  I've tested a number 
 > of documents and refdb-manual is the only document failing so far.  The 
 > refdb-elisp manual outputs PDF just fine.
 > 

Drives me nuts. Is the reason of this problem too obvious for us to
see? We have to sort this out, somehow.

I'd suggest to do the following:

- please post the refdb-manual.fo that your tools create on some http
  or ftp space (you can abuse the RefDB homepage if you don't have web
  space of your own. Use e.g. the htdocs/stuff folder). I'd like to
  diff it against what my system creates.

- please 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.

- please try whether the transformation problem is caused by the RefDB
  driver file. Transform refdb-manual.xml manually with the stock
  DocBook stylesheets.

- please try whether size matters :-) Remove some or all of the
  xincludes in refdb-manual.xml and reprocess the document. You'll get
  warnings about missing linkends but this shouldn't matter.

- please try whether your Java runtime needs more memory. Have a look
  at the fop command in doc/Makefile.am and give it some more memory,
  like in:

  JAVA_OPTS=-Xmx512M fop -fo refdb-manual.fo -pdf refdb-manual.pdf

thanks,
Markus

-- 
Markus Hoenicka
[email protected]
(Spam-protected email: replace the quadrupeds with "mhoenicka")
http://www.mhoenicka.de


-------------------------------------------------------------------------
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