软件开发和文档编制管理

QG湖南计算机股份有限公司管理标准软件开发和文档编制管理程序2005-03-25发布2005-03-28实施湖南计算机股份有限公司发布湖南计算机股份有限公司管理标准湖南计算机股份有限公司管理标准软件开发和文档编制程序QG/PLA07.02—2002l范围

本标准规定了软件产品开发研制过程质量职责及控制要求。2引用标准GB8567—88计算机软件产品开发文件编制指南3定义不需用。4职责4.1设计部门负责人批准软件开发项目任务书。4.2技术发展部负责组织对公司下达的软件项目进行各阶段的评审。4.3物流部经理负责组织项目的最终检测。4.4项目负责人负责组织对软件项目的各阶段进行考核、质量控制、组织接口协调文档的发布批准及文档更改审批。4.5项目负责人(软件负责人)负责：a、制定软件课题开发计划和进度安排及资源需求；b、进行总体设计；

c、提供阶段评审资料；

d、协调技术接口。4.6标准档案室管理员负责文档的存贮、保管和处理。5工作程序与要求5.1公司下达的软件项目立项后，由技术发展部下达[新产品研制任务书]。5.2软件项目5.2.1公司立项项目由技术发展部负责组织评审。a、项目负责人（软件负责人）于评审前3天填写[评审申请表]，并备齐评审资料，交技术发展部。b、技术发展部审批评审申请表，并将有关资料提前3-5天下发评审组成员以供分工审阅，c、评审组长主持评审会，并填写[评审报告]；评审结束，技术发展部负责收回评审资料交项目组存档。5.2.2凡上级下达的项目，若上级部门（或系统组织单位）对评审另有要求时，则按其执行；否则，按5.2.1条执行。5.2.4若项目既有软件开发，又有硬件开发，其评审是分开（软件、硬件）还是合并进行，由设计部门负责人决定。5.3软件项目的检测5.3.1项目负责人负责组织完成下述工作。a、测试阶段的检测；b、软件课题的系统检测；c、软件版本存档前的检测。对以上测试发现的问题，由项目组填写[软件测试修改单]，经分析原因和采取纠正措施及回归测试后，由项目负责人审批，方可列入正式版本。5.3.2物流部经理负责组织软件版本存档前的最终检测，并在[版本送检（启用）通知单]上签署检测结果。5.4设计部门负责人批准软件项目开发计划。5.5设计部门负责人审批各项目负责人资格，并负责：a、考核各阶段的进度完成情况；b、及时协调开发中组织接口及计划修改；

c、控制项目开发各阶段的设计输入、设计输出、技术状态和各阶段的验证,并对软件的正确性、文档的完整性负责。5.6项目负责人(软件负责人)负责组织：a、制定项目开发计划，若软件、硬件相结合的，其计划也可合并制定。开发计划须明确划分各开发阶段，并可按开发阶段进行自主开发；b、总体设计；d、组织软件(版本)检测，并对检测结果负责；e、协调技术接口；f、定期填报工作进度，若进度计划需修改，应在报表中申述（进度报表既可按月也可按项目分阶段填报）。5.7软件的交付管理按[版本启用/存档细则]执行。5.8软件版本管理5.8.1应顾客需要进行软件版本升级或修订时，设计部门负责人确定项目负责人，组织软件人员实施。5.8.2软件负责人发出[版本送检（启用）通知单]升级的版本由物流部组织检测合格后，由软件负责人将新版本存入标准档案室；并在[版本档案]中详细记录升级内容，存入项目档案中。5.8.3技术人员在为顾客服务的现场，遇到需要版本修订时，应先电告项目负责人，经认可后，回厂填写[用户服务档案]，必要时项目负责人应组织评审和检测。5.9文档要求5.9.1各阶段需具备的基本文档及文档格式（见附录）

5.9.2鉴定需具备的文档参见附录。

6支持文件

7记录

7.1质量记录

