CentOS vim插件——Doxygen注释插件(用命令生成各种注释)
来源:互联网 发布:淳萃洗发水 知乎 编辑:程序博客网 时间:2024/06/08 08:57
写代码,注释的重要性就不说了。总体来说注释分为以下三种:对于整个的版权说明(可有可无);对整个代码文件是干嘛的一个总体的描述;对每个函数是干嘛的一个描述(包括函数参数和返回值)。如果每次新写一个代码,都挨个去注释,还是挺麻烦的。vim上有个挺方便的插件DoxygenToolkit (下载地址点击打开链接 )。下面讲述如何配置和如何使用。
本机配置过程
所用的环境 CentOS 6.5、VIM 7.4
1、下载DoxygenToolkit.vim 插件
下载地址 http://www.vim.org/scripts/script.php?script_id=987
2、将下载的文件放到vim的plugin 文件夹中
每个系统plugin所在的路径可能不一样,可以查看一下文件夹的位置。具体查看命令可以用
$ locate /plugin
由下图可以看出,文件很多,找到vim下面的那个plugin 就是了。将文件放到plugin文件夹里面。
3、修改vimrc 文件
vimrc文件中是对vim的一些基本配置,文件的位置我就不多说了,如果不知道自己机子的vimrc文件在哪里的话,用上面的定位方式进行查找。
let g:DoxygenToolkit_briefTag_pre="@Synopsis " let g:DoxygenToolkit_paramTag_pre="@Param " let g:DoxygenToolkit_returnTag ="@Returns " let g:DoxygenToolkit_blockHeader="============================================================================" let g:DoxygenToolkit_blockFooter="============================================================================" let g:DoxygenToolkit_authorName="XIU" let g:DoxygenToolkit_fileTag = "@filename "
4、使用Doxygen插件
(1)插入版权等描述信息
如下图中,2是插入的注释信息,1是插入所使用的命令。是以命令的形式输入的。在vim的命令行模式输入DoxLic
(2)插入作者信息
如下图中,2是插入的注释信息,1是插入所使用的命令。是以命令的形式输入的。在vim的命令行模式输入DoxAuthor
(3)在任何地方都可以插入信息
如下图中,2是插入的注释信息,1是插入所使用的命令。是以命令的形式输入的。在vim的命令行模式输入Dox
关于Doxygen的一些介绍
关于下面的注释内容,摘自 Vim下快速生成Doxygen注释插件_hpcincfd_新浪博客
http://blog.sina.com.cn/s/blog_7f5285bf0100uff1.html
忽 略在#ifdef...#endif(C/C++)块中代码碎片。给块命名的时候一定要考虑到其功能。在所有文件中,所有有联系的块将会放在一个新的块 DOX_SKIP_BLOCK(或者用户定义的名称)。你需要使用当前的新块名更新你的doxygen配置文件中的PREDEFINED变量。而且你还需 要将ENABLE_PREPROCESSING设置为YES。
在vim中,将光标放在想要添加doxygen作者注释的地方。然后执行命令:DoxAuthor。这将会生成一个框架,如果没有为其设置变量则将光标放置在@author标签之后,或者放在在框架之后。
- CentOS vim插件——Doxygen注释插件(用命令生成各种注释)
- vim生成注释插件
- NERD_commenter——VIM批量注释与反注释插件
- vim 插件 快速注释
- vim之注释插件
- vim+Doxygen实现注释自动生成
- VIM插件: NERDCOMMENTER[快速注释]
- vim插件: nerdcommenter[快速注释]
- Doxygen生成文档注释
- Doxygen生成注释文档
- Doxygen生成注释文档
- 使用doxygen生成注释文档——eclipse
- 使用doxygen生成注释文档——visual studio
- vim的注释代码插件 NERD_commenter
- VIM注释插件NERD Commenter 使用简介
- php通过注释自动生成文档插件
- Xcode快速注释 — ThisService Doxygen
- doxygen注释
- 使用Spring Security保护web应用安全
- ListView中条目指定位置停留和动画效果
- ZOJ 3780 - Paint the Grid Again
- jQuery源码解读一
- Unity 单例与实例的区别
- CentOS vim插件——Doxygen注释插件(用命令生成各种注释)
- FOJ Problem 2214 Knapsack problem
- 霍夫曼编码和解码
- 1094. The Largest Generation (25)
- xpath对XML进行模糊查询
- StringUtils中 isNotEmpty 和isNotBlank的区别
- 警告:receiver Exported receiver does not require permission
- 利用power_profile.xml获取Android运行时的能耗
- 屏幕尺寸/机型/系统版本判定