bug#50551: 28.0.50; Describe "package-menu-execute" better

[Rudolf Adamkovič]

The documentation for "package-menu-execute" says: 

> Packages marked for installation are downloaded and installed; 
> packages marked for deletion are removed. 

The documentation should mention *upgrades* as well.


In GNU Emacs 28.0.50 (build 6, x86_64-apple-darwin20.6.0, NS 
appkit-2022.60 Version 11.5.1 (Build 20G80)) 
of 2021-09-12 built on Workstation.local 
Repository revision: 4a44ac987e1357c8d4fdd18dd8cf902f5eec5401 
Repository branch: master Windowing system distributor 'Apple', 
version 10.3.2022 System Description:  macOS 11.5.1  Configured 
using: 
'configure --with-json 
PKG_CONFIG_PATH=/usr/local/Cellar/zlib/1.2.11/lib/pkgconfig:/usr/local/lib/pkgconfig:/opt/X11/lib/pkgconfig' 
Configured features: ACL DBUS GIF GLIB GMP GNUTLS JPEG JSON LCMS2 
LIBXML2 MODULES NOTIFY KQUEUE NS PDUMPER PNG RSVG THREADS TIFF 
TOOLKIT_SCROLL_BARS XIM ZLIB Important settings: 
 value of $LANG: en_US.UTF-8 locale-coding-system: utf-8-unix 

Major mode: Helpful  Minor modes in effect: 
 global-auto-revert-mode: t show-paren-mode: t save-place-mode: t 
 global-subword-mode: t subword-mode: t which-key-mode: t 
 corfu-global-mode: t corfu-mode: t vertico-mode: t 
 marginalia-mode: t shell-dirtrack-mode: t 
 async-bytecomp-package-mode: t global-diff-hl-mode: t 
 yas-global-mode: t yas-minor-mode: t savehist-mode: t 
 delete-selection-mode: t tooltip-mode: t global-eldoc-mode: t 
 electric-indent-mode: t mouse-wheel-mode: t menu-bar-mode: t 
 file-name-shadow-mode: t global-font-lock-mode: t 
 font-lock-mode: t auto-composition-mode: t auto-encryption-mode: 
 t auto-compression-mode: t buffer-read-only: t 
 size-indication-mode: t column-number-mode: t line-number-mode: 
 t global-visual-line-mode: t visual-line-mode: t 
 transient-mark-mode: t 

