doxygen 手记

1、忽略某段代码，即不对该段代码编制文档
@cond sectionname
  code
@endcond sectionname
如果在配置文件中对于ENABLE_SECTION选项中不包含该段名，则不会对该段代码编制文档。

2、分类
    group
 
    python中
    ## @defgroup  这两行必须在一起，之间不能有空行
    ## @{
     ...
    ##@}
    也可以写成
    ## @defgroup
    #  @{
      ...
    #  @}

    ## @addtogroup
    #  @{
      ...
    #  @}

    子组
    ## @defgroup
    ## @defgroup
    #  @ingroup  father_group
    #  @{
      ...
    #  @}

3、可自动识别python类中的self.var及静态变量，但无法识别静态方法，静态方法与一般实例方法处理是一样的。
4、加入todo列表： 1、@file 2、@todo，如果没有@file标签，在生成页面时不会有related pages，而todo列表就在这个页面里
5、设置SOURCE_BROWSER后，源文件会包含进来，并且会在函数或变量的文档中生成相关源文件行号 。

6、@package
   java:
   /** @package
    *  @brief brief description
    *
    *  detail description
    */