[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Changelogs and bug closing



> Joey Hess asks me:
> > Is associating changelog entries and the bugs they close really
> > important? If the maintainer feels it's not clear which entries of the
> > changelog close which bugs, he can always refer to the bug numbers
> > in the changelog.
> 
> Yes, I think it is important.  If several bugs are closed in the same
> upload then if you only see the upload announcement you can't find the
> relevant bug easily to check up on things.  It will _always_ be
> unclear which entries in the changelog close which bugs, because the
> bugs are just numbers.  You'll end up with the same information - the
> bug numbers - appearing twice, once with meaning for computers (in the
> closes entry at the top of the change entry) and once with meaning for
> humans (in the changelog text).  This is almost always a bad idea.
How about having as many "Closes:" as necessary (one per bug or set of related
bugs) and a short explanation in brackets?

Closes: #... (Explanation)

Luis.
-- 
Luis Francisco Gonzalez <luisgh@cogs.susx.ac.uk>
PGP Fingerprint = F8 B1 13 DE 22 22 94 A1  14 BE 95 8E 49 39 78 76


Reply to: