[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Generating ChangeLog files.
From: |
Rüdiger Sonderfeld |
Subject: |
Generating ChangeLog files. |
Date: |
Fri, 03 Jan 2014 10:31:39 +0100 |
User-agent: |
KMail/4.11.3 (Linux/3.11.0-14-generic; KDE/4.11.3; x86_64; ; ) |
On Friday 03 January 2014 08:39:04 Michael Albinus wrote:
> Thierry Volpiatto <address@hidden> writes:
> > Also would be great to stop writing unuseful changelog files.
>
> They are useful. A tar distribution does not contain the git repo with
> the history of commitments.
>
> Another question is, whether we still want to write ChangeLogs manually,
> or whether we want to extract them from commit comments. That's not such
> easy, see all the "fix typo" comments.
I think we should generate the ChangeLogs from commit messages. I know that
one argument raised in the past was that the commit message and ChangeLog can
differ. But I don't see a reason why it shouldn't be possible to have both in
the commit message. Only the ChangeLog part is added to the generated
ChangeLog. This would also allow "fix typo" commits not to be added.
IMO ChangeLogs are an atavism from times when VCS's were not as sophisticated
as today. They cause more problems for developers than they are useful. A
modern VCS provides tools to more easily match changes to commits than
searching a ChangeLog can. They are a pain when merging or rebasing patches.
I usually write patches on a branch and rebase them when they are ready to be
pushed. This always causes merge conflicts for the ChangeLog. (Maybe [1]
could help a bit.)
E.g., GNU Octave replaced ChangeLog with an auto-generated ChangeLog from
commit messages and they seem to be quite happy with that solution.
I know the topic has been discussed several times and it seems a bit pointless
to start the discussion again. But in my opinion ChangeLogs are an even
bigger issue than the VC because at least I can work around the latter by
using git-bzr.
[1]
http://git.savannah.gnu.org/gitweb/?p=gnulib.git;a=blob;f=lib/git-merge-changelog.c
Regards
Rüdiger
- Re: PROPOSAL: Move to git, now that bzr is no longer a req., (continued)
- Re: PROPOSAL: Move to git, now that bzr is no longer a req., Bastien, 2014/01/03
- Re: PROPOSAL: Move to git, now that bzr is no longer a req., Rüdiger Sonderfeld, 2014/01/03
- Re: PROPOSAL: Move to git, now that bzr is no longer a req., Daniel Colascione, 2014/01/03
- Re: PROPOSAL: Move to git, now that bzr is no longer a req., Eli Zaretskii, 2014/01/03
- Re: PROPOSAL: Move to git, now that bzr is no longer a req., Stephen J. Turnbull, 2014/01/03
- Re: PROPOSAL: Move to git, now that bzr is no longer a req., Bastien, 2014/01/03
- Re: PROPOSAL: Move to git, now that bzr is no longer a req., Tassilo Horn, 2014/01/03
- Generating ChangeLog files.,
Rüdiger Sonderfeld <=
- Re: Generating ChangeLog files., Eli Zaretskii, 2014/01/03
- Re: Generating ChangeLog files., Bozhidar Batsov, 2014/01/03
- Re: Generating ChangeLog files., Juanma Barranquero, 2014/01/03
- Re: Generating ChangeLog files., Stefan Monnier, 2014/01/03
- Re: Generating ChangeLog files., Kenichi Handa, 2014/01/03
- Re: Generating ChangeLog files., Paul Eggert, 2014/01/03
- Re: Generating ChangeLog files., Richard Stallman, 2014/01/05
- Re: Generating ChangeLog files., Eli Zaretskii, 2014/01/04
- Re: PROPOSAL: Move to git, now that bzr is no longer a req., Stefan Monnier, 2014/01/03
- Re: PROPOSAL: Move to git, now that bzr is no longer a req., Bastien, 2014/01/04