gunzip doxygen-$VERSION.src.tar.gztar xf doxygen-$VERSION.src.tarsh ./configure，或者configure --platform platform-type（略去直接使用configure需要平台检测的过程，平台类型在PLATFORMS文件中列出），configure --with-doxywizard（GUI前端选项）make，或者make docs（创建HTML格式的手册），make pdf（创建PDF格式的手册）

./configuremake install

JavaDoc风格，中间的"*"号可选。/*** 注释*/Qt风格，中间的"*"号可选。/*!* 注释*/C++风格的变体，或者最后一个"/"改为"！"也可以。/// 单行注释/// 注释///更加显著的表示。////////////////////////////////////////////// 注释///////////////////////////////////////////简要描述亦有多种表示方式。在上述注释块中使用\brief命令，详细注释在空行之后开始。/*! \brief 简要描述*   继续** 详细注释*/JAVADOC_AUTOBRIEF设置为YES后，在JavaDoc风格的注释中，第一个点号之前的内容被自动设置为简要描述。对于多行C++变体，这个选项亦会起到相同的作用。/** 简要描述.详细描述* 注释*/C++变体风格。/// 简要描述/* 详细描述 */

            
命令
            
     Doxygen支持的指令非常多，主要作用是控制输出文档的排版格式。命令以"\"或"@"号开始。
            
一些命令可以有多个参数，一些命令只有一个参数。参数周围的括号使用是有含义的：
            

                
<>号表示参数是单个词。
                
()号表示参数一直会到行尾。
                
{}号表示参数会扩展到下一段落。
                
[]号表示参数是可选的。
            
            
下面章节中也涉及到一些命令的使用，其它的命令可以查阅Doxygen用户手册。
            
列表
            
Doxygen有许多方法可以创建项目列表。
            

                

                    

                        

                        
使用"-"在每行开始之前打头，使用"."可以结束一个列表，开始新的段落。使用这种方法要严格对齐。/***  - 表项一*    - 子项一*    - 子项二*    .*  .*/在文档块中使用HTML命令。这种方法不需要严格对齐。/*!*  <ul>*  <li> 表项一*  <ol>*     <li> 子项一*     <li> 子项二*     </ol>*  <li> 表项二*  </ul>*/
                        
                    
                
            
            

            
分组
            
     Doxygen有两种分组机制。第一种是全局地为每一个组创建一个网页，此时分组被称为"module"；第二种是用于复合实体中的成员列表，此时分组被称为"member group"。Module是一种把内容在单个网页上分组的方法。分组可以包括files，namespace，classes，functions，variables，enums，typedefs和defines，也可以包含其它分组。复合实体（compound entities）如类、文件、命名空间等可以分布在多个分组中，而成员实体（member）如变量、函数、typedef等只能归属于一个分组。
            
定义分组的方法是在特殊注释块中使用命令\defgroup和\addtogroup。 defgroup的格式如下：
            
\defgroup <唯一标识名> （中间可以有空格的标题）
            
     两次使用同一标识名，在doxygen解析的时候会出现错误。命令addtogroup与defgroup不同的地方在于，如果使用了同一标识，则会在改组中加入新的项，如果标识不重复，则会创建分组。addtogroup中的标题是可选的。
            
     声明分组之后，如果要使某个实体归属某一分组，需要使用ingroup命令。避免在每个成员之前都使用ingroup命令，可以将member用@{和@}封装起来。
            

                

                    

                        

                        
/** * \ingroup A */extern int VarInA;/** * \defgroup IntVariables Global integer variables *//*@{*//** an integer variable */extern int IntegerVariable;/*@}*/..../** * \defgroup Variables Global variables *//*@{*//** a variable in group A */int VarInA;int IntegerVariable;/*@}*/
                        
                    
                
            
            

            
     上面这些命令都是有优先级的，doxygen会根据优先级将实体放入具有最高优先级的分组之中。它们的优先级顺序是：ingroup，defgroup，addtogroup，weakgroup。weakgroup类似一个低优先级的addtogroup。在.h文件中可以使用高优先级的命令定义层次结构，在.c文件中\weakgroup就不需要准确遵循.h文件中定义的层次结构。
            
如果要把不同的类型归入同一分组内，就要使用Member group，它的定义方法如下：
            

                

                    

                        

                        
//@{   ...//@}或者/*@{*/   ... /*@}*/
                        
                    
                
            
            

            
Member group不可以嵌套。
            
图表
            
     Doxygen里有内置生成C++类层次图的功能。它使用贝尔实验室开发的graphviz 1.5中的工具"dot"来生成更高级的图表。使用这个工具时，要将配置选项HAVE_DOT设为YES。
            

                
当GRAPHICAL_HIERARCHY设置为YES时，将会绘制一个图形表示的类图结构。
                
当CLASS_GRAPH设置为YES时，会为每个归档的类创建一张图表示其直接或间接的继承关系。
                
当INCLUDE_GRAPH设置为YES时，会为每个归档文件创建一幅包含依赖图，此功能目前仅有HTML和RTF格式支持。
                
当COLLABORATION_GRAPH设置为YES时，会为每个归档类或结构绘制基类继承关系图和使用关系图。
                
当CALL_GRAPH设置为YES时，会为每个函数显示一幅直接或间接调用关系图。
                
            
            
更具体的信息可以参考Doxygen的手册。
            
公式
            
     Doxygen可以把LaTeX格式的公式输出出来。要在HTML文档里包含公式，需要安装下面的工具：latex（LaTeX编译器）、dvips（将DVI文件转换为PS文件）、gs（将PS文件转换为位图）。
            
包含公式的方法有两种：
            

                

                    

                        

                        
使用\f$命令对表示文本中间的公式，遵循LaTeX格式。\f$(x_1, y_1)\f$  (x1,y1)位于独立一行上未编号的公式，应放在命令\f[和\f]之间。\f[    |I_2|=\left| \psi(t)           \right|\f]对应的输出是|I2|=|ψ(t)|。
                        
                    
                
            
            

            
中文文档
            
     Doxygen支持多种语言，输出中文文档的时候，只需要将配置文件中的OUTPUT_LANGUAGE标签设置为Chinese即可（用Doxywizard修改更方便）。
            
     有一个需要注意的问题是，在Windows下的浏览器浏览中文HTML文档时，英文字母会变得很难看，解决的办法是将doxygen_cn.css下载到本地硬盘，并将配置文件中的HTML_STYLESHEET修改为这个文件的位置。
            
HTML_STYLESHEET=c:\doxygen\doxygen.css
            
运行doxygen
            
在命令行下运行doxygen是很简单的，只需要指定配置文件即可。
            
doxygen project.cfg
            
或者，也可以使用Doxywizard在配置完后直接运行doxygen。