详细的ChangeLog条目通常会告诉谁,何时以及更改了哪些功能以及为什么要进行此更改.
这对于源代码树中的每个单独的函数!
据我所知,ChangeLog来自过去,当时没有好的VCS.
所以传统的ChangeLog根本不需要,因为你可以从以下方面获得:
$ svn log . $ hg log . $ git log . $ bzr log .
只有一个可能需要ChangeLog用于产品版本之间的简短摘要,仅供用户使用(例如,当新版本出现时,开发人员准备ChangeLog描述显着/可见的更改).
或者我错了?
来自http://autotoolset.sourceforge.net/tutorial.html#SEC45:
The ChangeLog file: Use this file to record all the changes that you make to your source code. If your source code is distributed among many subdirectories, and there is reason enough to think of the contents of the subdirectories as different subpackages,then please maintain a separate `ChangeLog' file for each subdirectory.
看起来过时和教条.Autotools和"GNU编码标准"要求的ChangeLog.
GNU Emacs源代码包含许多巨大的ChangeLog(许多部分由许多部分组成): …