软件开发和文件汇编管理程序

1、50/50QG湖南计算机股份有限公司治理标准软件开发和文档编制治理程序2005-03-25公布 2005-03-28实施湖南计算机股份有限公司公布湖南计算机股份有限公司治理标准湖南计算机股份有限公司治理标准软件开发和文档编制程序QG/PLA 07.022002l 范围 本标准规定了软件产品开发研制过程质量职责及操纵要求。2 引用标准 GB856788 计算机软件产品开发文件编制指南 3 定义 不需用。4 职责4.1 设计部门负责人批准软件开发项目任务书。4.2 技术进展部负责组织对公司下达的软件项目进行各时期的评审。4.3 物流部经理负责组织项目的最终检测。4.4 项目负责人负责组织对软件项目

2、的各时期进行考核、质量操纵、组织接口协调文档的公布批准及文档更改审批。4.5 项目负责人(软件负责人)负责： a、制定软件课题开发打算和进度安排及资源需求；b、进行总体设计；c、提供时期评审资料；d、协调技术接口。4.6 标准档案室治理员负责文档的存贮、保管和处理。5 工作程序与要求5.1 公司下达的软件项目立项后，由技术进展部下达新产品研制任务书。5.2 软件项目5.2.1 公司立项项目由技术进展部负责组织评审。 a、项目负责人（软件负责人）于评审前3天填写评审申请表，并备齐评审资料，交技术进展部。 b、技术进展部审批判审申请表，并将有关资料提早3-5天下发评审组成员以供分工批阅， c、评审

3、组长主持评审会，并填写评审报告；评审结束，技术进展部负责收回评审资料交项目组存档。5.2.2 凡上级下达的项目，若上级部门（或系统组织单位）对评审另有要求时，则按其执行；否则，按5.2.1条执行。5.2.4 若项目既有软件开发，又有硬件开发，其评审是分开（软件、硬件）依旧合并进行，由设计部门负责人决定。5.3 软件项目的检测5. 3. 1 项目负责人负责组织完成下述工作。 a、测试时期的检测； b、软件课题的系统检测； c、软件版本存档前的检测。 对以上测试发觉的问题，由项目组填写软件测试修改单，经分析缘故和采取纠正措施及回归测试后，由项目负责人审批，方可列入正式版本。5. 3. 2 物流部经

4、理负责组织软件版本存档前的最终检测，并在版本送检（启用）通知单上签署检测结果。5. 4 设计部门负责人批准软件项目开发打算。5.5 设计部门负责人审批各项目负责人资格，并负责： a、考核各时期的进度完成情况；b、及时协调开发中组织接口及打算修改； c、操纵项目开发各时期的设计输入、设计输出、技术状态和各时期的验 证,并对软件的正确性、文档的完整性负责。5.6 项目负责人(软件负责人)负责组织： a、制定项目开发打算，若软件、硬件相结合的，其打算也可合并制定。开发打算须明确划分各开发时期，并可按开发时期进行自主开发； b、总体设计； d、组织软件(版本)检测，并对检测结果负责； e、协调技术接口

5、； f、定期填报工作进度，若进度打算需修改，应在报表中申述（进度报表既可按月也可按项目分时期填报）。5.7 软件的交付治理按版本启用/存档细则执行。5.8 软件版本治理5.8.1 应顾客需要进行软件版本升级或修订时，设计部门负责人确定项目负责人，组织软件人员实施。5.8.2 软件负责人发出版本送检（启用）通知单升级的版本由物流部组织检测合格后，由软件负责人将新版本存入标准档案室；并在版本档案中详细记录升级内容，存入项目档案中。5.8.3 技术人员在为顾客服务的现场，遇到需要版本修订时，应先电告项目负责人，经认可后，回厂填写用户服务档案，必要时项目负责人应组织评审和检测。5.9 文档要求5.9.

6、1 各时期需具备的差不多文档及文档格式（见附录）5.9.2 鉴定需具备的文档参见附录。6 支持文件 7 记录 7.1 质量记录 7.1.1 JL/PLA10.05-2002 版本启用通知单 7.1.2 JL/PLA14.00-2002 用户服务档案 7.1.3 JL/PLA07.06-2002 软件测试修改单 以上记录由标准档案室保存三年。 7.2 工作记录 7.2.3 版本档案 以上记录由标准档案室保存三年。 7.3 附录 附录一：软件产品文件表附录二：版本启用/存档实施细则附录三：概要设计讲明书附录四：需求讲明书附录五：软件开发规范附录六：程序设计若干规定附录一：软件产品文件表序号文 件

7、名 称文件简号产 品产品的组成部门成套软件整 件整 件软 件1任务托付书RW2可行性研究报告KY3软件需求讲明RX4数据要求讲明书SY5项目开发打算XK6概要设计讲明书GS7详细设计讲明书QS8数据库设计讲明书SG9测试打算CJ10程序CX11测试分析报告CF12用户手册YS13操作手册CS14程序维护手册CW15项目开发总结报告XZ16使用报告SB17产品标准18媒体内程序/数据目录MM19成套软件明细表MX20整件明细表MX21成套运用文件清单YQ22整件汇总表ZH23鉴定报告JB24用户反馈信息YX25维护记录文件WJ26版本更新通知BT注：表示必须编制的文件；表示可依照产品的需要制定。

8、湖南计算机股份有限公司用户服务档案JL/PLA14.00-2002出 差 人出差时刻出差地点用户名称产品名称版 本 号实际费用（元）使用的系统环境：发觉的问题：解决情况：改动的程序模块：用户意见：办事处意见：处理结果（回厂后经协调或评审结论）：湖南计算机股份有限公司版 本 档 案（工作记录） 编号：产品名称版本号版本适用范围源 版 本取代版本号版本源程序压缩文件名代 码 和提 交 人提交时刻存档日期配备的输入方法：修改记录：备注：软 件 测 试 修 改 单 JL/PLA07.06-2002软件名称测试人日 期测试问题： 测试人： 日 期：缘故分析： 签 字： 日 期：纠正措施： 签 字： 日

9、期：回归测试： 签 字： 日 期：审批意见： 批准人： 日 期：附录二：版本启用/存档实施细则为了规范版本的治理，减少版本的数量，文档资料的治理和保存，文档的及时更新，以及便于电子化的治理和规范工作流程，特制定该实施细则。一、工作流程和任务:讲明：内部测试：进行白盒测试，要求对源程序进行检查，分析出可能阻碍的模块，并对相应的模块进行测试。外部测试：进行黑盒测试，对整个系统进行测试。审核：检查文件的完整性和正确性。资料审查：检查文件的完整性和格式的正确性。批准：审查该版本是否能够发行。委派他人对提交的文档进行抽查，验证其正确性和完备性。编号、录入数据、刻盘：光盘的卷标为8位数字的序列号，在根目录

10、下建立以版本编号为名称的子目录，所有提交的文档资料存放在该子目录中。版 本 启 用 通 知 单 JL/PLA10.05-2002名称编号状态配套版本简要描述日期光盘编号提交人版本号被取代的版本编号验证码适用范围编制人测试人资料审查复制要求修改的原因不能合并的缘故测试结果审核意见批准意见讲明：栏目描述填写人备注名称要求填写产品的全称提交人编号由项目编号+分模块编号+序列号构成项目编号由4位数字构成，分模块编号由2位数字构成，序列号由4位构成该版本批准后，编写编号档案治理员日期提交的日期提交人版本号提交人资料审查负责检查提交文件的完整性，并将版本启用单录入计算机档案治理员验证码要求复制时能验证版本

11、正确性的关键数据（代码和、文件长度等）提交人简要描述对该版本的简单描述提交人光盘编号由8位数字序列号构成档案治理员提交人负责提交所有的文件要紧设计者适应范围描述适用的用户和机器的批次提交人状态作废/使用档案治理员编制人编写该程序的人员签名审核意见对提交的文件负责对被取代版本已发行产品的处理意见和该版本的使用时效项目负责人批准意见技术部经理修改缘故写明改正了的错误或新增的功能提交人不能合并的缘故在原来的版本基础上产生了一个新版本时，但应又不能取代原来版本时，必须讲明缘故。提交人复制要求讲明发行版本的格式，版本载体的类型（介质），复制的设备，复制的专门要求提交人配套版本当一个产品需要几个软件构成，

12、必须要紧与该版本配套的版本的编号，或关系用“/”隔开，与关系用“，”隔开提交人测试人不能少于两人测试该版本的所有人员的名单，要求签名附录三：概 要 设 计 讲 明 书概述介绍该项目的名称、任务提出者、提出的背景，应用的目标。功能和性能对比软件需求讲明书，来讲明系统是如何满足功能和性能需求的。开发工具和平台描述采纳何种操作系统平台、何种编程语言、开发工具进行开发。总体结构设计用图表和文字方式讲明该系统由几个模块构成，各模块的功能、各模块之间的关系。用数据流图描述出数据在该系统中的流淌过程，在各模块输入前和输出后数据的变换。用程序流程图描述出要紧功能的实现方式。接口设计外部接口讲明该系统同外部所有

13、的接口安排，包括硬件接口、软件接口、用户接口。内部接口讲明该系统内部各个模块之间的接口安排。系统数据结构设计逻辑数据结构设计给出该系统内所使用的每个数据项、记录、文件的标识、定义、长度以及他们之间的相互关系。物理数据结构设计给出系统中的数据的存储要求和访问方式、和存储介质。系统出错处理设计出错信息用表格形式列出每种可能的出错或故障情况出现时，系统输出信息的形式、含义及处理方法。补救措施讲明故障出现后可能采取的变通措施，如后备技术、降效技术、恢复及再启动技术等。系统维护设计讲明为了系统维护方便而在程序内部设计中作出的安排，如在程序中专门安排用于系统的检查与维护的检测点和专用模块。关键的技术和难点

14、描述开发该系统采纳的关键技术和难点，对关键技术和难点作出风险评估，要求作出相应的解决对策，或提出其他的解决方案。交付方式交付的内容全部的设计文件、发行版本、源程序交付的媒体介质纸质文件、电子文件、CD、FLASH、软盘附录四：需 求 讲 明 书简介介绍该项目的名称、任务提出者、提出的背景，应用的目标详细需求环境需求硬件环境描述运行该软件需要的设备能力处理器的速度、数量和内存容量存储媒体的容量输入、输出设备的种类和数量通讯网络软件环境运行该软件需要的操作系统、数据库软件、以及相应的其他应用软件人员环境操作该软件对人员的要求，人员的素养、数量功能需求对系统中每一个功能，要求用图示或文字详细描述：概

15、述叙述功能名称、目标和作用输入详述该功能输入的信息处理描述该功能作什么，如何对输入信息进行加工并转换成输出信息输出详述该功能输出的信息内部生成数据列出用户所关怀的内部生成数据性能需求定量的描述该软件系统应满足的具体性能需求精度讲明该软件系统的精度要求，如：数据的精度要求数字计算的精度要求数据转送的误码率要求时刻特性讲明该软件系统的时刻要求，如：解题时刻询问和更新数据文件的响应时刻系统各项功能的顺序关系由于输入类型的不同和操作方式的变化而引起的优先顺序在峰值负载期，与所规定的响应时刻的同意偏离范围灵活性讲明当需求发生某些变化时该软件系统的适应能力，指出为适应这些变化而需要设计的软件成分和过程输入

16、和输出描述输入和输出的每个数据元素，对每个数据元素可列出如下信息：数据元素名同义名定义格式值域度量单位数据项名、缩写词和代码关于输入数据，还要讲明时刻要求、优先顺序和输入媒体。关于输出数据，亦要讲明时刻要求、优先顺序和输出形式，并要描述对专门输入输出项的保密要求和措施。数据库特性详细描述数据库中要用到的每个数据元素，对每个数据元素可列出如下信息：数据元素名同义名定义格式值域度量单位数据项名、缩写词和代码要依照记录的规模和数量来可能数据存储要求，并要预测数据的增长率。故障处理列出在该系统出现故障时，为满足信息处理要求而可能采取的技术措施，如：后备技术低效技术再启动技术接口讲明该软件系统与其他系统

17、和子系统的接口软件接口和硬件接口安全和保密讲明该软件系统在安全和保密方面的要求交付方式交付的内容全部的设计文件、发行版本、源程序交付的媒体介质纸质文件、电子文件、CD、FLASH、软盘附录五：软 件 开 发 规 范软件开发的流程和需要的文档资料同项目开发类似，在第 章中有详细的描述，在这不再作介绍了，仅介绍与软件紧密相关的常用文档资料的格式模板，以及编程设计中的若干规定常用文档的格式模板流程图概述国家标准GB1526-89信息处理数据流程图、程序流程图、系统流程图、程序网络图和系统资源图的文件编制符号及约定规定了信息处理文件使用的各种符号及其使用的具体约定。要求采纳VISIO或SMARTDRA

18、W软件绘制流程图。流程图所用符号及其简要讲明符号符号名简要讲明备注数据表示数据，其中可注明数据名、来源、用途或其他的文字讲明。此符号并不限定数据的媒体处理表示各种处理功能。符号内可注明处理名或其简要功能既定处理表示已命名的既定处理。该处理为在另外地点已得到详细讲明的一个操作或一组操作。例如子程序、函数、模块。符号内可注明处理名或其简要功能预备表示修改一条指令或一组指令以阻碍随后的活动。例如：设置开关、修改变址寄存器、初始化例行程序推断表示推断或开关。符号内可注明推断的条件，它只有一个入口，但能够有若干能够选择的出口。在对符号内的条件求值后，有一个且只有一个出口被激活。求值结果可在表示出口路径的

19、流线附近写出并行处理表示同步进行两个或两个以上并行方式的操作。循环界限循环界限由上界限和下界限构成，分不表示循环的开始和结束。流线表示操纵流的流向虚线用于表明被注解的范围或连接被注解部分与注解正文连接符用于表明转向流程图的它处，或从它处转入。它是流线的断点。在圆内注明某一标志符，表明该流线将在具有相同标志符的另一连接符处接着下去。端点符程序流程的起点或结束注解符表示注解的内容，虚线须连接到被注解的符号或符号组合上。省略符若流程图中有些部分无需给出符号的具体形式和数量，可用省略符。省略符应夹在流线符号之中。使用约定图的布局流程图所用的符号应该均匀分布，连线保持合理的长度，并尽量少使用长线。符号标

20、志符这是给予某个符号的标志符，其作用是便于其他文件中引用该符号。符号标志符要写在符号的左上角。符号描述符它用于交叉引用，表达一个符号的专门用途，或者进一步理解某个符号的功能。描述符要写在符号的右上角。连接的约定标准流向从左至右，自上而下箭头的使用可随时在流线上使用箭头指示方向，当流程不是标准流向时，一定要采纳箭头来指示方向。流线的交叉应当尽量幸免流线的交叉，即使出现，交叉的流线之间没有任何逻辑关系，不对流向产生阻碍。流线的汇合两根或更多的进入线能够汇合为一根输出线，各连接点应相互错开以提高清晰度，并在必要时使用箭头表示流向。互连一般情况下，流线应从符号的左边或顶端进入，从右边或底端离开。它们都

21、应对准符号的中心。多出口一个符号如有多个出口，应按下述方式表示，在每个出口都应标有适当的条件值，以反映它所表示的逻辑路径。数据结构结构名称描述名 称定 义描 述使用特点数据字典数据字典和数据结构图可形成交互参照关系名称定义描述使用特点项目打算表要求采纳PROJECT软件制作，大致格式如下：项目名称标识号任务工期开始时刻完成时刻提交件负责人拟制： 校对： 审核： 批准： 第 页函数/过程接口函数名：必须与源程序中的一致，包括大小写功能：简要讲明该函数/过程实现的功能，以及要紧的算法，对重要的函数/过程可采纳伪语言进行描述入口参数：对入口参数作简要的讲明，利用全局变量，则也要讲明出口参数：对出口参

22、数作简要的讲明，改变了全局变量，则也要讲明返回值：对函数的返回值讲明其类型和作用程序设计的若干规定那个地点例举了C语言和汇编语言的规定，其他编程语言应参照这些规定编写C语言见附录六汇编语言见附录六附录六：程 序 设 计 若 干 规 定引言本文档描述了项目开发中的编程标准，其目的是提供一个编程的严格规则，使得程序有统一的风格，以便于理解和维护，项目要紧由C语言和汇编语言编写.C语言产生新代码图D-1描述了产生C语言新代码的格式，在写新代码之前，程序员必需首先将std.c拷贝到新文件中，然后编辑新文件以提供下列信息.目的提供一个关于程序的简要描述.版本状态给出当日的日期，程序员姓名，创建或修改.输

23、入列出及描述所有该程序将输入的变量，描述应简要而完全，有必要要描述一个组中不同的元素，或者一个词的字节或位，假如没有输入变量,则键入none.输出列出及描述所有该函数的输出变量，同时描述副作用，假如有的话.限制简要讲明程序的限制，例如数组长度，算法等等，同时给出对以后版本的建议，假如没有限制，给出“none”错误信息描述出错信息或在出错时变量的置值，假如没有的话给出“none”.方法简单描述程序中所有调用的算法及方法，假如方法专门明显，则删去这一项，假如应用了复杂的算法或方程式，请给出解释及参考.外部变量描述仅列出及描述那些一般不为人所知的变量，假如该函数不用任何外部变量，给出“none”.局

24、部、静态、寄存器变量描述列出及描述局部，静态寄存器变量，假如一个变量的用途可从其它变量名中明显地看到，则不必给出解释，变量名按字典顺序列出. /* * 本程序属于XXXXXXXXX(公司名).作为商品机密* * 版权所有,未经许可不得公布或使用.* *. 目的 函数的功能描述. 版本状态 11-7-90(程序员姓名)新代码. 输入 列出所有输入变量和解释. 输出 列出所有输出变量参数返回值及解释. 限制 给出使用的算法和处理方法. 错误信息 描述错误信息. 方法 该函数中用的算法和处理方法. 函数调用 列出调用的函数. 外部变量 描述所有使用的外部变量. 局部变量 描述局部变量. */图 D-

25、1 C标准格式(in “std.c”)改旧代码在函数头上的所有必要的信息必须修改, 版本状态必须包含版本日期, 程序员姓名, 以及版本的简要描述, 这种描述必须规格化, 而且要包含足够的信息, 以便于对这些修改进行回溯. 版本状态列出的顺序必须使得最新的版本列在最上边. 所有其它的信息包括输入、输出、限制、以及函数调用等等, 必须与最新的版本保持一致.编程常规下面讲明了C语言指令中的标准结构:程序设计风格symbol 183 f Symbol s 10 h通过空格和空行, 使程序有层次感, 便于阅读.symbol 183 f Symbol s 10 h提倡使用C+的语法和程序结构.symbol

26、 183 f Symbol s 10 h所有代码必须是小写字符, 以下的例外: 1。常量或宏(用#define 或 #typedef 在include文件中定义的)必须用大写字母.2。在编译或连接器中要求大写的标识符或库函数名.3。该文本中讲明的其它必须大写的字母.symbol 183 f Symbol s 10 h代码尽可能写得简单、清晰、将复杂语句切成几个简单的语句以增加可读性.symbol 183 f Symbol s 10 h一般将子程序限制在100行以内.symbol 183 f Symbol s 10 h关于一个程序只同意一个入口和出口（在有出错处理等情况下可能同意有若干个出口）.

27、symbol 183 f Symbol s 10 h设计的子程序必须有一个完整定义的输出、输入同时完成一个任务.symbol 183 f Symbol s 10 h将紧密相关的子程序存放在一个文件中.symbol 183 f Symbol s 10 h程序中尽量不使用直接数, 即尽量不在源程序中出现某个具体的数值, 相应的数值最好用#define语句定义成宏, 以便于修改和维护.symbol 183 f Symbol s 10 h使用统一的工作环境, 建立子目录, 各目录存放指定的内容: src (源程序存放目录) doc (文档存放目录) bin (可执行程序存放目录) lib (库函数存放

28、目录) test (测试用目录) inc (引用文件存放目录) personal (各人自用目录)symbol 183 f Symbol s 10 h使用make, Makefile进行编译, 更新目标文件和可执行文件.C 库函数symbol 183 f Symbol s 10 h仅使用Unix System V、Microsoft C、Lattic C及Turbo C 编译器中的库函数. symbol 183 f Symbol s 10 h在用malloc或calloc申请空间之后, 建议测试一下不为空指针，若使用空指针，通常会导致系统的崩溃，或莫名其妙的错误。symbol 183 f Sy

29、mbol s 10 h在用malloc或calloc申请空间之后, 必须牢记在不需要它们的时候调用free释放空间以便于今后使用空间.类型讲明symbol 183 f Symbol s 10 h类型讲明的顺序是由短到长: char short long float doublesymbol 183 f Symbol s 10 h尽量不使用int, 用short或long取代, 以免不同硬件环境的阻碍.symbol 183 f Symbol s 10 h仅仅使用var_style.h中用typedef定义的宏以便共享.变量名变量名的长度没有限制. 但各个变量的前31个字符必须唯一.(各系统的状态

30、会有变化,尽可能在开始时区分变量名). 建议用英文语句的一般风格命名变量名, 英文单词的首字母大写，后面的字母小写。关于外部(公共)变量或函数名, 在第一个字符之前加_, 对局部的变量名, 建议遵照下列格式: 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)注意：变量名

31、不应该和当前系统采纳的编译器，以及与已知的其他编译器中已定义的函数名或C的库函数相同，也不应与同C的关键字相同。比如：class 不是C编译器的关键字，然而C+的关键字，在用C编译器开发的系统中，不能采纳class作为变量名，否则将阻碍移植性。寄存器变量在程序中找一个频繁使用的变量(int或指针类型),将其定义成寄存器类以加快运行速度，特不适用于循环变量中。外部变量symbol 183 f Symbol s 10 h外部变量必须在函数中以extern语句讲明 .symbol 183 f Symbol s 10 h假如外部变量是数组,在外部讲明中,第一维必须为空.symbol 183 f Sym

