I recognized two issues in commenting (XML style) Visual C++/CLI generic functions. Typed functions behave as expected.
System configuration is Windows 7 and Visual Studio Premium 2013. The project is a C++/CLI project and outputs a DLL.
Description
If I "split" the function declaration over two lines, the comments will be displayed NOWHERE. Not in the same C++/CLI project, nor in C# projects using it and Visual Studios' Object Browser displays nothing, too:
/// <summary>
/// Does something with <paramref name="col"/>.
/// </summary>
/// <remarks>VS does not like me :-(</remarks>
/// <typeparam name="T">Types allowed derive from class <see cref="CClassA"/>. These (actually) are ...</typeparam>
/// <param name="col">Collection to do something with.</param>
generic<class T> where T : CClassA
static void DoSomething(IEnumerable<T>^ col);
If the whole declaration is arranged on a single line, the comments only show up in the same C++/CLI project:
/// SAME COMMENT AS ABOVE
generic<class T> where T : CClassA static void DoSomething(IEnumerable<T>^ col);
Question:
Does anybody know, how to re-write the comment to show up in projects using the generic function?
