vim 中的 Doxygen 样式注释使用答案

【问题标题】：Doxygen-style comments in vim usingvim 中的 Doxygen 样式注释使用
【发布时间】：2015-10-02 15:45:37
【问题描述】：

我正在试用 c.vim 插件。该插件效果很好。但是我在使用 Doxygen 时遇到了一个小问题。我想要的是自动为一个函数生成一个 doxygen 样式的 cmets（只要我填满占位符）。

但后者不起作用。它只是生成默认的 cmets。

我在我的 .vimrc 中设置了“let g:C_UseTool_doxygen = 'yes'”。

根据文档 (http://lug.fh-swf.de/vim/vim-c/csupport.html#csupport-doxygen)，我应该打开模板文件 (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 中取出并放在了正确的文件夹中。即使现在它也无法正常工作。

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

谁能帮帮我..尤其是第一个问题...

【问题讨论】：

【解决方案1】：

lh-cpp 为此提供了:DOX 命令。它处理返回类型、参数列表和异常规范。尚未检测到 C++ 模板参数——为此我必须重写解析器以使用 clang。

感谢options，甚至modified/overloaded，可以调整模板。

关于函数的 sn-p/模板，我真的不明白 sn-p 的意义，因为 sn-p 可以添加的是一对花括号和一对圆括号和几个空格. IMO，包围系统在这里将同样有效。然而，它可能很简单：

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

（这里没有空格，因为 lh-cpp 通过 mu-template 使用来自 lh-dev 的样式功能——是的，这里涉及到许多插件——在项目样式的任何地方添加空格和换行符命令）

【讨论】：

Hermitee 我来看看 lh-cpp。也许我错了，但我至少希望 c.vim 会在占位符完成后自动调用 :Dox，这样我就可以避免一些击键（移动 + cmd）
AFAIK，c.vim 不提供高级功能（在解析 C++ 代码的意义上）。我们的插件无关。 c.vim 不使用 lh-cpp 的特性，lh-cpp 也不使用 c.vim 的特性。