From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#29420: 26.0; doc of `list-packages' Date: Sat, 19 Oct 2019 04:04:21 +0200 Message-ID: References: Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="00000000000018ee70059539dfaf" Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="24865"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 29420@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Oct 19 04:05:22 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iLe7D-0005wA-RC for geb-bug-gnu-emacs@m.gmane.org; Sat, 19 Oct 2019 04:05:11 +0200 Original-Received: from localhost ([::1]:47820 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iLe7C-0002WU-04 for geb-bug-gnu-emacs@m.gmane.org; Fri, 18 Oct 2019 22:05:10 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:45062) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iLe75-0002WF-GO for bug-gnu-emacs@gnu.org; Fri, 18 Oct 2019 22:05:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iLe74-0005O4-Gj for bug-gnu-emacs@gnu.org; Fri, 18 Oct 2019 22:05:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:42935) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iLe74-0005O0-Dk for bug-gnu-emacs@gnu.org; Fri, 18 Oct 2019 22:05:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iLe74-0003Oc-6n for bug-gnu-emacs@gnu.org; Fri, 18 Oct 2019 22:05:02 -0400 X-Loop: help-debbugs@gnu.org In-Reply-To: Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 19 Oct 2019 02:05:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 29420 X-GNU-PR-Package: emacs Original-Received: via spool by 29420-submit@debbugs.gnu.org id=B29420.157145068713029 (code B ref 29420); Sat, 19 Oct 2019 02:05:02 +0000 Original-Received: (at 29420) by debbugs.gnu.org; 19 Oct 2019 02:04:47 +0000 Original-Received: from localhost ([127.0.0.1]:51756 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iLe6n-0003O4-RC for submit@debbugs.gnu.org; Fri, 18 Oct 2019 22:04:46 -0400 Original-Received: from mail-pf1-f181.google.com ([209.85.210.181]:45515) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iLe6g-0003NT-60 for 29420@debbugs.gnu.org; Fri, 18 Oct 2019 22:04:39 -0400 Original-Received: by mail-pf1-f181.google.com with SMTP id y72so4894903pfb.12 for <29420@debbugs.gnu.org>; Fri, 18 Oct 2019 19:04:38 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to:cc; bh=w8YcaAxO9o1gMI6HHsBGBitFuc1qnWCSOw1Gza+YMvQ=; b=IwhUS7H6kUTkzS5CLv0IRmOTkcGHyYm+OWlzeGWlphGHaUq4S0lNXB92uEVikgnqd2 HJZKg5lx/k753ek3goJSobTtcQRHkc5YWICv5TmCNP9/lIQbvti0BeQi3SeT6YMxh4x5 u6QRiW12XS6EY5oIkYUuOb22dNp/KOIwLLZR1mfSfuOLkLbq++VC+DBTF3l6xLusOLXK EKYcwdW7QbuKc0sd31icOhmXriCZgMiltx84CSBbS/1ewUQqjBkSGfj9VXEXAPudZJRG swaIngJP6yskUXBBB8xcPwskiFsXrCww7K/FbpMQEEHVeuUgg1Pxh9zYGFad/dHQae+w OAqQ== X-Gm-Message-State: APjAAAXNAQh8r3Zffb3WDYyzhXvU3EvPEggQuFFA9Z32WO/23AjjlO1p ay7G4Dvbu/zGyBnbEmYr72mz520aOfm+GHnXXdI= X-Google-Smtp-Source: APXvYqw+o0mCFmG6EBTciTvvK0akZM8lJ4UPN/QyNErhyA9gZlTQsnIn7DazWQa3qT20FUnc9ZuDluOElXX9IQ1bdr8= X-Received: by 2002:aa7:8652:: with SMTP id a18mr9893781pfo.190.1571450672166; Fri, 18 Oct 2019 19:04:32 -0700 (PDT) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:169692 Archived-At: --00000000000018ee70059539dfaf Content-Type: text/plain; charset="UTF-8" tags 29420 + patch quit Drew Adams writes: >> > `C-h r g package menu' should give you a better description. >> > It should describe each column of the display. >> >> It does that already. > > It does, but the next sentence details the problem > with that description: nothing about `dependency', > for example (dunno whether there are other problems > with the columns description). > >> > It could describe column `status' better, for instance. Apparently >> > one of the possible values is `dependency', but that is not >> > mentioned. >> >> Patches to improve the documentation of package.el in the manual are >> most welcome. I generally find its documentation inadequate and >> outdated, and tried to improve that as best I could, but I don't know >> enough about it to do a better job, and apparently (and sadly) no one >> else is interested. > > I know (and likely care) less about the package system > than you. Neither of us is well placed, probably, to > help much in this regard. > > I do appreciate your attempts to solicit strong doc > along with new developments. The package system > slipped between the cracks to some extent in this > regard, I guessed. A guess is that when a large > set of code gets developed outside Emacs first > it can get added to Emacs all at once, and the doc > isn't necessarily gone over with a fine-tooth comb, > in spite of your best efforts. > > I agree that it would be great if Someone (TM) gave > the package.el doc some more attention. Please see the attached patch which extends the documentation to cover all possible package statuses. Any comments? Best regards, Stefan Kangas --00000000000018ee70059539dfaf Content-Type: application/octet-stream; name="0001-Document-package-statuses-better.patch" Content-Disposition: attachment; filename="0001-Document-package-statuses-better.patch" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_k1wx40ht0 RnJvbSA0ODM4OTQyYjRlNzM2ZmY4OWMxNGY1MTllN2M1MjQ0YmQzODJkNTI0IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBTdGVmYW4gS2FuZ2FzIDxzdGVmYW5rYW5nYXNAZ21haWwuY29t PgpEYXRlOiBTYXQsIDE5IE9jdCAyMDE5IDAzOjU2OjQxICswMjAwClN1YmplY3Q6IFtQQVRDSF0g RG9jdW1lbnQgcGFja2FnZSBzdGF0dXNlcyBiZXR0ZXIKCiogZG9jL2VtYWNzL3BhY2thZ2UudGV4 aSAoUGFja2FnZSBNZW51KTogRXh0ZW5kIGRvY3VtZW50YXRpb24gdG8KY292ZXIgYWxsIHBvc3Np YmxlIHBhY2thZ2Ugc3RhdHVzZXMuICAoQnVnIzI5NDIwKQotLS0KIGRvYy9lbWFjcy9wYWNrYWdl LnRleGkgfCAzMyArKysrKysrKysrKysrKysrKysrKysrKysrKystLS0tLS0KIDEgZmlsZSBjaGFu Z2VkLCAyNyBpbnNlcnRpb25zKCspLCA2IGRlbGV0aW9ucygtKQoKZGlmZiAtLWdpdCBhL2RvYy9l bWFjcy9wYWNrYWdlLnRleGkgYi9kb2MvZW1hY3MvcGFja2FnZS50ZXhpCmluZGV4IGQ5NzY0OGFm MWIuLjFkMjMxNThkNTkgMTAwNjQ0Ci0tLSBhL2RvYy9lbWFjcy9wYWNrYWdlLnRleGkKKysrIGIv ZG9jL2VtYWNzL3BhY2thZ2UudGV4aQpAQCAtNjQsMTMgKzY0LDM0IEBAIFBhY2thZ2UgTWVudQog Y2Fubm90IGJlIGRlbGV0ZWQgdGhyb3VnaCB0aGUgcGFja2FnZSBtZW51LCBhbmQgYXJlIG5vdCBj b25zaWRlcmVkIGZvcgogdXBncmFkaW5nLgogCi1UaGUgc3RhdHVzIGNhbiBhbHNvIGJlIEBzYW1w e25ld30uICBUaGlzIGlzIGVxdWl2YWxlbnQgdG8KLUBzYW1we2F2YWlsYWJsZX0sIGV4Y2VwdCB0 aGF0IGl0IG1lYW5zIHRoZSBwYWNrYWdlIGJlY2FtZSBuZXdseQotYXZhaWxhYmxlIG9uIHRoZSBw YWNrYWdlIGFyY2hpdmUgYWZ0ZXIgeW91ciBsYXN0IGludm9jYXRpb24gb2YKLUBrYmR7TS14IGxp c3QtcGFja2FnZXN9LiAgSW4gb3RoZXIgaW5zdGFuY2VzLCBhIHBhY2thZ2UgbWF5IGhhdmUgdGhl Ci1zdGF0dXMgQHNhbXB7aGVsZH0sIEBzYW1we2Rpc2FibGVkfSwgb3IgQHNhbXB7b2Jzb2xldGV9 LgorVGhlIHN0YXR1cyBAc2FtcHtkZXBlbmRlbmN5fSBtZWFucyB0aGF0IHRoZSBwYWNrYWdlIHdh cyBhdXRvbWF0aWNhbGx5CitpbnN0YWxsZWQgdG8gc2F0aXNmeSBhIGRlcGVuZGVuY3kgb2YgYW5v dGhlciBwYWNrYWdlLgorCitUaGUgc3RhdHVzIEBzYW1we25ld30gaXMgZXF1aXZhbGVudCB0byBA c2FtcHthdmFpbGFibGV9LCBleGNlcHQgdGhhdAoraXQgbWVhbnMgdGhlIHBhY2thZ2UgYmVjYW1l IG5ld2x5IGF2YWlsYWJsZSBvbiB0aGUgcGFja2FnZSBhcmNoaXZlCithZnRlciB5b3VyIGxhc3Qg aW52b2NhdGlvbiBvZiBAa2Jke00teCBsaXN0LXBhY2thZ2VzfS4KKworVGhlIHN0YXR1cyBAc2Ft cHtpbmNvbXBhdH0gbWVhbnMgdGhhdCB0aGUgcGFja2FnZSBjYW5ub3QgYmUgaW5zdGFsbGVkCitm b3Igc29tZSByZWFzb24sIGZvciBleGFtcGxlIGJlY2F1c2UgaXQgZGVwZW5kcyBvbiB1bmluc3Rh bGxhYmxlCitwYWNrYWdlcy4KKworVGhlIHN0YXR1cyBAc2FtcHtvYnNvbGV0ZX0gbWVhbnMgdGhh dCB0aGUgcGFja2FnZSBpcyBhbiBvdXRkYXRlZAoraW5zdGFsbGVkIHZlcnNpb247IGluIGFkZGl0 aW9uIHRvIHRoaXMgdmVyc2lvbiwgYSBuZXdlciB2ZXJzaW9uIGlzCithbHJlYWR5IGluc3RhbGxl ZC4KKworVGhlIHN0YXR1cyBAc2FtcHthdmFpbC1vYnNvfSBtZWFucyB0aGF0IHRoZSBwYWNrYWdl IGlzIGF2YWlsYWJsZSBmb3IKK2luc3RhbGxhdGlvbiwgYnV0IHRoZXJlIGFsc28gZXhpc3RzIGEg bmV3ZXIgdmVyc2lvbi4KKworVGhlIHN0YXR1cyBAc2FtcHtkaXNhYmxlZH0gbWVhbnMgdGhhdCB0 aGUgcGFja2FnZSBoYXMgYmVlbiBkaXNhYmxlZAordXNpbmcgdGhlIHZhcmlhYmxlIGBwYWNrYWdl LWxvYWQtbGlzdCcuCisKK0ZpbmFsbHksIGEgcGFja2FnZSBtYXkgaGF2ZSB0aGUgc3RhdHVzIEBz YW1we2hlbGR9LgogQHhyZWZ7UGFja2FnZSBJbnN0YWxsYXRpb259LgogCitAaXRlbQorV2hpY2gg cGFja2FnZSBhcmNoaXZlIHRoaXMgcGFja2FnZSBpcyBmcm9tLCBpZiB5b3UgaGF2ZSBtb3JlIHRo YW4gb25lCitwYWNrYWdlIGFyY2hpdmUuCisKIEBpdGVtCiBBIHNob3J0IGRlc2NyaXB0aW9uIG9m IHRoZSBwYWNrYWdlLgogQGVuZCBpdGVtaXplCkBAIC0xMjMsNyArMTQ0LDcgQEAgUGFja2FnZSBN ZW51CiBNYXJrIGFsbCBwYWNrYWdlIHdpdGggYSBuZXdlciBhdmFpbGFibGUgdmVyc2lvbiBmb3Ig dXBncmFkaW5nCiAoQGNvZGV7cGFja2FnZS1tZW51LW1hcmstdXBncmFkZXN9KS4gIFRoaXMgcGxh Y2VzIGFuIGluc3RhbGxhdGlvbiBtYXJrCiBvbiB0aGUgbmV3IGF2YWlsYWJsZSB2ZXJzaW9ucywg YW5kIGEgZGVsZXRpb24gbWFyayBvbiB0aGUgb2xkCi1pbnN0YWxsZWQgdmVyc2lvbnMuCitpbnN0 YWxsZWQgdmVyc2lvbnMgKG1hcmtlZCB3aXRoIHN0YXR1cyBAc2FtcHtvYnNvbGV0ZX0pLgogCiBA aXRlbSB4CiBAdmluZGV4IHBhY2thZ2UtbWVudS1hc3luYwotLSAKMi4yMy4wCgo= --00000000000018ee70059539dfaf--