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
> 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.
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk