大家在函数头部都喜欢采用什么格式写说明？

Question

我喜欢这样/* int32 SCurve2d::PointOnCurve(PNT2D *pnt, real64 u)
Work out the point on curve corispond to parameter ureturn:
    TRUE successful
    FALSE failedpnt:   point returned
u:     parameterProgrammer: ag
*/

Answer 1

///////////////////////////////////////////////////////
//Function:.....
//
//
//Discription:....
//
//
//update:....
//
///////////////////////////////////////////////////////

Answer 2

/************************************************
**Function
**
**Param
**
**Return
**
**Re
************************************************/

Answer 3

/*
------------------------------------------------------
**Function
**
**Param
**
**Return
**
**Re
------------------------------------------------------
*/

Answer 4

/************************************************/
/**Function
/**
/**Param
/**
/**Return
/**
/**Re
/************************************************/

Answer 5

/************************************************
Function:Param:Return:Re:************************************************/

Answer 6

同志们，我正在做我的 DocWizard，它可以从程序源代码里面提出注释，形成文档。
提取注释真是困难啊

Answer 7

/*****************************************************************************
 *
 * Copyright(c)2003  Hitachi Medical corp. All Rights Reserved.
 *
 * REVISION HISTORY:
 * YYYY/MM/DD | REVISION | WHO             | WHAT/WHY/HOW
 * -----------+----------+-----------------+-----------------------------
 * 2003/06/10 | 1.00     | Team C          | Initial Release
 * -----------+----------+-----------------+-----------------------------
 * 2003/06/11 | 1.01     | Team C          | Update function()
 *
 * FILE NAME:
 * classCommission.cpp  
 *
 * DESCRIPTION:   
 * This function is used to solve the functions of the class
 * MasterCommission. The simple functions are wrote in head 
 * file. We write those hard functions here. 
 *
 *  NOTES:
 * This is the common module for all the class. TEAM A and TEAM B will
 * use this module, too.(DESIGNED by TEAM C)
 *
 ****************************************************************************/
前些日子， 新人培训的 时候 ，写的 文件 头的 注释 不是 关于 文件 的 注释 ，  这个 注释 几乎 所有 的 程序里 都有 

Answer 8

/********************************
//Name  :FuncA
//Description  :
//Calls  :
//Calls by:
//Input   :
//Output  :
//Return  :
//Re  :
**********************************/

Answer 9

//函数名称-函数作用
//返回值-false:...;true:...
//参数1-
//参数2-

Answer 10

总结一下，大家的注释的格式基本上是这样的<keyword> : "text"基于这样的特点，我可以写一个程序进行提取了