From: Paul Eggert <eggert@cs.ucla.edu>
Date: Tue, 25 Jul 2006 18:37:55 +0000 (+0000)
Subject: (Directory Setuid and Setgid): Explain that this is a
X-Git-Tag: v6.0~92
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=5637c1634f8d08b25c41390d7cc95acd94a1d37e;p=thirdparty%2Fcoreutils.git

(Directory Setuid and Setgid): Explain that this is a
GNU extension, and that other systems behave differently here.
---

diff --git a/doc/ChangeLog b/doc/ChangeLog
index f30b6a3e5d..22490068d2 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2006-07-25  Paul Eggert  <eggert@cs.ucla.edu>
+
+	* perm.texi (Directory Setuid and Setgid): Explain that this is a
+	GNU extension, and that other systems behave differently here.
+
 2006-07-22  Paul Eggert  <eggert@cs.ucla.edu>
 
 	* coreutils.texi (What information is listed): Clarify that the
diff --git a/doc/perm.texi b/doc/perm.texi
index 5a65420a1e..4cc00b1d6b 100644
--- a/doc/perm.texi
+++ b/doc/perm.texi
@@ -537,7 +537,7 @@ bits of new subdirectories.  These mechanisms let users share files
 more easily, by lessening the need to use @command{chmod} or
 @command{chown} to share new files.
 
-These convenience mechanisms rely on the set-group-ID and set-user-ID
+These convenience mechanisms rely on the set-user-ID and set-group-ID
 bits of directories.  If commands like @command{chmod} and
 @command{mkdir} routinely cleared these bits on directories, the
 mechanisms would be less convenient and it would be harder to share
@@ -557,11 +557,11 @@ mkdir -m 755 c
 mkdir -m u=rwx,go=rx d
 @end example
 
-If you want to clear these bits, you must mention them explicitly in
-the symbolic or numeric modes, e.g.:
+If you want to try to clear these bits, you must mention them
+explicitly in the symbolic or numeric modes, e.g.:
 
 @example
-# These commands clear the set-user-ID
+# These commands try to clear the set-user-ID
 # and set-group-ID bits of the subdirectories.
 mkdir a b
 chmod 0755 a
@@ -569,3 +569,7 @@ chmod a-s,u=rwx,go=rx b
 mkdir -m 0755 c
 mkdir -m a-s,u=rwx,go=rx d
 @end example
+
+This behavior is a @acronym{GNU} extension.  Portable scripts should
+not rely on requests to set or clear these bits on directories, as
+@acronym{POSIX} allows implementations to ignore these requests.