From: Joel de Guzman (joel_at_[hidden])
Date: 2007-11-02 20:27:27
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.
-- Joel de Guzman http://www.boost-consulting.com http://spirit.sf.net
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk