Function definition tips in class or assembly????

[Serge Calderara]

dear all,

when I use classes function from framework, I could see a
small tooltips wich is showing parameters to pass to the
function but in addition a brief derscription of each.

When doing my own function, is there a way to display as
well description of each parameters when implementing that
function?

thanks
regards

[Jon Skeet]

Serge Calderara <se*************@maillefer.net> wrote:

when I use classes function from framework, I could see a
small tooltips wich is showing parameters to pass to the
function but in addition a brief derscription of each.

When doing my own function, is there a way to display as
well description of each parameters when implementing that
function?

If you're writing in C#, you can add XML documentation to the methods
etc - and within that XML documentation you can describe the parameters
using the <param> element.

--
Jon Skeet - <sk***@pobox.com>
http://www.pobox.com/~skeet/
If replying to the group, please do not mail me too

[Rob Epstein]

To follow up on John's spot on comment, above the function you wish to
document simply type "///". This will cause VS.NET to put the framework
of tags required for building complete documentation that can be used by
VS.NET for intellityping. You will also need to go into your project
properties and under Configuration Properties>Build specify a value for
XML Documentation File. If my project name is TestProject, then I would
set XML Documentation File to \bin\Debug\TestProject.xml. You then
distribute the XML file to developers who will be using your namespace.
If the XML file is in the same directory as the DLL then VS.NET will
show them the comments you added to the functions.

Hope that makes sense.
Rob Epstein
Sr Developer
Auctionworks, Inc.
"Nothing's impossible until proven so" - Me

Serge Calderara wrote:

dear all,

when I use classes function from framework, I could see a
small tooltips wich is showing parameters to pass to the
function but in addition a brief derscription of each.

When doing my own function, is there a way to display as
well description of each parameters when implementing that
function?

thanks
regards

[calderara serge]

Unfortunatly I am using Visual basic.
is there other way?

*** Sent via Developersdex http://www.developersdex.com ***
Don't just participate in USENET...get rewarded for it!

[Jon Skeet]

calderara serge <se*************@maillefer.net> wrote:

Unfortunatly I am using Visual basic.
is there other way?

Search for
VB.NET XML documentation
on Google - there are lots of hits. I don't know if any of them plug
into VS.NET though.

--
Jon Skeet - <sk***@pobox.com>
http://www.pobox.com/~skeet/
If replying to the group, please do not mail me too