From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#29420: 26.0; doc of `list-packages' Date: Sun, 20 Oct 2019 18:58:01 +0300 Message-ID: <83zhhv4dfa.fsf@gnu.org> References: <83zhhx6xsr.fsf@gnu.org> Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="266590"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 29420@debbugs.gnu.org To: Stefan Kangas Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Oct 20 17:59:14 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 1iMDbt-0017DP-Nl for geb-bug-gnu-emacs@m.gmane.org; Sun, 20 Oct 2019 17:59:13 +0200 Original-Received: from localhost ([::1]:39318 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iMDbs-0000sh-Fv for geb-bug-gnu-emacs@m.gmane.org; Sun, 20 Oct 2019 11:59:12 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:58672) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iMDbj-0000sE-3l for bug-gnu-emacs@gnu.org; Sun, 20 Oct 2019 11:59:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iMDbh-0000Zu-VE for bug-gnu-emacs@gnu.org; Sun, 20 Oct 2019 11:59:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:46321) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iMDbh-0000Zp-Rw for bug-gnu-emacs@gnu.org; Sun, 20 Oct 2019 11:59:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iMDbh-0006D1-PO for bug-gnu-emacs@gnu.org; Sun, 20 Oct 2019 11:59:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 20 Oct 2019 15:59:01 +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: patch Original-Received: via spool by 29420-submit@debbugs.gnu.org id=B29420.157158710023816 (code B ref 29420); Sun, 20 Oct 2019 15:59:01 +0000 Original-Received: (at 29420) by debbugs.gnu.org; 20 Oct 2019 15:58:20 +0000 Original-Received: from localhost ([127.0.0.1]:55142 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iMDb1-0006Bz-Iw for submit@debbugs.gnu.org; Sun, 20 Oct 2019 11:58:19 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:49555) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iMDb0-0006Be-35 for 29420@debbugs.gnu.org; Sun, 20 Oct 2019 11:58:18 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:50086) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1iMDau-0000Mz-J6; Sun, 20 Oct 2019 11:58:12 -0400 Original-Received: from [176.228.60.248] (port=1535 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1iMDat-0008Mj-4Y; Sun, 20 Oct 2019 11:58:12 -0400 In-reply-to: (message from Stefan Kangas on Sun, 20 Oct 2019 17:42:09 +0200) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:169828 Archived-At: > From: Stefan Kangas > Date: Sun, 20 Oct 2019 17:42:09 +0200 > Cc: Drew Adams , 29420@debbugs.gnu.org > > Thanks. I decided to add a new section to not make the "Package Menu" > node too cluttered. What do you think? It should rather be a subsection of "Package Menu", since that's where you talk about 'status', and it should follow "Package Menu". Otherwise, in the printed manual, the text which starts "Package Status" will come out of the blue, with nothing to connect it to the previous or the next section. > +or @samp{built-in} (included in Emacs by default). For more > +details, @xref{Package Status}. @xref produces a capitalize "See", so it is inappropriate in the middle of a sentence. You want "see @ref" here. > + > +@item > +Which package archive this package is from, if you have more than one > +package archive. > > @item > A short description of the package. > @@ -123,7 +117,7 @@ Package Menu > Mark all package with a newer available version for upgrading > (@code{package-menu-mark-upgrades}). This places an installation mark > on the new available versions, and a deletion mark on the old > -installed versions. > +installed versions (marked with status @samp{obsolete}). > > @item x > @vindex package-menu-async > @@ -303,6 +297,60 @@ Package Installation > installed will be ignored. The @samp{muse} package will be listed in > the package menu with the @samp{held} status. > > +@node Package Status > +@section Package Status > +@cindex package status > + > +A package can have one of the following statuses: > + > +@table @samp > +@item available > +The package is not installed, but can be downloaded from the package > +archive. > + > +@c @samp{unsigned} (installed, but not signed; @pxref{Package Signing}), > + > +@item built-in > +The package is included in Emacs by default. It cannot be deleted > +through the package menu, and is not considered for upgrading. > + > +@item installed > +The package is installed. > + > +@item dependency > +The package was installed automatically to satisfy a dependency of > +another package. > + > +@item new > +Equivalent to @samp{available}, except that the package became newly > +available on the package archive after your last invocation of > +@kbd{M-x list-packages}. > + > +@item obsolete > +The package is an outdated installed version; in addition to this > +version of the package, a newer version is also installed. > + > +@item avail-obso > +The package is available for installation, but a newer version is also > +available. Packages with this status are hidden by default. > + > +@item disabled > +The package has been disabled using the @code{package-load-list} > +variable. > + > +@item external > +The package is not built-in and not from the directory specified by > +@code{package-user-dir} (@pxref{Package Files}). External packages > +are treated much like built-in packages and cannot be deleted. > + > +@item incompat > +The package cannot be installed for some reason, for example because > +it depends on uninstallable packages. > + > +@item held > +The package is held, @xref{Package Installation}. > +@end table Maybe the table should be organized in alphabetical order? Not sure. Thanks, looks fine with these nits fixed.