I regularly stumble over sections wrapped in
#ifndef DOXYGEN which are parts of the codebase that are obviously not intended to be documented by Doxygen. I think this syntax is quite readable and I’d like to adopt it.
However, I haven’t seen this in any other code so far and googling for it does not give a lot of results for other people doing the same thing. So can I expect this to work in all cases or does it need any special Doxygen settings to get parsed correctly or to make Doxygen activate the
DOXYGEN macro while running?