c++ - Visual Studio 2013 无法正确处理 Doxygen 多行注释

Question

我正在使用带有 Atomineer Utils 加载项的 Visual Studio 2013 (C++)。

来自 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 的文档生成器)

• 禁用 Generate XML documentation comments for/// under Options -> Text Editor -> C# -> Advanced(我们在这里谈论 C++，所以很明显这没有做任何事情)

Answer 1

(很抱歉回答晚了，我没有早点发现这个问题)

简单的解决方法是键入///或 ctrl+shift+D 来生成注释。但是，Atomineer 已经更新，现在还允许您键入/** 以生成评论。