[Doxygen-develop] Seamless documentation for project with C++ and VHDL

[Martin Z. <mar...@df...>]

Hi,

I'm setting up a documentation about some sort of library which consists
of a C/C++ part and a VHDL part, plus some instructive doxygen-only
pages. They have to be put into one self-contained group with several
subgroups separated by language and so on. Everything works so far, nice
and fluffy...

But what if I want to optimise the output in the vhdl-subdirectory by
using 'OPTIMISE_OUTPUT_VHDL = YES' and optimise the output of the
c-subdirectory by using 'OPTIMISE_OUTPUT_C = YES' at the same time?

As far as I understand, using doxygen-tags is not optimal in my case,
since it introduces new doxyfile.conf-files in each subdirectory, with
independent runs of doxygen in each subdirectory. So, doing this I can't
put both parts (c and vhdl) in different subgroups of the same group
any more, and links between the two parts are not possible. Also, the
whole module should be "self-contained", to be includable into bigger
documentations, without the special build-structure involved in this
solution...

What would you do?


see also my earlier posts at Stackoverflow and doxygen-users about the
same problem:
http://stackoverflow.com/questions/5102770/doxygen-seamless-documentation-for-project-with-c-and-vhdl

http://sourceforge.net/mailarchive/forum.php?thread_name=1298967113.3440.153.camel%40mzenzes-u&forum_name=doxygen-users