Boost logo

Boost :

From: David Abrahams (dave_at_[hidden])
Date: 2007-11-01 15:14:26

on Thu Nov 01 2007, Eric Niebler <> wrote:

> John Maddock wrote:
>> Folks I think we need to get organised with PDF's now that we have many more
>> libraries with quickbook/boostbook docs.
>> I don't particularly want these in SVN trunk: apart from anything else it
>> needlessly bloats the download size if folks are happy with HTML versions.
>> Previously I've placed these in the vault, but there's a file size limit
>> there and the new Boost.Math PDF's are too large :-(
>> Another alternative would be the sourceforge file release system, but I
>> don't believe all developers have access to that?
>> So.... how about we either have a directory in the "website" area of SVN for
>> these, or else in the sandbox maybe?
>> Thoughts? John.
> How are the HTML docs handled? Are the generated HTML files checked into
> the website's SVN?

In some cases.

> Seems odd to check generated files into version
> control.

Yeah, but can I count on whoever is generating docs to install
docutils for my ReST documents?

What about the GPL'd Makefile I used to generate PDFs of the iterator
docs, which I can't include in the boost distro, but link to from the

> Maybe the Documentation link on the Boost's home page could take you
> to a page that had links to automatically generated PDFs in addition
> to the HTML.

Would be nice, for sure.

Dave Abrahams
Boost Consulting

Boost list run by bdawes at, gregod at, cpdaniel at, john at