[webkit-dev] Changes to prepare-ChangeLog

[Mike Hommey]

On Thu, Jul 02, 2009 at 12:26:14AM -0700, Maciej Stachowiak <mjs at apple.com> wrote:
>
> On Jul 1, 2009, at 10:47 PM, Dan Bernstein wrote:
>
>>
>> On Jul 1, 2009, at 10:44 PM, Eric Seidel wrote:
>>
>>>       prepare-ChangeLog should have a --bug= argument and use it for
>>> url autofill
>>>       https://bugs.webkit.org/show_bug.cgi?id=26383
>>
>> I would much prefer if the bug URL came first. I believe that this is 
>> the prevailing style.
>
> Looking at the ChangeLog, I see a mix of different styles. I personally 
> prefer the human-readable short description first, and I prefer to prefix 
> it with a dash, like so:
>
>         - Rename html4.css to html.css, since we target HTML5 now
> 	https://bugs.webkit.org/show_bug.cgi?id=26873
>
> I wouldn't mind the URL first if it was much shorter and could be on the 
> same line as the summary.
>
> Not too picky about this, but since it's a matter of taste, I thought  
> I'd chime in.

I've always wondered, in the days of atomic commits and advanced SCM, why
fill changelogs at all ? Except for CVS, RCS or SCCS, any SCM already
stores the log of changes. Keeping a Changelog in the SCM is both a
duplication of information and a stick to beat yourself when you
cherry-pick or revert changes, or merge branches.

Mike