我正在使用带有 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++,所以显然这没有做任何事情)