ahh勘違いすんな、全部が全部実ソースの注釈ばっかって事じゃないぞ。

関数作ったなら、必ずインターフェイス（引数、返り値）のコメント
も作りなさい、って事だ。例えば、

/********************************************************************************
　矩形アルファブレンド処理

　BOOL　AlphaBlendingRect( GRAPHICPLANE PlaneDst,
int PointXDst, int PointYDst
GRAPHICPLANE PlaneSrc1,
int PointXSrc1, int PointYSrc1,
int XSize, int YSize,
GRAPHICPLANE PlaneSrc2,
int PointXSrc2, int PointYSrc2,
int AlphaIn, int MMXFlg ){
　引数
GRAPHICPLANE　PlaneDst　:　出力先プレーン
int　PointXDst　:　フェード開始Ｘ座標
int　PointYDst　:　フェード開始Ｙ座標
GRAPHICPLANE PlaneSrc1　:　入力プレーン１
int　PointXSrc1 :　フェード開始Ｘ座標
int　PointYSrc1 :　フェード開始Ｙ座標
int　XSize : 幅
int　YSize : 高さ
GRAPHICPLANE PlaneSrc2 : 入力プレーン２
int　PointXSrc2 : フェード開始Ｘ座標
int　PointYSrc2 : フェード開始Ｙ座標
int　AlphaIn : アルファ値
int　MMXFlg : ＭＭＸフラグ
　返り値
int　0 : 正常終了
1以上 : エラーコード（異常終了）

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

とかな。
最近見た他人のソースで、しっかり書いてる奴あまり見かけん。
まずは！バグ出したくなかったら綺麗にソース書け！
注釈は書いても損にならないし、逆にメリットﾀﾌﾟｰﾘだぞ？
っていうか、ある程度プロでやってるのならわかるっしょ？＞186氏
（プロじゃなかったらスマソ）