emacs-29 9b38773a20b: ; * lisp/dired.el (dired-no-confirm): Doc fix. (Bug#64493)

[Eli Zaretskii]

branch: emacs-29
commit 9b38773a20b43e2354ddf036ffa28e397537da3f
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    ; * lisp/dired.el (dired-no-confirm): Doc fix.  (Bug#64493)
---
 lisp/dired.el | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/lisp/dired.el b/lisp/dired.el
index de875302793..d14cf47ffd5 100644
--- a/lisp/dired.el
+++ b/lisp/dired.el
@@ -3881,13 +3881,20 @@ or \"* [3 files]\"."
        (format "%c [%d files]" dired-marker-char count)))))
 
 (defcustom dired-no-confirm nil
-  "A list of symbols for commands Dired should not confirm, or t.
-Command symbols are `byte-compile', `chgrp', `chmod', `chown', `compress',
-`copy', `delete', `hardlink', `load', `move', `print', `shell', `symlink',
-`touch' and `uncompress'.
-If t, confirmation is never needed."
+  "Dired commands for which Dired should not popup list of affected files, or 
t.
+
+If non-nil, Dired will not pop up the list of files to be affected by
+some Dired commands, when asking for confirmation.  (Dired will still
+ask for confirmation, just without showing the affected files.)
+
+If the value is t, the list of affected files is never popped up.
+The value can also be a list of command symbols: then the list of the
+affected files will not be popped up only for the corresponding Dired
+commands.  Recognized command symbols are `byte-compile', `chgrp',
+`chmod', `chown', `compress', `copy', `delete', `hardlink', `load',
+`move', `print', `shell', `symlink', `touch' and `uncompress'."
   :group 'dired
-  :type '(choice (const :tag "Confirmation never needed" t)
+  :type '(choice (const :tag "Affected files never shown" t)
                 (set (const byte-compile) (const chgrp)
                      (const chmod) (const chown) (const compress)
                      (const copy) (const delete) (const hardlink)