未验证 提交 3bebe17f 编写于 作者: O openharmony_ci 提交者: Gitee

!22328 【轻量级 PR】:update模板

Merge pull request !22328 from zengyawen/N/A
......@@ -14,12 +14,7 @@
* @brief 一句话描述该库的作用。(请使用动宾结构,如:实现XX功能。)
*
* 详细描述该模块的主要功能、使用场景和使用建议。尤其对这个模块中涉及的逻辑概念,相互关系,在应用中的作用进行说明。
* 比如AOSP中的Choreographer,介绍下这个概念的功能;然后介绍下简单的使用方法
* Choreographer,负责编排帧渲染时间,是java版本的C实现,应用可以利用这个机制安排帧的合理绘制时间点。接口使用
* 1. 注册一个回调函数到这个Choreographer,下一帧的时候调用
* 2. 在下一帧开始的时候,回调被调用,参数会带一个系统返回的FrameCallbackData
* 3. 回调中可以做的处理
* 4. sf根据回调的返回值,进行转换处理
* 介绍这个概念的功能;然后介绍下简单的使用方法
* 详细描述中,如果有多个段落,每段必须以“\n”结束。\n
*
* @since OS的版本号
......@@ -41,6 +36,7 @@
* 详细描述该类或接口的主要功能、使用场景和使用建议。覆盖该类的主要功能、使用场景和使用建议。尤其对这个类涉及的逻辑概念,相互关系,在应用中的作用进行说明。\n
* 详细描述中,如果有多个段落,每段必须以“\n”结束。\n
* @library 引用头文件接口,需要链接的so名字
* @syscap 后面跟着这个头文件属于的syscap能力
* @since OS的版本号
*/
```
......@@ -54,7 +50,7 @@
* 详细描述该宏定义/常量/变量的作用、使用限制和建议、取值范围,以及取到边界值、非法值的后果。\n
* 详细描述中,如果有多个段落,每段必须以“\n”结束。\n
*
* @deprecated (可选)标记位废弃的接口,需要加上这个标记,并写明从什么版本开发废弃,使用什么接口代替
* @deprecated (可选)since OS的版本号 标记从什么版本开始废弃此变量,后面需要写明使用替代的方法
* @since OS的版本号
*/
```
......@@ -68,7 +64,7 @@
* 详细描述该结构体或联合体的作用、使用场合和建议等。\n
* 详细描述中,如果有多个段落,每段必须以“\n”结束。\n
*
* @deprecated (可选)标记位废弃的接口,需要加上这个标记,并写明从什么版本开发废弃,使用什么接口代替
* @deprecated (可选)since OS的版本号;标记位废弃的接口,需要加上这个标记,后面写明从什么版本开发废弃,使用什么接口代替
* @since OS的版本号
*/
struct StructName {
......@@ -76,6 +72,10 @@ struct StructName {
unsigned long StructMember1;
/** 描述成员2的含义。 */
unsigned long StructMember2;
/** 描述成员3的含义。
* @since(可选) OS版本号,当新增域时,与结构体总的引入版本号不一样的时候,需要写上since,表明这个域新增版本。
*/
unsigned long StructMember3;
};
```
......@@ -88,15 +88,19 @@ unsigned long StructMember2;
* 详细描述该枚举的主要功能、使用场景和使用建议。\n
* 详细描述中,如果有多个段落,每段必须以“\n”结束。\n
*
* @deprecated (可选)标记位废弃的接口,需要加上这个标记,并写明从什么版本开发废弃,使用什么接口代替
* @deprecated (可选)since OS的版本号;标记位废弃的接口,需要加上这个标记,后面写明从什么版本开发废弃,使用什么接口代替
* @since OS的版本号
*/
enum EnumName {
/** 描述枚举值1的含义 */
EnumMermber1,
/** 描述枚举值2的含义 */
/** 描述枚举值2的含义
* @deprecated(可选) since OS的版本号;当需要废弃某个枚举值,需要标记从什么版本开始废弃。废弃后不要删除,尤其是顺序编码的枚举值,删除后会导致枚举值变化。
*/
EnumMermber2,
/** 描述枚举值3的含义 */
/** 描述枚举值3的含义
* @since(可选) OS版本号,当新增枚举值时,与结构体总的引入版本号不一样的时候,需要写上since,表明这个域新增版本
*/
EnumMermber3
};
```
......@@ -111,10 +115,11 @@ enum EnumName {
* 详细描述中,如果有多个段落,每段必须以“\n”结束。\n
*
* @param (可选)后接参数名和参数描述,一个参数使用一个@param标记。参数描述写作要点:1.参数的作用、使用限制和建议;2.参数的取值范围,以及取到边界值、非法值的后果;3.如果存在参数设置方面的建议值或经验值,请描述。如果该方法没有参数,则请删除该标记。
* @return (可选)后接返回描述。如果该函数没有返回值,则请删除该标记。
* @return (可选)后接返回描述,对此函数会返回的每个返回值进行详细说明其含义。如果该函数没有返回值,则请删除该标记。
* @see (可选)当存在与该函数相关联的函数时(功能相近或者存在关系),可以通过@see建立到参考函数的链接。如果需要链接多个函数,每个函数使用一个@see标记。如果不涉及,则请删除该标记。
* @permission (可选)对权限有要求的接口需要写
* @deprecated (可选)标记位废弃的接口,需要加上这个标记,并写明从什么版本开发废弃,使用什么接口代替
* @deprecated (可选)since OS的版本号;标记位废弃的接口,需要加上这个标记,并写明从什么版本开发废弃
* @useinstead 使用什么接口代替
* @since OS的版本号
*/
```
\ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册