感谢zhou版主的资料，收藏一下。
唉，至少“每一个变量声明都应该进行注释 [COMMENT-05-3] ”这个偶程序中就没有准循，继续努力。
这条国标 建议不使用单行注释“∥” [GJB5369-4_10_2_2-5] 让偶很纠结。

不重视注释、不重视格式，是很多初学者的通病，甚至有人以写出别人看不懂的代码为荣的。看看那些总是问for(……);为什么错的问题帖就知道了，答了一次、两次，总不听劝，还辩解说书上就是这么写，那就随他们去吧。

规则是死的，人是活的，诸如循环变量ijk之类，也写个注释，那是神经病。

一般i,j,k偶也没有注释，觉得很明了的变量，无须多解释。

没有注释的程序读起来很蛋疼呀，每个初学者都应该一开始就学习编码规范的，不过大多数初学者没有意识到，等意识到的时候，已经形成习惯不写注释了。

Doxygen 的注释风格不错 还能自动生成注释文档 推荐一下

连i,j,k这样的纯粹循环变量也注释，就是我前面提到的过分注释。那些文档规范，只可意会，不可死守，关键是理解其精神。

嗯，这个开源工具蛮好的，听说过，还未曾使用，搞一个玩玩去。

如果是变量名能很清楚的表名意图呢？
如程序片段中
   char buffer[BUFSIZ];
        int found = 0;
如果按规定非i,j,k之类的应该注释，但偶却怕过份注释，没有写，有时候看到别人的代码好象也没有注释，有点纠结了。

还有个问题：如果这样设计函数错误信息设置，是否合理？

#ifndef CERROR_H_INCLUDED
#define CERROR_H_INCLUDED

int g_nerror = -1;

const char *error_msg[] = {
        "invoke ok",            // 0 函数调用成功
        "alloc memory faile",   // 1 内存分配失败
        "string not init",      // 2 字符串未初始化附值
        "string not equal",     // 3 字符串不相等
        "out of index range"    // 4 索引超出范围
};

int             get_last_error(void);        //获取最后一次函数调用错误值
const char *    get_error_msg(int errro);    //获取对应的错误信息

#endif // CERROR_H_INCLUDED

[ 本帖最后由 hellovfp 于 2011-8-19 14:12 编辑 ]