[boost] Re: Yet another quickbook question

From: Joel de Guzman (joel_at_[hidden])
Date: 2005-05-29 18:49:53

Arkadiy Vertleyb wrote:
> "Joel de Guzman" <joel_at_[hidden]> wrote
> 
> 
>>Arkadiy Vertleyb wrote:
>>
>>>Hi all,
>>>
>>>How do I generate the document-level index in the quickbook?  Right now
> 
> it
> 
>>>generates indexes for those sections that contain subsections, but not
> 
> the
> 
>>>top-level index.
>>
>>Something's not right here. It should be generated. Here's an
>>example from the python tutorial:
>>
>>http://www.boost.org/libs/python/doc/tutorial/doc/html/index.html
> 
> 
> Is it conditional on something inside the .qbk file?  By the way, your own
> quickbook documentation doesn't seem have a top-level index either ;-)
> 
> I am using this one that I got from one of your posts:
> 
> 
> http://cvs.sourceforge.net/viewcvs.py/*checkout*/boost/boost/tools/quickbook
> /doc/html/index.html?rev=HEAD

Ah yes. I understand now. The generation of the top-level index depends
on what you are generating. It's a BoostBook thing that I don't quite
understand yet. It somehow depends on the document-type. An article
will not have a top-level index; a library will. If you really want to
know why, you should probably ask the boost-docs list. I don't know
the answer. Anyway, I cross posted to the list. Let's continue this
discussion there.

Cheers,
-- 
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net