7.1.1JL/PLA10.05-2002版本启用通知单7.1.2JL/PLA14.00-2002用户服务档案7.1.3JL/PLA07.06-2002软件测试修改单以上记录由标准档案室保存三年。7.2工作记录7.2.3版本档案以上记录由标准档案室保存三年。7.3附录附录一：软件产品文件表附录二：版本启用/存档实施细则附录三：概要设计说明书附录四：需求说明书附录五：软件开发规范附录六：程序设计若干规定附录一：软件产品文件表序号文件名称文件简号产品产品的组成部门成套软件整件整件软件1任务委托书RW●○2可行性研究报告KY●○3软件需求说明RX●○○○4数据要求说明书SY○○○5项目开发计划XK○6概要设计说明书GS○○○7详细设计说明书QS○○○8数据库设计说明书SG○○○9测试计划CJ○○○10程序CX●●●11测试分析报告CF○○12用户手册YS●○○13操作手册CS●○○14程序维护手册CW○○○15项目开发总结报告XZ●●16使用报告SB●●17产品标准—●●18媒体内程序/数据目录MM●●●19成套软件明细表MX●20整件明细表MX●●21成套运用文件清单YQ●○22整件汇总表ZH○○23鉴定报告JB●●24用户反馈信息YX○○25维护记录文件WJ○○26版本更新通知BT○○注：●表示必须编制的文件；○表示可根据产品的需要制定。湖南计算机股份有限公司用户服务档案JL/PLA14.00-2002出差人出差时间出差地点用户名称产品名称版本号实际费用（元）使用的系统环境：发现的问题：解决情况：改动的程序模块：用户意见：办事处意见：处理结果（回厂后经协调或评审结论）：湖南计算机股份有限公司版本档案（工作记录）编号：产品名称版本号版本适用范围源版本取代版本号版本源程序压缩文件名代码和提交人提交时间存档日期配备的输入方法：修改记录：备注：软件测试修改单JL/PLA07.06-2002软件名称测试人日期测试问题：测试人：日期：原因分析：签字：日期：纠正措施：签字：日期：回归测试：签字：日期：审批意见：批准人：日期：附录二：版本启用/存档实施细则为了规范版本的管理，减少版本的数量，文档资料的管理和保存，文档的及时更新，以及便于电子化的管理和规范工作流程，特制定该实施细则。一、工作流程和任务:说明：内部测试：进行白盒测试，要求对源程序进行检查，分析出可能影响的模块，并对相应的模块进行测试。外部测试：进行黑盒测试，对整个系统进行测试。审核：检查文件的完整性和正确性。资料审查：检查文件的完整性和格式的正确性。批准：审查该版本是否可以发行。委派他人对提交的文档进行抽查，验证其正确性和完备性。编号、录入数据、刻盘：光盘的卷标为8位数字的序列号，在根目录下建立以版本编号为名称的子目录，所有提交的文档资料存放在该子目录中。版本启用通知单JL/PLA10.05-2002名称编号状态配套版本简要描述日期光盘编号提交人版本号被取代的版本编号验证码适用范围编制人测试人资料审查复制要求修改的原因不能合并的原因测试结果审核意见批准意见

说明：栏目描述填写人备注名称要求填写产品的全称提交人编号由项目编号+分模块编号+序列号构成项目编号由4位数字构成，分模块编号由2位数字构成，序列号由4位构成该版本批准后，编写编号档案管理员日期提交的日期提交人版本号提交人资料审查负责检查提交文件的完整性，并将版本启用单录入计算机档案管理员验证码要求复制时能验证版本正确性的关键数据（代码和、文件长度等）提交人简要描述对该版本的简单描述提交人光盘编号由8位数字序列号构成档案管理员提交人负责提交所有的文件主要设计者适应范围描述适用的用户和机器的批次提交人状态作废/使用档案管理员编制人编写该程序的人员签名审核意见对提交的文件负责对被取代版本已发行产品的处理意见和该版本的使用时效项目负责人批准意见技术部经理修改原因写明改正了的错误或新增的功能提交人不能合并的原因在原来的版本基础上产生了一个新版本时，但应又不能取代原来版本时，必须说明原因。提交人复制要求说明发行版本的格式，版本载体的类型（介质），复制的设备，复制的特殊要求提交人配套版本当一个产品需要几个软件构成，必须主要与该版本配套的版本的编号，或关系用“/”隔开，与关系用“，”隔开提交人测试人不能少于两人测试该版本的所有人员的名单，要求签名

