技术分享
doxygen使用教程
00 分钟
2024-1-18
2024-4-10
type
status
date
slug
summary
tags
category
icon
password
文章筛选
以下是常见的 Doxygen 注释标记的表格,包括它们的功能和说明:
标记
功能
说明
@file
描述整个源文件
描述整个源文件的内容和作用
@brief
提供简要描述
描述函数、类或成员的简要说明
@param
描述函数参数
描述函数的参数名称和用途
@return
描述返回值
描述函数的返回值的含义
@retval
函数返回值的特定取值说明
@see
引用相关文档或代码元素
创建超链接到其他文档或资源
@note
提供额外的注释或注记
提供额外的相关信息或注记
@warning
指示潜在问题或警告
指示潜在的问题或需要注意的警告
@deprecated
标记已弃用的代码元素
标记代码元素已被弃用,不推荐使用
@code
标记代码示例的开始
将注释内的文本标记为代码示例的开始
@endcode
标记代码示例的结束
结束 @code 块,代码示例的结束
@class
描述类
描述类的内容和作用
@struct
描述结构体
描述结构体的内容和作用
@enum
描述枚举类型
描述枚举类型的内容和作用
@fn
描述函数
描述函数的内容和作用
@var
描述变量
描述变量的内容和作用
@typedef
描述类型定义
描述类型定义的内容和作用
@example
提供代码示例
提供一个代码示例,展示使用方法
@todo
标记待办事项
标记待办事项或未完成的工作
@internal
指示内部代码元素
指示内部代码元素,不会出现在生成的文档中
@link
创建超链接
创建一个超链接到其他文档或资源
@mainpage
标记为主页
标记为整个文档的主页,作为入口点
@defgroup
创建模块分组
将相关的类、函数或变量分组为一个模块
@addtogroup
添加到现有模块分组
将代码元素添加到现有的模块分组中
@par
创建段落
创建一个段落,提供特定的使用指南、示例等
@namespace
描述命名空间
描述命名空间的内容和作用
@anchor
创建命名的锚点,用于在文档内部进行跳转
@ref
引用锚点或其他文档元素,创建内部跳转链接
 
 
github
 

评论
  • Waline