]> git.eshelyaron.com Git - emacs.git/commitdiff
Document the `x' DWIM action in the manual
authorLars Ingebrigtsen <larsi@gnus.org>
Sat, 7 May 2022 12:42:18 +0000 (14:42 +0200)
committerLars Ingebrigtsen <larsi@gnus.org>
Sat, 7 May 2022 12:42:18 +0000 (14:42 +0200)
* doc/emacs/package.texi (Package Menu): Mention the DWIM action
of the `x' command.

doc/emacs/package.texi
etc/NEWS

index bd3ae2aa6ad51744e7ec911879e7651527663c84..fc2a093ec426ab2a6ed025f77a845c4726e2b6eb 100644 (file)
@@ -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
index 5dd87e3e9e80561746c7be3fdc571d4d7401d194..de3f093864f6313ad6c2fd42dd4f045ef5c395e1 100644 (file)
--- 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.