附录三：概要设计说明书概述介绍该项目的名称、任务提出者、提出的背景，应用的目标。功能和性能对照软件需求说明书，来说明系统是如何满足功能和性能需求的。开发工具和平台描述采用何种操作系统平台、何种编程语言、开发工具进行开发。总体结构设计用图表和文字方式说明该系统由几个模块构成，各模块的功能、各模块之间的关系。用数据流图描述出数据在该系统中的流动过程，在各模块输入前和输出后数据的变换。用程序流程图描述出主要功能的实现方式。接口设计外部接口说明该系统同外部所有的接口安排，包括硬件接口、软件接口、用户接口。内部接口说明该系统内部各个模块之间的接口安排。系统数据结构设计逻辑数据结构设计给出该系统内所使用的每个数据项、记录、文件的标识、定义、长度以及他们之间的相互关系。物理数据结构设计给出系统中的数据的存储要求和访问方式、和存储介质。系统出错处理设计出错信息用表格形式列出每种可能的出错或故障情况出现时，系统输出信息的形式、含义及处理方法。补救措施说明故障出现后可能采取的变通措施，如后备技术、降效技术、恢复及再启动技术等。系统维护设计说明为了系统维护方便而在程序内部设计中作出的安排，如在程序中专门安排用于系统的检查与维护的检测点和专用模块。关键的技术和难点描述开发该系统采用的关键技术和难点，对关键技术和难点作出风险评估，要求作出相应的解决对策，或提出其他的解决方案。交付方式交付的内容全部的设计文件、发行版本、源程序交付的媒体介质纸质文件、电子文件、CD、FLASH、软盘附录四：需求说明书简介介绍该项目的名称、任务提出者、提出的背景，应用的目标详细需求环境需求硬件环境描述运行该软件需要的设备能力处理器的速度、数量和内存容量存储媒体的容量输入、输出设备的种类和数量通讯网络软件环境运行该软件需要的操作系统、数据库软件、以及相应的其他应用软件人员环境操作该软件对人员的要求，人员的素质、数量功能需求对系统中每一个功能，要求用图示或文字详细描述：概述——叙述功能名称、目标和作用输入——详述该功能输入的信息处理——描述该功能作什么，如何对输入信息进行加工并转换成输出信息输出——详述该功能输出的信息内部生成数据——列出用户所关心的内部生成数据性能需求定量的描述该软件系统应满足的具体性能需求精度说明该软件系统的精度要求，如：数据的精度要求数字计算的精度要求数据转送的误码率要求时间特性说明该软件系统的时间要求，如：解题时间询问和更新数据文件的响应时间系统各项功能的顺序关系由于输入类型的不同和操作方式的变化而引起的优先顺序在峰值负载期，与所规定的响应时间的允许偏离范围灵活性说明当需求发生某些变化时该软件系统的适应能力，指出为适应这些变化而需要设计的软件成分和过程输入和输出描述输入和输出的每个数据元素，对每个数据元素可列出如下信息：数据元素名同义名定义格式值域度量单位数据项名、缩写词和代码对于输入数据，还要说明时间要求、优先顺序和输入媒体。对于输出数据，亦要说明时间要求、优先顺序和输出形式，并要描述对特殊输入输出项的保密要求和措施。数据库特性详细描述数据库中要用到的每个数据元素，对每个数据元素可列出如下信息：数据元素名同义名定义格式值域度量单位数据项名、缩写词和代码要根据记录的规模和数量来估计数据存储要求，并要预测数据的增长率。故障处理列出在该系统出现故障时，为满足信息处理要求而可能采取的技术措施，如：后备技术低效技术再启动技术接口说明该软件系统与其他系统和子系统的接口软件接口和硬件接口安全和保密说明该软件系统在安全和保密方面的要求交付方式交付的内容全部的设计文件、发行版本、源程序交付的媒体介质纸质文件、电子文件、CD、FLASH、软盘附录五：软件开发规范软件开发的流程和需要的文档资料同项目开发类似，在第章中有详细的描述，在这不再作介绍了，仅介绍与软件紧密相关的常用文档资料的格式模板，以及编程设计中的若干规定常用文档的格式模板流程图概述国家标准GB1526-89《信息处理—数据流程图、程序流程图、系统流程图、程序网络图和系统资源图的文件编制符号及约定》规定了信息处理文件使用的各种符号及其使用的具体约定。要求采用VISIO或SMARTDRAW软件绘制流程图。流程图所用符号及其简要说明符号符号名简要说明备注数据表示数据，其中可注明数据名、来源、用途或其他的文字说明。此符号并不限定数据的媒体处理表示各种处理功能。符号内可注明处理名或其简要功能既定处理表示已命名的既定处理。该处理为在另外地方已得到详细说明的一个操作或一组操作。例如子程序、函数、模块。符号内可注明处理名或其简要功能准备表示修改一条指令或一组指令以影响随后的活动。例如：设置开关、修改变址寄存器、初始化例行程序判断表示判断或开关。符号内可注明判断的条件，它只有一个入口，但可以有若干可以选择的出口。在对符号内的条件求值后，有一个且只有一个出口被激活。求值结果可在表示出口路径的流线附近写出并行处理表示同步进行两个或两个以上并行方式的操作。循环界限循环界限由上界限和下界限构成，分别表示循环的开始和结束。流线表示控制流的流向虚线用于表明被注解的范围或连接被注解部分与注解正文连接符用于表明转向流程图的它处，或从它处转入。它是流线的断点。在圆内注明某一标志符，表明该流线将在具有相同标志符的另一连接符处继续下去。端点符程序流程的起点或结束注解符表示注解的内容，虚线须连接到被注解的符号或符号组合上。省略符若流程图中有些部分无需给出符号的具体形式和数量，可用省略符。省略符应夹在流线符号之中。使用约定图的布局流程图所用的符号应该均匀分布，连线保持合理的长度，并尽量少使用长线。符号标志符这是赋予某个符号的标志符，其作用是便于其他文件中引用该符号。符号标志符要写在符号的左上角。符号描述符它用于交叉引用，表达一个符号的特殊用途，或者进一步理解某个符号的功能。描述符要写在符号的右上角。连接的约定标准流向从左至右，自上而下箭头的使用可随时在流线上使用箭头指示方向，当流程不是标准流向时，一定要采用箭头来指示方向。流线的交叉应当尽量避免流线的交叉，即使出现，交叉的流线之间没有任何逻辑关系，不对流向产生影响。流线的汇集两根或更多的进入线可以汇集为一根输出线，各连接点应相互错开以提高清晰度，并在必要时使用箭头表示流向。互连一般情况下，流线应从符号的左边或顶端进入，从右边或底端离开。它们都应对准符号的中心。多出口一个符号如有多个出口，应按下述方式表示，在每个出口都应标有适当的条件值，以反映它所表示的逻辑路径。数据结构结构名称描述名称定义描述使用特点数据字典数据字典和数据结构图可形成交互参照关系名称定义描述使用特点项目计划表要求采用PROJECT软件制作，大致格式如下：项目名称标识号任务工期开始时间完成时间提交件负责人拟制：校对：审核：批准：第页函数/过程接口函数名：必须与源程序中的一致，包括大小写功能：简要说明该函数/过程实现的功能，以及主要的算法，对重要的函数/过程可采用伪语言进行描述入口参数：对入口参数作简要的说明，利用全局变量，则也要说明出口参数：对出口参数作简要的说明，改变了全局变量，则也要说明返回值：对函数的返回值说明其类型和作用程序设计的若干规定这里例举了C语言和汇编语言的规定，其他编程语言应参照这些规定编写C语言见附录六汇编语言见附录六附录六：程序设计若干规定引言本文档描述了项目开发中的编程标准，其目的是提供一个编程的严格规则，使得程序有统一的风格，以便于理解和维护，项目主要由C语言和汇编语言编写.C语言产生新代码图D-1描述了产生C语言新代码的格式，在写新代码之前，程序员必需首先将std.c拷贝到新文件中，然后编辑新文件以提供下列信息.目的提供一个关于程序的简要描述.版本状态给出当日的日期，程序员姓名，创建或修改.输入列出及描述所有该程序将输入的变量，描述应简要而完全，有必要要描述一个组中不同的元素，或者一个词的字节或位，如果没有输入变量,则键入"none".输出列出及描述所有该函数的输出变量，同时描述副作用，如果有的话.限制简要说明程序的限制，例如数组长度，算法等等，同时给出对未来版本的建议，如果没有限制，给出“none”错误信息描述出错信息或在出错时变量的置值，如果没有的话给出“none”.方法简单描述程序中所有调用的算法及方法，如果方法很明显，则删去这一项，如果应用了复杂的算法或方程式，请给出解释及参考.外部变量描述仅列出及描述那些一般不为人所知的变量，如果该函数不用任何外部变量，给出“none”.局部、静态、寄存器变量描述列出及描述局部，静态寄存器变量，如果一个变量的用途可从其它变量名中明显地看到，则不必给出解释，变量名按字典顺序列出./************************************************************本程序属于XXXXXXXXX(公司名).作为商品机密 **版权所有,未经许可不得公布或使用. *************************************************************.目的------函数的功能描述.版本状态----11-7-90(程序员姓名)新代码.输入-----列出所有输入变量和解释.输出-----列出所有输出变量／参数／返回值及解释.限制-----给出使用的算法和处理方法.错误信息----描述错误信息.方法----该函数中用的算法和处理方法.函数调用----列出调用的函数.外部变量-----描述所有使用的外部变量.局部变量----描述局部变量.*/图D-1C标准格式(in“std.c”)改旧代码在函数头上的所有必要的信息必须修改,版本状态必须包含版本日期,程序员姓名,以及版本的简要描述,这种描述必须规格化,而且要包含足够的信息,以便于对这些修改进行回溯.版本状态列出的顺序必须使得最新的版本列在最上边.所有其它的信息包括输入、输出、限制、以及函数调用等等,必须与最新的版本保持一致.编程常规下面说明了C语言指令中的标准结构:程序设计风格symbol183\f"Symbol"\s10\h 通过空格和空行,使程序有层次感,便于阅读.symbol183\f"Symbol"\s10\h 提倡使用C++的语法和程序结构.symbol183\f"Symbol"\s10\h 所有代码必须是小写字符,以下的例外: 1。常量或宏(用#define或#typedef在include文件中定义的)必须用大写字母. 2。在编译或连接器中要求大写的标识符或库函数名. 3。该文本中说明的其它必须大写的字母.symbol183\f"Symbol"\s10\h 代码尽可能写得简单、清晰、将复杂语句切成几个简单的语句以增加可读性.symbol183\f"Symbol"\s10\h 一般将子程序限制在100行以内.symbol183\f"Symbol"\s10\h 对于一个程序只允许一个入口和出口（在有出错处理等情况下可能允许有若干个出口）.symbol183\f"Symbol"\s10\h 设计的子程序必须有一个完整定义的输出、输入并且完成一个任务.symbol183\f"Symbol"\s10\h 将密切相关的子程序存放在一个文件中.symbol183\f"Symbol"\s10\h 程序中尽量不使用直接数,即尽量不在源程序中出现某个具体的数值,相应的数值最好用#define语句定义成宏,以便于修改和维护.symbol183\f"Symbol"\s10\h 使用统一的工作环境,建立子目录,各目录存放指定的内容: src(源程序存放目录) doc(文档存放目录) bin(可执行程序存放目录) lib(库函数存放目录) test(测试用目录) inc(引用文件存放目录) personal(各人自用目录)symbol183\f"Symbol"\s10\h 使用make,Makefile进行编译,更新目标文件和可执行文件.C库函数symbol183\f"Symbol"\s10\h 仅使用UnixSystemV、MicrosoftC、LatticC及TurboC编译器中的库函数.symbol183\f"Symbol"\s10\h 在用"malloc"或"calloc"申请空间之后,建议测试一下不为空指针，若使用空指针，通常会导致系统的崩溃，或莫名其妙的错误。symbol183\f"Symbol"\s10\h 在用"malloc"或"calloc"申请空间之后,必须牢记在不需要它们的时候调用free释放空间以便于将来使用空间.类型说明symbol183\f"Symbol"\s10\h 类型说明的顺序是由短到长: char short long float doublesymbol183\f"Symbol"\s10\h 尽量不使用int,用short或long取代,以免不同硬件环境的影响.symbol183\f"Symbol"\s10\h 仅仅使用var_style.h中用typedef定义的宏以便共享.变量名变量名的长度没有限制.但各个变量的前31个字符必须唯一.(各系统的状态会有变化,尽可能在开始时区分变量名).建议用英文语句的一般风格命名变量名,英文单词的首字母大写，后面的字母小写。对于外部(公共)变量或函数名,在第一个字符之前加"_",对局部的变量名,建议遵照下列格式:bxxx_或xxxx_b 字节变量cxxx_或xxxx_c 字符变量ixxx_或xxxx_i 数变量sxxx_或xxxx_s 字变量lxxx_或xxxx_l 长变量fxxx_或xxxx_f 浮点变量dxxx_或xxxx_d 精变量fpxxx或xxxx_fp 文件指针xpxxx或xxxx_xp 指针变量(例:ipxxxx或xxxx_ip)注意：变量名不应该和当前系统采用的编译器，以及与已知的其他编译器中已定义的函数名或C的库函数相同，也不应与同C的关键字相同。比如：class不是C编译器的关键字，但是C++的关键字，在用C编译器开发的系统中，不能采用class作为变量名，否则将影响移植性。寄存器变量在程序中找一个频繁使用的变量(int或指针类型),将其定义成寄存器类以加快运行速度，特别适用于循环变量中。外部变量symbol183\f"Symbol"\s10\h 外部变量必须在函数中以extern语句说明.symbol183\f"Symbol"\s10\h 如果外部变量是数组,在外部说明中,第一维必须为空.symbol183\f"Symbol"\s10\h 如果不同类型的变量要组在一起,用结构取代数组.symbol183\f"Symbol"\s10\h 将外部变量说明成static类,如果它们在一个文件中共享而不被其它文件访问.常量symbol183\f"Symbol"\s10\h 对公共使用的常量,引用com_cons.h中定义的宏.for循环对于数组的处理,循环的结束用"<"取代"<=".例:inta[9];for(i=0;i<9;i++)...;...;if_else有elseif的语句,应将if提上一行,例如:if() { ………. } elseif { ………. } 标号所有标号应在第一列开始goto除非绝对必要,避免使用gotodefault在switch语句中将default放在case的最后breaksymbol183\f"Symbol"\s10\h 在switch语句之外尽量少用break.symbol183\f"Symbol"\s10\h 在某些循环中为减少代码层次可有限地使用break和continue.返回returnsymbol183\f"Symbol"\s10\h 即使不返回任何值,也应在函数的出口处写上return以示函数出口symbol183\f"Symbol"\s10\h 尽量在一个函数中使用一个return,个别情况例外(如有多个错误处理时).大括号用大括号将一些语句组在一起小括号用"（）"避免操作顺序的混乱.特别要注意以下两点的应用（通过例子来说明）,也是程序设计中经常不注意而犯的错误：1、#definex y+3 (1) #definex (y+3) (2) 按(1)的定义z=x/3---〉z=y+3/3=y+1 按(2)的定义z=x/3--->z=(y+3)/3=y/3=1 2、char*buf; long*plong; plong=(long*)buf+2; (1) plong=(long*)(buf+2); (2) 如果buf=0;则在(1)中plong=8,(2)中plong=2;注释symbol183\f"Symbol"\s10\h 在需要明确程序含义的地方应勤于使用注释,所有注释写成:/*......*/或//symbol183\f"Symbol"\s10\h 在语句后的注释必须与语句在同一行: statement/*..._..*/ statement/*..._..*/symbol183\f"Symbol"\s10\h 如果注释太长,超出一行,应将其按如下格式放在语句之前:/*... ... ... ...*/symbol183\f"Symbol"\s10\h 如果变量需要注释,它们必须一行行地进行说明,例如:inti;/*......*/汇编语言产生新模块代码图D-2描述了产生汇编语言新模块代码的格式,在写新代码之前,程序员必需首先将model.asm拷贝到新文件中.然后编辑新文件以提供下列信息.目的提供一个关于程序模块的简要描述.版本状态给出当日的日期,程序员姓名，版本号。COMMENT%************************************************************本程序属于XXXXXXXXX(公司名).作为商品机密 **版权所有,未经许可不得公布或使用. ************************************************************.目的------模块的功能描述.版本状态----11-7-90(程序员姓名)新代码图D-2ASM标准格式(in“model.asm”)产生新的子过程代码图D-3描述了产生汇编语言新的子过程代码的格式,在写新子过程代码之前,程序员必需首先将Pro.asm拷贝到新子过程前.然后编辑新文件以提供下列信息.子过程名称给出子过程的名称功能描述用语言或伪C代码提供一个关于该子过程的简要描述,并且简要说明子过程的限制。版本状态和历史给出当日的日期,程序员姓名.入口参数列出及描述所有该子过程将输入的变量和寄存器，描述应简要而完全,有必要描述一个组中不同的元素,或者一个词的字节或位.如果没有输入变量,则键入“none”.出口参数列出及描述所有该子过程的输出变量和寄存器,同时描述对全局变量的影响和被破坏的寄存器,如果有的话.同时还要描述出错信息或在出错时变量的值,如果没有的话给出“none”.默认的段寄存器和段名用ASSUME指出在该子过程中，默认的段寄存器和段名的关系。COMMENT.子过程名称----给出子过程的名称.功能描述----提供一个关于子过程的简要描述，并且简要说明子过程的限制..版本状态和历史----给出当日的日期,程序员姓名..入口参数----列出及描述所有该子过程将输入的变量和寄存器..出口参数----列出及描述所有该子过程的输出变量和寄存器,并列出被破坏的寄存器..默认的段寄存器和段名----用ASSUME指出在该子过程中，默认的段寄存器和段名的关系。%图D-3标准格式(in“pro.asm”)修改旧代码在过程头上的所有必要的信息必须修改,版本状态必须包含版本日期,程序员姓名,以及版本的简要描述,这种描述必须规格化,而且要包含足够的信息,以便于对这些修改进行回溯.版本状态列出的顺序必须使得最新的版本列在最上边.所有其它的信息包括输入、输出、限制、以及过程调用等等,必须与最新的版本保持一致.编程常规下面说明了汇编语言指令中的标准结构:程序设计风格symbol183\f"Symbol"\s10\h 应该遵照MIRCOSOFTMASM5.0~6.0和TURBOASMBLE2.0~3.0的语言规范。建议不用简写方式.symbol183\f"Symbol"\s10\h 在同一子过程中所有代码必须是统一的小写字符和大写字母,以下的例外:(1)宏必须用大写字母.(2)在编译或连接器中要求大写的标识符或库函数名.(3)该文本中说明的其它必须大写的字母.symbol183\f"Symbol"\s10\h 对于一个程序只允许一个入口和出口（在有出错处理等情况下可能允许有若干个出口）.symbol183\f"Symbol"\s10\h 设计的子程序必须有一个完整定义的输出、输入并且完成一个任务.symbol183\f"Symbol"\s10\h 将密切相关的子程序存放在一个文件中.symbol183\f"Symbol"\s10\h 程序中尽量不使用直接数,即尽量不在源程序中出现某个具体的数值,相应的数值最好用EQU语句定义成宏,以便于修改和维护.symbol183\f"Symbol"\s10\h 使用统一的工作环境,建立子目录,各目录存放指定的内容:src(源程序存放目录)doc(文档存放目录)bin(可执行程序存放目录)lib(库函数存放目录)test(测试用目录)inc(引用文件存放目录)personal(各人自用目录)symbol183\f