From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: installed packages long description. Date: Sun, 09 Dec 2018 11:38:59 -0500 Message-ID: References: <868t14kazo.fsf@stephe-leake.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1544373433 18549 195.159.176.226 (9 Dec 2018 16:37:13 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 9 Dec 2018 16:37:13 +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 Sun Dec 09 17:37:09 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 1gW24q-0004jj-Uy for ged-emacs-devel@m.gmane.org; Sun, 09 Dec 2018 17:37:09 +0100 Original-Received: from localhost ([::1]:55910 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gW26x-0000Yb-FJ for ged-emacs-devel@m.gmane.org; Sun, 09 Dec 2018 11:39:19 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54714) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gW26r-0000YL-S9 for emacs-devel@gnu.org; Sun, 09 Dec 2018 11:39:14 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gW26o-0001NR-MM for emacs-devel@gnu.org; Sun, 09 Dec 2018 11:39:13 -0500 Original-Received: from [195.159.176.226] (port=33046 helo=blaine.gmane.org) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gW26o-0001Lz-F7 for emacs-devel@gnu.org; Sun, 09 Dec 2018 11:39:10 -0500 Original-Received: from list by blaine.gmane.org with local (Exim 4.84_2) (envelope-from ) id 1gW24e-0004Se-OM for emacs-devel@gnu.org; Sun, 09 Dec 2018 17:36:56 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 23 Original-X-Complaints-To: usenet@blaine.gmane.org Cancel-Lock: sha1:OfHFozPLixS6h3OsbAonJo+8MN0= 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:231735 Archived-At: > I see two solutions; describe-package can also look for README or the > Commentary comment header, or package-install can always populate > ~/.emacs.d/elpa/-readme.txt Another is to look for a corresponding package in the archives and download its readme file. > preferences? The ELPA standard doesn't say how/where to find the description within the package: the -readme.txt served via HTTP is the only documented/official way to get the description (the README file and the Commentary sections are just what existing archives tend to use in their own package-building scripts). While we can come up with a short-term solution, I think in the long run we should try and improve the ELPA standard in this respect, e.g. by specifying where the description can be found within the package (and also by specifying some kind of markup for this description rather than being limited to plain text). Stefan