Documentation of Objects

[Mike Morse]

Dies anyone know of a good way to document your classes.
I currently use the VB commenter for VS.net 2003 but that
does not provide any intellisence functionality for my
objects like description and such. Also when you select
tools > build comment web pages... I find these web pages
to be almost useless and less than satisfactory as
documentation.

I would really like to know how to document my objects
better.

Thanks All!

-mike

[Kevin Spencer]

Use C#, and Summary Tags.

--
HTH,

Kevin Spencer
Microsoft MVP
..Net Developer
http://www.takempis.com
Big things are made up of
lots of little things.

"Mike Morse" <mi********@micromo.com> wrote in message
news:00****************************@phx.gbl...

Dies anyone know of a good way to document your classes.
I currently use the VB commenter for VS.net 2003 but that
does not provide any intellisence functionality for my
objects like description and such. Also when you select
tools > build comment web pages... I find these web pages
to be almost useless and less than satisfactory as
documentation.

I would really like to know how to document my objects
better.

Thanks All!

-mike

[Bill Priess]

LOL.. to think, I was going to make the same suggestion...

Mike, unfortunatly, unless you use a VS.NET addin, you are not going to get
much use out of VB's meager commenting features. At least, not like you
would with C# and it's XML Documentation. I have seen one commenter that is
nice, but a bit pricey. CodeSmart for VS.NET (http://www.axtools.com/).

Anyhow,

HTH,

Bill Priess

On Wed, 23 Jul 2003 12:50:49 -0700, mike morse <mi********@micromo.com>
wrote:

Your f'n kiddig me. Yeah, why don't I just switch languages.

-----Original Message-----
Use C#, and Summary Tags.

-- HTH,

Kevin Spencer
Microsoft MVP
..Net Developer
http://www.takempis.com
Big things are made up of
lots of little things.

"Mike Morse" <mi********@micromo.com> wrote in message
news:00****************************@phx.gbl...

Dies anyone know of a good way to document your classes.
I currently use the VB commenter for VS.net 2003 but that does not provide any intellisence functionality for my
objects like description and such. Also when you select
tools > build comment web pages... I find these web pages to be almost useless and less than satisfactory as
documentation.

I would really like to know how to document my objects
better.

Thanks All!

-mike

.

--
Using M2, Opera's revolutionary e-mail client: http://www.opera.com/m2/

[Kevin Spencer]

In that case, wait until MS provides Summary Tags for VB.Net.

--
HTH,

Kevin Spencer
Microsoft MVP
..Net Developer
http://www.takempis.com
Big things are made up of
lots of little things.

"mike morse" <mi********@micromo.com> wrote in message
news:01****************************@phx.gbl...

Your f'n kiddig me. Yeah, why don't I just switch
languages.

-----Original Message-----
Use C#, and Summary Tags.

--
HTH,

Kevin Spencer
Microsoft MVP
..Net Developer
http://www.takempis.com
Big things are made up of
lots of little things.

"Mike Morse" <mi********@micromo.com> wrote in message
news:00****************************@phx.gbl...

Dies anyone know of a good way to document your classes.
I currently use the VB commenter for VS.net 2003 but that does not provide any intellisence functionality for my
objects like description and such. Also when you select
tools > build comment web pages... I find these web pages to be almost useless and less than satisfactory as
documentation.

I would really like to know how to document my objects
better.

Thanks All!

-mike

.

[Yan-Hong Huang[MSFT]]

Hello Mike,

XML comments is only supported in C# now. Please refer to
http://msdn.microsoft.com/msdnmag/is...C/default.aspx for details.

If you want to do it in other languages, I think you need to install some third party add-in or etc.

Thanks.

Best regards,
Yanhong Huang
Microsoft Online Partner Support

Get Secure! - www.microsoft.com/security
This posting is provided "AS IS" with no warranties, and confers no rights.

--------------------
!Content-Class: urn:content-classes:message
!From: "mike morse" <mi********@micromo.com>
!Sender: "mike morse" <mi********@micromo.com>
!References: <00****************************@phx.gbl> <u$*************@TK2MSFTNGP12.phx.gbl>
!Subject: Re: Documentation of Objects
!Date: Wed, 23 Jul 2003 12:50:49 -0700
!Lines: 38
!Message-ID: <01****************************@phx.gbl>
!MIME-Version: 1.0
!Content-Type: text/plain;
! charset="iso-8859-1"
!Content-Transfer-Encoding: 7bit
!X-Newsreader: Microsoft CDO for Windows 2000
!X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4910.0300
!Thread-Index: AcNRU7dB1HNJBzx5SaqeosxcsVGJ/Q==
!Newsgroups: microsoft.public.dotnet.framework.aspnet
!Path: cpmsftngxa06.phx.gbl
!Xref: cpmsftngxa06.phx.gbl microsoft.public.dotnet.framework.aspnet:161501
!NNTP-Posting-Host: TK2MSFTNGXA12 10.40.1.164
!X-Tomcat-NG: microsoft.public.dotnet.framework.aspnet
!
!Your f'n kiddig me. Yeah, why don't I just switch
!languages.
!
!>-----Original Message-----
!>Use C#, and Summary Tags.
!>
!>--
!>HTH,
!>
!>Kevin Spencer
!>Microsoft MVP
!>..Net Developer
!>http://www.takempis.com
!>Big things are made up of
!>lots of little things.
!>
!>"Mike Morse" <mi********@micromo.com> wrote in message
!>news:00****************************@phx.gbl...
!>> Dies anyone know of a good way to document your classes.
!>> I currently use the VB commenter for VS.net 2003 but
!that
!>> does not provide any intellisence functionality for my
!>> objects like description and such. Also when you select
!>> tools > build comment web pages... I find these web
!pages
!>> to be almost useless and less than satisfactory as
!>> documentation.
!>>
!>> I would really like to know how to document my objects
!>> better.
!>>
!>> Thanks All!
!>>
!>> -mike
!>
!>
!>.
!>
!