From: Lars Ingebrigtsen Date: Sat, 7 May 2022 12:42:18 +0000 (+0200) Subject: Document the `x' DWIM action in the manual X-Git-Tag: emacs-29.0.90~1910^2~931 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=5ac6af4e886e630e039d282bb6f3965d7367c461;p=emacs.git Document the `x' DWIM action in the manual * doc/emacs/package.texi (Package Menu): Mention the DWIM action of the `x' command. --- diff --git a/doc/emacs/package.texi b/doc/emacs/package.texi index bd3ae2aa6ad..fc2a093ec42 100644 --- a/doc/emacs/package.texi +++ b/doc/emacs/package.texi @@ -89,6 +89,11 @@ list of available packages from package archive servers. If the network is unavailable, it falls back on the most recently retrieved list. +The main command to use in the package list buffer is the @key{x} +command. If the package under point isn't installed already, this +command will install it. If the package under point is already +installed, this command will delete it. + The following commands are available in the package menu: @table @kbd @@ -162,7 +167,10 @@ installed versions (marked with status @samp{obsolete}). @findex package-menu-execute Download and install all packages marked with @kbd{i}, and their dependencies; also, delete all packages marked with @kbd{d} -(@code{package-menu-execute}). This also removes the marks. +(@code{package-menu-execute}). This also removes the marks. If no +packages are marked, this command will install the package under point +(if it isn't installed already), or delete the package under point (if +it's already installed). @item g @item r diff --git a/etc/NEWS b/etc/NEWS index 5dd87e3e9e8..de3f093864f 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -748,6 +748,7 @@ this includes "binary" buffers like 'archive-mode' and 'image-mode'. This command allows you to upgrade packages without using 'M-x list-packages'. ++++ *** New DWIM action on 'x'. If no packages are marked, 'x' will install the package under point if it isn't already, and remove it if it is installed.