在Eclipse中更改doxygen注释样式

Question

有谁知道如何在Eclipse CDT中编辑用于Doxygen评论的样式？

换句话说,键入/**并enter在函数之前按下一行就会产生类似于:

/**
 * 
 * @param one
 * @param two
 * @return
 */
Foo(int one, int two);

我希望它能给我一些类似的东西:

/**********************************************************************/
///
/// \param one
/// \param two
/// \return
/***********************************************************************/
Foo(int one, int two);

此外,再加上一个,如果任何人知道如何把它绑定到键盘快捷键(如alt- shift- j为Eclipse JDT).

此外,仅供参考,Eclipse CDT支持Doxygen的事实现在似乎是一个基于谷歌的鲜为人知的事实.详情请见此处.通过在"C/C++常规"选项卡中选择"启用项目特定设置"并选择"Doxygen",可以在项目属性下启用Doxygen.我的CDT版本是7.0.1,但我认为这在5.0中可用.

最后,首选项中代码模板下的注释部分无法根据我的测试完成此操作.

编辑: 见这里.似乎评论样式是硬编码的.如果有人发现,我很想知道.我想模板现在是最好的,除非Javadoc风格适合你.

Answer 1

是的，这似乎是Eclipse CDT中的错误。

作为一种解决方法，我建议您创建一个可使用Ctrl+ Space组合键访问的自定义模板。

在Eclipse Helios中：窗口->首选项-> C / C ++->编辑器->模板

单击New ...创建一个新模板，然后在Name字段中使用一些描述性名称，例如“ comment-function”，并在Pattern字段中添加您的doxygen注释。确认并应用此更改。

然后，在代码中，您可以转到函数声明上方的行，键入自定义模板名称的前几个字母，然后键入Ctrl+ Space组合键。

在此示例中：

com<Ctrl+space>

将会弹出用“ com *”过滤的Content Assist对话框，您可以从中选择“评论功能”模板。

注意：

com<Ctrl+space+space>

通过仅在Content Assist弹出窗口中显示模板提案，将进一步过滤。

Answer 2

我可以通过以下方式获得您想要的东西：首选项 - PHP - 代码样式 - 代码模板 - 注释。

我不确定这是否能让您在关键字中使用反斜杠而不是 @s，但我认为它应该可以实现您想要的大部分效果。