From: Philip Kaludercic Date: Sat, 6 May 2023 18:51:39 +0000 (+0200) Subject: ; Expand 'package-vc-install' documentation X-Git-Tag: emacs-29.0.91~37 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=dfde902f3b9c7eea7e58e09c4d52c1346ef52ee4;p=emacs.git ; Expand 'package-vc-install' documentation * lisp/emacs-lisp/package-vc.el (package-vc-install): Go into further detail on the handling of the REV argument. (Bug#60418) --- diff --git a/lisp/emacs-lisp/package-vc.el b/lisp/emacs-lisp/package-vc.el index 8f62e7d65f3..85193dd7a30 100644 --- a/lisp/emacs-lisp/package-vc.el +++ b/lisp/emacs-lisp/package-vc.el @@ -747,11 +747,13 @@ indicating the package name and SPEC is a plist as described in symbol whose name is the package name, and the URL for the package will be taken from the package's metadata. -By default, this function installs the last version of the package -available from its repository, but if REV is given and non-nil, it -specifies the revision to install. If REV has the special value -`:last-release' (interactively, the prefix argument), that stands -for the last released version of the package. +By default, this function installs the last revision of the +package available from its repository. If REV is a string, it +describes the revision to install, as interpreted by the VC +backend. The special value `:last-release' (interactively, the +prefix argument), will use the commit of the latest release, if +it exists. The last release is the latest revision which changed +the \"Version:\" header of the package's main Lisp file. 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,