How to be able to extract comments from inside a function in doxygen?

c, c++, documentation, doxygen, java

Solution

No, doxygen does not support comments blocks inside function bodies. From the manual:

Doxygen allows you to put your documentation blocks practically anywhere (the exception is inside the body of a function or inside a normal C style comment block).

Section: Doxygen documenting the code

Problem

I'm interested to know if it is possible to have some comments in a function (c, c++, java) in a way that doxygen could put them in the generated html file. for example: ``` function(...) { do_1(); /** * Call do_2 function for doing specific stuff. */ do_2(); } ```

Original source