Configure Doxygen to hide certain names or keywords

Question

I'm just getting started with Doxygen, and have done considerable searching on this, so forgive me if there's an obvious answer.

I'm working on an embedded project where functions can be tagged as debug or nodebug before the return type. In most of our libraries, we use a conditional macro to set libname_debug to either debug or nodebug at the top of the file, and then each function is prefaced with libname_debug.

For documentation purposes, I'd like to have Doxygen leave libname_debug out of the function documentation. It clutters up the function list and makes it harder to see the return types of each function.

Is it possible to tag the file in some way so Doxygen will leave that symbol out? At the moment, I'm wrapping each instance in @cond/@endcond:

/** @cond */ libname_debug /** @endcond */

But that's a pain and adds extra markup to the source.

Answer 1

You can define macros in the doxygen configuration file. Something like this

PREDEFINED += libname_debug