This is called to fixup the comments for C++ compiler generated XML comments files.
Namespace: SandcastleBuilder.Utils.BuildEngineAssembly: SandcastleBuilder.Utils (in SandcastleBuilder.Utils.dll) Version: 1.9.7.0
Syntax
| C# |
|---|
public void FixupComments() |
| Visual Basic |
|---|
Public Sub FixupComments |
Remarks
The C++ compiler generates method signatures that differ from the other .NET compilers
for methods that take generics as parameters. These methods fail to get documented as they do
not match the output of MRefBuilder. The C# and VB.NET compilers generate names that do
match it and this option is not needed for comments files generated by them. The C++ compiler
also has problems resolving references to some members if it hasn't seen them yet. These are
prefixed with "!:" which is removed by the fix-up code. Parameters that use
interior_ptr<T> also do not match the reflection output and need to be converted to
the explicit dereference syntax.