doxygen 使用

这文值得一看：

http://www.doc88.com/p-38771914275.html

http://www.cnblogs.com/xuxm2007/archive/2010/11/05/1870108.html

1、export设置:

doxygen -g xx.cfg

根据下边3条修改配置文件xx.cfg,然后执行 doxygen xx.cfg,就会得到相应文件在project->OUTPUT_DIRECTORY下

 1) 常规

project->PROJECT_NAME=XX   工程名

project->OUTPUT_DIRECTORY=doc 输出目录

input->INPUT=D:\SRC\  输入文件或目录

input->RECURSIVE=YES 递归目录输入

input->EXCLUDE=D:\SRC\XX\BIN\ D:\SRC\XX\TEST\ 排除输入目录或文件

input->EXCLUDE_PATTERNS=*/.svn/* */Debug/* */Release/* 排除模式匹配

build->GENERATE_TODOLIST=NO

build->GENERATE_LATEX=NO

2)中文显示问题

 project->DOXYFILE_ENCODING=GB2312

 project->OUTPUT_LANGUAGE=Chinese 

 input->INPUT_ENCODING=GBK2312

 3)Dot

 Dot->HAVE_DOT

 Dot-> UML_LOOK

 Dot->CALL_GRAPH

 Dot->CALLER_GRAPH 

2、对于中文编码设置后还是乱码的情况，请保证源程序文件是否是ANSI编码(即GB2312/GBK)，如不是请转下，我这边是用的notepad.exe程序另存为修改的。还可以用VS修改。如果转了还是不行，估计是文件坏了，可以重新做这个文件，或把这个文件通过input->EXCLUDE排除(要用绝对路径)。

3、我使用的注释

多行注释

/*! \file test.h

 *  \brief  test

 *  详细信息

*/

单行

/// 代码段说明

或

/*! 代码行说明 */

或

///< 单行右侧注释

4、命令

\file

\fn

\enum

\struct

\param

\return

\var

\brief