Re: [boost] location for PDF docs?

Subject: Re: [boost] location for PDF docs?
From: John Maddock (john_at_[hidden])
Date: 2008-11-04 05:24:44

Matthias Schabel wrote:
>>> For now, I have quite a few PDF docs in the PDF directory of the
>>> sandbox (the max file size of the vault is too limiting for the
>>> larger libs docs).
>>>
>>> BTW, if anyone with quickbook/boostbook style docs would like pdf's
>>> generated for them, then I can probably generate a few more...
>>
>> Thanks for the offer, John. Generation of PDF docs on OS X is a
>> disaster in my experience - if you get the chance, I would very much
>> appreciate it if you could generate PDF docs for Boost.Units.

I've added a first cut to the sandbox at pdf/units/release/units 
(https://svn.boost.org/svn/boost/sandbox/pdf/units/release/units.pdf) using 
a patched version of your Jamfile (let me know if you want me to commit the 
attached patch).

Things I've noticed:

* Links to source files and headers are broken, I think this may be fixable 
with some more xsl:param's, but haven't looked into it.
* Pagination in the reference section looks a little screwy in places: I 
think this must have something to do with the way the Doxygen generated docs 
are sectioned, but I'm not sure about this.
* The PNG images don't look that good in PDF's, we have the ability to embed 
SVG's or PDF's (haven't tried the latter though) if you want to improve 
these: but it would require some editing of the quickbook source.

Also if you want the page setup options changed/tweaked let me know as now 
I've got it working I can regenerate it pretty quickly...

John.