Сохранять комментарии при переопределении

Question

Есть ли способ (инструмент или что-то еще), который позволяет не дублировать те же комментарии XML при наследовании/переопределении методов из базовых классов?

Например .:

/// <summary> 
/// Represent a brand new object in .NET 
/// </summary> 
public class MyObject : Object 
{ 
    /// <summary> 
    /// Copy-Paste the same Xml comment 
    /// like in the base class is boring! 
    /// </summary> 
    /// <param name="obj">and params too!! ((</param> 
    /// <returns>this one too!!! (((</returns> 
    public override bool Equals(object obj) 
    { 
     return base.Equals(obj); 
    } 
} 

Answer 1

Я думаю, что вы ищете inheritdoc:

/// <inheritdoc /> 
public override bool Equals(object obj) 

Это не standard tag (так Intellisense может не поддерживать его, exampple), но это довольно обычно используется - в частности, Sandcastle supports it.

Answer 2

Если вы ищете инструмент, вы можете попробовать GhostDoc расширение для визуальной студии. Он помогает вам генерировать комментарии и может принимать комментарии от базового класса.

Как сгенерированный комментарий является регулярным комментарием, IntelliSense поддерживает его правильно, но он не волшебным образом обновляется при изменении базового комментария.