Jonathan Sachs - 2017-07-05

I'm a member of a technical writing team, and I need to add a new repo to a Doxygen project that generates a large reference manual. This repo poses a problem because the engineers who own it do not only use it for software development; they also use it to generate a wiki from the Doxygen comments.

The problem is that our manual and their wiki have completely different structures. We need particular \defgroup and \ingroup commands to fit the repo's content into our existing document structure; the engineers need different ones (actually, in this case, none) to fit the content into theirs.

I planned to do this by wrapping our \defgroup and \ingroup in an \if... \endif block with a condition that is true for our doxygen build, and false for theirs. However, I've discovered that Doxygen won't allow \defgroup (or, presumably, \ingroup) in a conditional block.

What other approaches could we use to get the result we need?

We're using Doxygen 1.8.7 running under Windows. The engineers are using an unknown version, probably under Linux.

Note that adopting a different version of Doxygen is not an option here, at least not in the short run. 1.8.7 is a department standard, and is written into numerous pathnames and used by numerous projects. A change would require careful planning and extensive testing, and would take at least weeks (and lots of persuasiveness) to get approved.