VS.NET 2005 and VB.NET xml comments.

[Ray Cassick \(Home\)]

Has anyone played around with them on VB in the new version yet?

I am interested to get some feedback form people that have used this new
feature before I install next week.

I am using VBXC now to create the xml file and then using Ndoc to create the
help file, but VBCX has a bug in it where it will not create comments unique
comments for each member in an enum. Also, just looking to streamline my
tools a bit. VBXC has been good for me so far but this enum thing has me
thinking about a tool change (nothing negative towards the tool author at
all intended here).

Any comments


--
Raymond R Cassick
CEO / CSA
Enterprocity Inc.
www.enterprocity.com
3380 Sheridan Drive, #143
Amherst, NY 14227
V: 716-316-5973
Blog: http://spaces.msn.com/members/rcassick/

 

[Herfried K. Wagner [MVP]]

Has anyone played around with them on VB in the new version yet?

I am interested to get some feedback form people that have used this new
feature before I install next week.

I have only used it in the preview versions but XML comments worked pretty
well.

 

[Jay B. Harlow [MVP - Outlook]]

Ray,
From what I have used the XML comments in VB 2005 they seem to be extremely
well integrated.

I like the fact that they show up in the Object Browser & Intellisense while
you are working on the project, you don't need to wait for an explicit build
of your project to see them.

I added xml comments to an enum, both summary & remarks work for both the
enum itself & for the enum values themselves.

Intellisense shows the summary, while the object browser shows the Summary,
Parameters, Return Values, Exceptions and Remarks...

When you use the XML comments in VB 2005 & use "Edit - Outlining - Collapse
to definitions" you see the summary of the XML comment, which I rather like!

I understand that you will still need to use ndoc to create your final
documentation.

--
Hope this helps
Jay [MVP - Outlook]
..NET Application Architect, Enthusiast, & Evangelist
T.S. Bradley - http://www.tsbradley.net


| Has anyone played around with them on VB in the new version yet?
|
| I am interested to get some feedback form people that have used this new
| feature before I install next week.
|
| I am using VBXC now to create the xml file and then using Ndoc to create
the
| help file, but VBCX has a bug in it where it will not create comments
unique
| comments for each member in an enum. Also, just looking to streamline my
| tools a bit. VBXC has been good for me so far but this enum thing has me
| thinking about a tool change (nothing negative towards the tool author at
| all intended here).
|
| Any comments
|
|
| --
| Raymond R Cassick
| CEO / CSA
| Enterprocity Inc.
| www.enterprocity.com
| 3380 Sheridan Drive, #143
| Amherst, NY 14227
| V: 716-316-5973
| Blog: http://spaces.msn.com/members/rcassick/
|
|

 

[Ray Cassick \(Home\)]

Thanks.

Yeah, I figured I would still need to use NDoc (when it officially supports
2005 anyway).