Re: Unable to get doxygen reference output with Boost documentation
Edward Diener <[email protected]> Sun, 06 Oct 2013 20:27:00 -0400
| Newsgroups | gmane.comp.lib.boost.documentation |
|---|---|
| Message-ID | <[email protected]> |
On 10/6/2013 7:20 PM, Daniel James wrote: > On 6 October 2013 23:19, Edward Diener <[email protected]> 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.