Re: [boost] QuickBook question

Subject: Re: [boost] QuickBook question
From: Daniel James (dnljms_at_[hidden])
Date: 2010-12-29 16:28:34

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? 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]

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

Daniel