From: Paul Eggert <eggert@cs.ucla.edu>
Date: Fri, 24 Sep 2004 23:33:13 +0000 (+0000)
Subject: (chmod invocation): Warn about "chmod -w file".
X-Git-Tag: v5.3.0~594
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=6ca4627b99cb62bd04d6027d3a8c220712f1b971;p=thirdparty%2Fcoreutils.git

(chmod invocation): Warn about "chmod -w file".
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 7068fc4878..8db25a90f0 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -8303,6 +8303,9 @@ recursive directory traversals.
 
 If used, @var{mode} specifies the new permissions.
 For details, see the section on @ref{File permissions}.
+In the extremely rare cases where @var{mode} has leading @samp{-}, a
+portable script should use @option{--} first, e.g., @samp{chmod -- -w
+file}.  Typically, though, @samp{chmod a-w file} is preferable.
 
 The program accepts the following options.  Also see @ref{Common options}.