From: Philip Kaludercic <philipk@posteo.net>
Date: Sun, 13 Nov 2022 07:18:49 +0000 (+0100)
Subject: Explain that 'package-vc-install' doesn't remove tarball packages
X-Git-Tag: emacs-29.0.90~1616^2~73
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=4aee4cde3aa3d9cdf4184af7c06f9ea7464c8824;p=emacs.git

Explain that 'package-vc-install' doesn't remove tarball packages

* lisp/emacs-lisp/package-vc.el (package-vc-install): Expand documentation.
---

diff --git a/lisp/emacs-lisp/package-vc.el b/lisp/emacs-lisp/package-vc.el
index 96ae518b216..acef568e549 100644
--- a/lisp/emacs-lisp/package-vc.el
+++ b/lisp/emacs-lisp/package-vc.el
@@ -645,7 +645,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