I'm documenting a C++/CLI header that wraps a native C++ class for use by a C# application. Each wrapper class declares an accessor for a reference to the underlying native class:
/// NativeFoo &. NativeFoo& getNative();
The generated XML fails to convert the ampersand to the entity & and VS2019 complains about this:
warning C4635: XML document comment applied to Foo'.getNative': badly-formed XML: Only one top level element is allowed in an XML document.
I can manually fix the XML comment to make VS2019 happy.