scratch/package-vc-fixes bef3acf0f0 31/48: Explain that 'package-vc-install' doesn't remove tarball packages

[Philip Kaludercic]

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

    Explain that 'package-vc-install' doesn't remove tarball packages
    
    * lisp/emacs-lisp/package-vc.el (package-vc-install): Expand documentation.
---
 lisp/emacs-lisp/package-vc.el | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/lisp/emacs-lisp/package-vc.el b/lisp/emacs-lisp/package-vc.el
index cbcd9fd55d..664629d156 100644
--- a/lisp/emacs-lisp/package-vc.el
+++ b/lisp/emacs-lisp/package-vc.el
@@ -626,7 +626,9 @@ name as deduced from NAME-OR-URL.
 Optional argument BACKEND specifies the VC backend to use for cloning
 the package's repository; this is only possible if NAME-OR-URL is a URL,
 a string.  If BACKEND is omitted or nil, the function
-uses `package-vc-heuristic-alist' to guess the backend."
+uses `package-vc-heuristic-alist' to guess the backend.
+Note that by default, a source package will be prioritised over a
+regular package, but it will not remove a source package."
   (interactive
    (progn
      ;; Initialize the package system to get the list of package