[Pm-utils] Fwd: [PATCH 1/1] Generate ChangeLog on demand.

[Victor Lowther]

On Sun, Mar 09, 2008 at 03:37:23PM +0100, Michael Biebl wrote:
> 2008/3/9, Sjoerd Simons <sjoerd at luon.net>:
> > On Sun, Mar 09, 2008 at 03:14:40PM +0100, Michael Biebl wrote:
> >  > Forgot to CC the mailing list.
> >  >
> >  > ---------- Forwarded message ----------
> >  > From: Michael Biebl <mbiebl at gmail.com>
> >  > Date: 09.03.2008 15:14
> >  > Subject: Re: [Pm-utils] [PATCH 1/1] Generate ChangeLog on demand.
> >  > To: Victor Lowther <victor.lowther at gmail.com>
> >  >
> >  >
> >  > 2008/3/6, Victor Lowther <victor.lowther at gmail.com>:
> >  >
> >  > > Since git has very fast log creation aand we imported the entire revision
> >  >  >  history from CVS, we can generate ChangeLog on demand instead of having to
> >  >  >  track it.
> >  >
> >  >
> >  > Problem is, a generated Changelog will never be as clean as a hand written
> >  > one.  It will contain a lot of noise and be less well formatted.
> >
> >
> > Otoh changelogs are redundant in the presence of decent commit logs and a
> >  source of merge conflicts. As long as everyone realises the commit messages
> >  are important a generated ChangeLog is just as good or even better then a
> >  hand-crafted one.
> >
> 
> Agreed, the merge conflicts are definitely a problem.

The original patch series explicitly discarded merge-related ChangeLog
entries -- I removed that option when dbn expressed concerns on how
available that switch is.  Adding it back would not be a problem,
assuming that we can make it a requirement that the person generating 
the official dist tarball have a git version recent enough to have the 
--no-merges switch.
 
> About the increased "noise" of a generated changelog: Maybe it would
> make sense to provide a NEWS file, which lists the major new
> features/changes of a new release.
> This NEWS file could be written by the maintainer, that prepares the release.
> 
> Michael
> 
> 
> -- 
> Why is it that all of the instruments seeking intelligent life in the
> universe are pointed away from Earth?
> _______________________________________________
> Pm-utils mailing list
> Pm-utils at lists.freedesktop.org
> http://lists.freedesktop.org/mailman/listinfo/pm-utils

-- 
Victor Lowther
Ubuntu Certified Professional