1

我正在使用带有 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会起作用,但不是

    /**
     * |
     */
    
  • 或者您在该行上输入一些内容并按回车键

现在谈谈我希望如何解决这个问题:以某种方式修复多行注释生成和自动扩展,使其与我期望的相似。

但是,如果你们确定这种解决方案不存在,那么我知道 Atomineer 会在我输入时自动生成文档///(但为什么不/**!?),我可以使用它作为一种解决方法。

到目前为止我已经尝试过:

  • 在选项 -> 文本编辑器 -> C/C++ -> 高级下禁用Complete Multiline Comments(这将禁用它和 Atomineer 的文档生成器)

  • 在选项 -> 文本编辑器 -> C# -> 高级下禁用Generate XML documentation comments for ///(我们在这里谈论 C++,所以显然这没有做任何事情)

4

1 回答 1

0

(为迟到的答案道歉,我之前没有发现这个问题)

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

于 2016-05-12T21:31:46.783 回答