注释开关1:

 //*/ 去掉第一个'/'即可注释下面这段代码

 codeSegement ……

 
//*/

注释开关2

 //*/ 去掉第一个'/'即可切换注释,codeSegement1被注释,codeSegement2取消注释

 codeSegement1 ……

 
/*/

 codeSegement2 ……

 //
*/


几种美观的注释
/*! @file
********************************************************************************
<PRE>
模块名       : <文件所属的模块名称>
文件名       : <文件名>
相关文件     : <与此文件相关的其它文件>
文件实现功能 : <描述该文件实现的主要功能> 
作者         : <作者部门和姓名>
版本         : <当前版本号>
--------------------------------------------------------------------------------
多线程安全性 : <是/否>[,说明]
异常时安全性 : <是/否>[,说明]
--------------------------------------------------------------------------------
备注         : <其它说明>
--------------------------------------------------------------------------------
修改记录 : 
日 期        版本     修改人              修改内容
YYYY/MM/DD   X.Y      <作者或修改者名>    <修改内容>
</PRE>
******************************************************************************
*/

 
如果该文件有其它需要说明的地方,还可以专门为此扩展一节 ,节与节之间用长度为80的“=”带分割:
/*! @file
********************************************************************************
<PRE>
模块名       : <文件所属的模块名称>
文件名       : <文件名>
相关文件     : <与此文件相关的其它文件>
文件实现功能 : <描述该文件实现的主要功能> 
作者         : <作者部门和姓名>
版本         : <当前版本号>
--------------------------------------------------------------------------------
多线程安全性 : <是/否>[,说明]
异常时安全性 : <是/否>[,说明]
--------------------------------------------------------------------------------
备注         : <其它说明>
--------------------------------------------------------------------------------
修改记录 : 
日 期        版本     修改人              修改内容
YYYY/MM/DD   X.Y      <作者或修改者名>    <修改内容>
</PRE>
********************************************************************************

* 项目1
  - 项目1.1
  - 项目1.2

================================================================================
* 项目2
  - 项目2.1
  - 项目2.2
.

******************************************************************************
*/

 

/********************************************************************
    created:    2008/08/08        08:08
    filename:     project1/utility/util.cpp
    file base:    util
    file ext:    cpp
    author:        name@company
    
    purpose:    
********************************************************************
*/