Re: [Boost-docs] Unable to get doxygen reference output with Boost documentation

Subject: Re: [Boost-docs] Unable to get doxygen reference output with Boost documentation
From: Edward Diener (eldiener_at_[hidden])
Date: 2013-10-07 03:17:45

On 10/6/2013 11:04 PM, Edward Diener wrote:
> On 10/6/2013 7:20 PM, Daniel James wrote:
>> On 6 October 2013 23:19, Edward Diener <eldiener_at_[hidden]> wrote:
>>> When i try to build Boost documentation for my VMD library I receive,
>>> at the
>>> end of the output:
>>>
>>> "xslt-xsltproc.windows ..\bin.v2\doc\msvc-11.0\debug\vmd.docbook
>>> file:///C:/Utilities/Docbook/xml/dbpoolx.mod:7254: validity error :
>>> Redefinition of element code
>>> <!ELEMENT code %ho; (%cptr.char.mix;)*>
>>>                                         ^
>> [snip]
>>>
>>> I am using the latest tools from the Boost trunk.
>>>
>>> Any ideas why I cannot produce a doxygen reference section ?
>>
>> I think you're using the wrong version of docbook. You need to use
>> docbook 4.2, boostbook isn't compatible with any other versions.
>
> I discovered what the problem was in not generating doxygen
> documentation. I needed to define more than one:
>
> <doxygen:param>PREDEFINED=xxx
>
> in my jamfile. How do I do that ? I can tell you that
>
> <doxygen:param>PREDEFINED=xxx
> <doxygen:param>PREDEFINED=yyy
> <doxygen:param>PREDEFINED=zzz
>
> does not work. It generates
>
> PREDEFINED = xxx
> PREDEFINED = yyy
> PREDEFINED = zzz
>
> in the doxygen configuration file but the correct syntax in the doxygen
> configuration file is:
>
> PREDEFINED = xxx \
>               yyy \
>               zzz

As an addendum specifying

<doxygen:param>PREDEFINED=xxx yyy zzz

leads to a bjam error.