【正文】 ... 。對(duì)于外部 (公共 )變量或函數(shù)名 ,在第一個(gè)字符之前加 _,對(duì)局部的變量名 , 建議遵照下列格式 : bxxx_ 或 xxxx_b 字節(jié)變量 wxxx_ 或 xxxx_w 字變量 dxxx_ 或 xxxx_d 雙字變量 sbxxx 或 xxxx_sb 字節(jié)串變量 swxxx 或 xxxx_sw 字串變量 cxxx_ 或 xxxx_c 常 量 外部變量 ? 外部變量必須在模塊中以 extrn語句說明 .所有的外部變量集中在一起放在文件的開始處 . ? 如果不同類型的變量要組在一起 , 用結(jié)構(gòu)取代零散的變量 . 過程 引用的外部過程必須在模塊以 extrn語句說明 .所有的外部過程集中在一起放在外部變量之后 , 兩者之間有明顯的界限。 注釋 ? 在需要明確程序含義的地方應(yīng)勤于使用注釋 , 所有注釋寫成 :/*... ...*/或 // ? 在語句后的注釋必須與語句在同一行 : statement /*..._ ..*/ statement /*..._ ..*/ ? 如果注釋太長(zhǎng) , 超出一行 ,應(yīng)將其按如下格式放在語句之前 : /*... ... ... ...*/ ? 如果變量需要注釋 , 它們必須一行行地進(jìn)行說明 , 例如 : int i。i++) ...。該文本中說明的其它必須大寫的字母 . ? 代碼盡可能寫得簡(jiǎn)單、清晰、將復(fù)雜語句切成幾個(gè)簡(jiǎn)單的語句以增加可讀性 . ? 一般將子程序限制在 100行以內(nèi) . ? 對(duì)于一個(gè)程序只允許一個(gè)入口和出口（在有出錯(cuò)處理等情況下可能允許有若干個(gè)出口） . ? 設(shè)計(jì)的子程序必須有一個(gè)完整定義的輸出、輸入并且完成一個(gè)任務(wù) . ? 將密切相關(guān)的子程序存放在一個(gè)文件中 . ? 程序中盡量不使用直接數(shù) , 即盡量不在源程序中出現(xiàn)某個(gè)具體的數(shù)值 , 相應(yīng)的數(shù)值最好用define語句定義成宏 , 以便于修改和維護(hù) . ? 使用統(tǒng)一的工作環(huán)境 , 建立子目錄 , 各目錄存放指定的內(nèi)容 : src (源程序存放目錄 ) doc (文檔存放目錄 ) bin (可執(zhí)行程序存放目錄 ) lib (庫函數(shù)存放目錄 ) test (測(cè)試用目錄 ) inc (引用文件存放目錄 ) personal (各人自用目錄 ) ? 使用 make, Makefile進(jìn)行編譯 , 更新目標(biāo)文件和可執(zhí)行文件 . C 庫函數(shù) ? 僅使用 Unix System V、 Microsoft C、 Lattic C及 Turbo C 編譯器中的庫函數(shù) . ? 在用 malloc或 calloc申請(qǐng)空間之后 , 建議測(cè)試一下不為空指針，若使用空指針，通常會(huì)導(dǎo)致系統(tǒng)的崩潰，或莫名其妙的錯(cuò)誤。 ? 流線的交叉 應(yīng)當(dāng)盡量避免流線的交叉，即使出現(xiàn)，交叉的流線之間沒有任何邏輯關(guān)系，不對(duì)流向產(chǎn)生影響。 省略符 若流程圖中有些部分無需給出符號(hào)的具體形式和數(shù)量，可用省略符。符號(hào)內(nèi)可注明判斷的條件，它只有一個(gè)入口，但可以有若干可以選擇的出口。 要求采用 VISIO 或 SMARTDRAW軟件繪制流程圖。 系統(tǒng)出錯(cuò)處理設(shè)計(jì) 出錯(cuò)信息 用表格形式列出每種可能的出錯(cuò)或故障情況出現(xiàn)時(shí)，系統(tǒng)輸出信息的形式、含義及處理方法。 開發(fā)工具和平臺(tái) 描述采用何種操作系 統(tǒng)平臺(tái)、何種編程語言、開發(fā)工具進(jìn)行開發(fā)。 3. 審核： 檢查文件的完整性和正確性。 技術(shù)人員在為顧客服務(wù)的現(xiàn)場(chǎng)，遇到需要版本修訂時(shí)，應(yīng)先電告項(xiàng)目負(fù)責(zé)人，經(jīng)認(rèn)可后，回廠填寫 [用戶服務(wù)檔案 ]，必要時(shí)項(xiàng)目負(fù)責(zé)人應(yīng)組織評(píng)審和檢測(cè)。 5. 3. 2 物流部經(jīng)理負(fù)責(zé)組織軟件版本存檔前的最終檢測(cè)，并在 [版本送檢（啟用）通知單 ]上簽署檢測(cè)結(jié)果。 軟件項(xiàng)目 公司立項(xiàng)項(xiàng)目由技術(shù)發(fā)展部負(fù)責(zé)組織評(píng)審。 2 引用 標(biāo)準(zhǔn) GB8567— 88 計(jì)算機(jī)軟件產(chǎn)品開發(fā)文件編制指南 3 定義 不需用。 4 職責(zé) 設(shè)計(jì)部門負(fù)責(zé)人批準(zhǔn)軟件開發(fā)項(xiàng)目任務(wù)書。 a、項(xiàng)目負(fù)責(zé)人（軟件負(fù)責(zé)人）于評(píng)審前 3 天填寫 [評(píng)審申請(qǐng)表 ]，并備齊評(píng)審資料，交技術(shù)發(fā)展部。 5. 4 設(shè)計(jì)部門負(fù)責(zé)人批準(zhǔn)軟件項(xiàng)目開發(fā)計(jì)劃。 文檔要求 各階段需具備的基本文檔及文檔格式（見附錄） 鑒定需具備的文檔參見附錄。 4. 資料審查： 檢查文件的完整性和格式的正確性。 總體結(jié)構(gòu)設(shè)計(jì) 用圖表和文字方式說明該系統(tǒng)由幾個(gè)模塊構(gòu)成，各模塊的功能、各模塊之間的關(guān)系。 補(bǔ)救措施 說明故障出現(xiàn)后可能采取的變通措施，如后備技術(shù)、降效技術(shù)、恢復(fù)及再啟動(dòng)技術(shù)等。 流程圖所用符號(hào)及其簡(jiǎn)要說明 符號(hào) 符號(hào)名 簡(jiǎn)要說明備注 數(shù)據(jù) 表示數(shù)據(jù)，其中可注明數(shù)據(jù)名、來源、用途或其他的文字說明。在對(duì)符號(hào)內(nèi)的條件求值后，有一個(gè)且只有一個(gè)出口被激活。省略符應(yīng)夾在流線符號(hào)之中。 ? 流線的匯集 兩根或更多的進(jìn)入線可以匯集為一根輸出線，各連接點(diǎn)應(yīng)相互錯(cuò)開以提高清晰度，并在必要時(shí)使用箭頭表示流向。 ? 在用 malloc或 calloc申請(qǐng)空間之后 , 必須牢記在不需要它們的時(shí)候調(diào)用 free釋放空間以便于將來使用空間 . 類型說明 ? 類型說明的順序是由短到長(zhǎng) : char short long float double ? 盡量不使用 int, 用 short或 long取代 , 以免不同硬件環(huán)境的影響 . ? 僅僅使用 typedef定義的宏以便共享 . 變量名 變量名的長(zhǎng)度沒有限制 . 但各個(gè)變量的前 31個(gè)字符必須唯一 .(各 系統(tǒng)的狀態(tài)會(huì)有變化 ,盡可能在開始時(shí)區(qū)分變量名 ). 建議用英文語句的一般風(fēng)格命名變量名 , 英文單詞的首字母大寫，后面的字母小寫。 ...。 /*... ...*/ 匯編語言 產(chǎn)生新模塊代碼 圖 D2描述了產(chǎn)生匯編語言新模塊代碼的格式 , 在寫新代碼之前 ,程序員必需首先將 件中 .然后編輯新文件以提供下列信息 . 目的 提供一個(gè)關(guān)于程序模塊的簡(jiǎn)要描述 . 版本狀態(tài) 給出當(dāng)日的日期 ,程序員姓名 ，版本號(hào)。 常量 對(duì)公共使用的常量 , 在 . 標(biāo)號(hào) ? 所有標(biāo)號(hào)應(yīng)在第一列開始 . ? 標(biāo)號(hào)名稱由子過程名稱的簡(jiǎn)寫 (用大寫字母 )加下劃線加有具體含義的單詞構(gòu)成。... ? 每一個(gè)變量都應(yīng)以注釋 , 對(duì)其用途、含義、可能的取值加以說明。... 。對(duì)于外部 (公共 )子過程名 ,在第一個(gè)字符之前加 _. 變量名 變量名的長(zhǎng)度沒有限制 . 但各個(gè)變量的前 31個(gè)字符必須唯一 .(各系 統(tǒng)的狀態(tài)會(huì)有變化 , 盡可能在開始時(shí)加以區(qū)分 ).建議用英文語句的一般風(fēng)格命名變量名 . 英文單詞的首字母大寫，后面的字母小寫。則在 (1)中 plong=8,(2)中 plong=2。i9。在編譯或連接器中要求大寫的標(biāo)識(shí)符或庫函數(shù)名 . 3。 連接的約定 ? 標(biāo)準(zhǔn)流向 從左至右，自上而下 ? 箭頭的使用 可隨時(shí)在流線上使用箭頭指示方向，當(dāng)流程不是標(biāo)準(zhǔn)流向時(shí)，一定要采用箭頭來指示方向。 端點(diǎn)符 程序流程的起點(diǎn)或結(jié)束 注解符 表示注解的內(nèi)容，虛線須連接到被注解的符號(hào)或符號(hào)組合上。例如：設(shè)置開關(guān)、修改變址寄 存器、初始化例行程序 判斷 表示判斷或開關(guān)。 故障處理 列出在該系統(tǒng)出現(xiàn)故障時(shí)，為滿足信息處理要求而可能采取的技術(shù)措施，如： ? 后備技術(shù) ? 低效技術(shù) ? 再啟動(dòng)技術(shù) 接口 說明該軟件系統(tǒng)與其他系統(tǒng)和子系統(tǒng)的接口 軟件接口和硬件接口 安全和保密 說明該軟件系統(tǒng)在安全和保密方面的要求 交付方式 交付的內(nèi)容 全部的設(shè)計(jì)文件、發(fā)行版本、源程序 交付的媒體介質(zhì) 紙質(zhì)文件、電子文件、 CD、 FLASH、軟盤 附錄五： 軟 件 開 發(fā) 規(guī) 范 軟件開發(fā)的流程和需要的文檔資料同項(xiàng)目開發(fā)類似，在第 章中有詳細(xì)的描述，在這不再作介紹了，僅介紹與軟件緊密相關(guān)的常用文檔資料的格式模板，以及編程設(shè)計(jì)中的若干規(guī)定 常用文檔的格式模板 流程圖 概述 國家標(biāo)準(zhǔn) GB152689《信息處理 — 數(shù)據(jù)流程圖、程序流程圖、系統(tǒng)流程圖、程序網(wǎng)絡(luò)圖和系統(tǒng)資源圖的文件編制符號(hào)及