Atomineer Utils アドインで Visual Studio 2013 (C++) を使用しています。
Java のバックグラウンドを持っていたので、Doxygen スタイルのドキュメントに興味があったので、Atomineer を構成してこのDoxygen (Javadoc)
スタイルを使用しました。基本的には次のようになります。
/**
* @brief adds two numbers together
*/
void add(int x, int y);
ただし、複数行のコメントを開始したいとしましょう。IntelliJ IDEA から来て、これがうまくいくと思いました:
/**
enter
/**
*
またはさらに良い:
/**
enter
/**
*
*/
実際には、これは最も奇妙な結果をもたらします。
/**
# autocompletes to
/**/
enter
/**
/* /
この種のオートコンプリートの動作がどれほど役に立たないかを理解していただければ幸いです。
その上、完全な Doxygen コメントを取得できた場合、そのコメントの拡張は (私の観察から) 場合にのみ機能します。
- コメントの先頭を選択していません (
/**
) を押す前にアスタリスクの後に選択してenterいて、その後に自動的に生成されるスペースではありません: (
|
はカーソルを表します)/** *| */
その後、ヒットenterは機能しますが、機能しません
/** * | */
または、その行に何かを入力してEnterキーを押します
次に、問題をどのように解決したいかについて説明します。複数行のコメント生成と自動拡張を修正して、期待どおりになるようにします。
ただし、そのような解決策が存在しないことを確信している場合は、入力すると Atomineer がドキュメントを自動的に生成することを認識しており///
(なぜそうならない/**
のですか!?)、代わりにそれを一種の回避策として使用できます。
私がこれまでに試したこと:
[オプション] -> [テキスト エディター] -> [C/C++] -> [詳細設定] で無効
Complete Multiline Comments
化 (これにより、Atomineer のドキュメント ジェネレーターが無効化されます)[オプション] -> [テキスト エディター] -> [C#] -> [詳細設定] で無効
Generate XML documentation comments for ///
にします (ここでは C++ について話しているので、明らかにこれは何もしませんでした)