Vim中使用Doxygen风格的注释

Question

3

我正在尝试使用c.vim插件。该插件功能强大。但在使用Doxygen时遇到了小问题。我希望能够自动为函数生成Doxygen样式注释（一旦填写了占位符）。但是后者无法正常工作，只会生成默认注释。我已在我的.vimrc文件中设置了“let g:C_UseTool_doxygen ='yes'”。根据文档（http://lug.fh-swf.de/vim/vim-c/csupport.html#csupport-doxygen），我应该打开Templates文件（https://github.com/vim-scripts/c.vim/blob/master/c-support/templates/Templates）并包含“doxygen.template”。然而，我没有那个模板文件。所以我从http://www.vim.org/scripts/download_script.php?src_id=21803获取它并放置在正确的文件夹中。即使现在它仍然无法正常工作。

作为一个旁问（或评论）...我检查了函数模板的习语文件。在那里，返回类型被硬编码为“void”。返回类型不应该是一个占位符吗？

有人可以帮帮我吗...特别是第一个问题...

- knightrider

1个回答

网页内容由stack overflow 提供, 点击上面的

可以查看英文原文，
原文链接

- Luc Hermitte · Accepted Answer

lh-cpp提供:DOX命令来处理返回类型、参数列表和异常规范，但是尚未检测到C++模板参数--我需要重写解析器并使用clang来实现。

通过选项可以调整模板，甚至可以进行修改/重载。

关于函数的代码片段/模板，我真的不明白为什么需要代码片段，因为代码片段只能添加一对花括号和一对圆括号以及一些空格。在我看来，这里使用一个括号系统将会更有效。然而，它可能就像这样简单：

<+void+> <+name+>(<+parameters+>){<+code+>}

这里没有空格，因为lh-cpp通过mu-template使用lh-dev的样式特性（是的，这里涉及到许多插件）在项目样式命令所需的地方添加空格和换行符。