文档介绍:Comments criterion of the Code 在多个 PROJIECT 共同开发的前提下,为了减少修改升级 CODE 过程中出现失误和方便 SI 人员对代码的维护,加强部门整体代码注释规范,建议通过在每一次代码修改过程中添加代码标志符进行注释,这样可以使软件工程师在升级代码的过程中减少错误率,同时可以保持对以前版本代码的修改思路清晰,能在最短时间里复查代码中的错误。标准 C++/C 的文件结构: //Copyright (c) Microsoft Corporation. All rights reserved. //Use ofthis source code issubject tothe terms ofthe Microsoft end-user //license agreement (EULA) under which you licensed this SOFTWARE PRODUCT. //Ifyou did not accept the terms ofthe EULA, you are not authorized touse //this source code. For acopy ofthe EULA, please see the onyour //install media. /** *Port Copyright (c) Hisys Corporation. All rights reserved. ****@file *Abstract *This file contains battery driver PDD implementation. *Change Log * Shi Yuehua Initial Version ***/ 代码注释规范如下: //***********COMMENTS-HISTORY***********// /****************************************************************************** *NAME |SIGN |PROJECT |SUMMARY * *------------------------------------------------------------------------------ * M060806_A HXS006 Use the two methods tomeasure the battery voltage. * M060812_A HXS010 Change the init array value from 4to8. * MON Change the USB CHANGING conditions. *........... *........... ******************************************************************************/ 代码注释标题声明包含四部分: 1.《NAME 》:修改该部分 CODE 的软件人员名称