Rename 'package-vc-refresh' to 'package-vc-rebuild'

* doc/emacs/package.texi (Fetching Package Sources): Update documentation.
* lisp/emacs-lisp/package-vc.el (package-vc-refresh): Rename from.
(package-vc-rebuild): Rename to.

This intends to clarify the intention and avoid confusion with
'package-refresh-contents'.  Thanks to Rudolf Adamkovič for the
suggestion.
This commit is contained in:
Philip Kaludercic 2022-11-13 00:59:35 +01:00
parent 2ec02024ab
commit c53c5f3884
2 changed files with 10 additions and 5 deletions

View file

@ -593,7 +593,7 @@ with the maintainers, first commit your changes then use the command
@code{package-vc-prepare-patch} to share it. @xref{Preparing Patches}.
@findex package-vc-install-from-checkout
@findex package-vc-refresh
@findex package-vc-rebuild
If you maintain your own packages you might want to use a local
checkout instead of cloning a remote repository. You can do this by
using @code{package-vc-install-from-checkout}, which creates a symbolic link

View file

@ -720,10 +720,15 @@ name from the base name of DIR."
pkg-dir)))
;;;###autoload
(defun package-vc-refresh (pkg-desc)
"Refresh the installation for package given by PKG-DESC.
Interactively, prompt for the name of the package to refresh."
(interactive (list (package-vc--read-package-desc "Refresh package: " t)))
(defun package-vc-rebuild (pkg-desc)
"Rebuild the installation for package given by PKG-DESC.
Rebuilding an installation means scraping for new autoload
cookies, re-compiling Emacs Lisp files, building and installing
any documentation, downloading any missing dependencies. This
command does not fetch new revisions from a remote server. That
is the responsibility of `package-vc-update'. Interactively,
prompt for the name of the package to rebuild."
(interactive (list (package-vc--read-package-desc "Rebuild package: " t)))
(package-vc--unpack-1 pkg-desc (package-desc-dir pkg-desc)))
;;;###autoload