32、bol s 10 h假如不同类型的变量要组在一起,用结构取代数组.symbol 183 f Symbol s 10 h将外部变量讲明成static类, 假如它们在一个文件中共享而不被其它文件访问.常量symbol 183 f Symbol s 10 h对公共使用的常量,引用com_cons.h中定义的宏.for 循环关于数组的处理,循环的结束用取代=.例: int a9; for (i=0;i z=(y+3)/3=y/3=12、char *buf;long *plong;plong=(long *)buf+2;(1)plong=(long *)(buf+2);(2)假如buf=0;则在(1)中

33、plong=8,(2)中plong=2;注释symbol 183 f Symbol s 10 h在需要明确程序含义的地点应勤于使用注释, 所有注释写成:/*. .*/或 /symbol 183 f Symbol s 10 h在语句后的注释必须与语句在同一行:statement /*._ .*/statement /*._ .*/symbol 183 f Symbol s 10 h假如注释太长, 超出一行,应将其按如下格式放在语句之前: /*. . . .*/symbol 183 f Symbol s 10 h假如变量需要注释, 它们必须一行行地进行讲明, 例如: int i; /*. .*/汇

34、编语言产生新模块代码图D-2描述了产生汇编语言新模块代码的格式, 在写新代码之前,程序员必需首先将model.asm拷贝到新文件中.然后编辑新文件以提供下列信息.目的提供一个关于程序模块的简要描述.版本状态给出当日的日期,程序员姓名，版本号。COMMENT % * * 本程序属于XXXXXXXXX(公司名).作为商品机密 * * 版权所有,未经许可不得公布或使用. * *. 目的 模块的功能描述. 版本状态 11-7-90(程序员姓名)新代码图 D-2 ASM标准格式(in “model.asm”)产生新的子过程代码图D-3描述了产生汇编语言新的子过程代码的格式,在写新子过程代码之前,程序员必

35、需首先将Pro.asm拷贝到新子过程前.然后编辑新文件以提供下列信息.子过程名称给出子过程的名称功能描述用语言或伪C代码提供一个关于该子过程的简要描述,同时简要讲明子过程的限制。版本状态和历史给出当日的日期,程序员姓名.入口参数列出及描述所有该子过程将输入的变量和寄存器，描述应简要而完全, 有必要描述一个组中不同的元素, 或者一个词的字节或位. 假如没有输入变量,则键入“none”.出口参数列出及描述所有该子过程的输出变量和寄存器, 同时描述对全局变量的阻碍和被破坏的寄存器, 假如有的话. 同时还要描述出错信息或在出错时变量的值, 假如没有的话给出“none”.默认的段寄存器和段名用ASSUM

36、E指出在该子过程中，默认的段寄存器和段名的关系。COMMENT . 子过程名称 给出子过程的名称. 功能描述 提供一个关于子过程的简要描述，同时简要讲明子过程的限制. 版本状态和历史 给出当日的日期,程序员姓名. 入口参数 列出及描述所有该子过程将输入的变量和寄存器. 出口参数 列出及描述所有该子过程的输出变量和寄存器, 并列出被破坏的寄存器. 默认的段寄存器和段名 用ASSUME指出在该子过程中，默认的段寄存器和段名的关系。%图 D-3 标准格式(in “pro.asm”)修改旧代码在过程头上的所有必要的信息必须修改, 版本状态必须包含版本日期, 程序员姓名, 以及版本的简要描述, 这种描述

37、必须规格化, 而且要包含足够的信息, 以便于对这些修改进行回溯. 版本状态列出的顺序必须使得最新的版本列在最上边. 所有其它的信息包括输入、输出、限制、以及过程调用等等, 必须与最新的版本保持一致.编程常规下面讲明了汇编语言指令中的标准结构:程序设计风格symbol 183 f Symbol s 10 h应该遵照 MIRCOSOFT MASM 5.06.0和TURBO ASMBLE 2.03.0的语言规范。建议不用简写方式.symbol 183 f Symbol s 10 h在同一子过程中所有代码必须是统一的小写字符和大写字母,以下的例外: (1) 宏必须用大写字母. (2) 在编译或连接器中

38、要求大写的标识符或库函数名. (3) 该文本中讲明的其它必须大写的字母.symbol 183 f Symbol s 10 h关于一个程序只同意一个入口和出口（在有出错处理等情况下可能同意有若干个出口）.symbol 183 f Symbol s 10 h设计的子程序必须有一个完整定义的输出、输入同时完成一个任务.symbol 183 f Symbol s 10 h将紧密相关的子程序存放在一个文件中.symbol 183 f Symbol s 10 h程序中尽量不使用直接数, 即尽量不在源程序中出现某个具体的数值, 相应的数值最好用EQU语句定义成宏, 以便于修改和维护.symbol 183 f Symbol s 10 h使用统一的工作环境, 建立子目录, 各目录存放指定的内容: src (源程序存放目录) doc (文档存放目录) bin (可执行程序存放目录) lib (库函数存放目录) test (测试用目录) inc (引用文件存放目录) personal (各人自用目录)symbol 183 f Symbol s 10 h使用统一的程序名后缀： .ASM (汇编源程序) .INC (公共的宏定义和结构定义) .DO