Link to code: https://github.com/symphonyoss/plexus-interop
/// <summary>
/// Log a message with the specified <paramref name="logLevel"/>.
/// </summary>
/// <param name="logLevel">The level of log entry.</param>
/// <param name="exception">The exception to log.</param>
/// <param name="message">The format of the message object to log.<see cref="string.Format(string,object[])"/> </param>
/// <param name="arg1">The first argument for message formatting.</param>
[StringFormatMethod("format")]
void Log<T1>(LogLevel logLevel, [CanBeNull] Exception exception, string message, T1 arg1);What's even worse is that Visual Studio 2015 just vomits out that the XML is malformed when I have C++ headers with Doxygen style comments in them. It detects the three slashes and tries to apply C# XML docs parsing to them and that of course fails. Meanwhile NetBeans can handle them no problem and display parsed docs in pop ups.
It's not an essential part of the language. It's something that is used by the IDE and doc-generation tools. Comments inside the method that follows will not be so verbose (one hopes).