Visual Studio 2012 IntelliSense with Visual Assist X and Doxygen

I used to write simple comments in my style header files

// Returns a new string in which all occurrences of a specified string in the
// current instance are replaced with another specified string.
// - strSubject: The string to perform the replacement on.
// - strOldValue: The string to be replaced.
// - strNewValue: The string to replace all occurrences of strOldValue.
static RUNTIME_API String::type Replace
    (_In_       String::type  strSubject,
     _In_ const String::type& strOldValue,
     _In_ const String::type& strNewValue);

so that Visual Assist displays me this particular comment:

IntelliSense

I am currently thinking of using Doxygen to create documentation for a project, however I am struggling with finding a documentation style that displays correctly in tooltips and can be analyzed using Doxygen. At first I thought about including Doxygen-style comments in * .cpp files to get only the displayed header comments. So in my source file I have a comment like

/*!
 * Returns a new string in which all occurrences of a specified string in the
 * current instance are replaced with another specified string.
 *
 * \param   strSubject  The string to perform the replacement on.
 * \param   strOldValue The string to be replaced.
 * \param   strNewValue The string to replace all occurrences of strOldValue.
 * 
 * \return  A string that is equivalent to the current string except that all
 *          instances of strOldValue are replaced with strNewValue. If
 *          strOldValue is not found in the current instance, the method returns
 *          the current instance unchanged.
 */
String::type String::Replace
    (_In_       String::type  strSubject,
     _In_ const String::type& strOldValue,
     _In_ const String::type& strNewValue) { /* ... */ }

Surprisingly, I get two different outputs when this function hangs or when I get Visual Assists "IntelliSense". Pointing Replacegives

Hover tooltip

IntelliSense

enter image description here

Doxygen

enter image description here

, , doxygen Qt, IntelliSense ( , ) , , ? . ( , doxygen - , )

+5
1

( ), , , Visual Studio

#if 0
/*! your comment
*/
#endif

, #endif, , , . , VS2013 #if 0. , .

0

All Articles