Apache HTTP 服务器版本 2.2
This document refers to the 2.2 version of Apache httpd, which is no longer maintained. The active release is documented here. If you have not already upgraded, please follow this link for more information.
You may follow this link to go to the current version of this document.
使用 /**
开始文档块
使用 */
结束文档块
在文档块中,我们可以使用多个标签:
Description of this functions purpose
@param parameter_name description
@return description
@deffunc signature of the function
一般不需要 deffunc
。DoxyGen 没有完整的解析器,所以任何
在返回类型声明中使用宏的原型,都是太复杂了。这些函数就需要使用 deffunc
。
例如 (使用 > 而不是 >):
/**
* return the final element of the pathname
* @param pathname The path to get the final element of
* @return the final element of the path
* @tip Examples:
* <pre>
* "/foo/bar/gum" -> "gum"
* "/foo/bar/gum/" -> ""
* "gum" -> "gum"
* "wi\\n32\\stuff" -> "stuff"
* </pre>
* @deffunc const char * ap_filename_of_pathname(const char *pathname)
*/
总是在头文件开始包含:
/**
* @package Name of library header
*/
Doxygen 为每个包生成一个新的 HTML 文件,名字是 {Name_of_library_header}.html,所以请简化名称。
更深入的讨论,请参见 Doxygen 站点。