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