473,387 Members | 1,904 Online
Bytes | Software Development & Data Engineering Community
Post Job

Home Posts Topics Members FAQ

Join Bytes to post your question to a community of 473,387 software developers and data experts.

Problem with NDoc and overloaded properties

I have a set of properties in my assembly that look like this:

''' <overloads>
''' Allows the caller to have get or set access to an item in the
collection.
''' </overloads>
''' <summary>
''' Allows the caller to set or get an item from the collection using the
object.
''' </summary>
''' <param name="key">The item to reference.</param>
''' <returns>An object item from the collection.</returns>
Public Property Item(ByVal key As Object) As Object Implements
IDictionary.Item
Get
. . .
End Get
Set(ByVal value As Object)
. . .
End Set

End Property

''' <summary>
''' Allows the caller to set or get an item from the collection using the
items index.
''' </summary>
''' <param name="index">The index of the item to reference.</param>
''' <returns>An object item from the collection.</returns>
Public Property Item(ByVal index As Integer) As Object
Get
. . .
End Get
Set(ByVal value As Object)
. . .
End Set

End Property
They work just fone, but when I run the xml doc file through NDoc 1.3 it
tells me that I am missing:

The summary documentation for the second method (Missing <summary>
documentation for
P:Enterprocity.Base.Collections.KeyedList.Item(Sys tem.Int32) )

And I am missing the parameters documentation for the index param (Missing
<param> documentation for index)

The best I can see, these are the only two methods I am having issues with.
The rest of the assembly seems to be documented just fine.

Can anyone point out why I might be having this problem besides maybe a bug
in NDoc?

--
Raymond R Cassick
CEO / CSA
Enterprocity Inc.
www.enterprocity.com
3380 Sheridan Drive, #143
Amherst, NY 14227
V: 716-316-7537
Blog: http://spaces.msn.com/members/rcassick/
Nov 21 '05 #1
6 1279
KD
More likely, it's a bug in VBCommenter.

There was a bug in VBCommenter that caused it to sometimes 'lose' the
namespace part of parameters. Check the xml file and look at the signature
for the problem property, it should match the signature in the NDoc
'missing' message...

I believe that latest version of VBCommenter (1.2.5) may have finally fixed
this issue.

hope this helps,
Kevin
The summary documentation for the second method (Missing <summary>
documentation for
P:Enterprocity.Base.Collections.KeyedList.Item(Sys tem.Int32) )

And I am missing the parameters documentation for the index param (Missing
<param> documentation for index)

The best I can see, these are the only two methods I am having issues
with. The rest of the assembly seems to be documented just fine.

Can anyone point out why I might be having this problem besides maybe a
bug in NDoc?

Nov 21 '05 #2
I am building the xml comments using VBXC (http://vbxmldoc.tor-erik.net/)
not VBCommentor. I started using it a while ago (before the VBCommentor was
available) and like it. I have not seen this issue before which makes me
wonder if the problem is not more with NDoc V1.3...

I will check out the XML file though...

Thanks.

"KD" <kd@home> wrote in message news:eB*************@TK2MSFTNGP15.phx.gbl...
More likely, it's a bug in VBCommenter.

There was a bug in VBCommenter that caused it to sometimes 'lose' the
namespace part of parameters. Check the xml file and look at the signature
for the problem property, it should match the signature in the NDoc
'missing' message...

I believe that latest version of VBCommenter (1.2.5) may have finally
fixed this issue.

hope this helps,
Kevin
The summary documentation for the second method (Missing <summary>
documentation for
P:Enterprocity.Base.Collections.KeyedList.Item(Sys tem.Int32) )

And I am missing the parameters documentation for the index param
(Missing <param> documentation for index)

The best I can see, these are the only two methods I am having issues
with. The rest of the assembly seems to be documented just fine.

Can anyone point out why I might be having this problem besides maybe a
bug in NDoc?


Nov 21 '05 #3
Ray,

"Ray Cassick (Home)" <rc************@enterprocity.com> schrieb:
''' <overloads>
''' Allows the caller to have get or set access to an item in the
collection.
''' </overloads>
''' <summary>
''' Allows the caller to set or get an item from the collection using the
object.
''' </summary>
''' <param name="key">The item to reference.</param>
''' <returns>An object item from the collection.</returns>
Public Property Item(ByVal key As Object) As Object Implements
IDictionary.Item
Get
. . .
End Get
Set(ByVal value As Object)
. . .
End Set

End Property

''' <summary>
''' Allows the caller to set or get an item from the collection using the
items index.
''' </summary>
''' <param name="index">The index of the item to reference.</param>
''' <returns>An object item from the collection.</returns>
Public Property Item(ByVal index As Integer) As Object
Get
. . .
End Get
Set(ByVal value As Object)
. . .
End Set

End Property
They work just fone, but when I run the xml doc file through NDoc 1.3 it
tells me that I am missing:

The summary documentation for the second method (Missing <summary>
documentation for
P:Enterprocity.Base.Collections.KeyedList.Item(Sys tem.Int32) )

And I am missing the parameters documentation for the index param (Missing
<param> documentation for index)

The best I can see, these are the only two methods I am having issues
with. The rest of the assembly seems to be documented just fine.

Can anyone point out why I might be having this problem besides maybe a
bug in NDoc?


I didn't check it, but as C# doesn't support overloading of properties maybe
NDoc doesn't support comments for overloaded properties.

