The nested if/endif sample seems not to work as expected:
http://www.doxygen.nl/manual/commands.html#cmdif
It produces:
Unconditionally shown documentation. More text. Unconditional text.
But I would expect:
Unconditionally shown documentation. Unconditional text.
I tried several doxygen versions (also the currently latest v1.8.6). Does this sample work for anybody?
As a workaround I used:
/*! Unconditionally shown documentation.
* \if Cond1
* Only included if Cond1 is set.
* \endif
* \if Cond2
* Only included if Cond2 is set.
* \endif
* \if (Cond2 && Cond3)
* Only included if Cond2 and Cond3 are set.
* \endif
* \if Cond2
* More text.
* \endif
* Unconditional text.
*/
But I would prefer to use the nested style from the original sample.