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

From: Vladimir Prus (ghost_at_[hidden])
Date: 2007-11-01 16:20:44

Rene Rivera wrote:

> Vladimir Prus 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?
>> 
>> I don't think there's a need to version control docs. What we need is:
>> 
>> 1. Docs for SVN state of Boost, in HTML and PDF, placed in some area of
>> the web site (and preferrably, not placed in SVN).
> 
> Currently the only way to have anything show up on the beta web site is
> to check them into SVN. This is not going to change because of
> management and security issues. Anything that isn't in SVN and needs to
> be in the web site needs special, programmatic, handling.

Well, then docs needs special, programmatic, handling.

>> 2. Docs for the last release -- which clearly should not versioned
>> either.
> 
> I don't see why? Or maybe I just don't understand the statement.

I would expect that a given release of Boost has docs for that release,
not revision 1 of docs, followed by revision 2, and so on. So there
seems to be little reason to put docs in SVN.

- Volodya