| XmlCommentsFileFixupComments Method |
This is called to fix-up the comments for C++ compiler generated XML comments files.
Namespace: SandcastleBuilder.Utils.BuildEngineAssembly: SandcastleBuilder.Utils (in SandcastleBuilder.Utils.dll) Version: 2014.11.22.0
Syntax public void FixupComments()
public:
void FixupComments()
member FixupComments : unit -> unit
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.
See Also