From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#29420: 26.0; doc of `list-packages' Date: Fri, 24 Nov 2017 09:02:46 -0800 (PST) Message-ID: References: <> <<838tevafus.fsf@gnu.org>> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1511543014 9240 195.159.176.226 (24 Nov 2017 17:03:34 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 24 Nov 2017 17:03:34 +0000 (UTC) Cc: 29420@debbugs.gnu.org To: Eli Zaretskii , Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Nov 24 18:03:26 2017 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1eIHNp-0001X8-7H for geb-bug-gnu-emacs@m.gmane.org; Fri, 24 Nov 2017 18:03:21 +0100 Original-Received: from localhost ([::1]:50351 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eIHNw-0000y2-NK for geb-bug-gnu-emacs@m.gmane.org; Fri, 24 Nov 2017 12:03:28 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52328) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eIHNX-0000hc-Ni for bug-gnu-emacs@gnu.org; Fri, 24 Nov 2017 12:03:05 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eIHNW-0005Hm-Kj for bug-gnu-emacs@gnu.org; Fri, 24 Nov 2017 12:03:03 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:47544) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eIHNW-0005FV-Fu for bug-gnu-emacs@gnu.org; Fri, 24 Nov 2017 12:03:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1eIHNW-0004HQ-4P for bug-gnu-emacs@gnu.org; Fri, 24 Nov 2017 12:03:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 24 Nov 2017 17:03:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 29420 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 29420-submit@debbugs.gnu.org id=B29420.151154297616433 (code B ref 29420); Fri, 24 Nov 2017 17:03:02 +0000 Original-Received: (at 29420) by debbugs.gnu.org; 24 Nov 2017 17:02:56 +0000 Original-Received: from localhost ([127.0.0.1]:56224 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eIHNQ-0004Gz-E9 for submit@debbugs.gnu.org; Fri, 24 Nov 2017 12:02:56 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:35829) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eIHNO-0004Gm-TK for 29420@debbugs.gnu.org; Fri, 24 Nov 2017 12:02:55 -0500 Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id vAOH2m72009363 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 24 Nov 2017 17:02:49 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id vAOH2muv006022 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 24 Nov 2017 17:02:48 GMT Original-Received: from abhmp0006.oracle.com (abhmp0006.oracle.com [141.146.116.12]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id vAOH2lMB003069; Fri, 24 Nov 2017 17:02:48 GMT In-Reply-To: <<838tevafus.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4615.0 (x86)] X-Source-IP: userv0021.oracle.com [156.151.31.71] 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: 208.118.235.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:140319 Archived-At: > > `C-h f list-packages' should give you a better description of the > > display that results. It wouldn't hurt to succinctly describe each > > column. >=20 > I added the list of columns. Thanks. > > `C-h r g package menu' should give you a better description. > > It should describe each column of the display. >=20 > 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). =20 > > It could describe column `status' better, for instance. Apparently > > one of the possible values is `dependency', but that is not > > mentioned. >=20 > 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. > Thanks. Thank you.