SourceInsight代码编写辅助工具V1.0的使用.ppt

SourceInsight代码编写辅助工具的使用 老边饺子: tacj1975@126.com 工欲善其事，必先利其器 功能 添加代码修改说明 添加代码注释 添加#if 0－#endif注释 添加函数说明 添加文件说明 以上功能均由工具自动完成，您只需按一个快捷键即可。 添加代码修改说明I 这个功能比较适合于修改BugBase中的问题单 如果当前光标只选中了一行代码，格式如下： a = 1;/*Modifed by CuiJin on 2003年6月29日 Version(NetEye3.2)*/ 添加代码修改说明II 如果当前光标选中了多行代码，格式如下： /*Start of CuiJin on 2003年6月29日 NetEye3.2*/ if( x == y ){ a = 1; }else{ a = 0; } … /*End of CuiJin on 2003年6月29日 NetEye3.2*/ 添加代码修改说明III 通常可能是先修改了M行代码，隔几行后又修改了N行。这时，如果整个修改的部分比较集中（如在20行以内），则使用一次多行修改说明就可以了，用不着每次都加说明，那样的话有喧宾夺主的感觉。 说明中的CuiJin指实际代码的修改人，后面的NetEye3.2指代码所属的版本，可能包括子版本。这两项都可以通过宏自动设置（后面介绍）。 添加代码注释 只选择了一行代码，格式如下： //a = 1; 选中了多行代码 /*if( x == Y ){ a = 1; }else{ a = 0; }*/ 添加#if 0－#endif注释I 在实际工作中，往往遇到这种情况：代码经过多次修改，已经添加过/*…*/组合。这样如果再次添加就不能完全将代码注释掉，如下： /*/*a = 1; b = 100;*/ c = 200;*/ 实际上，黄色部分并没有被注释掉，也就是说第二次添加的注释信息没有起到应有的作用。 添加#if 0－#endif注释II 解决方案 使用#if 0－#endif组合，即刻搞定： #if 0 /*a = 1; b = 100;*/ c = 200; #endif 函数说明的自动添加 完全符合部门的编程规范 /* * Function: * Description: * Calls: * Called By: * Table Accessed: * Table Updated: * Input: * Output: * Return: * Others: */ 文件说明的自动添加 同样符合部门的编程规范 /* * FileName: * Author: CuiJin Version: NetEye3.1 Date:2003.6.29 * Description: * Version: * Function List: * 1. * History: * author time version desc */ 其中的作者、版本、日期信息是自动添加的 菜单项分类说明 SaveSysInfo－保存你的基本信息。注意这是第一个要操作的菜单！ AddModInfo－添加修改代码说明信息 AddCommentInfo－添加代码注释信息 AddIf0Identifier－添加#if 0－#endif注释信息 AddFuncHeader－添加函数说明信息 AddFileHeader－添加文件说明信息 使用方法I 小工具的文件名为NetEyeutils.em，将其放入SourceInsight工程目录下的Base工程下。 使用方法II 启动Base工程，打开NetEyeutils.em文件。打开Options-Menu Assignment...菜单，在Menu下拉框中选中Work子菜单。在它的Command中选出各个Macro，将其一一插入Menu Contents内，按OK完成。 使用方法III 关闭Base工程，打开你的工程，发现Work菜单项已经在上面了。打开Work-SaveSysInfo，输入你的名字和版本信息。 至此，她是你的了 谢谢大家！ * *