--
M S Herfried K. Wagner
M V P <URL:http://dotnet.mvps.org/>
V B <URL:http://classicvb.org/petition/>

Nov 21 '05 #4
KD
NDoc copes with overloaded properties ok.

It is pretty-much language agnostic; it just documents whatever it finds
using reflection over an assembly...

---
Kevin

"Herfried K. Wagner [MVP]" <hi***************@gmx.at> wrote in message
news:e3****************@TK2MSFTNGP14.phx.gbl...

I didn't check it, but as C# doesn't support overloading of properties
maybe NDoc doesn't support comments for overloaded properties.

--
M S Herfried K. Wagner
M V P <URL:http://dotnet.mvps.org/>
V B <URL:http://classicvb.org/petition/>

Nov 21 '05 #5
KD
Let us know what you find :)

---
Kevin

"Ray Cassick (Home)" <rc************@enterprocity.com> wrote in message
news:%2****************@TK2MSFTNGP14.phx.gbl...
I am building the xml comments using VBXC (http://vbxmldoc.tor-erik.net/)
not VBCommentor. I started using it a while ago (before the VBCommentor was
available) and like it. I have not seen this issue before which makes me
wonder if the problem is not more with NDoc V1.3...

I will check out the XML file though...

Thanks.

Nov 21 '05 #6
"KD" <kd@home> schrieb:
NDoc copes with overloaded properties ok.


Thank you for clarification.

--
M S Herfried K. Wagner
M V P <URL:http://dotnet.mvps.org/>
V B <URL:http://classicvb.org/petition/>
Nov 21 '05 #7

This thread has been closed and replies have been disabled. Please start a new discussion.

Similar topics

1
by: Marty McDonald | last post by:
I use the following, and then use Visual Studio's "Tools", "Build Comment Web Pages". But on the generated pages, the list elements don't show up as lists, just text that wrap around. Am I doing...
3
by: cybertof | last post by:
Hello, Is it possible in C# to have 2 overloaded functions with - same names - same parameters - different return type values If no, is it possible in another language ?
3
by: Jorel | last post by:
Hi. I am just running through the hello world tutorial and when I attempt to generate the comment web pages (like javadoc) it just creates a page with no content. Um....this is the tutorial and...
7
by: Ash Moollan [InfoMaster] | last post by:
Hi there, I am using NDOC to generate docs for one C# project which I wrote. My assembly has some public classes that are not meant to be used by others and I have not documented them. I would...
11
by: julien | last post by:
Hello, I posted this question on the NDoc-user mailing list, but it looks like a dead list (no messages for 10 days!). I'd like to use NDoc tags or custom tags inside methods like: void...
2
by: ajikoe | last post by:
Hi, I tried to follow the example in swig homepage. I found error which I don't understand. I use bcc32, I already include directory where my python.h exist in bcc32.cfg. /* File : example.c...
7
by: Dino Buljubasic | last post by:
Hi, I am using C# 2.0 (VS2005) to build my user control that contains a number of dynamically loaded ListViews. ListViewItems have their ForeColor properties set to either black or blue to...
8
by: Kuldeep | last post by:
Framework: Visual Studio 2005 Technology: ASP.NET 2.0 Language: C#.NET 2.0 Hi All, Could any one of you please let me know how to use NDoc in Visual Studio 2005. If there is a source where...
4
by: Peter Lykkegaard | last post by:
Hi gotdotnet is being phased out Anyone knows where I get a copy of the NDOC add-on for VB.NET? Yeah I know about time to move on and start using VS 2005 :) tia/Peter (repost from...
0
by: taylorcarr | last post by:
A Canon printer is a smart device known for being advanced, efficient, and reliable. It is designed for home, office, and hybrid workspace use and can also be used for a variety of purposes. However,...
0
by: Charles Arthur | last post by:
How do i turn on java script on a villaon, callus and itel keypad mobile phone
0
by: aa123db | last post by:
Variable and constants Use var or let for variables and const fror constants. Var foo ='bar'; Let foo ='bar';const baz ='bar'; Functions function $name$ ($parameters$) { } ...
0
by: ryjfgjl | last post by:
In our work, we often receive Excel tables with data in the same format. If we want to analyze these data, it can be difficult to analyze them because the data is spread across multiple Excel files...
0
by: emmanuelkatto | last post by:
Hi All, I am Emmanuel katto from Uganda. I want to ask what challenges you've faced while migrating a website to cloud. Please let me know. Thanks! Emmanuel
1
by: nemocccc | last post by:
hello, everyone, I want to develop a software for my android phone for daily needs, any suggestions?
0
by: Hystou | last post by:
There are some requirements for setting up RAID: 1. The motherboard and BIOS support RAID configuration. 2. The motherboard has 2 or more available SATA protocol SSD/HDD slots (including MSATA, M.2...
0
marktang
by: marktang | last post by:
ONU (Optical Network Unit) is one of the key components for providing high-speed Internet services. Its primary function is to act as an endpoint device located at the user's premises. However,...
0
jinu1996
by: jinu1996 | last post by:
In today's digital age, having a compelling online presence is paramount for businesses aiming to thrive in a competitive landscape. At the heart of this digital strategy lies an intricately woven...

By using Bytes.com and it's services, you agree to our Privacy Policy and Terms of Use.

To disable or enable advertisements and analytics tracking please visit the manage ads & tracking page.