From c53c5f388470188632d518df68cff1204c930c49 Mon Sep 17 00:00:00 2001 From: Philip Kaludercic Date: Sun, 13 Nov 2022 00:59:35 +0100 Subject: [PATCH] Rename 'package-vc-refresh' to 'package-vc-rebuild' MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit * 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. --- doc/emacs/package.texi | 2 +- lisp/emacs-lisp/package-vc.el | 13 +++++++++---- 2 files changed, 10 insertions(+), 5 deletions(-) diff --git a/doc/emacs/package.texi b/doc/emacs/package.texi index a0f02f38b74..cd4c113ae5a 100644 --- a/doc/emacs/package.texi +++ b/doc/emacs/package.texi @@ -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 diff --git a/lisp/emacs-lisp/package-vc.el b/lisp/emacs-lisp/package-vc.el index 8031bea490f..620b21d0a1b 100644 --- a/lisp/emacs-lisp/package-vc.el +++ b/lisp/emacs-lisp/package-vc.el @@ -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 -- 2.39.2