I came across the reference to the self-documenting comment tags that can be
embedded in the C# source code (e.g., ///<summary>) and used to generate an
XML file that describes the code. This looks interesting, but I have some
concerns.
1. If I enable this for a single project, add some tags for most objects,
specify the XML output file name, then I can build the project with no
problems and the XML file is created -- but if I attempt to build the
solution it complains that not all of the members of every structure I
defined have a tag associated with them! Why this discrepency and how do I
convince the solution build to permit this?
2. I am permitted to enter the name of the XML file to generate, but I
cannot put a relative path in front of the name -- if I do then the "Apply"
button erases the text that I entered.
3. Is there some facility available that will convert the genersted XML into
a documentation dictionary? The XML file is cool, but I do not see it as
being much use outside of the IDE itself.
4. The documentation indicates that the commentes entered are used for
intellisense and the object browser displays -- do I have to generate the
XML file to get these beefits, or merely define the tags?
-Ken