scratch/package-vc-fixes 9e4ef24033 15/16: Explain what "refreshing" a source package means

[Philip Kaludercic]

branch: scratch/package-vc-fixes
commit 9e4ef24033e06bd8f94c0b283f8a7d5c9f5c6e8d
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)))