Visual Studio 2013無法正確處理Doxygen多行注釋

Question

我將Visual Studio 2013（C ++）與Atomineer Utils加載項一起使用。

來自Java背景，我對Doxygen風格的文檔很感興趣，因此我將Atomineer配置為使用Doxygen (Javadoc)風格，基本上看起來像這樣：

/**
 * @brief adds two numbers together
 */
void add(int x, int y);

但是，假設我要開始多行注釋。 來自IntelliJ IDEA，我認為這可以工作：

/**

輸入

/**
 *

或更好：

/**

輸入

/**
 *
 */

實際上，這會產生最奇怪的結果：

/**

# autocompletes to

/**/

輸入

/**
/* /

希望您能理解這種自動完成行為是多么無益。

最重要的是，如果您設法獲得完整的Doxygen評論，則僅在以下情況下（根據我的觀察），可以擴展該評論​​：

• 您沒有選擇評論的開頭（ /** ）

• 您是在按Enter鍵之前選擇星號，而不是在其后自動生成的空間：（ |代表光標）

   /** *| */ 

  然后按回車將起作用，但不起作用

   /** * | */ 

• 或者您在該行上鍵入內容，然后按Enter

現在，我將介紹如何解決該問題： 以某種方式修復多行注釋生成和自動擴展，使其與我期望的類似。

但是，如果你們確定不存在這種解決方案，那么我知道如果我輸入/// （但為什么不輸入/** ！？），Atomineer會自動生成文檔，我可以將其用作一種排序方式解決方法。

到目前為止我嘗試過的是：

• 在“選項”->“文本編輯器”->“ C / C ++”->“高級”下禁用了“ Complete Multiline Comments （這將禁用它，並且禁用了Atomineer的文檔生成器）

• 禁用在選項->文本編輯器-> C＃->高級下Generate XML documentation comments for /// （我們在這里談論C ++，顯然這沒做任何事情）

Answer 1

（抱歉，我沒有早點發現這個問題）

簡單的解決方法是輸入///或ctrl + shift + D生成注釋。 但是，此后更新了Atomineer，現在還允許您鍵入/ **以生成評論。