苦练1天半，终于写出了一些常用doxygen风格的vim注释脚本

 脚本内容如下，欢迎大家补充

1. "一些常用的doxygen风格的注释
2. "作者：peacon
3. "Email:[e-mail]
4. "Copyright (c) 2008 任何人都可以自由获取、修改、发布该程序。
5. "参考：本脚本参考了大量的网上资料以及VIM中文手册、doxygen user manual
6. "不足之处：函数注释并不能提取函数的参数列表和返回值。虽然www.vim.org有大量的doxygen风格函数注释脚本，
7. "但是经过测试我还没有发现有完全工作正确的。提取函数参数列表的难点在于有字符串作为默认参数以及有函数指针
8. "的参数。虽然已经想到了些方法，但是鉴于时间关系没有去实现。如果有你实现了该功能或者有好的想法，欢迎与
9. "我进行交流。
10. 
    
12. "添加只包含一次文件的宏#ifndef ..#define #endif
13. "使用方法：在普通模式下击键zho
14. function InsertPragmaOnceTag()
15.     let CurTime = strftime("%Y_%m_%d_%H_%M")    "将当前时间格式化后存入到CurTime当中去
16.     let CurFilePath = toupper(expand("%"))      "expand(/"%/")获取当前编辑的文件路径
17.     let LastSlash = strridx(CurFilePath, "/")   "找出路径中最后一个/
18.     let HeadTag1 = "#ifndef "
19.     let HeadTag2 = "#define "
20.     let HeadTag3 = "#endif //"
22.     "将非数字、字母替换为_
23.     let Suffix = substitute(strpart(CurFilePath, LastSlash + 1), "[^a-zA-Z0-9]", "_", "g")."_".CurTime  
24.     let HeadTag1 = HeadTag1.Suffix
25.     let HeadTag2 = HeadTag2.Suffix
26.     let HeadTag3 = HeadTag3.Suffix
27.     
28.     "跳转到第一行并输入#ifndef ..
29.     exe "normal ggO".HeadTag1                   
30.     exe "normal O".HeadTag2
31.     exe "normal Go".HeadTag3
33.     "添加一个空白行
34.     exe "normal o"
36.     "添加两行空白行并将光标停在第四行
37.     normal 3GO
38.     normal 4GO
39. endfunction
40. 
    
42. "添加doxygen风格的文件注释
43. "使用方法：在普通模式下击键zfc
44. function InsertFileCommentTag()
45.     let l:File_Path = expand("%")
46.     let l:File_Name = strpart(l:File_Path, strridx(l:File_Path, "/") + 1)
47.     exe "normal ggO/**"
48.     exe "normal o*  @file ".l:File_Name
49.     exe "normal o*  @brief  "
50.     let l:wRow = winline()
51.     let l:wCol = wincol()
52.     exe "normal o*  @author [e-mail]"
53.     exe "normal o*  @version VERSION_PLACEHOLDER"
54.     exe "normal o*  @date ".strftime("%Y/%m/%d")
55.     exe "normal o*  @note "
56.     exe "normal o*  @remarks  Copyright 1998 - 2008 Company Name Inc. All Rights Reserved."
57.     exe "normal o*/"
59.     "重新缩进文件
60.     exe "silent normal gg=G"
62.     "设置光标在@brief后面
63.     :call cursor(l:wRow, l:wCol)
64. endfunction
65. 
    
67. "添加doxygen风格的类注释
68. "使用方法：在普通模式下，将光标停留在类名上面击键zcc
69. function InsertClassCommentTag()
70.     let Class_Name = expand("<cword>")
71.     exe "normal O/**"
72.     exe "normal o*  @class ".Class_Name
73.     exe "normal o*  @brief  "
74.     let l:wRow = winline()
75.     let l:wCol = wincol()
76.     exe "normal o*  @author [e-mail]"
77.     exe "normal o*  @version VERSION_PLACEHOLDER"
78.     exe "normal o*  @date ".strftime("%Y/%m/%d")
79.     exe "normal o*  @note "
80.     exe "normal o*/"
81.     exe "silent normal gg=G"
82.     :call cursor(l:wRow, l:wCol)
83. endfunction
84. 
    
