eclipse - 在 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);

此外，如果有人知道如何将其绑定(bind)到键盘快捷键(如 Eclipse JDT 的 alt-shift-j)，则加一个。

另外，仅供引用，Eclipse CDT 支持 Doxygen 的事实现在似乎是一个鲜为人知的基于 Google 的事实。见 here详情。通过在“C/C++ 常规”选项卡中选择“启用项目特定设置”并选择“Doxygen”，可以在项目属性下启用 Doxygen。我的 CDT 版本是 7.0.1，但我认为这在 5.0 中可用。

最后，根据我的测试，首选项中代码模板下的注释部分并未完成此操作。

编辑:
见 here .评论风格似乎是硬编码的。如果有人发现其他情况，我很想知道。我想模板将是目前最好的东西，除非 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 对话框，您可以从中选择“comment-function”模板。

笔记:

com<Ctrl+space+space>

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