Re: [boost] location for PDF docs?

Subject: Re: [boost] location for PDF docs?
From: Vladimir Prus (vladimir_at_[hidden])
Date: 2008-11-04 05:10:25

Paul A Bristow wrote:

>>-----Original Message-----
>>From: boost-bounces_at_[hidden]
>>[mailto:boost-bounces_at_[hidden]] On Behalf Of Eric Niebler
>>Sent: 03 November 2008 19:19
>>To: boost_at_[hidden]
>>Subject: Re: [boost] location for PDF docs?
> 
>>I can think of two logical places to put the PDFs:
>>   - A dedicated location under www.boost.org/doc
>>   - Alongside the release tarballs on sourceforge.
>>
>>The problem with both of these locations is that average boost
>>developers do not have upload access. We can make it part of
>>the release
>>procedure that developers can optionally provide the release manager
>>with PDFs, but this is one more thing for developers to forget to do,
>>and more work for the release manager.
>>
>>Maybe both locations should have a link to documentation in alternate
>>formats,
> 
> Since we don't have an automatic indexing system for Quickbook (or other) documentation (A GSoC
> project?), 

Boostbook docs have automatic indexing system, for some definition of 'automatic'. Please see

        http://www.boost.org/boost-build2/doc/html/ix01.html

Each index entry must be explicitly provided in the source (where the index term is defined).
However, collection of all index entries at a single page is done by some magic.

- Volodya