Comment Inheritance

[Tris.Phillips]

Hi All,

This may be a silly question, but:
Is it possible for a child class to inherit a base classes <summary>
tag info for an overridden method?

Cheers,

T

[Clive Dixon]

No. I also asked this question some time ago! It is very frustrating to have
to duplicate comments for derived classes, and also subsequently keep them
in synch. I would like to see comment inheritance in a future version of C#.

--
======================
Clive Dixon
Digita Ltd. (www.digita.com)
<Tr***********@gmail.com> wrote in message
news:11**********************@i39g2000cwa.googlegr oups.com...

Hi All,

This may be a silly question, but:
Is it possible for a child class to inherit a base classes <summary>
tag info for an overridden method?

Cheers,

T

[Tris.Phillips]

Thanks Clive,
I was questioning my sanity when I couldn't work it out. It seems like
such an obvious thing to need!
T

[Christoph Nahr]

On 24 Apr 2006 01:32:27 -0700, Tr***********@gmail.com wrote:

This may be a silly question, but:
Is it possible for a child class to inherit a base classes <summary>
tag info for an overridden method?

C# and Visual Studio don't allow that at all. However, the upcoming
NDoc 2.0 will allow comment inheritance.

But that's going to be an NDoc-only feature so you're not going to see
the inherited comment in IntelliSense -- which is why I'm not planning
to use that feature.
--
http://www.kynosarges.de

[Clive Dixon]

I did put in a request for this feature with the NDoc guys - glad to hear
it's actually happening. Would be nice to see this ability in the C#
compiler too...

--
======================
Clive Dixon
Digita Ltd. (www.digita.com)
"Christoph Nahr" <ch************@kynosarges.de> wrote in message
news:aq********************************@4ax.com...

On 24 Apr 2006 01:32:27 -0700, Tr***********@gmail.com wrote:

This may be a silly question, but:
Is it possible for a child class to inherit a base classes <summary>
tag info for an overridden method?

C# and Visual Studio don't allow that at all. However, the upcoming
NDoc 2.0 will allow comment inheritance.

But that's going to be an NDoc-only feature so you're not going to see
the inherited comment in IntelliSense -- which is why I'm not planning
to use that feature.
--
http://www.kynosarges.de

[Bruce Wood]

There is also an item in Microsoft's product feedback center for this:

http://lab.msdn.microsoft.com/produc...e-2a5811c0d3d1

Please, go and at least vote for it, if not comment on it. I mentioned
it during last week's C# language chat and there was some mild interest
and they asked if I would put in a feedback item on it, but I found one
already there... so go vote!

[Bjorn Abelli]

"Christoph Nahr" wrote...

Tr***********@gmail.com wrote:

This may be a silly question, but:
Is it possible for a child class to inherit a base classes <summary>
tag info for an overridden method?

C# and Visual Studio don't allow that at all. However, the upcoming
NDoc 2.0 will allow comment inheritance.

But that's going to be an NDoc-only feature so you're not going to see
the inherited comment in IntelliSense -- which is why I'm not planning
to use that feature.

You can use GhostDoc, which "fills in" the summary from the overridden
method.

http://www.roland-weigelt.de/ghostdoc/

It's pretty useful for filling in other summaries as well.

// Bjorn A

[Frans Bouma [C# MVP]]

Tr***********@gmail.com wrote:

Hi All,

This may be a silly question, but:
Is it possible for a child class to inherit a base classes <summary>
tag info for an overridden method?

Yes, use Ghostdoc.
http://www.roland-weigelt.de/ghostdoc/

:)

Frans

--
------------------------------------------------------------------------
Lead developer of LLBLGen Pro, the productive O/R mapper for .NET
LLBLGen Pro website: http://www.llblgen.com
My .NET blog: http://weblogs.asp.net/fbouma
Microsoft MVP (C#)
------------------------------------------------------------------------

[Tris.Phillips]

Nice one, thanks.

[Nick Hounsome]

"Frans Bouma [C# MVP]" <pe******************@xs4all.nl> wrote in message
news:xn***************@news.microsoft.com...

Tr***********@gmail.com wrote:

Hi All,

This may be a silly question, but:
Is it possible for a child class to inherit a base classes <summary>
tag info for an overridden method?

Yes, use Ghostdoc.
http://www.roland-weigelt.de/ghostdoc/

:)

Frans

It doesn't support VS Express

:(

Nick

[Christoph Nahr]

On Wed, 26 Apr 2006 08:08:00 GMT, "Nick Hounsome"
<Ne**@NickHounsome.Me.Uk> wrote:

It doesn't support VS Express

The other way round... VS Express doesn't support plug-ins.
Any plug-ins. Microsoft very much wants you to buy Standard or higher
if you wish to use plug-ins...
--
http://www.kynosarges.de