Re: [Doxygen-develop] [PATCH] Support for C++ comments next to arguments of macro function

[Albert <alb...@gm...>]

Dear Christian,

Not sure if this is wanted., especially when the second part of the comment
spans multiple lines. In this case we see now multiple lines in the comment
although the intention, by the documentation writer, was just one block but
this could lead to an incredible long line in the original source.

Albert

<http://www.avg.com/email-signature?utm_medium=email&utm_source=link&utm_campaign=sig-email&utm_content=webmail>
Virus-free.
www.avg.com
<http://www.avg.com/email-signature?utm_medium=email&utm_source=link&utm_campaign=sig-email&utm_content=webmail>
<#DAB4FAD8-2DD7-40BB-A1B8-4E2AA1F9FDF2>

On Sun, Dec 10, 2017 at 8:14 PM, Christian Schoenebeck via Doxygen-develop <
dox...@li...> wrote:

> On Sonntag, 10. Dezember 2017 19:50:06 CET Albert wrote:
> > Dear Christian,
> >
> > What happens in case of multi-line inline comments?
> > E.g.:
> > DECLARE_ENUM(Foo_t,
> >      foo1 = 0x000000001, ///< First comment.
> >                                     ///< continuation of first comment
> >      foo2 = 22, ///< Second comment.
> >                     ///< continuation of second comment
> >      foo3
> >  );
>
> Internally that example macro would first be expanded by the lexer like
> this:
>
> enum Foo_t {     foo1 = 0x000000001, /**< First comment. */
>                     /**< continuation of first comment */     foo2 = 22,
> /**< Second comment. */                    /**< continuation of second
> comment */     foo3 };
>
> Everything in one line at this point.
>
> And in the final (i.e. html) document the enum member "foo1" for example
> would then end up with the following explanation text (tested):
>
> ---------------------------
> First comment
> [NEW-LINE]
> continuation of first comment
> ---------------------------
>
> Best regards,
> Christian Schoenebeck
>
> ------------------------------------------------------------
> ------------------
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> _______________________________________________
> Doxygen-develop mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-develop
>