不知道 mod by *** on 20050814 这样的注释有什么意思？

flw

我一向是极力反对的——理由很简单，随便哪个版本控制系统都可以支持，莫非这个公司从来不用版本控制系统？
比如 cvs ann svn ann 就可以看每一行代码的最终修改者。

更可笑的是有很多公司居然把这一条写入了《编码规范》

Edengundam

天才啊...

Mart1n

这个还是很有用的。。。

flw

原帖由 Mart1n 于 2007-8-6 12:10 发表
这个还是很有用的。。。

如果刚才那位网友所说，
当他看到一大堆 mod by *** on 20050814 却发现 *** 已经离职的时候，那感受啊……

yg

不能说完全没用。一是对于一次小规模的改动，很容易找到所有修改点，再一个，一看是谁改的，就知道容易出什么问题。在中间版本提交的时候，也更容易协调一点。

Edengundam

原帖由 yg 于 2007-8-6 12:19 发表
不能说完全没用。一是对于一次小规模的改动，很容易找到所有修改点，再一个，一看是谁改的，就知道容易出什么问题。在中间版本提交的时候，也更容易协调一点。

完全没用. 版本控制, 直接版本比较就可以看出变动了, 唯一值得留下的应该是关联于本次改动必要的注释和需求ID.

flw

原帖由 Edengundam 于 2007-8-6 12:22 发表

完全没用. 版本控制, 直接版本比较就可以看出变动了, 唯一值得留下的应该是关联于本次改动必要的注释和需求ID.

同意。
补充一下，“关联于本次改动必要的注释和需求ID”那个应该写在提交给版本控制系统的 log 里面。

flw

原帖由 yg 于 2007-8-6 12:19 发表
不能说完全没用。一是对于一次小规模的改动，很容易找到所有修改点，再一个，一看是谁改的，就知道容易出什么问题。在中间版本提交的时候，也更容易协调一点。

那你有没有碰到过这种情况呢？
好比有一段代码，我改了一下，加了个 // add(or mod) by flw 20070806
然后过了几天，又有一个人改了一下那段代码，但是没有加注释，
然后等第三个人看到那段代码时，有了不明白的地方，却跑来问我，我自然是回答不上来了。

Edengundam

原帖由 flw 于 2007-8-6 12:24 发表

同意。
补充一下，“关联于本次改动必要的注释和需求ID”那个应该写在提交给版本控制系统的 log 里面。

我们comment用来写摘要的

有时候修改算法时候, 注释就得放在函数头, 文件头的位置了...

ID那个是多个版本之间修改时候, 防止某些人看不到history变更时候(我看不到某些版本的历史), 用来快速定位的...这个不算是太好

flw

原帖由 快乐的土豆 于 2007-8-6 12:28 发表
有作用啊,文档化的时候用得上的--并不是所有的时候你都通过cvs这类工具去看源代码来了解当前的代码状态.
在一些开源项目的用户手册上还能看到todo list呢--其实就是通过源代码用工具倒出来的.

哥们，通过你这个回复和刚才那个帖子里你的观点，
我发现你做事非常不靠谱，基本概念混乱，赶紧跳槽找个大公司历练历练吧。
再或者研究一下某个开源项目，对你的成长有帮助。