Date: Sun, 31 Jul 2005 17:50:15 GMT From: garys@opusnet.com (Gary W. Swearingen) To: freebsd-doc@FreeBSD.org Subject: Re: docs/84265: chmod(1) manpage omits implication of setting w on directory Message-ID: <200507311750.j6VHoFTd066444@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/84265; it has been noted by GNATS.
From: garys@opusnet.com (Gary W. Swearingen)
To: Ceri Davies <ceri@submonkey.net>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/84265: chmod(1) manpage omits implication of setting w on
directory
Date: Sun, 31 Jul 2005 10:49:15 -0700
Ceri Davies <ceri@submonkey.net> writes:
> On 29 Jul 2005, at 02:57, Gary W. Swearingen wrote:
> > I'd also add the following paragraph to the chmod(1) and chgrp(1)
> > manpages, but I'll wait for approval before making patches.
> >
> > The group of a directory will be assigned to files newly created
> > (eg, by > or an editor, but not by mv or cp) within it, despite the
> > owner or group of the creator.
> A reference to touch(1) rather than '>' reads better here, I think.
How about this new para for chown(1) and chgrp(1)?
Files created in a directory will be generally be assigned the
group ID of the directory, with exceptions including files added
by cp(1) with -p and mv(1).
Want patches for that? In new PR(s) or this one?
> Also, the reference to "owner" should be "user id", as the creator of the file probably doesn't have an owner ;)
"Owner" is a concept, while "User ID" is an implementation detail,
but it's no big deal; I've changed that (and more):
Setting the write permission on a directory will enable files to be added
to it. Files created in the directory will be generally be assigned the
group ID of the directory, with exceptions including files added by cp(1)
with -p and mv(1).
Note that I haven't added cp(1) and mv(1) to the "SEE ALSO" because
their man pages don't sufficiently help explain chmod(1).
I hope I handled that last period OK; it looks OK on my xterm.
--- chmod..orig.1 Wed Jul 27 18:05:44 2005
+++ chmod.1 Sun Jul 31 10:35:18 2005
@@ -276,6 +276,16 @@
``o'' by itself), in combination with the
.Ar perm
symbols ``s'' or ``t'', are ignored.
+.Pp
+Setting the write permission on a directory will enable files to be
+added to it. Files created in the directory will be generally be
+assigned the group ID of the directory, with exceptions including
+files added by
+.Xr cp 1
+with
+.Fl p
+and
+.Xr mv 1 .
.Sh EXAMPLES
.Bl -tag -width "u=rwx,go=u-w" -compact
.It Li 644
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200507311750.j6VHoFTd066444>