Where the API references is extracted from

Oct 24, 2012 at 10:05 AM


In my project I have referenced as Documentation sources both the assemblies and their xml files. The xml files contain the api of the assemblies, so I was under the impression that when building it will be read from there. So I went ahead and I removed the assemblies, and when attempted to build the project it required me to add a documentation source, even though the xml files were referenced.

So my question is where the api is extracted from - the assemblies or the xml files?

Oct 24, 2012 at 3:06 PM

XML comments files contain only the comments.  They contain no information about the inherited members or base classes.  For that, you do need the assemblies as that's where all that information comes from.  MRefBuilder parses the assemblies to generate the reflection information file.  The XML comments are used by BuildAssembler, matched up by member ID, to put the comments in each API topic.