all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Stefan Kangas <stefan@marxist.se>
To: Drew Adams <drew.adams@oracle.com>
Cc: 24897@debbugs.gnu.org
Subject: bug#24897: 24.5; doc for `M' in Dired
Date: Mon, 14 Oct 2019 00:38:21 +0200	[thread overview]
Message-ID: <CADwFkmkn+mQS10EG9BcE7ibN8dvf7RoNcFhJeAieRUWUQ0SHCg@mail.gmail.com> (raw)
In-Reply-To: <b7a7de08-ab3c-4b47-ba36-f5c2856d495d@default>

Thanks for your comments Drew.  I think the patch I sent separately
fixes your comments, but see also below.

Drew Adams <drew.adams@oracle.com> writes:

> 2. The main point of the request is to ask that the
> doc for `M' say something about the permissions, that
> it _not_ just point to a `man' page (which typically
> won't be available for MS Windows users anyway).
[...]
> It's good for the doc to _also_ mention the `chmod'
> command and its `man' page, but this bug report asks
> that the `M' doc itself provide at least a minimum of
> help about this - the possible user inputs and their
> effects.

Are you suggesting that we fully document how both symbolic and octal
modes work on Unix-like systems here?  If so, I think it's outside the
scope of this doc string.  Linking to separate documentation seems
more sensible, and the new patch I suggested does that.

See also:
https://www.gnu.org/software/coreutils/manual/html_node/File-permissions.html

Best regards,
Stefan Kangas





  reply	other threads:[~2019-10-13 22:38 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
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 [this message]
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=CADwFkmkn+mQS10EG9BcE7ibN8dvf7RoNcFhJeAieRUWUQ0SHCg@mail.gmail.com \
    --to=stefan@marxist.se \
    --cc=24897@debbugs.gnu.org \
    --cc=drew.adams@oracle.com \
    /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.