GNU bug report logs - #24897
24.5; doc for `M' in Dired

Previous Next

Full log

View this message in rfc822 format

From: Stefan Kangas <stefan <at> marxist.se>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 24897 <at> debbugs.gnu.org, Eli Zaretskii <eliz <at> gnu.org>
Subject: bug#24897: 24.5; doc for `M' in Dired
Date: Mon, 14 Oct 2019 00:38:21 +0200

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

Drew Adams <drew.adams <at> 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

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.