Just upgraded my doxygen and enabled markup, but noticed some funny
handling of my indentation levels when images get involved--not sure
if it is a bug or if my comments need to be reformatted. In my code
comments, I have a lot of sections/subsections/etc that I prefer to
indent for readability. Also for readability, I prefer to surround my
image commands with blanklines, which is apparently the root of the
trouble. In a simplified example, take:
/**
\page newpage Some Test Page
text
text
text
Start talking about the image
\image latex someimage.png "An image"
And continue talking about that subject
*/
>From this, doxygen produces the tex:
----------------------------------
text
text
text
Start talking about the image
\begin{DoxyImage}
\includegraphics{someimage.png}
\caption{An image}
\end{DoxyImage}
\begin{DoxyVerb}And continue talking about that subject\end{DoxyVerb}
----------------------------------
Notably, the "And continue talking..." paragraph has been interpreted
as an indented code section. Deleting the image or the blankline
between the image and the "And continue..." paragraph fixes things.
I'm supposing that the image command is resetting Doxygen's
understanding of previous paragraph indentation or being treated as a
paragraph of indentation 0 regardless of actual indentation, causing
that "And continue..." paragraph to be interpreted as indented enough
to trigger a code section.
What is the expected behavior here? Do I need to reformat my comments
to get rid of the blanklines if I want to enable Markdown? Or should
Doxygen be able to handle that comment without triggering a code
section on the "And continue" paragraph?
Thanks,
Kyle
------------------------------------------------------------------------------
Try New Relic Now & We'll Send You this Cool Shirt
New Relic is the only SaaS-based application performance monitoring service
that delivers powerful full stack analytics. Optimize and monitor your
browser, app, & servers with just a few lines of code. Try New Relic
and get this awesome Nerd Life shirt! http://p.sf.net/sfu/newrelic_d2d_may
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
