生成文档

cmdblock

                生成文档
  在emacs中可以使用doxymacs来生成注释，再配合doxymacs就可以生成文档。要生成中文文档，在emacs中必须使用utf-8的中文字体。所以需要加入下面的代码到~/.emacs中。
;; For my language code setting (UTF-8)
(setq current-language-environment "UTF-8")
(setq default-input-method "chinese-py")
(setq locale-coding-system 'utf-8)
(set-terminal-coding-system 'utf-8)
(set-keyboard-coding-system 'utf-8)
(set-selection-coding-system 'utf-8)
(prefer-coding-system 'utf-8)
    通过doxymacs很容易生成doxy格式的注释。下面的代码就是一个doxy格式的代码注释。
/**
* @file   49.cc
* @author wg
* @date   Sat Feb 14 13:55:04 2009
*
* @brief  扩大数组大小
*
*
*/
#include  
void ChangeSizeId(int iArr[], int size);
int main(int argc, char * argv[])
{
    int a[10];
    for (int i = 0; i < 10; i++) {
        a = i;
    }
    ChangeSizeId(a, 10);
}
/**
* Change array size
*
* @param iArr
* @param size 数组大小
*/
void ChangeSizeId(int iArr[], int size)
{
    int *p = new int(2 * size);
    for (int i = 0; i < size; i++) {
        *(p + i) = iArr;
    }
}
     doxygen可以产生多种文档，默认产生html和latex两种格式的文档。用doxygen生成文档主要是三个步骤：
1）doxygen -g filename
   生成filename配置文件
2）编辑配置文件filename
   配置文件主要有下面几个参数：
PROJECT_NAME        项目名称  
PROJECT_NUMBER       项目版本
OUTPUT_DIRECTORY      输出的目录  
INPUT           输入的目录
[color="#000000"]OUTPUT_LANGUAGE = Chinese 设定语言
FILE_PATTERNS     = *.c *.h *.cpp ....  分析的文件后缀
  INLINE_SOURCES  = YES    会显示源码
[color="#000000"]RECURSIVE ＝ YES  [color="#000000"]INPUT所指定目录的所有子目录都会被处理
[color="#000000"]SOURCE_BROWSER  [color="#000000"]= YES  Doxygen会产生出源文件的列表，以供查阅
[color="#000000"]EXCLUDE 指定不希望处理的目录或文件
[color="#000000"]EXCLUDE_PATTERNS  设定不希望处理的文件的后缀与FILE_PATTERNS类似
3）doxygen filename
    生成文档完毕。你可以在目录下查看多了两个文件夹html和latex。里面就是生成的文档。
     doxygen 除了 html latex   还可以生成 man rtf xml ， 而且也支持生成数学公式，以及图片 。具体的以后研究了，在写出来。
               
               
               
               
               

本文来自ChinaUnix博客，如果查看原文请点：http://blog.chinaunix.net/u3/93856/showart_2014591.html