4

这更像是一个 MonoDevelop 问题。我真的很喜欢使用 '///' 并获得 VisualStudio 提供的评论的骨架轮廓。但我讨厌默认提供的额外填充文本,因为它没有增加任何实际价值(它只是重申我已经输入的内容!)。对于我的生活,我找不到保留 XML 注释生成但没有额外文本的选项。有一个已针对此问题修复的错误报告 ( https://bugzilla.novell.com/show_bug.cgi?id=606222 ) 但我没有看到该选项在哪里解决。

我想要生成的只是:

    /// <summary>
    /// 
    /// </summary>
    /// <param name="bar"></param>
    public void Foo(string bar)
    {
    }

TL; 博士;

在 MonoDevelop 中是否有(以及在哪里)关闭自动生成的详细注释的选项,但保留方法标头的样板/// 注释?

谢谢。

4

1 回答 1

0

不支持。我很确定投诉的解决方案是撤消将有两个步骤,因此您可以轻松删除自动填充的值。

添加选项是一个滑坡。例如,您可能想要:

/// <summary>
/// 
/// </summary>
/// <param name="bar"></param>
public void Foo(string bar)
{
}

但我可能想要

/// <summary></summary>
public void Foo(string bar)
{
}

其他人可能想要

/// <summary></summary>
/// <param name="bar"></param>
public void Foo(string bar)
{
}

支持这一点的选项 UI 将非常复杂,并且 MD 已经有太多的选项,因此必须为每个新选项提供强有力的案例。这种行为可能并不适合每个人,但它非常好,调整生成的文档仍然比从头开始输入要容易得多。

但是,生成评论的插件是开源的,因此您可以轻松地随意修改它。

于 2012-05-09T23:05:06.143 回答