Doxygen documentation after members and XML commands

I try to get the most out of doxygen and IntelliSense, and I find that the XML commands are pretty good here: the documentation is generated on the one hand, while it appears at the time of completion, on the other.

One catch is inline documentation after members.

As for doxygen manual mentions only one way to have the documentation after members: ///<. Unfortunately, this conflicts with Visual Studio, as shown here:

enum
{
    A, ///< Doxygen understands this, but IntelliSense is oblivious to it.
    B, ///  <summary>IntelliSense understands this, but Doxygen applies it to the wrong member.</summary>
    C, ///< <summary>Doxygen understand this, but IntelliSense considers it to be invalid XML.</summary>
};

Is there a way to write the documentation after the members in XML so that both Doxygen and Visual Studio understand it correctly, or should I return to the comments on the previous line?

+4
source share

Source: https://habr.com/ru/post/1545631/


All Articles