recovery中文版图解注释
recovery中文版图解注释：
-reboot system now 重启系统
-apply sdcard:update.zip 使用SD卡根目录的update.zip 更新系统
-wipe data/factory reset 清空data分区并恢复出厂设置
-wipe cache partition 清空cache分区
-install zip from sdcard 从SDcard选择文件更新系统
--apply sdcard:update.zip 使用SD卡根目录的update.zip 更新系统
--choose zip from sdcard 从SD卡选择zip格式升级包
--toggle signature verification 切换签名验证
--toggle script asserts 切换升级脚本检查
-backup and restore 备份和恢复
--Backup 备份
--Restore 恢复
--Advanced Restore 高级恢复
-mounts and storage 挂载和存储
--mount /system 挂载/system分区(系统分区)
--mount /data 挂载/data分区(数据分区)
--mount /cache 挂载/cache分区(缓存分区)
--mount /sd-ext 挂载/sd-ext分区(A2SD分区)
--format boot 格式化内核分区
--format system 格式化系统分区
--format data 格式化数据分区
--format cache 格式化缓存分区
--format sdcard 格式化存储卡
--format sd-ext 格式化内存卡SD
--mount USB storage 挂载SD卡为U盘模式-advanced 高级
--Reboot Recovery 重启Recovery
--Wipe Dalvik Cache 清空Dalvik缓存
--Wipe Battery Stats 清空电池状态
--Report Error 报告错误
--Key Test 键位测试
--Partition SD Card 对SD卡分区
--Fix Permissi** 修复权限
程序代码注释编写规范
程序代码注释编写规范 为提高控制程序的阅读性与可理解性，现制定相关代码程序代码注释编写的编写规范。 一般情况下，源程序有效注释量必须在20％以上，注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。 常规注释有以下两种方式。 单行:以"//"符号开始，任何位于该符号之后的本行文字都视为注释。 多行:以"/*"符号开始，以"*/"结束。任何介于这对符号之间的文字都视为注释。 一、说明性文件 说明性文件（如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等）头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等，头文件的注释中还应有函数功能简要说明。 示例：下面这段头文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************* COPYRIGHT (C), MicTiVo International. Co., Ltd. File NAME: // 文件 Author: Version: Date: // 作者、版本及完成日期 DESCRIPTION: // 用于详细说明此程序文件完成的主要功能，与其他模块 // 或函数的接口，输出值、取值范围、含义及参数间的控 // 制、顺序、独立或依赖等关系 Others: // 其它内容的说明 Function List: // 主要函数列表，每条记录应包括函数名及功能简要说明 1.... History: // 修改历史记录列表，每条修改记录应包括修改日期、修改 // 者及修改内容简述 1. Date: Author: Modification: 2. .. *************************************************/ 二、源文件头 源文件头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。 示例：下面这段源文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************************ COPYRIGHT (C), MicTiVo International. Co., Ltd. FileName: Author:
C语言注释规范
C语言注释规范 1.注释原则 同一软件项目开发中，尽量保持代码注释规范和统一。 注释方便了代码的阅读和维护。 边写代码边注释，修改代码时要相应修改注释，保证注释和代码的一致性。 注释要简洁明确，不要出现形容词。 对于写的好的注释，我们将是第一个受益者。 大型软件开发中，通过别人的注释可以快速知道他人所写函数的功能，返回值，参数的使用。 2.文件头部的注释 示例： / * Program Assignment : 该文件的作用 * Author: 作者 * Date: 2013/8/6 14:34 * Description: 该文件的描述 *****/ /* * Source code in : 源代码的路径 * Function List: * initLinear 初始化线性表 * destoryLinear 释放线性表申请的空间 * isLinearEmpty 判断线性表是否为空 * isLinearFull 判断线性表是否为满 * getLinearElementValue 取得下标为index的元素的值 */ 注意：这个函数列表可以快速查询到我们想要了解的函数。 3.结构体，全局变量等的注释 示例： typedef POLYNOMIAL USER_TYPE; /* 新的数据类型的描述*/ int a; /* 全局变量的作用*/ /* 说明结构体的功能*/ typedef struct LINEAR { USER_TYPE *data; /* 每个成员的意义(作用) */ int maxRoom; /* 每个成员的意义(作用) */
int elementCount; /* 每个成员的意义(作用) */ }LINEAR; 4.函数的注释 在逻辑性较强的的地方加入注释，以便其他人的理解，在一定的程度上排除bug。 示例： /* * Function Name: getLinearElementIndex * Purpose: 取得元素的index值 * Params : * @LINEAR linear 线性表实例 * @USER_TYPE var 类型为USER_TYPE的实例 * @int (*)() cmp 提供接口，让用户定义具体比较函数 * Return: int 返回元素的index值 * Limitation: 如果返回-1，则代表不存在var的元素 */ int getLinearElementIndex(LINEAR linear, USER_TYPE var, int (*cmp)()) { /* * 如果逻辑太过复杂，这里写明该算法的过程和思路。 */ boolean found = FALSE; int i; for(i = 0; i < && !found; i++) if(cmp[i], var) == 0) found = TRUE; if(i >= i = NOT_FOUND; return i; }
弟子规原版及注释
弟子规原版及注释 ?dìzǐguīshèngrénxùn shǒuxiàotì cìjǐnxìn 弟子规圣人训首孝悌次谨信 ?fànàizhòng érqīnrén yǒuyúlìzéxuéwén 泛爱众而亲仁有余力则学文 ?释义：《弟子规》所讲述的，是至圣先师孔子的训导。首先要孝顺父母，尊敬兄长。 其次做事小心谨慎，说话诚实可信。博爱大众，亲近有仁德的人，做好这些之后，还有剩余力量，就再去学习文献。 ?rù zé xiào 入则孝 对父母尽心奉养并顺从父母的意志 ?fùmǔhūyìngwùhuǎn fùmǔmìng xíngwùlǎn 父母呼应勿缓父母命行勿懒 fùmǔjiào xūjìngtīng fùmǔzé xūshùnchéng 父母教须敬听父母责须顺承 ?释义：父母叫你，应该赶快答应；父母让你做什么事，不要拖拉懒散；父母教导你，一定要恭恭敬敬地听；父母责备你，一定要虚心接受。 ?dōngzéwēn xiàzéqìng chénzéxǐng hūnzédìng 冬则温夏则凊晨则省昏则定 chūbìgào fǎnbìmiàn jūyǒucháng yèwúbiàn 出必告反必面居有常业无变 ?释义：冬天让父母暖和，夏天让父母凉快，早晨恭恭敬敬地请安，晚上要替父母铺好被褥。出门要告诉父母一声，回来也要通报一声，住的地方要稳定，工作也不要随便变动。 ?Shìsuīxiǎo wùshànwéi gǒushànwéi zǐdàokuī 事虽小勿擅为苟擅为子道亏 wùsuīxiǎo wùsīcáng gǒusīcáng qīnxīnshāng 物虽小勿私藏苟私藏亲心伤 ?释义：事情虽然很小，也不要擅自做主，如果擅自做主，就有损为人子女的本分。 东西虽然很小，也不能私藏起来，如果私藏的话，父母一定会很伤心。 ?qīnsuǒhào lìwèijù qīnsuǒwù jǐnwèiqù 亲所好力为具亲所恶谨为去 shēnyǒushāng yíqīnyōu déyǒushāng yíqīnxiū 身有伤贻亲忧德有伤贻亲羞 qīnàiwǒxiàohénán qīnzēngwǒxiàofāngxián 亲爱我孝何难亲憎我孝方贤 ?释义：父母所喜欢的东西，要尽力为他们准备好；父母所厌恶的东西，要小心谨慎地为他们扔掉。身体有了伤痛，会让父母担心；道德品质出了毛病，会让父母丢丑。 父母喜欢我，孝顺很容易；父母不喜欢我，我还能孝顺他们，这样的孝才是真正的孝。
华为JAVA编程规范
1 Java 编程规范 1.1 排版 1.1.1 规则 规则1程序块要采用缩进风格编写，缩进的空格数为4个，不允许使用TAB缩进。(1.42+) 说明：缩进使程序更易阅读，使用空格缩进可以适应不同操作系统与不同开发工具。 规则2分界符（如大括号…{?和…}?）应各独占一行，同时与引用它们的语句左对齐。在函数体的开始、类和接口的定义、以及if、for、do、while、switch、case语句中的程序 或者static、,synchronized等语句块中都要采用如上的缩进方式。(1.42+) 示例: if (a>b) { doStart(); } 规则3较长的语句、表达式或参数（>80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐， 语句可读。(1.42+) 示例： if (logger.isDebugEnabled()) { logger.debug("Session destroyed,call-id" + event.getSession().getCallId()); } 规则4不允许把多个短语句写在一行中，即一行只写一条语句(1.42+) 说明：阅读代码更加清晰 示例：如下例子不符合规范。 Object o = new Object(); Object b = null; 规则5if, for, do, while, case, switch, default 等语句自占一行，且if, for, do, while,switch等语句的执行语句无论多少都要加括号{},case 的执行语句中如果定义变量必须加括号{}。 (1.42+) 说明：阅读代码更加清晰，减少错误产生 示例： if (a>b) { doStart(); }
程序代码编写规范
程序编写规范及约定 (仅供内部使用) 文档作者：_______________ 日期：___/___/___ 开发/测试经理：_______________ 日期：___/___/___ 项目经理：_______________ 日期：___/___/___ 请在这里输入公司名称 版权所有不得复制
目录 程序编写规范及约定 (3) 1编写目的 (3) 2代码编写风格 (3) 2.1单元风格 (3) 2.2语句风格 (3) 3命名规则 (3) 3.1命名约定 (3) 3.1.1标志符 (3) 3.1.2类class (3) 3.1.3枚举类型enum (4) 3.1.4委托delegate (4) 3.1.5常量const (4) 3.1.6接口interface (4) 3.1.7方法function (4) 3.1.8命名空间namespace (4) 3.1.9参数 (4) 3.1.10局部变量 (5) 3.1.11数据成员 (5) 3.1.12自定义异常类 (5) 3.1.13命名缩写 (5) 3.1.14数据库命名 (5) 3.2代码编写命名规范 (6) 3.3界面常用控件命名约定 (6) 3.4文件命名规范 (7) 3.4.1文档文件命名 (7) 3.4.2配置文件命名 (7) 3.4.3程序文件命名 (7)
程序编写规范及约定 1编写目的 为了使编写代码具有可读性、可理解性、可维护性，对程序编写人员代码实行统一风格，使得程序代码能够以名称反映含义、以形式反映结构。此文档可供程序代码编写人员及代码维护人员使用。 2代码编写风格 2.1单元风格 2.2语句风格 3命名规则 3.1命名约定 Pascal和Camel命名约定： 编程的命名方式主要有Pascal和Camel两种（Pascal：每个单词的首字母大写，例如ProductType；Camel：首个单词的首字母小写，其余单词的首字母大写，例如productType） 3.1.1标志符 规则：Pascal、Camel 实例与描述：例子说明 3.1.2类class 规则：Pascal 实例与描述：Application
程序代码注释编写规范
百度文库- 让每个人平等地提升自我 1 程序代码注释编写规范 为提高控制程序的阅读性与可理解性，现制定相关代码程序代码注释编写的编写规范。 一般情况下，源程序有效注释量必须在20％以上，注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。 常规注释有以下两种方式。 单行:以"文件、.inc文件、.def文件、编译说明文件.cfg等）头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等，头文件的注释中还应有函数功能简要说明。 示例：下面这段头文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************* (C), MicTiVo International. Co., Ltd. 1.File : . History: Date: Author: Modification: 2. .. *************************************************/ 一、源文件头 源文件头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。 示例：下面这段源文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************************ (C), MicTiVo International. Co., Ltd. FileName: Author: Version : Date: : / /*receive _process() */ 意:与溢出中断写初值不同}
程序代码注释编写规范
程序代码注释编写规范 XXX份公司
为提高控制程序的阅读性与可理解性，现制定相关代码程序代码注释编写的编写规范。 一般情况下，源程序有效注释量必须在20％以上，注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。 常规注释有以下两种方式。 单行:以"//"符号开始，任何位于该符号之后的本行文字都视为注释。 多行:以"/*"符号开始，以"*/"结束。任何介于这对符号之间的文字都视为注释。 一、说明性文件 说明性文件（如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等）头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等，头文件的注释中还应有函数功能简要说明。 示例：下面这段头文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************* COPYRIGHT (C), MicTiVo International. Co., Ltd. File NAME: // 文件 Author: Version: Date: // 作者、版本及完成日期 DESCRIPTION: // 用于详细说明此程序文件完成的主要功能，与其他模块 // 或函数的接口，输出值、取值范围、含义及参数间的控 // 制、顺序、独立或依赖等关系 Others: // 其它内容的说明 Function List: // 主要函数列表，每条记录应包括函数名及功能简要说明 1.... History: // 修改历史记录列表，每条修改记录应包括修改日期、修改 // 者及修改内容简述 1. Date: Author: Modification: 2. .. *************************************************/ 二、源文件头 源文件头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。 示例：下面这段源文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************************
弟子规全文翻译及注释上课讲义
弟子规全文翻译及注 释
【总叙】 弟子规圣人训首孝悌次谨信泛爱众而亲仁有余 力则学文 （注释：训：教导，教诲。悌：敬爱兄长为悌。信：言语真实，诚实。） 译文：《弟子规》这本书是依据孔子的教诲编成的，其中提出了许多生活规范。在日常生活中，首先要做到孝顺父母，友爱兄弟姊妹。其次，言语行为要小心谨慎，诚实无欺。和大众相处时要平等博爱，并且亲近有仁德的人，向他们学习。如果这些事情做了之后，还有多余的时间、精力，就应该好好地学习典籍，以获得有益的学问。 【入则孝】 父母呼应勿缓父母命行勿懒父母教须敬听父母责须顺承 （注释：应：应答。命：指派，差遣。承：接受，承受。） 译文：父母呼唤，要及时回答，不要慢吞吞地过了很久才应答；父母差遣，要立刻去做，不可拖延或偷懒；父母教导，应该恭敬地聆听；父母批评，应当顺从地接受。 冬则温夏则凊晨则省昏则定出必告反必面居有常业无变（注释：清：冷，凉。省：问候，探望。反：同“返”，回来） 译文：侍奉父母要用心体贴，汉朝时期的黄昏（人名）为了让父亲安心睡眠，夏天睡前会帮父亲把床铺扇凉，冬天睡前会为父亲温暖被窝，实在值得我们学习。早晨起床之后，应该先探望父母，并向父母请安问好。下午回家之后，要将今天在外的情形告诉父母，向父母报平安，使老人家放心。外出离家时，须告诉父母要到哪里去，回家后还要当面禀报父母自己回来了，让父母安心，平
时起居作息，要做到有规律，做事也要有规矩，不要任意改变，以免父母担忧。 事虽小勿擅为苟擅为子道亏物虽小勿私藏苟私藏亲心伤（注释：为：做。苟：假如。亏：欠缺，短少。亲：父母。） 译文：纵然是小事，也不要擅自作主，而不向父母禀告。如果任性而为，一旦出错，就有损为人子女的本分，让父母担心，这就是不孝的行为了。公物虽小，也不可以私自据为己有。如果私藏，品德就有了污点，父母知道了一定很伤心。 亲所好力为具亲所恶谨为去身有伤贻亲忧德 有伤贻亲羞 （注释：亲：父母。好：喜好。具：置办，准备。去：除去，去掉。贻：让。羞：感到羞辱。） 译文：父母所喜好的东西，应该尽力去准备；父母所厌恶的事物，要小心谨慎地去除（包括自己的坏习惯）。如果我们的身体受到伤害，会让父母担忧；如果我们的品德有了污点，会让父母感到羞耻。 亲爱我孝何难亲憎我孝方贤亲有过谏使更怡吾 色柔吾声 （注释：方：才。过：过错。谏：用言语规劝尊长。更：更改。怡：使——喜悦、快乐。柔：使——柔和。） 译文：父母爱我，我孝敬父母，这并不是一件难事；如果父母不爱我，而我又能孝敬父母，这才是真正的大孝。如果父母有了过失，我们要劝其改过；劝的时候一定要和颜悦色，声调柔和。
C语言编写规范之注释
1、头文件包含Includes 2、私有类型定义 Private typedef 3、私有定义Private define 4、私有宏定义 Private macro 5、私有变量 Private variables 6、私有函数原型Private function prototypes 7、私有函数Private functions 8、私有函数前注释 /****************************************************************************** * * Function Name : FSMC_NOR_Init * Description : Configures the FSMC and GPIOs to interface with the NOR memory. * This function must be called before any write/read operation * on the NOR. * Input : None * Output : None * Return : None ******************************************************************************* / 9、程序块采用缩进风格编写，缩进空格为4。 10、相对独立的程序块之间、变量说明之后必须加空行； 11、较长的字符（>80字符）要分成多行书写，长表达式要在低优先级操作符划分新行，操作符放在新行之首，新行要恰当缩进，保持排版整齐； 12、循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首; 13、若函数或过程中的参数较长，则要进行适当的划分。 14、不允许把多个短语句写在一行中，即一行只写一条语句。 15、if、for、do、while、case、switch、default等语句自占一行，且if、for、 do、while等语句的执行语句部分无论多少都要加括号{}。 16、对齐只使用空格键，不使用TAB键； 17、 函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格，case 语句下的情况处理语句也要遵从语句缩进要求 18、 程序块的分界符（如C/C++语言的大括号‘{’和‘}’）应各独占一行并且位于同一 列，同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以 及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。 19、 在两个以上的关键字、变量、常量进行对等操作时，它们之间的操作符之前、之后或
《弟子规》全文拼音版带注释
dìzǐ guī 弟子规 弟子：一般有两种意义：一是年纪较小为人弟和为人子的人；二是指学生。这里是用一种意义上的“弟子”。 zǒng xù 【总叙】 dì zǐ guī shèng rén xùn shǒu xiào tì cì jǐn xìn 弟子规圣人训首孝悌次谨信 解读：弟子规这本书，是依据至圣先师孔子的教诲而编成的生活规范。首先在日常生活中，要做到孝顺父母，友爱兄弟姊妹。其次在一切日常生活言语行为中要小心谨慎，要讲信用。 fàn ài zhòng ér qīn rén yǒu yú lì zé xué wén 泛爱众而亲仁有余力则学文 解读：和大众相处时要平等博爱，并且亲近有仁德的人，向他学习，这些都是很重要非做不可的事，如果做了之后，还有多余的时间精力，就应该好好的学习六艺等其他有益的学问。 rù zé xiào 【入则孝】 在日常生活中要孝顺父母 fù mǔ hū yìng wù huǎn fù mǔ mìng xíng wù lǎn 父母呼应勿缓父母命行勿懒 解读：父母呼唤，应及时回答，不要慢吞吞的很久才应答，父母有事交代，要立刻动身去做，不可拖延或推辞偷懒。 fù mǔ jiào xū jìng tīng fù mǔ zé xū shùn chéng 父母教须敬听父母责须顺承 解读：父母教导我们做人处事的道理，是为了我们好，应该恭敬的聆听。做错了事，父母责备教诫时，应当虚心接受，不可强词夺理，使父母亲生气、伤心。（君子闻过则喜，小人闻过则怒。） dōng zé wēn xià zé qìng chén zé xǐng hūn zé dìng 冬则温夏则凊晨则省昏则定 解读：侍奉父母要用心体贴，二十四孝的黄香（香九龄），为了让父亲安心睡眠，夏天睡前会帮父亲把床铺扇凉，冬天寒冷时会为父亲温暖被窝，实在值得我们学习。早晨起床之后，
代码规范
目录 一．规范简介 1.1 目的 所有的程序开发手册都包含了各种规则。一些习惯自由程序人员可能对这些规则很不适应，但是在多个开发人员共同写作的情况下，这些规则是必需的。这不仅仅是为了开发效率来考虑，而且也是为了后期维护考虑。 本规范正是为培养规范设计和编程，养成良好的习惯，增强软件产品的稳定，健壮，可靠性；同时也为了提高软件的可读性，可以让程序员尽快而彻底地理解新的代码，使产品可维护性提高而制定的规范。 1.2 开发规范的重要性 （1）减少维护成本； 一个软件的生命周期中，80%的花费在于维护，另一方面，几乎没有任何一个软件，在其整个生命周期中，均由最初的开发人员来维护，规范的编码减少人员变动带来的维护成本。 （2）改善软件的可读性 可以让程序员尽快而彻底地理解新的代码。在一个团队中，代码也容易在程序员之间共享。 （3）维护部门交付产品的规范形象。 二．具体规范 2.1 注释 注释是软件可读性的具体表现。程序注释量一般占程序编码量的20%，软件工程要求不少于20%。程序注释不能用抽象的语言，要精确表达出程序的处理说明。避免每行程序都使用注释，可以在一段程序的前面加一段注释，具有明确的处理逻辑。 注释必不可少，但也不应过多，不要被动得为写注释而写注释。
2.1.1 需要注释的部分 （1）文件头注释，文件创建及修改记录，版权归属，作者以及修订者，以及对文件的简短描述。 （2）类的目的（即类所完成的功能）、设置接口的目的以及应如何被使用。 （3）成员方法注释（对于设置与获取成员方法，在成员变量已有说明的情况下，可以不加注释；普通成员方法要求说明完成功能，参数含义以及返回值）。 （4）普通成员方法内部注释（控制结构、代码所起到的作用以及如此编写代码的原因，处理顺序等）。 （4）参数的含义以及其他任何约束或前提条件、字段或属性描述。而对于局部变量，如无特别意义的情况下则不加注释。 2.1.2 具体注释 （1）文件头注释 要求：遵循JavaDoc的规范，在每一个源文件的开头注明该文件的作用, 作简要说明, 并写上源文件的作者,版权信息编写日期。如果是修改别人编写的源文件，要在修改信息上注明修改者和修改日期。 例子： /** * @Title: 文件名 * @Copyright (C) 年份龙图软件 * @Description: 文件信息描述 * @Revision History: * @Revision 版本号日期作者. */ （2）类和接口的注释 要求：遵循JavaDoc的规范，在每一个类的开头注明该类的作用，作简要说明，并写上作者，编写日期。 例子： /** * @ClassName: 类（或接口）名 * @Description: Description of this class
程序源代码注释规范
程序注释规范说明 程序注释规范应包括以下三方面： 一、文件头部注释 在代码文件的头部进行注释，这样做的好处在于，我们能对代码文件做变更跟踪。在代码头部分标注出创始人、创始时间、修改人、修改时间、代码的功能，这在团队开发中必不可少，它们可以使后来维护/修改的同伴在遇到问题时，在第一时间知道他应该向谁去寻求帮助，并且知道这个文件经历了多少次迭代、经历了多少个程序员的开发和修改。 样本： /***************************************************** ** 作者：Liuchao ** 创始时间：2007-11-12 ** 修改人：Liuchao ** 修改时间：2007-11-12 ** 修改人：Liaochao ** 修改时间：2007-11-12 ** 描述： ** 主要用于产品信息的资料录入，… *****************************************************/ 二、函数、属性、类等注释 请使用///三斜线注释，这种注释是基于XML的，不仅能导出XML制作帮助文档，而且在各个函数、属性、类等的使用中，编辑环境会自动带出注释，方便你的开发。以protected，protected Internal，public声明的定义注释都建议以这样命名方法。 例如： ///
/// 用于从ERP系统中捞出产品信息的类 /// class ProductTypeCollector { … } 三、逻辑点注释 在我们认为逻辑性较强的地方加入注释，说明这段程序的逻辑是怎样的，以方便我们自己后来的理解以及其他人的理解，并且这样还可以在一定程度上排除BUG。在注释中写明我们的逻辑思想，对照程序，判断程序是否符合我们的初衷，如果不是，则我们应该仔细思考耀修改的是注释还是程序了… 四、变量注释 我们在认为重要的变量后加以注释，说明变量的含义，以方便我们自己后来的理解以及其他人的理解，并且这样还可以在一定程度上排除BUG.我们常用///三斜线注释。 /// 用于从ERP系统中捞出产品信息的类 class ProductTypeCollector { int STData;///
《弟子规》全文及注释(附拼音)
弟子规 dì zǐ guīshèng rén xùn shǒu xiào tìcì jǐn xìn 弟子规圣人 训 首孝 弟 次谨 信 fàn ài zhòng ér qīn rén yǒu yú lìzé xué wén 泛爱众而亲 仁 有余 力 则学 文 【解释】《弟子规》这本书，是依据至圣先师孔子的教诲而编成的生活规范。首先在日常生活中，要做到孝顺父母，友爱兄弟姐妹。其次在一切日常生活言语行为中要小心谨慎，要讲信用。和大众相处时要平等博爱，并且亲近有仁德的人，向他学习，这些都是很重要非做不可的事，如果做了之后，还有多余的时间精力，就应该好好的学习六艺等其他有益的学问。 rù zé xiào 入则孝 fù mǔ hūyìng wù huǎn fù mǔ mìng xíng wù lǎn 父母呼应勿 缓 父母 命 行勿 懒 fù mǔ jiào xū jìng tīng fù mǔ zéxū shùn chéng 父母教须敬 听 父母 责 须顺 承 【解释】父母呼唤，应及时回答，不要慢吞吞的很久才应答，父母有事交代，要立刻动身去做，不可拖延或推辞偷懒。父母教导我们做人处事的道理，是为了我们好，应该恭敬的聆听。做错了事，父母责备教诫时，应当虚心接受，不可强词夺理，使父母亲生气、伤心。（君子闻过则喜，小人闻过则怒。）
dōng zé wēn xià zé jìng chén zé xǐng hūn zé dìng 冬则温夏则 凊 晨则 省 昏则 定 chū bì gào fǎn bì miàn jū yǒu cháng yè wú biàn 出必告反必 面 居有 常 业无 变 【解释】侍奉父母要用心体贴，在二十四孝故事里，九岁的黄香，为了让父亲安心睡眠，夏天睡前会帮父亲把床铺扇凉，冬天寒冷时会为父亲温暖被窝，实在值得我们学习。早晨起床之后，应该先探望父母，并向父母请安问好。下午回家之后，要将今天在外的情况告诉父母，向父母报平安，使老人家放心。外出离家时，须告诉父母要到哪里去，回家后还要当面禀报父母，让父母安心。平时生活起居，要保持正常有规律，做事有常规，不要任意改变，以免父母忧虑。 shì suī xiǎo wù shàn wéi gǒu shàn wéi zǐ dào kuī 事虽小勿擅 为 苟擅 为 子道 亏 wù suī xiǎo wù sī cáng gǒu sī cáng qīn xīn shāng 物虽小勿私 藏 苟私 藏 亲心 伤 【解释】纵然是小事，也不要任性，擅自作主，而不向父母禀告。如果任性而为，容易出错，就有损为人子女的本分，因此让父母担心，是不孝的行为。公物虽小，也不可以私自收藏占为己有。如果私藏，品德就有缺失，父母亲知道了一定很伤心。 qīn suǒ hào lì wèi jùqīn suǒ wùjǐn wèi qù 亲所好力为 具 亲所 恶 谨为 去 shēn yǒu shāng yí qīn yōu dé yǒu shāng yí qīn xiū身有贻亲德有贻亲
弟子规全文及注释教学文案
《弟子规》全文及解释 第一章<总序> ●弟子规，圣人训，首孝悌，次谨信。 译：作为子弟所要谨守的规戒，古圣先贤所传下的教训，第一就是要我们在家能孝顺、出外能敬长，其次是敬业而守信用。 ●泛爱众，而亲仁。有余力，则学文。 译：多关爱众生，亲近有仁德的人。如果德行培养差不多了，就可以去学习吸收经典的知识。 第二章<入则孝> ●父母呼，应勿缓；父母命，行勿懒。 译：父母叫我们，不可以慢吞吞的；父母交代事情，要勤快认真，不可以懒惰懈怠。 ●父母教，须敬听；父母责，须顺承。 译：父母亲有所教导，要恭敬听取；父母有所责备，也要承担接纳。 ●冬则温，夏则凊；晨则省，昏则定。 译：天冷或天热，要关心父母亲的寒暖；早起或晚睡，定时的问候父母起居安好。 ●出必告，反必面。居有常，业无变。 译：出门或返家，都向父母报告一声；居家作息有一定的规矩，工作行业则不要经常更换。 ●事虽小，勿擅为；苟擅为，子道亏。 译：虽然是小事情，也不可擅作主张；如果擅自作主，就不合作为子弟的身分了。 ●物虽小，勿私藏；苟私藏，亲心伤。 虽然是小东西，也不可私自收藏；如果个个藏为己有，就会惹父母亲难过伤心了。 ●亲所好，力为具；亲所恶，谨为去。 译：父母亲所喜欢的事物，我们要尽力准备妥当；父母亲不喜欢的，我们要留意避免。 ●身有伤，贻亲忧；德有伤，贻亲羞。 译：身体如果受伤了，会让父母亲担忧；品德如果败坏了，会让父母亲蒙羞。 ●亲爱我，孝何难；亲憎我，孝方贤。 译：父母亲喜欢我，要孝顺一点都不难；父母亲不喜欢我，我仍然孝顺那才是真贤能。
●亲有过，谏使更，怡吾色，柔吾声。 译：父母亲有过错，想办法劝谏让他们改正，但是要和颜悦色，要声音柔婉。 ●谏不入，悦复谏，号泣随，挞无怨。 译：如果父母不听劝谏，和悦的再劝，甚至用哭泣来求父母答应，就算被责打也无怨言。 ●亲有疾，药先尝；昼夜侍，不离床。 译：父母有了病痛，侍奉汤药冷热苦甘亲自尝过；早晚照顾，不离父母身边。 ●丧三年，常悲咽，居处变，酒肉绝。 译：父母去世守丧三年，心存哀苦，居家作息有所改变，酒肉美食暂时不去享用。 ●丧尽礼，祭尽诚；事死者，如事生。 译：守丧完毕，逢年过节祭祀要竭尽诚意；对死去的父母亲，要如生前一样的尽孝。 <出则悌> ●兄道友，弟道恭；兄弟睦，孝在中。 译：作哥哥的友爱弟弟，作弟弟的尊敬哥哥；兄弟和睦，也就是尽到了孝道。 ●财物轻，怨何生，言语忍，忿自泯。 译：如果能把财物看得轻淡，彼此就不会产生怨隙；说话时忍一忍，就不会有意气之争。 ●或饮食，或坐走，长者先，幼者後。 译：无论吃饭餐饮、入坐走路，要让长辈在先，晚辈在後。 ●长呼人，即代叫，人不在，己先到。 译：长辈叫人，马上帮忙代为传唤；如果所叫的人不在场，自己先到长者前听候使唤。 ●称尊长，勿呼名。对尊长，勿显能。 译：称呼长者要有礼貌，不可直呼其名；在长者前面，不要自以为才能高强。 ●路遇长，疾趋拜。长无言，退恭立。 译：路上遇到长辈，立刻趋前问候；长辈没有别的话，再恭敬退下站在一旁。 ●骑下马，乘下车，过犹待，百余步。 译：遇到了亲长，如果是骑马立刻下马，如果驾车立刻下车；就算过
弟子规全文__拼音、注释(经典版)
《弟子规》原名《训蒙文》，原作者李毓秀（1662年-1722）是清朝秀才，后经清朝贾存仁修订，并改名为《弟子规》，以体现《论语·学而篇》“弟子入则孝，出则悌，谨而信，泛爱众，而亲仁，行有余力，则以学文”的核心思想。 全书三字一句，两句一韵，共360句，1080字，分为五个部分，详细列述“弟子”在家、在外、待人接物、为人处世、求学五方面应具备的礼仪与规范。 “弟子”：一切圣贤人家的子弟，这里主要是指学生； “规”：本意是指大丈夫的见解（夫见），在这里则是规范。 “弟子规”就是每个效仿圣贤的良家子弟，所必须学习的人生守则和行为准则。 至乐莫如读书，至要莫如教子。中华文化历来注重教育，自古以来，《弟子规》就与《三字经》、《百家姓》、《千字文》一道，被作为儿童启蒙教育的经典教材。 弟 子 规 全 文 总序 弟d ì 子z ǐ规gu ī 圣sh èng 人r én 训x ùn 首sh ǒu 孝xi ào 悌t ì 次c ì谨j ǐn 信x ìn 泛f àn 爱ài 众zh òng 而ér 亲q īn 仁r én 有y ǒu 余y ú 力l ì 则z é学xu é文w én 入r ù 则z é 孝xi ào 父f ù 母m ǔ 呼h ū 应y ìng 勿w ù缓hu ǎn 父f ù 母m ǔ命m ìng 行x íng 勿w ù 懒l ǎn 父f ù 母m ǔ教ji ào 须x ū敬j ìng 听t īng 父f ù 母m ǔ 责z é 须x ū顺sh ùn 承ch éng 冬d ōng 则z é温w ēn 夏xi à则z é凊q ìng 晨ch én 则z é省x ǐng 昏h ūn 则z é定d ìng
java注释规范总结大全
在软件开发的过程中总是强调注释的规范，但是没有一个具体的标准进行说明，通常都是在代码编写规范中简单的描述几句，不能作为一个代码注释检查的标准和依据，做什么都要有一个依据吗:),现在我特整理了一个《Java的注释规范》，内容来自网络、书籍和自己的实际积累。 JA V A注释规范 版本/状态作者版本日期 1.0 ghc 2008-07-02 一、背景 1、当我们第一次接触某段代码，但又被要求在极短的时间内有效地分析这段代码，我们需要什么样的注释信息？ 2、怎么样避免我们的注释冗长而且凌乱不堪呢？ 3、在多人协同开发、维护的今天，我们需要怎么样的注释来保证高质、高交的进行开发和维护工作呢？ 二、意义 程序中的注释是程序设计者与程序阅读者之间通信的重要手段。应用注释规范对于软件本身和软件开发人员而言尤为重要。并且在流行的敏捷开发思想中已经提出了将注释转为代码的概念。好的注释规范可以尽可能的减少一个软件的维护成本, 并且几乎没有任何一个软件，在其整个生命周期中，均由最初的开发人员来维护。好的注释规范可以改善软件的可读性，可以让开发人员尽快而彻底地理解新的代码。好的注释规范可以最大限度的提高团队开发的合作效率。长期的规范性编码还可以让开发人员养成良好的编码习惯，甚至锻炼出更加严谨的思维能力。 三、注释的原则 1、注释形式统一 在整个应用程序中，使用具有一致的标点和结构的样式来构造注释。如果在其他项目组发现他们的注释规范与这份文档不同，按照他们的规范写代码，不要试图在既成的规范系统中引入新的规范。 2、注释的简洁 内容要简单、明了、含义准确，防止注释的多义性，错误的注释不但无益反而有害。 3、注释的一致性 在写代码之前或者边写代码边写注释，因为以后很可能没有时间来这样做。另外，如果有机会复查已编写的代码，在今天看来很明显的东西六周以后或许就不明显了。通常描述性注释先于代码创建，解释性注释在开发过程中创建，提示性注释在代码完成之后创建。修改代码的同时修改相应的注释，以保证代码与注释的同步。 4、注释的位置 保证注释与其描述的代码相邻，即注释的就近原则。对代码的注释应放在其上方相邻或右方的位置，不可放在下方。避免在代码行的末尾添加注释；行尾注释使代码更难阅读。不过在批注变量声明时，行尾注释是合适的；在这种情况下，将所有行尾注释要对齐。 5、注释的数量 注释必不可少，但也不应过多，在实际的代码规范中，要求注释占程序代码的比例达到20%左右。注释是对代码的“提示”，而不是文档，程序中的注释不可喧宾夺主，注释太多了会让人眼花缭乱，注释的花样要少。不要被动的为写注释而写注释。 6、删除无用注释
弟子规注释及译文
《弟子规》注释及译文 《弟子规》是重要的蒙童读物，为清代李毓秀所作，文体仿效《三字经》，它教孩子在家在外怎样应对。(“弟子”是指做学生的少年，“规”，即行为规范。)第一段落是总说，以后是分别叙述 【原文】 弟子规，圣人训，首孝弟①，次谨信。 泛爱众，而亲仁，有余力，则学文。 【注释】 ①弟：通“悌”，尊重兄弟姊妹。 【译文】 《弟子规》是根椐孔子的教诲而编成的做人的行为规范。首先做到孝顺父母，友爱兄弟姐妹。其次，做到在日常生活中，言语行动要小心谨慎，讲信用。和大家相处时，要做到平等博爱，亲近有仁德的人，向他们学习，这些都是很重要的事，如果做好之后，有多余的时间和精力，还应该好好学习其他有益的学问。 入则孝 【原文】 父母呼，应勿缓，父母命，行勿懒。 父母教，须静听，父母责，须顺承。 【译文】 父母呼唤，应及时回答，父母有事交待，不可推辞偷懒。父母教导我们时，要恭敬地聆听，做错了事，父母责备时，应当虚心接受。 【原文】 冬则①温，夏则清，晨则省，昏则定。 出必告，返必面，居有常，业无变。 【注释】 ①则：就要。 【译文】 冬天要为父母把被子弄温暖，夏天要为父母把被子扇凉。天晚了，要让父母休息不再劳累。外出时，须告诉父母要到哪里去，回家后，要向父母禀报。生活习惯要保持有规律，做事有常规，不要任意改变。 【原文】 事虽小，勿擅①为，苟擅为，子②道亏。 物虽小，勿私藏，苟私藏，亲心伤。
①，擅：擅自，随便。②，子：你。 【译文】 虽是小事，也不要擅自作主，如果任性而为，做子女的就没有道理了。东西虽小，也不可以私藏，据为己有，如果私藏了，父母会很伤心的。 【原文】 亲所好，力为具①，亲所恶，谨为去。 身有伤，贻亲忧。德有伤，贻①亲羞。 亲爱我，孝何难，亲恶我，孝方贤。 【注释】 ①具：满足。②贻yí：给我…留下。 【译文】 父母所喜欢的事．努力满足，父母所厌恶的事．决不要去做。不要让身体轻易受到伤害．让父母优虑。不可以做出伤风败德的事．让自己德行受到损害，让父母蒙受耻辱。父母溺爱我们，孝顺是很容易的事。父母不喜欢我们，管教严厉时，这时，孝顺父母才是难能可贵的。 【原文】 亲有过，谏①使更，怡②吾色，柔吾声。 谏不入，悦复谏，号泣随，挞③无怨。 【注释】 ①谏：劝告。更：改过。②怡：愉快。③挞tà：打。 【译文】 父母有过错时，应劝导改过，劝导时态度要和缓愉快，声音要柔和。父母如果不听规劝．要耐心等待，父母情绪好转时，再继续功导。纵然遭受到父母责打，也要哭泣着劝父母改过，以免陷父母于不义。 【原文】 亲有疾．药先尝，昼夜侍，不离床。 丧三年，常悲咽，居处变，酒肉绝。 丧尽礼，祭尽诚，事死者，如事生。 【译文】 父母生病吃药时．要先为父母尝药，昼夜服侍，不可以随便离开。父母去世之后，守孝期间(古礼守孝三年),要常常追思，自己的生活起居必须调整：应该戒绝洒肉。父母的丧事要合乎礼仪，祭拜时应诚心减意，对去世的父母，要如生前一样恭敬 出则弟
java编程规范+数据库命名规范
Java编程规范 本编程规范建立在标准的Java编程规范的基础上，如和标准的Java编程规范有冲突，以本编程规范为准。 1.1 程序结构 包名 引入包/类名 类注释 类 常量//常量注释 构造器注释 构造器 构造器注释 构造器 方法注释 方法 方法注释 方法 1.2 命名规范 命名规范使得程序更易理解，可读性更强。并且能够提供函数和标识符的信息。 文件命名规范： java程序使用如下的文件名后缀： 文件类型后缀 Java 源文件.java Java 字节码文件.class 对系统的文件命名方式有待于根据实际业务决定。 包命名规范： 包名应该唯一，它的前缀可以为任何小写的ASCII字符，包名按照公司内部的命名规范，这些规范指出了某种目录名，主要包括部门，项目，机器，或者登录名。 命名规则为： app.系统名.模块名.xxx.xxx 包命名举例： app.oa.interceptor.xxx app.oa.sys.xxx 类命名规范： 类名应该是名词，并且是大小写混合的。首字母要大写。尽量保证类名简单并且描述性强。避免使用只取单词首字母的简写或者单词的缩写形式，除非缩写形式比单词的完整形式更常用（例如：URL或者HTML）。文件名必须和public的类名保持一致，注意大小写（JBuilder 等一些编译器可以忽略大小写，要特别注意）。如是实现类命名后缀+Impl。 类命名举例： classLoginAction; classUserServiceImpl; 接口命名规范：
接口命名方式与类命名方式相同。 接口命名举例： interfaceIUserService; interfaceSysYhjsDAO; 方法命名规范； 方法名应该为动词，并且是大小写混合的。首字母要小写，方法名的第 二个单词的第一个字母大写。 方法命名举例： String getNoticeNo(); Collection findByCondition(String); 变量命名规范 变量，以及所有的类实例应为首字母小写的大小写混合形式。变量名的第二个单词 的首字母大写。变量名的首字母不能为下划线或者$符。 变量名应该尽可能的短小，但要有意义。变量名应该便于记忆，也就是说变量名应 该尽可能的做到见名知意。除了暂时使用的变量外（一般用于循环变量），应该避免使 用只有一个字母的变量名。对于临时变量一般说来：i，j，k，m，n代表整型变量。c，d，e代表字符型变量。 变量命名举例： String dataType; String name; inti; char c; 常量命名规范： 声明为类常量的变量或者ANSI常量应该全部为大写字母，并且每个单词间用下划 线“_”隔开。为了便于调试，应避免使用ANSI常量。 常量命名举例： static final int MIN_WIDTH = 4; 1.3 注释规范 Java 提供了两种类型的注释：程序注释和文档注释。程序注释是由分隔符/*…*/，和// 隔开的部分，这些注释和C++ 中的注释一样。文档注释（即“doc 注释”）是Java 独有的。由分隔符/**…*/隔开。使用javadoc工具能够将文档注释抽取出来形成HTML 文件。程序注释主要是对程序的某部分具体实现方式的注释。文档注释是对程序的描述性注释，主要是提供给不需要了解程序具体实现的开发者使用。注释应该是代码的概括性描述，提供不易直接从代码中得到的信息，并且只包含对阅读和理解程序有用的信息。例如注释中包含相应的包如何编译或者在哪个目录下，而不应该包括这个包驻留在哪儿的信息。注释中可以描述一些精妙的算法和一些不易理解的设计思想，但应该避免那些在程序代码中很清楚的表达出来的信息。尽可能的避免过时的信息。错误的注释比没有注释更有害。经常性的注释有时也反映出代码质量的低下。 …程序注释： 程序注释有四种格式：块注释格式，单行注释，跟随注释，行尾注释 ?块注释格式 块注释主要用于描述：文件、方法、数据结构和算法。一般在文件或者方法定义的 之前使用。也可以用在方法定义里面，如果块注释放在函数或者方法定义里，它必须与它所描述的代码具有相同的缩进形式。