From: Paul A Bristow (pbristow_at_[hidden])
Date: 2007-11-02 09:55:08
>[mailto:boost-bounces_at_[hidden]] On Behalf Of Jeff Garland
>Sent: 02 November 2007 13:23
>Cc: Discussion of Boost Documentation
>Subject: Re: [boost] [Boost-docs] [1.35] Where to place PDF
>versions of docs?
>John Maddock wrote:
>I think this is an important point -- PDFs have to be *by library*. Full
>date-time user/reference docs are 400 pages
as are Math Toolkit ;-)
>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.
I agree - though I have to say that generating pdf for Math Toolkit was a hassle, even after John had cracked the difficult bits.
But pdfs are really convenient because you can use your reader's Find to search the whole document.
Without automatically generated indexes - something the Quickbook should be able to do, but making it work isn't a trivial task
(GSoC project perhaps?) - the pdf has this big advantage over html.
So I agree strongly with John that we need to agree a place to put pdfs, and that authors should be tasked with producing pdfs.
(Those using Quickbook will now reap the benefits of their investment ;-)
--- Paul A Bristow Prizet Farmhouse, Kendal, Cumbria UK LA8 8AB +44 1539561830 & SMS, Mobile +44 7714 330204 & SMS pbristow_at_[hidden]
Boost list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk