doxygen+VIM文档实用指南for C/C

摘要：
文档撰写是一项十分繁琐而且费力的工作，相信已经有很多人对此深感头痛。文档生成工具的出现最大限度地帮助程序员解决了这个问题，这些工具通常可以从程序源代码自动生成文档，大大方便了文档工作。这篇小东西主要介绍了如何用VIM和doxygen来快速生成注释，并用最少的额外劳动来完成专业水准的程序文档的过程。仅供参考，如有雷同，纯属巧合。 
关键字：
       doxygen vim doxygentoolkit chm dot lex CLanuageScanner 
补充：
本文一开始是为dylan同学准备的，后来有所扩展。本文不涉及doxygen注释的具体做法，因为可以在网上得到更多关于这方面的范例和资料。
 什么是doxygen
什么是VIM
为什么要使用doxygen+VIM
需要做什么？
1)    准备工作
2)    添加注释
3)    配置并运行doxygen
4)    编译成chm
5)    一些配置选项
Dot图形扩展
doxygen方便扩展吗？
小结
 
什么是doxygen
doxygen是一个十分好用的自由软件，是一种文档生成器，其工作机制是利用注释中的有效信息来自动生成文档。目前doxygen的最新版是(1.5.1)，从http://www.doxygen.org上可以下载最新版的doxygen。1.5.1版的doxygen可处理的语言包括：
l         C/C++
l         Java
l         Python
l         PHP
l         Objective-C
l         IDL (Corba, Microsoft及KDE-DCOP类型)
l         C#
l         D
它支持以下文档格式：
l         HTML
l         XML
l         LaTeX
l         RTF
l         Unix Man Page
         有了doxygen的支持后，从软件代码到项目文档的转化十分简单，直接