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; DR;

MonoDevelopには、自動生成された詳細なコメントをオフにするオプションがありますが、メソッドヘッダーのボイラープレート///コメントは保持しますか？

ありがとう。

4

1 に答える 1

0

サポートされていません。苦情の解決策は、元に戻すには2つの手順があるため、自動入力された値を簡単に削除できることだと確信しています。

オプションを追加すると、滑りやすい坂道になります。たとえば、次のようにします。

/// <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 に答える