1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-11-21 06:55:39 +00:00

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).
This commit is contained in:
Dmitry Gutov 2023-04-28 02:24:10 +03:00
parent f965f35b33
commit a365984d9e

View File

@ -2267,7 +2267,11 @@ had been enabled."
;;;###autoload ;;;###autoload
(defun package-upgrade (name) (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 (interactive
(list (completing-read (list (completing-read
"Upgrade package: " (package--upgradeable-packages) nil t))) "Upgrade package: " (package--upgradeable-packages) nil t)))
@ -2301,7 +2305,11 @@ had been enabled."
(defun package-upgrade-all (&optional query) (defun package-upgrade-all (&optional query)
"Refresh package list and upgrade all packages. "Refresh package list and upgrade all packages.
If QUERY, ask the user before upgrading packages. When called 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))) (interactive (list (not noninteractive)))
(package-refresh-contents) (package-refresh-contents)
(let ((upgradeable (package--upgradeable-packages))) (let ((upgradeable (package--upgradeable-packages)))