>> 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
------------------------------------------------------------------------------
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users

Reply via email to