From: Paul Eggert <eggert@cs.ucla.edu>
Date: Tue, 30 Jan 2007 21:54:34 +0000 (+0100)
Subject: * coreutils.texi (mkdir invocation): Say how to set the file
X-Git-Tag: COREUTILS-6_8~49
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=31bb8a431a022ffd24e4d0e08a3ee0b26099d302;p=thirdparty%2Fcoreutils.git

* coreutils.texi (mkdir invocation): Say how to set the file
permission bits of a parent directory with mkdir -p.
---

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 76542317d0..0dd0f9ef03 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2007-01-30  Paul Eggert  <eggert@cs.ucla.edu>
+
+	* coreutils.texi (mkdir invocation): Say how to set the file
+	permission bits of a parent directory with mkdir -p.
+
 2007-01-29  Jim Meyering  <jim@meyering.net>
 
 	Document new syntax: "chown +0:+287 file", "chgrp +99 file"
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 05bf7c6095..033059a7f9 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -8446,12 +8446,20 @@ overridden in this way.
 @opindex -p
 @opindex --parents
 @cindex parent directories, creating
-Make any missing parent directories for each argument.  The file permission
-bits of parent directories are set to the umask modified by @samp{u+wx}.
-@xref{Directory Setuid and Setgid}, for how the set-user-ID and
-set-group-ID bits of parent directories are inherited.
-Ignore arguments corresponding to existing directories, and do not
-change their file mode bits.
+Make any missing parent directories for each argument, setting their
+file permission bits to the umask modified by @samp{u+wx}.  Ignore
+existing parent directories, and do not change their file permission
+bits.
+
+To set the file permission bits of any newly-created parent
+directories to a value that includes @samp{u+wx}, you can set the
+umask before invoking @command{mkdir}.  For example, if the shell
+command @samp{(umask u=rwx,go=rx; mkdir -p P/Q)} creates the parent
+@file{P} it sets the parent's permission bits to @samp{u=rwx,go=rx}.
+To set a parent's special mode bits as well, you can invoke
+@command{chmod} after @command{mkdir}.  @xref{Directory Setuid and
+Setgid}, for how the set-user-ID and set-group-ID bits of
+newly-created parent directories are inherited.
 
 @item -v
 @item --verbose