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. Regards, -- Joel de Guzman http://www.boost-consulting.com http://spirit.sf.net