emacs-29 b33d25f5967: ; Minor improvements in doc strings of package-upgrade commands

[Eli Zaretskii]

branch: emacs-29
commit b33d25f596725c69ad5d85f3d724b8bf452ff509
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    ; Minor improvements in doc strings of package-upgrade commands
    
    * lisp/emacs-lisp/package.el (package-upgrade)
    (package-upgrade-all): Doc fixes.  (Bug#62720)
---
 lisp/emacs-lisp/package.el | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/lisp/emacs-lisp/package.el b/lisp/emacs-lisp/package.el
index 74796fc8744..9cc3f8724af 100644
--- a/lisp/emacs-lisp/package.el
+++ b/lisp/emacs-lisp/package.el
@@ -2270,8 +2270,9 @@ had been enabled."
   "Upgrade package NAME if a newer version exists.
 
 Currently, packages which are part of the Emacs distribution
-cannot be upgraded that way.  Use `i' after `M-x list-packages' to
-upgrade to an ELPA version first."
+cannot be upgraded that way.  To enable upgrades of such a
+package using this command, first upgrade the package to a
+newer version from ELPA by using 
`\\<package-menu-mode-map>\\[package-menu-mark-install]' after 
`\\[list-packages]'."
   (interactive
    (list (completing-read
           "Upgrade package: " (package--upgradeable-packages) nil t)))
@@ -2308,7 +2309,11 @@ If QUERY, ask the user before upgrading packages.  When 
called
 interactively, QUERY is always true.
 
 Currently, packages which are part of the Emacs distribution are
-not upgraded that way.  Use `i' after `M-x list-packages' to
+not upgraded by this command.  To enable upgrading such a package
+using this command, first upgrade  the package to a newer version
+from ELPA by using `\\<package-menu-mode-map>\\[package-menu-mark-install]' 
after `\\[list-packages]'.
+
+  Use `i' after `M-x list-packages' to
 upgrade to an ELPA version first."
   (interactive (list (not noninteractive)))
   (package-refresh-contents)