Load-path shadows: 
/Users/salutis/.emacs.d/elpa/magit-20210910.2039/magit-section-pkg 
hides 
/Users/salutis/.emacs.d/elpa/magit-section-20210829.1849/magit-section-pkg 
/Users/salutis/.emacs.d/elpa/transient-20210819.2118/transient 
hides 
/Users/salutis/src/emacs/nextstep/Emacs.app/Contents/Resources/lisp/transient 
Features: (shadow sort fortune mail-extr emacsbug sendmail 
bug-reference make-mode vc-mtn vc-hg vc-bzr vc-src vc-sccs vc-svn 
vc-cvs vc-rcs consult-vertico consult recentf tree-widget 
dired-aux dired-x mm-archive gnutls network-stream url-cache 
cc-mode cc-fonts cc-guess cc-menus cc-cmds cc-styles cc-align 
cc-engine cc-vars cc-defs eglot array jsonrpc ert xref pcase 
project swift-mode swift-mode-imenu swift-mode-repl 
swift-mode-beginning-of-defun swift-mode-font-lock 
swift-mode-standard-types swift-mode-indent swift-mode-lexer 
reftex-parse misearch multi-isearch cl-print debug tramp-cmds 
conf-mode elfeed-link elfeed-show elfeed-search elfeed-csv elfeed 
elfeed-curl elfeed-log xml-query bookmark elfeed-db elfeed-lib pp 
helpful imenu trace edebug backtrace info-look help-fns radix-tree 
elisp-refs sh-script smie executable tex-mode flymake-proc flymake 
compile flyspell ispell org-indent image-file image-converter 
disp-table ol-eww eww xdg thingatpt mm-url ol-rmail ol-mhe ol-irc 
ol-info ol-gnus nnselect gnus-search eieio-opt speedbar ezimage 
dframe gnus-art mm-uu mml2015 mm-view mml-smime smime dig gnus-sum 
shr kinsoku svg dom gnus-group gnus-undo gnus-start gnus-dbus dbus 
gnus-cloud nnimap nnmail mail-source utf7 netrc nnoo gnus-spec 
gnus-int gnus-range gnus-win gnus nnheader wid-edit ol-docview 
doc-view jka-compr image-mode exif ol-bbdb ol-w3m rx char-fold 
hl-todo modus-vivendi-theme modus-operandi-theme modus-themes 
autorevert paren saveplace cap-words superword subword which-key 
corfu orderless vertico marginalia org-ref org-ref-helm-bibtex 
org-ref-helm helm-bibtex bibtex-completion org-capture org-refile 
biblio biblio-download biblio-dissemin biblio-ieee biblio-hal 
biblio-dblp biblio-crossref biblio-arxiv timezone biblio-doi 
biblio-core let-alist url-queue ido hl-line helm-files filenotify 
tramp tramp-loaddefs trampver tramp-integration files-x 
tramp-compat shell parse-time helm-buffers helm-occur helm-tags 
helm-locate helm-grep helm-regexp helm-utils helm-types helm-net 
xml helm-help helm async-bytecomp helm-global-bindings 
helm-easymenu helm-source helm-multi-match helm-lib async 
helm-config org-ref-core warnings reftex-cite reftex 
reftex-loaddefs reftex-vars parsebib org-ref-glossary 
org-ref-bibtex vc-git org-ref-citeproc message ls-lisp dired 
dired-loaddefs rfc822 mml mml-sec epa derived epg rfc6068 
epg-config gnus-util rmail rmail-loaddefs text-property-search 
mm-decode mm-bodies mm-encode mailabbrev mail-utils gmm-utils 
mailheader key-chord hydra lv doi-utils org-ref-utils org-ref-pdf 
url-http url-auth mail-parse rfc2231 rfc2047 rfc2045 mm-util 
ietf-drums mail-prsvr url-gw nsm rmc puny ol-bibtex bibtex iso8601 
htmlize f s dash pdf-loader diff-hl log-view pcvs-util vc-dir ewoc 
vc vc-dispatcher diff-mode diminish yasnippet finder-inf ox-md 
ox-odt rng-loc rng-uri rng-parse rng-match rng-dt rng-util 
rng-pttrn nxml-parse nxml-ns nxml-enc xmltok nxml-util ox-latex 
ox-icalendar ox-html table ox-ascii ox-publish ox org-element 
avl-tree generator org-clock savehist delsel cl-extra help-mode 
org ob ob-tangle ob-ref ob-lob ob-table ob-exp org-macro 
org-footnote org-src ob-comint org-pcomplete pcomplete comint 
ansi-color ring org-list org-faces org-entities time-date noutline 
outline easy-mmode org-version ob-emacs-lisp ob-core ob-eval 
org-table ol org-keys org-compat advice org-macs org-loaddefs 
format-spec find-func cal-menu calendar cal-loaddefs edmacro 
kmacro info package browse-url url url-proxy url-privacy 
url-expand url-methods url-history url-cookie url-domsuf url-util 
mailcap url-handlers url-parse auth-source cl-seq eieio eieio-core 
cl-macs eieio-loaddefs password-cache json subr-x map url-vars seq 
byte-opt gv bytecomp byte-compile cconv cl-loaddefs cl-lib 
iso-transl tooltip eldoc electric uniquify ediff-hook vc-hooks 
lisp-float-type mwheel term/ns-win ns-win ucs-normalize mule-util 
term/common-win tool-bar dnd fontset image regexp-opt fringe 
tabulated-list replace newcomment text-mode elisp-mode lisp-mode 
prog-mode register page tab-bar menu-bar rfn-eshadow isearch 
easymenu timer select scroll-bar mouse jit-lock font-lock syntax 
font-core term/tty-colors frame minibuffer cl-generic cham 
georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao 
korean japanese eucjp-ms cp51932 hebrew greek romanian slovak 
czech european ethiopic indian cyrillic chinese composite 
charscript charprop case-table epa-hook jka-cmpr-hook help simple 
abbrev obarray cl-preloaded nadvice button loaddefs faces cus-face 
macroexp files window text-properties overlay sha1 md5 base64 
format env code-pages mule custom widget hashtable-print-readable 
backquote threads dbusbind kqueue cocoa ns lcms2 multi-tty 
make-network-process emacs)  Memory information: ((conses 16 
2729539 1395009) 
(symbols 48 51486 31) (strings 32 439060 230261) (string-bytes 1 
11084659) (vectors 16 120309) (vector-slots 8 2130939 765567) 
(floats 8 466 2333) (intervals 56 266290 67494) (buffers 992 
232)) 

--
Logic is a science of the necessary laws of thought, without which 
no employment of the understanding and the reason takes place. -- 
Immanuel Kant, 1785  Rudolf Adamkovič <salutis@me.com> 
Studenohorská 25 84103 Bratislava Slovakia  [he/him]