1. 程序应该包括两个部分注释，说明部分和语句注释。一般情况下，源程序有效注释量必
须在30％以上。
2. 说明部分：
1) 源文件说明部分位于每个源文件的最前面，主要描述：文件名、作者、生成日期、
联络方式、功能描述、版本号、软硬件平台、版权说明、修改记录等的简要说明，以英文书
写。
例如：
/*************************************************
File name: ;文件名
Author: ;作者
Date: ;日期
Email: ;邮箱地址
Description: ;功能描述
Version: ;版本号
7
Hardware&IDE ;软硬件平台
Copyright (C), SONIX TECHNOLOGY Co., Ltd.
History: ;修改记录
*************************************************/
2) 子程序说明部分位于每个子程序的最前面，主要描述：子程序名称、功能、设计原
理、所用变量、入口条件、出口信息、调用模块、堆栈层数、影响资源、算法简述、使用说
明和修改记录等。
例如：
/**************************************************
Subroutine: ;子程序名称
Description: ;子程序功能的描述
Principium: ;程序设计原理
Calls: ;被本子程序调用的子程序清单
Variables: ;本子程序中所用到的临时变量
Input: ;子程序调用所需要基本参数的说明
Output: ;子程序调用后运算结果的说明
Stack: ;占用的堆栈层数
History: ;修改记录
*************************************************/
3. 边写代码边注释，修改代码的同时修改相应注释，以保证注释与代码的一致性。不再有
用的注释要删除。
4. 要避免在注释中使用缩写，特别是非常用缩写。
5. 程序在必要的地方必须有注释，注释要准确、易懂、简洁。注释要有意义，如果有需要，
还要详细描述相关含义。
例如：
以下是无意义的注释
mov a,#5 ;把5赋给acc
mov wk00,a ;把acc 赋给wk00
应该如下注释：
mov a,#5 ;设置循环次数为5次
mov wk00,a
6. 注释应与其描述的代码相近，对代码的注释应放在其上方或右方（对单条语句的注释）
的相邻位置，不可放在下方，如放于上方则需与其上面的代码用空行隔开。
例如：
clr wk00
; Check Read index = FiFo Limit
cmprs a,r ; Is Read index = Limit
jmp @f
7. 注释格式尽量统一，对多行注释建议使用“/* …… */”，对单行的注释建议使用“;”。
8. 注释应考虑程序易读及外观排版因素，语言尽量统一。对不能进行准确英文表达的建议
使用中文。
9. 对有含义的变量、常量，如果其命名不是充分自注释的，在声明时都必须加以注释，说
明其含义。