Fix documentation and prompt in 'package-isolate'
authorEli Zaretskii <eliz@gnu.org>
Sat, 4 Jan 2025 12:18:54 +0000 (14:18 +0200)
committerEli Zaretskii <eliz@gnu.org>
Sat, 4 Jan 2025 12:18:54 +0000 (14:18 +0200)
* lisp/emacs-lisp/package.el (package-isolate): Fix doc string and
the prompt.  (Bug#75163)

lisp/emacs-lisp/package.el

index fa1d361d775c295d4e3519e3df09c5a685dc60ad..0fc5aaac3430fda43821b14ae1873491287517ed 100644 (file)
@@ -2647,16 +2647,23 @@ will be deleted."
 
 (defun package-isolate (packages &optional temp-init)
   "Start an uncustomized Emacs and only load a set of PACKAGES.
+Interactively, prompt for PACKAGES to load, which should be specified
+separated by commas.
+If called from Lisp, PACKAGES should be a list of packages to load.
 If TEMP-INIT is non-nil, or when invoked with a prefix argument,
-the Emacs user directory is set to a temporary directory."
+the Emacs user directory is set to a temporary directory.
+This command is intended for testing Emacs and/or the packages
+in a clean environment."
   (interactive
    (cl-loop for p in (cl-loop for p in (package--alist) append (cdr p))
            unless (package-built-in-p p)
            collect (cons (package-desc-full-name p) p) into table
            finally return
-           (list (cl-loop for c in (completing-read-multiple
-                                     "Isolate packages: " table
-                                     nil t)
+           (list
+             (cl-loop for c in
+                      (completing-read-multiple
+                       "Packages to isolate, as comma-separated list: " table
+                       nil t)
                           collect (alist-get c table nil nil #'string=))
                   current-prefix-arg)))
   (let* ((name (concat "package-isolate-"