visual studio .net documentation: Generated XML documentation file -- visual studio .net documentation

Generated XML documentation file

Jeff Walker
8/28/2007 6:54:05 AM

visual studio .net documentation: We have classes defined as follows.

Assembly Name: Root Namespace:
Carpenter.Components.MeltType Carpenter.Components

When the class is compiled, the following is generated
Carpenter.Components.MeltType.dll
Carpenter.Components.xml (Should be Carpenter.Components.MeltType.xml)

We are using VisualBuild to automate the build process and we are attempting
to produce all dlls to a release folder. The problem is when the next class
is built, it over writes the shortened xml file.

This works
Assembly Name: Root Namespace:
Carpenter_Components_MeltType Carpenter.Components

When the class is compiled, the following is generated
Carpenter_Components_MeltType.dll
Carpenter_Components_MeltType.xml

We prefer the . structure since it is more intuitive with the namespaces. I
was able to use a post build event to rename the file, but was hoping for a
better solution.

Thanks
--

Re: Generated XML documentation file

Stevanich
9/1/2007 2:31:00 PM

Jeff,

The XML documentation files are generated one per assembly, based on the
assembly's file name by default. You can change the XML documentation file
name manually in the *.*proj file.

In each configuration property group can be found:

<DocumentationFile>TestProject1.xml</DocumentationFile>

Hope this helps,

Steve - dotneticated.com

[quoted text, click to view]