[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Generating the ChangeLog files from the commit messages
From: |
David Engster |
Subject: |
Re: Generating the ChangeLog files from the commit messages |
Date: |
Fri, 21 Nov 2014 18:21:06 +0100 |
User-agent: |
Gnus/5.13001 (Ma Gnus v0.10) Emacs/24.3.91 (gnu/linux) |
Eli Zaretskii writes:
>> From: David Engster <address@hidden>
>> Cc: address@hidden, address@hidden, address@hidden
>> Date: Fri, 21 Nov 2014 17:19:30 +0100
>>
>> Just go through the log and in your mind strip all the generated
>> stuff (like filenames and affected symbols), and see what
>> information provided by the *author* actually remains - it's usually
>> very little, and often stating the obvious, instead of saying *why*
>> something was done.
>
> That's not what ChangeLog is supposed to tell.
We're in violent agreement here.
>> This makes our commit logs mostly useless for actually understanding how
>> code evolved.
>
> It's not intended for that. The 'annotate' commands are for that.
Yes. As I've written: we should improve the output of 'l' in an
annotated file from the Emacs repo: commit logs should tell why
something was done.
Anyway, I'm repeating myself, let's just disagree and drop this. It's
not like this is gonna change anytime soon.
-David
- Re: Generating the ChangeLog files from the commit messages, (continued)
- Re: Generating the ChangeLog files from the commit messages, Bastien, 2014/11/20
- Re: Generating the ChangeLog files from the commit messages, Bastien, 2014/11/20
- Re: Generating the ChangeLog files from the commit messages, Bastien, 2014/11/20
- Re: Generating the ChangeLog files from the commit messages, David Engster, 2014/11/19
- Re: Generating the ChangeLog files from the commit messages, Stefan Monnier, 2014/11/19
- Re: Generating the ChangeLog files from the commit messages, David Engster, 2014/11/19
- Re: Generating the ChangeLog files from the commit messages, Eli Zaretskii, 2014/11/21
- Re: Generating the ChangeLog files from the commit messages, David Engster, 2014/11/21
- Re: Generating the ChangeLog files from the commit messages, Eli Zaretskii, 2014/11/21
- Re: Generating the ChangeLog files from the commit messages, Stefan Monnier, 2014/11/21
- Re: Generating the ChangeLog files from the commit messages,
David Engster <=
- Re: Include necessary git tools in the Emacs distribution?, David Engster, 2014/11/19