1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2025-01-07 15:21:46 +00:00

Documentation copyedits for 'package-install-upgrade-built-in' etc

* etc/NEWS: More details about the new option
'package-install-upgrade-built-in'.

* lisp/emacs-lisp/package.el (package-install-upgrade-built-in)
(package--active-built-in-p, package-install): Doc fixes.
(Bug#62720)
This commit is contained in:
Eli Zaretskii 2023-04-16 18:11:07 +03:00
parent 580d8278c5
commit a0b04a2247
2 changed files with 23 additions and 7 deletions

View File

@ -1878,8 +1878,16 @@ install.
--- ---
*** New user option 'package-install-upgrade-built-in'. *** New user option 'package-install-upgrade-built-in'.
When enabled, 'package-install' can be used to install When enabled, 'package-install' will include in the list of
newer versions of built-in packages. upgradeable packages those built-in packages (like Eglot and
use-package, for example) for which a newer version is available in
package archives, and will allow to install those newer versions. By
default, this is disabled; however, if 'package-install' is invoked
with a prefix argument, it will act as if this new option were
enabled.
If you customize this option, we recommend to place its non-default
setting in your early-init file.
** Emacs Sessions (Desktop) ** Emacs Sessions (Desktop)
@ -3249,6 +3257,10 @@ based on data provided by language servers using the Language Server
Protocol (LSP). See the new Info manual "(eglot) Top" for more. Also Protocol (LSP). See the new Info manual "(eglot) Top" for more. Also
see "etc/EGLOT-NEWS". see "etc/EGLOT-NEWS".
If you want to be able to use 'package-install' to upgrade Eglot to
newer versions released on GNU ELPA, customize the new option
'package-install-upgrade-built-in' to a non-nil value.
+++ +++
** use-package: Declarative package configuration. ** use-package: Declarative package configuration.
use-package is now shipped with Emacs. It provides the 'use-package' use-package is now shipped with Emacs. It provides the 'use-package'
@ -3256,6 +3268,10 @@ macro, which allows you to isolate package configuration in your init
file in a way that is declarative, tidy, and performance-oriented. file in a way that is declarative, tidy, and performance-oriented.
See the new Info manual "(use-package) Top" for more. See the new Info manual "(use-package) Top" for more.
If you want to be able to use 'package-install' to upgrade use-package
to newer versions released on GNU ELPA, customize the new option
'package-install-upgrade-built-in' to a non-nil value.
--- ---
** New package 'wallpaper'. ** New package 'wallpaper'.
This package provides the command 'wallpaper-set', which sets the This package provides the command 'wallpaper-set', which sets the

View File

@ -798,7 +798,7 @@ specifying the minimum acceptable version."
(assq package package--builtins)))))) (assq package package--builtins))))))
(defun package--active-built-in-p (package) (defun package--active-built-in-p (package)
"Return non-nil if PACKAGE if the built-in version is used. "Return non-nil if the built-in version of PACKAGE is used.
If the built-in version of PACKAGE is used and PACKAGE is If the built-in version of PACKAGE is used and PACKAGE is
also available for installation from an archive, it is an also available for installation from an archive, it is an
indication that PACKAGE was never upgraded to any newer indication that PACKAGE was never upgraded to any newer
@ -2200,7 +2200,7 @@ using `package-compute-transaction'."
(defcustom package-install-upgrade-built-in nil (defcustom package-install-upgrade-built-in nil
"Non-nil means that built-in packages can be upgraded via a package archive. "Non-nil means that built-in packages can be upgraded via a package archive.
If disabled, then `package-install' will not suggest to replace a If disabled, then `package-install' will not suggest to replace a
built-in package with a version from a package archive." built-in package with a (possibly newer) version from a package archive."
:type 'boolean :type 'boolean
:version "29.1") :version "29.1")
@ -2220,9 +2220,9 @@ non-nil, install the package but do not add it to
If PKG is a `package-desc' and it is already installed, don't try If PKG is a `package-desc' and it is already installed, don't try
to install it but still mark it as selected. to install it but still mark it as selected.
If the command is invoked with a prefix argument, the upgrading If the command is invoked with a prefix argument, it will allow
of built-in packages will be possible, as if upgrading of built-in packages, as if `package-install-upgrade-built-in'
`package-install-upgrade-built-in' had been enabled." had been enabled."
(interactive (interactive
(progn (progn
;; Initialize the package system to get the list of package ;; Initialize the package system to get the list of package