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 00:27:00

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.
>

When I switched to docbook 4.2 the dbpoolx.mod messages went away but I 
still received the messages:

warning: cannot find macro `BOOST_VMD_IS_EMPTY'
warning: cannot find macro `BOOST_VMD_IS_BEGIN_PARENS'
warning: cannot find macro `BOOST_VMD_REMOVE_PARENS'
warning: cannot find macro `BOOST_VMD_ASSERT_IS_ARRAY'
warning: cannot find macro `BOOST_VMD_ASSERT_IS_LIST'
warning: cannot find macro `BOOST_VMD_ASSERT_IS_SEQ'
warning: cannot find macro `BOOST_VMD_ASSERT_IS_TUPLE'"

and my reference is completely empty of any documentation for my macros. 
This is strange since using doxygen directly does create the necessary 
documentation for the macros. Of course I need that reference to be 
generated. Also I can clearly see that doxygen is finding the header 
files where the macros exist, so I don't understand why it is not 
generating the documentation for them. I will look at the intermediate 
files and see what I can find.