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

Re: Horrific new levels of changelog abuse

On Wed, Sep 17, 2003 at 03:58:13PM -0500, Adam Heath wrote:
> As an example of how a nice changelog is written, see below the recently
> uploaded changelog for dpkg 1.10.11.

I have a cosmetic nitpick:  :)

> dpkg (1.10.11) unstable; urgency=low
>   * Frank Lichtenheld <frank@lichtenheld.de>:
>     Apply patch, to handle missing infodir.bak, and empty files.  Closes:
>     #196361
>   * Andrew Suffield <asuffield@debian.org>:
>     Fix inverted test of eof in parsedb, while looking for eof after
>     field name.  Closes: #198218

I found these hard to scan visually.  I think it's probably because of
the erratic right margin caused by breaking line after the submitter's
email adddress regardless of whether any of the trailing text can fit on
the rest of the line.

I wouldn't mention this except that I had to pause and think about why I
was consciously aware of not being able to read your changelog entry as
fast as I read other peoples'.

Just a suggestion; if you don't like it, I guess I'll just read your
changelogs more slowly in the future.

Thanks for your exemplary care in making changelog entries that are
useful for more than just auto-closing bugs.  I noticed from the latest
kaffe upload that Ean Schuessler still doesn't get it.  I guess he
doesn't feel it's the package maintainer's responsibility to retitle a
bug report that was given a shitty title by the submitter.

In fact I wonder what, exactly, Ean thinks a Debian package maintainer
*is* responsible for.

G. Branden Robinson                |     The power of accurate observation
Debian GNU/Linux                   |     is frequently called cynicism by
branden@debian.org                 |     those who don't have it.
http://people.debian.org/~branden/ |     -- George Bernard Shaw

Attachment: signature.asc
Description: Digital signature

Reply to: