Re: [boost] [1.35] Where to place PDF versions of docs?

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

on Thu Nov 01 2007, Eric Niebler <eric-AT-boost-consulting.com> 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
README?

> 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
http://www.boost-consulting.com