Debian Bug report logs - #646622
apt-listchanges: please parse upstream changelog, too (perhaps with packages' help)

version graph

Package: apt-listchanges; Maintainer for apt-listchanges is Sandro Tosi <morph@debian.org>; Source for apt-listchanges is src:apt-listchanges.

Reported by: Nemo Inis <nemoinis@hotmail.com>

Date: Tue, 25 Oct 2011 19:51:01 UTC

Severity: wishlist

Found in version apt-listchanges/2.85.8

Reply or subscribe to this bug.

Toggle useless messages

View this report as an mbox folder, status mbox, maintainer mbox


Report forwarded to debian-bugs-dist@lists.debian.org, nemoinis@hotmail.com, Debian Maintainer Keyring Team <debian-maintainers@nm.debian.org>:
Bug#646622; Package debian-maintainers. (Tue, 25 Oct 2011 19:51:04 GMT) Full text and rfc822 format available.

Acknowledgement sent to Nemo Inis <nemoinis@hotmail.com>:
New Bug report received and forwarded. Copy sent to nemoinis@hotmail.com, Debian Maintainer Keyring Team <debian-maintainers@nm.debian.org>. (Tue, 25 Oct 2011 19:51:04 GMT) Full text and rfc822 format available.

Message #5 received at submit@bugs.debian.org (full text, mbox):

From: Nemo Inis <nemoinis@hotmail.com>
To: Debian Bug Tracking System <submit@bugs.debian.org>
Subject: debian-maintainers: Changelog for new upstream release should include summary of upstream changelog
Date: Tue, 25 Oct 2011 12:50:02 -0700
Package: debian-maintainers
Severity: wishlist

Dear Maintainer,

(first thank you all for the tremendous job you are doing!)

I have a suggestion from an end-user point of view:

All too often when checking incoming updates (in Synaptic or other tools) the
Debian changelog includes a mere mention "new upstream release".
>From an end-user point of view, this is not very informative and less than
useful in deciding whether or not the update should be installed at this time.
I know that section 9.3 of the Debian New Maintainer's guide only requires
listing the debian bugs that are closed by the new release (or by the
maintainer's changes to that new release) and not anything else that may be in
that new release .  But for the convenience of the end-user, it would be nice
if a summary of the upstream's changelog would be included too (like new
features, UI changes, backward compatibility problems, etc..) This would avoid
having to go hunt for it on every single package, and would make the whole
process more user-friendly.

Thanks, and sorry if this was not the right place to report this - I could not
find a better fit.



-- System Information:
Debian Release: wheezy/sid
  APT prefers testing
  APT policy: (500, 'testing'), (500, 'stable')
Architecture: i386 (i686)

Kernel: Linux 3.0.0-1-686-pae (SMP w/2 CPU cores)
Locale: LANG=en_US.utf8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash




Bug reassigned from package 'debian-maintainers' to 'general'. Request was from Enrico Zini <enrico@debian.org> to control@bugs.debian.org. (Tue, 25 Oct 2011 19:57:05 GMT) Full text and rfc822 format available.

Information forwarded to debian-bugs-dist@lists.debian.org, debian-devel@lists.debian.org:
Bug#646622; Package general. (Tue, 29 Nov 2011 09:48:17 GMT) Full text and rfc822 format available.

Acknowledgement sent to Jonathan Nieder <jrnieder@gmail.com>:
Extra info received and forwarded to list. Copy sent to debian-devel@lists.debian.org. (Tue, 29 Nov 2011 09:48:21 GMT) Full text and rfc822 format available.

Message #12 received at 646622@bugs.debian.org (full text, mbox):

From: Jonathan Nieder <jrnieder@gmail.com>
To: Nemo Inis <nemoinis@hotmail.com>
Cc: 646622@bugs.debian.org, apt-listchanges@packages.debian.org
Subject: Re: Changelog for new upstream release should include summary of upstream changelog
Date: Tue, 29 Nov 2011 03:45:32 -0600
retitle 646622 apt-listchanges: please parse upstream changelog, too (perhaps with packages' help)
reassign 646622 apt-listchanges 2.85.8
quit

Hi,

Nemo Inis wrote:

> I have a suggestion from an end-user point of view:
>
> All too often when checking incoming updates (in Synaptic or other tools) the
> Debian changelog includes a mere mention "new upstream release".
[...]
> But for the convenience of the end-user, it would be nice
> if a summary of the upstream's changelog would be included too (like new
> features, UI changes, backward compatibility problems, etc..) This would avoid
> having to go hunt for it on every single package, and would make the whole
> process more user-friendly.

The package you are looking for is debian-policy.  But I am going to
assign this report to apt-listchanges instead --- if apt-listchanges
could parse upstream changelogs (with maintainer help), then there
would be no need for a summary in the Debian changelog except when a
particularly notable upstream change has appeared.

I can imagine two different ways to do that:

 A. Encourage packagers to provide a metadata file with the following
    information:

	format: the upstream changelog format.  The value is the name
	of a changelog parsing helper fulfilling the
	dpkg-parsechangelog interface, like the argument to
	"dpkg-parsechangelog -F"

	dversionmangle: a rule to map from the upstream component of
	the Debian version to an upstream version number, just like in
	uscan's "debian/watch" file.

    Or:

 B. Maintain state out-of-band to indicate how much of the upstream
    changelog has been read.  E.g., keep the top few lines read and
    total number of lines, and for each new version we look for lines
    similar to those lines the indicated number of lines from the end
    of the file to decide where the new changelog entries stop.

Sane?

Thanks and hope that helps,
Jonathan




Changed Bug title to 'apt-listchanges: please parse upstream changelog, too (perhaps with packages' help)' from 'debian-maintainers: Changelog for new upstream release should include summary of upstream changelog' Request was from Jonathan Nieder <jrnieder@gmail.com> to control@bugs.debian.org. (Tue, 29 Nov 2011 09:48:30 GMT) Full text and rfc822 format available.

Bug reassigned from package 'general' to 'apt-listchanges'. Request was from Jonathan Nieder <jrnieder@gmail.com> to control@bugs.debian.org. (Tue, 29 Nov 2011 09:48:32 GMT) Full text and rfc822 format available.

Bug Marked as found in versions apt-listchanges/2.85.8. Request was from Jonathan Nieder <jrnieder@gmail.com> to control@bugs.debian.org. (Tue, 29 Nov 2011 09:48:33 GMT) Full text and rfc822 format available.

Send a report that this bug log contains spam.


Debian bug tracking system administrator <owner@bugs.debian.org>. Last modified: Wed Apr 16 19:53:40 2014; Machine Name: buxtehude.debian.org

Debian Bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.