2011軟考軟件設(shè)計師：C語言代碼規(guī)范問題(3)

　　1.3 程序注釋

　　1.3.1程序注釋是程序員與日后的程序讀者之間通信的重要手段之一，注釋分為文件注釋、函數(shù)注釋和功能注釋。

　　1.3.2正規(guī)程序的注釋應(yīng)注意：

　　——注釋行的數(shù)量占到整個源程序的1/3到1/2。

　　1.3.3文件注釋位于整個源程序的最開始部分，注釋后空兩行開始程序正文。它包括：

　　——程序標(biāo)題。

　　——目的、功能說明。

　　——文件作者、最后修改日期等說明。

　　例：

　　./

　　(空一行)

　　標(biāo)題： Demo.c

　　功能： 測試VxWorks的各種系統(tǒng)調(diào)用。

　　說明：

　　該程序測試各種VxWorks的系統(tǒng)調(diào)用函數(shù)。包括任務(wù)(taks)的創(chuàng)建、掛起及任務(wù)間通過信號燈實現(xiàn)同步，通過消息隊列進行通訊。

　　程序創(chuàng)建了兩個任務(wù)：一個高優(yōu)先級的任務(wù)和一個低優(yōu)先級的任務(wù)。兩個任務(wù)間通過一個二進制的信號燈進行同步，通過消息隊列進行通訊。

　　當(dāng)前版本： x.x

　　修改信息： 2000.06.05 John， Initial Version

　　2000.07.05 Tom， Bug xxxx fixed

　　/

　　(空2行，開始程序正文)

　　2011年上半年軟考報名時間預(yù)測：2011年3月

　　2010年下半年軟考成績查詢時間及方式匯總

　　軟考軟件設(shè)計師歷年真題匯總(2007年-2010年)

　　2011軟考軟件設(shè)計師：C語言代碼規(guī)范問題匯總