From: Stefan Kangas <stefan@marxist.se>
To: Eli Zaretskii <eliz@gnu.org>
Cc: 24897@debbugs.gnu.org
Subject: bug#24897: 24.5; doc for `M' in Dired
Date: Mon, 14 Oct 2019 00:37:57 +0200 [thread overview]
Message-ID: <CADwFkmm+=nRM0TxVyiQ6vHBB-eifg-27x-WTvaJ9G-JAyAm_RA@mail.gmail.com> (raw)
In-Reply-To: <83d0f3pbzu.fsf@gnu.org>
[-- Attachment #1: Type: text/plain, Size: 719 bytes --]
Eli Zaretskii <eliz@gnu.org> writes:
> On GNU/Linux, 'chmod' is documented in the Coreutils Info manual, and
> the GNU Coding Standards generally prefer Info to man pages. So I'd
> suggest to point to the Coreutils manual first, and to the man page
> only as fallback.
Yes, good thinking. But I pointed to the "File permissions" section
instead, which seemed more to the point.
> Actually, here's a more useful text:
>
> Note that on MS-Windows only the `w' (write) bit is meaningful:
> resetting it makes the file read-only. Changing any other bit
> has no effect on MS-Windows.
Thanks. I'm pretty ignorant about MS-Windows so that definitely helps.
How about the attached?
Best regards,
Stefan Kangas
[-- Attachment #2: 0001-Improve-documentation-of-dired-do-chmod.patch --]
[-- Type: text/x-patch, Size: 1464 bytes --]
From 6ff8d2e525dc2b948059033d7901288f0921d576 Mon Sep 17 00:00:00 2001
From: Stefan Kangas <stefankangas@gmail.com>
Date: Fri, 11 Oct 2019 16:37:44 +0200
Subject: [PATCH] Improve documentation of dired-do-chmod
* lisp/dired-aux.el (dired-do-chmod): Doc fix. The part about
MS-Windows was written by Eli Zaretskii. (Bug#24897)
---
lisp/dired-aux.el | 14 +++++++++++---
1 file changed, 11 insertions(+), 3 deletions(-)
diff --git a/lisp/dired-aux.el b/lisp/dired-aux.el
index bfc37c5cde..8bda25e9e3 100644
--- a/lisp/dired-aux.el
+++ b/lisp/dired-aux.el
@@ -365,9 +365,17 @@ dired-do-chxxx
;;;###autoload
(defun dired-do-chmod (&optional arg)
"Change the mode of the marked (or next ARG) files.
-Symbolic modes like `g+w' are allowed.
-Type M-n to pull the file attributes of the file at point
-into the minibuffer."
+Both octal numeric modes like `644' and symbolic modes like `g+w'
+are supported. Type M-n 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\", using the command
+\\[man] in Emacs.
+
+Note that on MS-Windows only the `w' (write) bit is meaningful:
+resetting it makes the file read-only. Changing any other bit
+has no effect on MS-Windows."
(interactive "P")
(let* ((files (dired-get-marked-files t arg nil nil t))
;; The source of default file attributes is the file at point.
--
2.20.1
next prev parent reply other threads:[~2019-10-13 22:37 UTC|newest]
Thread overview: 17+ messages / expand[flat|nested] mbox.gz Atom feed top
2016-11-07 18:52 bug#24897: 24.5; doc for `M' in Dired Drew Adams
2016-11-07 19:22 ` Eli Zaretskii
2019-10-11 14:43 ` Stefan Kangas
2019-10-11 14:51 ` Eli Zaretskii
2019-10-11 14:56 ` Eli Zaretskii
2019-10-13 22:37 ` Stefan Kangas [this message]
2019-10-14 6:40 ` Eli Zaretskii
2019-10-14 14:01 ` Stefan Kangas
2019-10-11 15:42 ` Drew Adams
2019-10-13 22:38 ` Stefan Kangas
2019-10-13 23:21 ` Drew Adams
2019-10-14 6:46 ` Eli Zaretskii
[not found] <<b7cf8a94-afca-47b4-8d4a-3356a70c8b2b@default>
[not found] ` <<83shr3gkn1.fsf@gnu.org>
2016-11-07 19:28 ` Drew Adams
2016-11-07 19:50 ` Eli Zaretskii
[not found] <<<b7cf8a94-afca-47b4-8d4a-3356a70c8b2b@default>
[not found] ` <<<83shr3gkn1.fsf@gnu.org>
[not found] ` <<106ca6bc-ecf5-439f-853b-63331a41d4b8@default>
[not found] ` <<83oa1rgjdf.fsf@gnu.org>
2016-11-07 20:39 ` Drew Adams
[not found] <<CADwFkmmtroWL2iVhE+pZgGkab8uOBc8zVVdOi_DWE1hu5ezBqQ@mail.gmail.com>
[not found] ` <<83ftjzpc7g.fsf@gnu.org>
[not found] ` <<83d0f3pbzu.fsf@gnu.org>
2019-10-11 15:45 ` Drew Adams
2019-10-11 15:57 ` Eli Zaretskii
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to='CADwFkmm+=nRM0TxVyiQ6vHBB-eifg-27x-WTvaJ9G-JAyAm_RA@mail.gmail.com' \
--to=stefan@marxist.se \
--cc=24897@debbugs.gnu.org \
--cc=eliz@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.