On Fri, 1 Feb 2002, Stephen Adkins wrote:

> Unless there is a clear consensus on how to do this, I will
> probably modify my "cvshistory" script to create the
> "CHANGES" file. ("cvshistory" is the script which creates the
> CVS Activity page and is located in the P5EEx/Blue/sbin directory.)
>
>    http://www.officevision.com/pub/p5ee/activity.html

I really hate seeing changelogs that are collections of CVS comments.  You
end up with lots of stuff like:

 Rewrote algorithm to detect smells

 Tweaked some variable names

 ...

They tend to be way too low level to be of interest to non-core
developers, people who just use the stuff.  When I look at a changelog for
a Perl module, I want to to see what will affect me.  Faster, more
features, API changes, etc.  And that's it.  Take the time to write a
changelog by hand based on the CVS changes or something.


-dave

/*==================
www.urth.org
we await the New Sun
==================*/

Reply via email to