Re: [Doxygen-users] include/exclude comment content - based on html vs.latex ?

[Monique S. <mon...@ea...>]

>> As well, there are places where I'd like to simply refer people to a named section in the PDF, but in the HTML include an actual image.

> 

> You would just use \ref.  For either HTML or LaTeX.



No; what I meant was to use the equivalent of \ref to a .page file for the LaTeX output (which I've figured out how to do, with the nameref package), but in the HTML output, have the result of using the \image command to include the image.



<snip>



>> I do know about the \htmlonly and \latexonly commands, but then I really have to know how to deal with low-level LaTeX coding, which I'd prefer Doxygen took care of.

> 

> Doxygen will *still* take of it.  You don't really have to deal with 

> low-level LaTeX (or even HTML) coding, although there really isn't anything there

> anyway.   The \htmlonly and \latexonly don't mean those sections contain 

> either HTML or LaTeX, only that those sections should only be 

> processed for those specific output formats.  You would still use normal Doxygen commands.

> For the most part, you don't actually use any low-level LaTeX coding 

> -- in a sense, there isn't any such thing as "low-level LaTeX coding", 

> since *LaTeX* is pretty much a high level thing.



It would be lovely if things worked this way. But my quick trial didn't work at all. When I surrounded Doxygen comments (in a .page file, so perhaps it is different in a regular .c file's comments; I didn't try that) with \htmlonly and \endhtmlonly, all the Doxygen commands were simply output as text. And given the Doxygen documentation's description of this command (https://www.stack.nl/~dimitri/doxygen/manual/commands.html#cmdhtmlonly), "Starts a block of text that will be verbatim included in the generated HTML documentation only", I'm not surprised.



Another off-list reply said that they used sed scripting to manage multiple Doxyfile configuration files and then a preprocessing mechanism similar to what I'd described (using the ENABLED_SECTIONS for things such as __INCLUDE_PDF-ONLY__).



So I guess that's what I'll be doing.



Thanks for the help,

-Monique