https://bugzilla.gnome.org/show_bug.cgi?id=702189

--Kyle

On Thu, Jun 13, 2013 at 9:03 AM, Kyle Bygott <bygott...@hotmail.com> wrote:

> 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 <mats.be...@tritech.se> 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
>>
>>
>> mats.be...@tritech.se
>> +46 733 45 87 55
>>
>> www.tritech.se
>> +46 8 410 120 00
>> 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
>> Doxygen-users@lists.sourceforge.net
>> 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
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users

Reply via email to