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

From: Paul A Bristow (pbristow_at_[hidden])
Date: 2007-11-02 09:55:08

>-----Original Message-----
>From: boost-bounces_at_[hidden] 
>[mailto:boost-bounces_at_[hidden]] On Behalf Of Jeff Garland
>Sent: 02 November 2007 13:23
>To: boost_at_[hidden]
>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

---
Paul A Bristow
Prizet Farmhouse, Kendal, Cumbria UK LA8 8AB
[phone] & SMS, Mobile [phone] & SMS
pbristow_at_[hidden]