From owner-freebsd-doc@FreeBSD.ORG  Sun Jul 31 13:50:13 2005
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: freebsd-doc@hub.freebsd.org
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id E9CE916A41F
	for <freebsd-doc@hub.freebsd.org>; Sun, 31 Jul 2005 13:50:13 +0000 (GMT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id A753343D46
	for <freebsd-doc@hub.freebsd.org>; Sun, 31 Jul 2005 13:50:13 +0000 (GMT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.13.3/8.13.3) with ESMTP id j6VDoDSb029056
	for <freebsd-doc@freefall.freebsd.org>; Sun, 31 Jul 2005 13:50:13 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j6VDoDdx029054;
	Sun, 31 Jul 2005 13:50:13 GMT (envelope-from gnats)
Date: Sun, 31 Jul 2005 13:50:13 GMT
Message-Id: <200507311350.j6VDoDdx029054@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: Ceri Davies <ceri@submonkey.net>
Cc: 
Subject: Re: docs/84265: chmod(1) manpage omits implication of setting w on
	directory
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: Ceri Davies <ceri@submonkey.net>
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 31 Jul 2005 13:50:14 -0000

The following reply was made to PR docs/84265; it has been noted by GNATS.

From: Ceri Davies <ceri@submonkey.net>
To: garys@opusnet.com
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 14:44:38 +0100

 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.
 Also, the reference to "owner" should be "user id", as the creator of  
 the file probably doesn't have an owner ;)
 
 > --- /pr/work/chmod..orig.1    Wed Jul 27 18:05:44 2005
 > +++ /pr/work/chmod.1    Wed Jul 27 18:14:08 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
 > +moved into or copied into or created in the directory.  Files
 > +created in the directory (eg, by
 > +.Nm >
 
 Here too.
 
 > +or an editor, but not by
 > +.Nm mv
 > +or
 > +.Nm cp )
 > +will be assigned the group of the directory.
 
 "Group id" (or similar) wins over "group" here for me, too.
 
 Ceri
 -- 
 Only two things are infinite, the universe and human stupidity, and I'm
 not sure about the former.                        -- Einstein (attrib.)