2011软考软件设计师：C语言代码规范问题(3)

 　1.3 程序注释

　　1.3.1程序注释是程序员与日后的程序读者之间通信的重要手段之一，注释分为文件注释、函数注释和功能注释。

　　1.3.2正规程序的注释应注意：

　　--注释行的数量占到整个源程序的1/3到1/2。

　　1.3.3文件注释位于整个源程序的最开始部分，注释后空两行开始程序正文。它包括：

　　--程序标题。

　　--目的、功能说明。

　　--文件作者、最后修改日期等说明。

　　例：

　　./

　　(空一行)

　　标题： Demo.c

　　功能： 测试VxWorks的各种系统调用。

　　说明：

　　该程序测试各种VxWorks的系统调用函数。包括任务(taks)的创建、挂起及任务间通过信号灯实现同步，通过消息队列进行通讯。

　　程序创建了两个任务：一个高优先级的任务和一个低优先级的任务。两个任务间通过一个二进制的信号灯进行同步，通过消息队列进行通讯。

　　当前版本： x.x

　　修改信息： 2000.06.05 John， Initial Version

　　2000.07.05 Tom， Bug xxxx fixed

　　/

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