Re: [boost] location for PDF docs?

Subject: Re: [boost] location for PDF docs?
From: Paul A Bristow (pbristow_at_[hidden])
Date: 2008-11-05 04:59:31

>-----Original Message-----
>From: boost-bounces_at_[hidden] 
>[mailto:boost-bounces_at_[hidden]] On Behalf Of Vladimir Prus
>Sent: 04 November 2008 10:10
>To: boost_at_[hidden]
>Subject: Re: [boost] location for PDF docs?
>
>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?
>> 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.

This *looks* nice - but

1  I don't see where to define the index entries. Can you point me to the instructions for this.

2  It will be hard work for a 500 page document :-(

(We already have a several libraries that are this big - and it is for big documents that indexing is most useful).

3  Would it be more practical if the author had a list of all possible index terms from the document and could then generate a
subset by *excluding* ones that are not considered worth an entry.  Could Quickbook or some other tool output this list?
Once generated, this 'exclusion list' could be re-used?

Paul

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