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

From: Michael Marcin (mmarcin_at_[hidden])
Date: 2007-11-03 19:13:31

Joel de Guzman wrote:
> Jeff Garland wrote:
>> John Maddock wrote:
>>
>>> Also building the HTML documentation as a single "book" from doc/ simply 
>>> isn't viable anymore IMO: it doesn't scale well (takes an age to build, 
>>> breaks at the drop of a hat etc).  It worked when we only had a few 
>>> Boostbook libraries, but we have too many for this now. 
>> I think this is an important point -- PDFs have to be *by library*.  Full 
>> date-time user/reference docs are 400 pages so all of boost would be 
>> thousands.  Up to now, I've been generating date-time PDFs and putting them on 
>> my site which obviously isn't the ideal system. Personally I don't think we're 
>> ready to solve this issue in time for 1.35 so I think we should take it as an 
>> independent effort.
> 
> FWIW, I agree. I'd even venture to suggest that we have one
> URL for placing all our generated docs (html/pdf). Then, we can
> simply redirect to it from our library doc's index.html. That
> would mean though that people who download a snapshot needs to
> have net access to get the docs.
> 

I don't really care how I have to get them (so long as it is less 
painful than setting up the quickbook toolchain on windows) but in the 
past I've had use for a local copy of the docs.  For example if the 
network goes down or I'm working on a flight.

- Michael Marcin