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

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

Hello, Doxygen-users,

In Doxygen 1.8.10 (on Windows), is there any way to have different portions of the Doxygen comment block appear depending on which output is generated?

I was producing only HTML, and so I had nice tables of thumbnail images that the user can click to open a full-size page of the image. But now that I’ve added PDF (well, Doxygen->LaTeX->PDF), verbiage such as “click the thumbnail” doesn’t make sense. I’m using the full-size image for the “\image latex” instead of what I use for the html output (an <href> on the thumbnail that resolves to the full-size image).

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.

I know that I could use separate Doxyfile config files and the ENABLED_SECTIONS to selectively enable parts of the comments based on their output (for example; __INCLUDE_PDF-ONLY_CONTENT__ and __INCLUDE_HTML-ONLY_CONTENT__), but then that’s yet another configuration file to keep in sync. So I’m hoping for some smarter way to get Doxygen comments into only one output format.

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.

Thanks for any suggestions,
-Monique