By using this site, you agree to our updated Privacy Policy and our Terms of Use. Manage your Cookies Settings.
425,696 Members | 2,213 Online
Bytes IT Community
+ Ask a Question
Need help? Post your question and get tips & solutions from a community of 425,696 IT Pros & Developers. It's quick & easy.

Where are my comments???

P: n/a
Hey all.
I've noticed while programming in C# using vs.net 2003 that my xml comments
(ex. the ///<summary> comments) will not show up in intellisense or the
object browser unless all of the classes are in the same namespace. For
instance, if I create a new winform application that references my class
library, the comments for the classes in the library will not show up when I
view them in the object browser or when I write code that utilizes them
(through auto list members). However, the comments for the microsoft FCL
code still appear. Does anyone know if this is a bug in visual studio or I
am missing an attribute or something? Has anyone else experienced this?

Paul.

Nov 16 '05 #1
Share this Question
Share on Google+
3 Replies


P: n/a
The XML file that contains the documentation for your library needs to be in
the same directory as the assembly itself (that is, the folder from where
you're referencing it), unless it's in the GAC, in which case IIRC it needs
to be in the framework runtime directory.

Also the name of the XML file itself needs to match the DLL. "MyLib.dll"
will be matched by VS.NET with "MyLib.xml" but not with "My_Lib.xml".
--
Klaus H. Probst, MVP
http://www.vbbox.com/
"Paul Loveless" <pa****@rogers.com> wrote in message
news:df************@news04.bloor.is.net.cable.roge rs.com...
Hey all.
I've noticed while programming in C# using vs.net 2003 that my xml comments (ex. the ///<summary> comments) will not show up in intellisense or the
object browser unless all of the classes are in the same namespace. For
instance, if I create a new winform application that references my class
library, the comments for the classes in the library will not show up when I view them in the object browser or when I write code that utilizes them
(through auto list members). However, the comments for the microsoft FCL
code still appear. Does anyone know if this is a bug in visual studio or I
am missing an attribute or something? Has anyone else experienced this?

Paul.

Nov 16 '05 #2

P: n/a
Thanks for the reply. That solved it.

Paul

"Klaus H. Probst" <us*******@vbbox.com> wrote in message
news:uK***************@TK2MSFTNGP10.phx.gbl...
The XML file that contains the documentation for your library needs to be in the same directory as the assembly itself (that is, the folder from where
you're referencing it), unless it's in the GAC, in which case IIRC it needs to be in the framework runtime directory.

Also the name of the XML file itself needs to match the DLL. "MyLib.dll"
will be matched by VS.NET with "MyLib.xml" but not with "My_Lib.xml".
--
Klaus H. Probst, MVP
http://www.vbbox.com/
"Paul Loveless" <pa****@rogers.com> wrote in message
news:df************@news04.bloor.is.net.cable.roge rs.com...
Hey all.
I've noticed while programming in C# using vs.net 2003 that my xml comments
(ex. the ///<summary> comments) will not show up in intellisense or the
object browser unless all of the classes are in the same namespace. For
instance, if I create a new winform application that references my class
library, the comments for the classes in the library will not show up when I
view them in the object browser or when I write code that utilizes them
(through auto list members). However, the comments for the microsoft FCL
code still appear. Does anyone know if this is a bug in visual studio or

I am missing an attribute or something? Has anyone else experienced this?

Paul.


Nov 16 '05 #3

P: n/a
Hi Paul L,

I agree with Klaus comments. Just remember to generate your xml file.

If you had not generate it out yet, do this:

Go to your project in the solution explorer. Right click the Project and select properties.

The Property Pages will appear, on the left pane, select Configuration Properties and Build.

Under the outputs section, enter ABC.xml (depends what is your project name) in the XML Documentation File textbox.

Build it, and it will generate the xml file automatically for you.

Good Luck!
--
Regards,
Chua Wen Ching :)
"Paul L" wrote:
Thanks for the reply. That solved it.

Paul

"Klaus H. Probst" <us*******@vbbox.com> wrote in message
news:uK***************@TK2MSFTNGP10.phx.gbl...
The XML file that contains the documentation for your library needs to be

in
the same directory as the assembly itself (that is, the folder from where
you're referencing it), unless it's in the GAC, in which case IIRC it

needs
to be in the framework runtime directory.

Also the name of the XML file itself needs to match the DLL. "MyLib.dll"
will be matched by VS.NET with "MyLib.xml" but not with "My_Lib.xml".
--
Klaus H. Probst, MVP
http://www.vbbox.com/
"Paul Loveless" <pa****@rogers.com> wrote in message
news:df************@news04.bloor.is.net.cable.roge rs.com...
Hey all.
I've noticed while programming in C# using vs.net 2003 that my xml

comments
(ex. the ///<summary> comments) will not show up in intellisense or the
object browser unless all of the classes are in the same namespace. For
instance, if I create a new winform application that references my class
library, the comments for the classes in the library will not show up when
I
view them in the object browser or when I write code that utilizes them
(through auto list members). However, the comments for the microsoft FCL
code still appear. Does anyone know if this is a bug in visual studio or

I am missing an attribute or something? Has anyone else experienced this?

Paul.



Nov 16 '05 #4

This discussion thread is closed

Replies have been disabled for this discussion.