3. Comment on specifications and naming rules. Comment on standardized naming rules.
1. For C/C ++ files, the file header should have a comment similar to this:
/*************************************** *********************************
*
* File name: network. c
*
* File Description: network communication function set
*
* Created by: Hao Chen, December February 3, 2003
*
* Version: 1.0
*
**************************************** ********************************/
2. For functions, there should be comments similar to the following:
/* ===================================================== ======================================
*
* Letter count: XXX
*
* Parameter: type name [IN]: descripts
*
* Function description:
*
* Return value: TRUE for success, FALSE for failure
*
* Prepared by: ChenHao 2003/4/2
*
========================================================== ======================================= */
3,