Re: [Boost-docs] pdf generation broken on trunk

Subject: Re: [Boost-docs] pdf generation broken on trunk
From: Paul A Bristow (pbristow_at_[hidden])
Date: 2007-08-05 13:21:30

>-----Original Message-----
>From: boost-docs-bounces_at_[hidden] 
>[mailto:boost-docs-bounces_at_[hidden]] On Behalf Of Roland Schwarz
>Sent: 05 August 2007 13:04
>To: Discussion of Boost Documentation
>Subject: Re: [Boost-docs] pdf generation broken on trunk
>
>Roland Schwarz wrote:
>> I tried to build some pdf documentation from trunk.
>> 
>> I.e.
>> 
>> cd BOOST_ROOT/tools/build/v2/doc
>> 
>> bjam pdf
>> 
>> results in:
>> ....
>> ....
>> [ERROR:] 1
>> 
>> The same does works on RC_1_34_0 without (fatal) error.
>> 
>> I have tracked down the bug to the boostbook xsl stylesheets.
>> If one replaces the fo.xsl from trunk with fo.xsl from RC_1_34_0
>> pdf generation works as expected.
>> 
>> Since the error is reported by fop I tried to run with -d switch:
>> It bombs out somewhere in the hyphenation code with an out of bound 
>> array access.
>> 
>> fop version used is 0.20.5. (btw. are there any plans to 
>upgrade to the
>> current stable?)
>> 
>> I suspect the error has to do with the syntax coloring part.
>> 
>
>Some follow up:
>
>When the standalone.fo is put through xmlindent first (thereby making 
>the lines shorter) the resulting standalone.fo can be processed by fop 
>without (fatal) errors.
>
>This to me is an indication that fop 0.20.5 simply is (too) 
>broken, and 
>the question is where to go from here?

John Maddock concluded this as well and has used for the Math Toolkit docs  - 350 pages and counting ;-) and recommended RenderX to
generate the pdf.

It renders in colour (though I've not seen with the *new* coloured syntax yet).

You can get a trial version free.

I've got as far as this but am still working on the html upgrade to handle policies, so not got to pdf yet.

I'm sure John will post more details on request.  

Paul

---
Paul A Bristow
Prizet Farmhouse, Kendal, Cumbria UK LA8 8AB
[phone] & SMS, Mobile [phone] & SMS
pbristow_at_[hidden]