From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eric Abrahamsen Newsgroups: gmane.emacs.devel Subject: Re: Support for bringing package change logs to the user's attention Date: Fri, 25 May 2018 09:40:27 -0700 Message-ID: <87in7belj8.fsf@ericabrahamsen.net> References: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1527266703 11672 195.159.176.226 (25 May 2018 16:45:03 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 25 May 2018 16:45:03 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri May 25 18:44:59 2018 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fMFpp-0002sm-50 for ged-emacs-devel@m.gmane.org; Fri, 25 May 2018 18:44:57 +0200 Original-Received: from localhost ([::1]:45849 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fMFrw-00037Q-33 for ged-emacs-devel@m.gmane.org; Fri, 25 May 2018 12:47:08 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57047) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fMFoP-0000HA-Bi for emacs-devel@gnu.org; Fri, 25 May 2018 12:43:30 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fMFoL-0000ZA-CC for emacs-devel@gnu.org; Fri, 25 May 2018 12:43:29 -0400 Original-Received: from [195.159.176.226] (port=52227 helo=blaine.gmane.org) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fMFoL-0000YS-4l for emacs-devel@gnu.org; Fri, 25 May 2018 12:43:25 -0400 Original-Received: from list by blaine.gmane.org with local (Exim 4.84_2) (envelope-from ) id 1fMFmA-00070q-WA for emacs-devel@gnu.org; Fri, 25 May 2018 18:41:10 +0200 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 29 Original-X-Complaints-To: usenet@blaine.gmane.org Cancel-Lock: sha1:zbtKE0EDXR7uE4f6mRokkE7HLOw= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 195.159.176.226 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:225711 Archived-At: Christopher Done writes: > Hi all, > > As the author and maintainer of several Emacs Lisp packages, I'd like > to > discuss how change logs are brought to the user's attention. [...] The package format section of the README in Elpa already mentions: - A "News:" section (or "NEWS" file) can/should be used to list the user-visible changes of each version. It's not clear to me that anything is actually done with that information. The relevant parsing function, if there were one, would be in lisp-mnt.el, but it doesn't look like anything currently exists. But if this were done, it would be good to stick to the News:/NEWS convention, and add something to lisp-mnt.el that finds that (some of the utility functions already in that file will make it easier). It might not be necessarily to write a seen.el file: the package update mechanism could maybe keep track of what version is being uninstalled as the new one is installed, and then show the news that corresponds to the diff. When updating many packages at once, it could collect news from each one and show them in a single buffer. Eric