Le dimanche 6 octobre 2013 07:42:23 Paolo Greppi a écrit : > I found that you can get what you want if both a brief and a detailed > description is available for each struct member. The detailed > descriptions are then shown in the file Data Structure Documentation > section.
Thanks for pointing this out. Indeed, the brief description gets totally
ignored, but it works using long description. It appears more clearly if
the brief descriptions are explicit:
/**
* \brief Test structure (this appears)
*
* Detailed description of the test structure.
*/
struct mystruct {
/**
* \brief Doxygen ignores this.
*
* An int.
*/
int i;
/**
* \brief Doxygen ignores this as well.
*
* A char.
*/
char c;
};
> Curiously, a blank line is also required between each member.
I suppose that is because otherwise the following /// line is considered
as the sequel of the previous ///<, so in your example the second “A
public variable” gets attached to “An int”. That's probably due to
MULTILINE_CPP_IS_BRIEF in the Doxyfile.
I'm going to update the upstream bug with this new information, thanks
again for your help.
Matteo
signature.asc
Description: This is a digitally signed message part.
