[Doxygen-users] Variation on @latexonly, @htmlonly

[Gilligan, J. M <jon...@va...>]

With all the possible output options Doxygen offers, I wonder 
whether anyone has a solution to the following:

For LaTeX output, I want some LaTeX-specific markup, so I can use 
@latexonly and @endlatexonly. For the HTML output I can use 
@htmlonly, @endhtmlonly. But what can I do to specify output for 
other formats? It would be nice if there were the equivalent of an 
@else command.

Example:

/// Pythagoras's theorem:
/// @latexonly
/// @f$ a^2 + b^2 = c^2 @f$
/// @endlatexonly
/// @htmlonly
/// a<sup>2</sup> + b<sup>2</sup> = c<sup>2</sup>
/// @endhtmlonly

I would like to specify something to be used if neither latex nor 
html applies (e.g., RTF or XML).

I can do this for different languages:

/// @if french Bonjour Good morning
/// @elseif spanish Buenos dias
/// @else Hello
/// @endif

because doxygen enables sections according to the language being 
used, but it does not seem possible to enable sections 
conditionally depending on the kind of output being generated. Am I 
missing something here?

Perhaps a future version could generalize the @latexonly/@htmlonly 
concept to a syntax such as
/// @ifoutput latex ...
/// @elseifoutput html ...
/// @elseifoutput rtf ...
/// @elseoutput ...
/// @endifoutput.