Document that 'package-vc' doesn't support built-in packages

* doc/misc/use-package.texi (Install package):
* doc/emacs/package.texi (Fetching Package Sources): Document that
upgrading built-in packages is not yet supported using
'package-vc'.  (Bug#75328)

(cherry picked from commit 26c5fadf474a56d56064899bc3447bba6d3c3037)

diff --git a/doc/emacs/package.texi b/doc/emacs/package.texi
index e6d0a66d5713c21af49b047ce7208a75623e5b09..2e3191440cb01004e4d2803fd0628d6295490448 100644 (file)
--- a/doc/emacs/package.texi
+++ b/doc/emacs/package.texi
@@ -611,6 +611,9 @@ regular package listing.  If you just wish to clone the source of a
 package, without adding it to the package list, use
 @code{package-vc-checkout}.
 
+  Note that currently, built-in packages cannot be upgraded using
+@code{package-vc-install}.
+
 @findex package-report-bug
 @findex package-vc-prepare-patch
   With the source checkout, you might want to reproduce a bug against

diff --git a/doc/misc/use-package.texi b/doc/misc/use-package.texi
index 6f51780057f5cc23bc43e0037c34ffa9115eb3fc..bcb068e665435e7af705791947c9371a971acbea 100644 (file)
--- a/doc/misc/use-package.texi
+++ b/doc/misc/use-package.texi
@@ -1660,7 +1660,8 @@ declaration.  The accepted property list is augmented by a @code{:rev}
 keyword, which has the same shape as the @code{REV} argument to
 @code{package-vc-install}.  Notably -- even when not specified --
 @code{:rev} defaults to checking out the last release of the package.
-You can use @code{:rev :newest} to check out the latest commit.
+You can use @code{:rev :newest} to check out the latest commit.  Note
+that currently, you cannot upgrade built-in packages using @code{:vc}.
 
 For example,