86. "添加doxygen风格的函数注释
87. "使用方法：在普通模式下面，将光标停留在函数名称行击键zmc
88. function InsertFunctionCommentTag()
89.     exe "normal O/**"
90.     exe "normal o*  @brief  "
91.     let l:wRow = winline()
92.     let l:wCol = wincol()
93.     exe "normal o*  @param "
94.     exe "normal o*  @return "
95.     exe "normal o*  @note "
96.     exe "normal o*/"
97.     exe "silent normal gg=G"
98.     :call cursor(l:wRow, l:wCol)
99. endfunction
100. 
     
102. "添加doxygen风格的结构体注释
103. "使用方法：在普通模式下，将光标停留在结构体名称上面击键zsc
104. function InsertStructCommentTag()
105.     let l:Struct_Name = expand("<cword>")
106.     exe "normal O/**"
107.     exe "normal o*  @struct ".l:Struct_Name
108.     exe "normal o*  @brief  "
109.     let l:wRow = winline()
110.     let l:wCol = wincol()
111.     exe "normal o*  @note "
112.     exe "normal o*/"
113.     exe "silent normal gg=G"
114.     :call cursor(l:wRow, l:wCol)
115. endfunction
116. 
     
118. "添加doxygen风格的枚举体注释
119. "使用方法：在普通模式下，将光标停留在枚举体名称上面击键zec
120. function InsertEnumCommentTag()
121.     let l:Enum_Name = expand("<cword>")
122.     exe "normal O/**"
123.     exe "normal o*  @enum ".l:Enum_Name
124.     exe "normal o*  @brief  "
125.     let l:wRow = winline()
126.     let l:wCol = wincol()
127.     exe "normal o*  @note "
128.     exe "normal o*/"
129.     exe "silent normal gg=G"
130.     :call cursor(l:wRow, l:wCol)
131. endfunction
132. 
     
134. "添加doxygen风格的模块定义注释
135. "使用方法：在visual模式下选定要加入到模块的行，击键zgc
136. function InsertGroupCommentTag()
137.     "获取选定的行
138.     let l:wBegin = line("'<")
139.     let l:wEnd = line("'>")
140.     exe "normal ".l:wBegin."G"
141.     exe "normal O/**"
142.     exe "normal o*  @defgroup  "
143.     let l:wRow = winline()
144.     let l:wCol = wincol()
145.     exe "normal o*  @brief "
146.     exe "normal o*  @detail "
147.     exe "normal o*  @{"
148.     exe "normal o*  */"
149.     exe "normal o"
150.     let l:wEnd = l:wEnd + 7 
151.     exe "normal ".l:wEnd."G"
152.     exe "normal o/** @} */ //end define of group" 
153.     :call cursor(l:wRow, l:wCol)
154. endfunction
155. 
     
157. "在符号(宏、成员变量、全局变量)后增加doxygen风格的注释
158. "使用方法：普通模式下，在符号定义行击键zpc
159. function InsertItemPostCommentTag()
160.     exe "normal A/t"
161.     let l:wRow = winline()
162.     let l:wCol = wincol()
163.     while l:wCol < 60
164.         exe "normal A/t"
165.         let l:wCol = wincol()
166.     endwhile
167.     exe "normal A/*!<  */"
168.     exe "normal 2h"
169. endfunction
170. 
     
172. "在符号(宏、成员变量、全局变量)上方增加doxygen风格的注释或者是函数的简单说明
173. "使用方法：在普通模式下，在符号定义行击键zuc
174. function InsertItemUpCommentTag()
175.     exe "normal O"
176.     exe "normal o///  "
177. endfunction
178. 
     
180. nmap zho <Esc>:call InsertPragmaOnceTag()<CR>i
181. nmap zfc <Esc>:call InsertFileCommentTag()<CR>i
182. nmap zcc <Esc>:call InsertClassCommentTag()<CR>i
183. nmap zmc <Esc>:call InsertFunctionCommentTag()<CR>i
184. nmap zsc <Esc>:call InsertStructCommentTag()<CR>i
185. nmap zec <Esc>:call InsertEnumCommentTag()<CR>i
186. nmap zpc <Esc>:call InsertItemPostCommentTag()<CR>i
187. nmap zuc <Esc>:call InsertItemUpCommentTag()<CR>i
188. vmap zgc <Esc>:call InsertGroupCommentTag()<CR>i