[boost] QuickBook question

29 Dec 2010

      I am working one some quickbook docs and they start out like this:
...
[library The Boost Algorithm Library
    [quickbook 1.5]
    [id algorithm]
    [dirname algorithm]
    [purpose Library of useful algorithms]
    [category algorithms]
    [authors [Clow, Marshall]]
    [copyright 2010 Marshall Clow]
    [source-mode c++]
    [license
      Distributed under the Boost Software License, Version 1.0.
      (See accompanying file LICENSE_1_0.txt or copy at
      [@http://www.boost.org/LICENSE_1_0.txt])
    ]
]
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?

-- Marshall