From: Dmitry Gutov <dmitry@gutov.dev>
Date: Thu, 27 Apr 2023 23:24:10 +0000 (+0300)
Subject: package-upgrade[-all]: Expand docstrings to note the current limitation
X-Git-Tag: emacs-29.0.91~90
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=a365984d9e167c4d71a2a44a1abb4710765f460f;p=emacs.git

package-upgrade[-all]: Expand docstrings to note the current limitation

* lisp/emacs-lisp/package.el (package-upgrade, package-upgrade-all):
Expand docstrings to note the current limitation (bug#62720).
---

diff --git a/lisp/emacs-lisp/package.el b/lisp/emacs-lisp/package.el
index e15536c9f50..74796fc8744 100644
--- a/lisp/emacs-lisp/package.el
+++ b/lisp/emacs-lisp/package.el
@@ -2267,7 +2267,11 @@ had been enabled."
 
 ;;;###autoload
 (defun package-upgrade (name)
-  "Upgrade package NAME if a newer version exists."
+  "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."
   (interactive
    (list (completing-read
           "Upgrade package: " (package--upgradeable-packages) nil t)))
@@ -2301,7 +2305,11 @@ had been enabled."
 (defun package-upgrade-all (&optional query)
   "Refresh package list and upgrade all packages.
 If QUERY, ask the user before upgrading packages.  When called
-interactively, QUERY is always true."
+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
+upgrade to an ELPA version first."
   (interactive (list (not noninteractive)))
   (package-refresh-contents)
   (let ((upgradeable (package--upgradeable-packages)))