From: Eli Zaretskii <eliz@gnu.org>
Date: Wed, 9 Apr 2025 11:25:29 +0000 (+0300)
Subject: ; Fix doc strings of a few Dired commands
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=d8dcf92a578bfdec2c4dc4a0022172270de7942f;p=emacs.git

; Fix doc strings of a few Dired commands

* lisp/dired-aux.el (dired-do-chown, dired-do-touch)
(dired-do-chgrp, dired-do-chmod): Doc fix.  (Bug#77650)

(cherry picked from commit 378bea99b1a41a38c3915fa65e9adce4ec177197)
---

diff --git a/lisp/dired-aux.el b/lisp/dired-aux.el
index 1c5b9e0336b..8b39a497d81 100644
--- a/lisp/dired-aux.el
+++ b/lisp/dired-aux.el
@@ -479,9 +479,11 @@ List has a form of (file-name full-file-name (attribute-list))."
 (defun dired-do-chmod (&optional arg)
   "Change the mode of the marked (or next ARG) files.
 Both octal numeric modes like `644' and symbolic modes like `g+w'
-are supported.  Type \\<minibuffer-local-completion-map>\
-\\[next-history-element] to pull the file attributes of the file
-at point into the minibuffer.
+are supported.
+After invoking the command, \
+type \\<minibuffer-local-completion-map>\\[next-history-element] \
+to pull the file attributes
+of the file at point into the minibuffer.
 
 See Info node `(coreutils)File permissions' for more information.
 Alternatively, see the man page for \"chmod(1)\".
@@ -530,9 +532,10 @@ has no effect on MS-Windows."
 ;;;###autoload
 (defun dired-do-chgrp (&optional arg)
   "Change the group of the marked (or next ARG) files.
-Type \\<minibuffer-local-completion-map>\\[next-history-element] \
-to pull the file attributes of the file at point
-into the minibuffer."
+After invoking the command, \
+type \\<minibuffer-local-completion-map>\\[next-history-element] \
+to pull the file attributes
+of the file at point into the minibuffer."
   (interactive "P" dired-mode)
   (if (and (memq system-type '(ms-dos windows-nt))
            (not (file-remote-p default-directory)))
@@ -542,9 +545,10 @@ into the minibuffer."
 ;;;###autoload
 (defun dired-do-chown (&optional arg)
   "Change the owner of the marked (or next ARG) files.
-Type \\<minibuffer-local-completion-map>\\[next-history-element] \
-to pull the file attributes of the file at point
-into the minibuffer."
+After invoking the command, \
+type \\<minibuffer-local-completion-map>\\[next-history-element] \
+to pull the file attributes
+of the file at point into the minibuffer."
   (interactive "P" dired-mode)
   (if (and (memq system-type '(ms-dos windows-nt))
            (not (file-remote-p default-directory)))
@@ -555,9 +559,10 @@ into the minibuffer."
 (defun dired-do-touch (&optional arg)
   "Change the timestamp of the marked (or next ARG) files.
 This calls touch.
-Type Type \\<minibuffer-local-completion-map>\\[next-history-element] \
-to pull the file attributes of the file at point
-into the minibuffer."
+After invoking the command, \
+type \\<minibuffer-local-completion-map>\\[next-history-element] \
+to pull the file attributes
+of the file at point into the minibuffer."
   (interactive "P" dired-mode)
   (dired-do-chxxx "Timestamp" dired-touch-program 'touch arg))