master c53c5f3884 15/42: Rename 'package-vc-refresh' to 'package-vc-rebuild'

[Philip Kaludercic]

branch: master
commit c53c5f388470188632d518df68cff1204c930c49
Author: Philip Kaludercic <philipk@posteo.net>
Commit: Philip Kaludercic <philipk@posteo.net>

    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.
---
 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 a0f02f38b7..cd4c113ae5 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 8031bea490..620b21d0a1 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