Re: Another changelog rant
On Tue, Jul 17, 2001 at 09:18:49PM -0400, Matt Zimmerman wrote:
> > > Where would be a good place to recommend this where it would get some
> > > attention? It doesn't seem to fit in the developer's reference, because it
> > > relates specifically to packaging,
> >
> > Ahem. You need to read 11.4 "When bugs are closed by new uploads".
>
> I understand what the (Closes: #bug) syntax is for; I use it all the time.
> It is meant to complement proper changelog entries, to automatically close
> bugs. It is not a substitute for listing the changes that were made.
>
> bad: "Applied patch from Joe Schmo (Closes: #bug)
> bad: "Modified the configuration file (Closes: #bug)
>
> good: "Applied patch from Joe Schmo to warve the fleeble option (Closes: #bug)
> good: "Commented out the brillig directive in /etc/blarg.conf (Closes: #bug)"
>
> Persons reading the changelog should not have to access the BTS in order
> to learn what changes were actually made to the package.
You misunderstood my post: I meant that what you are suggesting fits in the
developers' reference because doing changelog entries that relate to bugs is
already described there.
--
Digital Electronic Being Intended for Assassination and Nullification
Reply to: