简要说明
使用 /** 开始文档块
使用 */ 结束文档块
在文档块中，我们可以使用多个标签:
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 站点。