在 Doxygen 中评论一个文件
Comment a file in Doxygen
我有一个 C 头文件,我想为其编写介绍性注释。像这样:
/**
* @brief Provides stuff for my great program.
*/
#ifndef MYHEADER_H
#define MYHEADER_H
#define __USE_GLIBC
#endif
此外,我有这个 Doxyfile:
FULL_PATH_NAMES = YES
TAB_SIZE = 8
OPTIMIZE_OUTPUT_FOR_C = YES
RECURSIVE = YES
INPUT = .
EXTRACT_ALL = YES
QUIET = YES
EXTRACT_STATIC = YES
当我现在 运行 Doxygen 时,它会生成 HTML 和 LaTeX 文档,但简短的描述最终会记录宏而不是整个文件。
那么如何向 Doxygen 提供文件的简短描述?
假设您的文件名为 header.h
。这样做:
/*! @file header.h
* @brief Provides stuff for my great program.
*
* Detailed description here, if any.
*/
您应该使用 @file
宏来表示与整个文件相关的评论:
/**
* @file myheader.h
* @brief Provides stuff for my great program.
*/
根据 the docs,虽然在任何文件中使用 @file myfile.ext
都有效(即不仅仅是文档注释所在的文件),但仅使用 @file
将记录当前文件.
完整示例
/**
* @file
* @brief A file that is documented.
*
* Detailed description, etc.
*/
我有一个 C 头文件,我想为其编写介绍性注释。像这样:
/**
* @brief Provides stuff for my great program.
*/
#ifndef MYHEADER_H
#define MYHEADER_H
#define __USE_GLIBC
#endif
此外,我有这个 Doxyfile:
FULL_PATH_NAMES = YES
TAB_SIZE = 8
OPTIMIZE_OUTPUT_FOR_C = YES
RECURSIVE = YES
INPUT = .
EXTRACT_ALL = YES
QUIET = YES
EXTRACT_STATIC = YES
当我现在 运行 Doxygen 时,它会生成 HTML 和 LaTeX 文档,但简短的描述最终会记录宏而不是整个文件。
那么如何向 Doxygen 提供文件的简短描述?
假设您的文件名为 header.h
。这样做:
/*! @file header.h
* @brief Provides stuff for my great program.
*
* Detailed description here, if any.
*/
您应该使用 @file
宏来表示与整个文件相关的评论:
/**
* @file myheader.h
* @brief Provides stuff for my great program.
*/
根据 the docs,虽然在任何文件中使用 @file myfile.ext
都有效(即不仅仅是文档注释所在的文件),但仅使用 @file
将记录当前文件.
完整示例
/**
* @file
* @brief A file that is documented.
*
* Detailed description, etc.
*/