Re: [boost] QuickBook question

Subject: Re: [boost] QuickBook question
From: Marshall Clow (mclow.lists_at_[hidden])
Date: 2010-12-29 17:54:58

On Dec 29, 2010, at 1:28 PM, Daniel James wrote:

> On 29 December 2010 21:18, Marshall Clow <mclow.lists_at_[hidden]> wrote:
>> 
>> Later (in the same file), I want to drop a link.
>> So, I write:
>>> [link algorithm.all.none_of_if none_of_if1]
>> 
>> (where all is a section, and none_of_if is a heading in that section)
>> 
>> but this doesn't work!
>> Some investigation shows that
>>> [link the_boost_algorithm_library.all.none_of_if none_of_if2]
>> 
>> does work - even though the documentation says that the first element in the link is the document id, not the document title.
>> 
>> Am I misunderstanding something?
> 
> Is 'all' in an included file?

Yes, it is.

> There's a bug which messes up explicit
> ids when including files. I can't fix it without a version switch
> because it'll break a lot of existing documentation (I've already got
> the fix in place for quickbook 1.6). What you have to do is explicitly
> specify the id when including a file. So:
> 
> [library The Boost Algorithm Library
> [quickbook 1.5]
> [id algorithm]
> ...
> ]
> 
> [include:algorithm file.qbk]

Thanks!
That fixed it.

> If you want to see a real example, I do this in both the unordered and
> hash documentation.

I'll take a look.
Next up: figuring out how to automatically generate a TOC and index ;-)

-- Marshall