From owner-freebsd-doc@FreeBSD.ORG  Sun Jul 31 20:30:19 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 B1F5216A420
	for <freebsd-doc@hub.freebsd.org>; Sun, 31 Jul 2005 20:30:19 +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 79AD343D45
	for <freebsd-doc@hub.freebsd.org>; Sun, 31 Jul 2005 20:30:19 +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 j6VKUJFi096480
	for <freebsd-doc@freefall.freebsd.org>; Sun, 31 Jul 2005 20:30:19 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j6VKUJNC096479;
	Sun, 31 Jul 2005 20:30:19 GMT (envelope-from gnats)
Date: Sun, 31 Jul 2005 20:30:19 GMT
Message-Id: <200507312030.j6VKUJNC096479@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: Giorgos Keramidas <keramida@freebsd.org>
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: Giorgos Keramidas <keramida@freebsd.org>
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 20:30:19 -0000

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

From: Giorgos Keramidas <keramida@freebsd.org>
To: "Gary W. Swearingen" <garys@opusnet.com>
Cc: bug-followup@freebsd.org
Subject: Re: docs/84265: chmod(1) manpage omits implication of setting w on directory
Date: Sun, 31 Jul 2005 23:25:09 +0300

 On 2005-07-31 17:50, "Gary W. Swearingen" <garys@opusnet.com> wrote:
 > 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).
 
 ``Files created in a directory will be assigned the group ID of the
 directory'' period.  The fact that cp(1) and mv(1) call chown to set
 the permissions to something else is a feature of those programs and
 not of the file creation code.
 
 I'm not sure if I am happy when features of programs are documented as
 the behavior of the file/directory creation code.
 
 Documenting the implications of write permission is important, but
 please let us not modify perfectly fine parts of the manpage :-/
 
 >  I hope I handled that last period OK; it looks OK on my xterm.
 > [...]
 >  +with
 >  +.Fl p
 >  +and
 >  +.Xr mv 1 .
 
 It is very fine, thanks for all the attention to the details :-)