views:

205

answers:

2

I know I can merge PDB with a DLL file but I'm trying to do the same with an XML documentation file.

It should be possible since you don't have .xml files with .net assemblies and yet you have documentation in the IDE.

Is there a way ?

A: 

ILMerge is only for merging DLLs and EXE's into one big DLL and EXE's respectively. The XML documentation is generated by the C# Compiler and ILMerge has nothing to do with it as it deals with the binary content of these files. If you were to think of ILMerge as Instruction Language Merge (ILMerge) that is all it does, no dealings with XML documentation. Sandcastle is a such documentation generator, by telling Sandcastle you want to build a Html Help or CHM of all xml comments, it will do that for you.

Hope this clarifies the understanding of ILMerge, Best regards, Tom.

tommieb75
Ok, but what about the way VStudio does it? I can't seem to find XML files for system libraries...
Stecy
Visual Studio knows about the source code which is organized into a part of a Solution, looking at the solution explorer, which can be more than one project listed underneath, VS can pull in all the xml comments in one fell swoop. System Libraries do not have XML files, remember this much, all xml comments are stripped by the compiler when it is generated into IL code. The MSDN is your friend when it comes to finding out about what the system libraries are, their namespaces, classes, methods, properties and events. Does this make sense?
tommieb75
+2  A: 

There's a command-line option for ILMerge to also merge the XML documentation /xmldocs.

Programming Hero
Unfortunately, merging of XML files produces one XML file outside of the assembly. I was looking for a way to have the XML embedded inside the assembly so as to only have one file (the assembly).
Stecy