Thanks, the Markdown support isn't something I use anyway, so turning that off  
in no problem.

Mats
________________________________
From: [email protected] [[email protected]] on behalf of Kyle Bygott 
[[email protected]]
Sent: 13 June 2013 17:03
To: Mats Behre
Cc: [email protected]
Subject: Re: [Doxygen-users] C# comments and blank lines

Mats--
I asked the same question to the list back in May (5/23, subject: "Markdown: 
Images and paragraph indentation") and never received a response.  One thing I 
found is that it is related to the new markdown capabilities.

I didn't think of the <br> workaround, another thing you can do is reformat all 
your comments to not indent.  Another option is to turn off markdown in your 
doxygen config file (faced with having to scrub through and reformat hundreds 
of lines of comments, that's what I had to resort to).

I wonder if the image tag is reverting the parser's understanding of 
indentation so that it then thinks that your line "More text" is indented >4 
spaces from the previous.  I'll file a bug report after all just so we can get 
some closure on it (if it is bugging more ppl than just me, probably worth it)

--Kyle


On Thu, Jun 13, 2013 at 1:07 AM, Mats Behre 
<[email protected]<mailto:[email protected]>> wrote:
Hi,

When I have blank lines (starting with ///) in C# comments (for readability in 
the source file) doxygen in some cases seems to get into a code mode; the 
following text is put inside a box.
It doesn't always happen, but one situation is after an image.

Example:
        /// <summary>
        ///             Brief text.
        /// </summary>
        /// <remarks>
        ///             Text.
        ///             @image html picture.png
        ///
        ///             More text.
        ///     </remarks>
        class Test {
        }


It doesn't matter if the picture exists or not, the result is the same.
If I put a <br/> on the blank line everything is OK, so the issue can be worked 
around.

Is this a known behaviour, and is it desired for some reason?

Tritech Technology AB

Mats Behre


[email protected]<mailto:[email protected]>
+46 733 45 87 55<tel:%2B46%20733%2045%2087%2055>

www.tritech.se<http://www.tritech.se>
+46 8 410 120 00<tel:%2B46%208%20410%20120%2000>
J?rnv?gsgatan 10
PO Box 1094, SE-172 22 Sundbyberg, Sweden


------------------------------------------------------------------------------
This SF.net email is sponsored by Windows:

Build for Windows Store.

http://p.sf.net/sfu/windows-dev2dev
_______________________________________________
Doxygen-users mailing list
[email protected]<mailto:[email protected]>
https://lists.sourceforge.net/lists/listinfo/doxygen-users

------------------------------------------------------------------------------
This SF.net email is sponsored by Windows:

Build for Windows Store.

http://p.sf.net/sfu/windows-dev2dev
_______________________________________________
Doxygen-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/doxygen-users

Reply via email to