scratch/package-vc-fixes 4b30679030 15/48: Explain what "refreshing" a source package means

[Philip Kaludercic]

branch: scratch/package-vc-fixes
commit 4b30679030c7ab77db9cf7595b57a1b6b1bece2b
Author: Philip Kaludercic <philipk@posteo.net>
Commit: Philip Kaludercic <philipk@posteo.net>

    Explain what "refreshing" a source package means
    
    * lisp/emacs-lisp/package-vc.el (package-vc-refresh): Expand docstring.
---
 lisp/emacs-lisp/package-vc.el | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/lisp/emacs-lisp/package-vc.el b/lisp/emacs-lisp/package-vc.el
index d2ee63da87..89ed034f0e 100644
--- a/lisp/emacs-lisp/package-vc.el
+++ b/lisp/emacs-lisp/package-vc.el
@@ -702,7 +702,12 @@ name from the base name of 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."
+Refreshing 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 refresh."
   (interactive (list (package-vc--read-package-desc "Refresh package: " t)))
   (package-vc--unpack-1 pkg-desc (package-desc-dir pkg-desc)))