From owner-freebsd-doc@FreeBSD.ORG  Mon Aug  1 09:00:41 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 C8EE216A41F
	for <freebsd-doc@hub.freebsd.org>; Mon,  1 Aug 2005 09:00:41 +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 954C143D45
	for <freebsd-doc@hub.freebsd.org>; Mon,  1 Aug 2005 09:00:41 +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 j7190f5v098466
	for <freebsd-doc@freefall.freebsd.org>; Mon, 1 Aug 2005 09:00:41 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j7190fRw098465;
	Mon, 1 Aug 2005 09:00:41 GMT (envelope-from gnats)
Date: Mon, 1 Aug 2005 09:00:41 GMT
Message-Id: <200508010900.j7190fRw098465@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: Mon, 01 Aug 2005 09:00:41 -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: Mon, 1 Aug 2005 11:59:35 +0300

 On 2005-07-31 14:25, "Gary W. Swearingen" <garys@opusnet.com> wrote:
 >Giorgos Keramidas <keramida@freebsd.org> writes:
 >> I'm not sure if I am happy when features of programs are documented as
 >> the behavior of the file/directory creation code.
 >
 > I wasn't sure, either. But users with a different concept of "created"
 > than a Unix programmer will cry "FALSE" when they read your ``Files
 > created in a directory will be assigned the group ID of the
 > directory''.
 
 Ah, I see.  Good point.
 
 > If you want your sentence, it should at least have another saying
 > something like: "This rule has exceptions." or "Some software will
 > appear to violate this convention".
 
 How about a note that...
 
 	There are exceptions, since some programs by design (or because
 	it was requested with a special command-line option) need to
 	create the files and then modify their owner and/or permissions
 	for various reasons.  Such exceptions include:
 
 	*	The cp(1) utility when the -p option is used.
 
 	*	The mv(1) utility.
 
 	*	Archiving tools, like cpio(1) or tar(1).
 
 	*	Backup tools, like restore(8)
 
 Does that look ok?
 
 > I've probably said enough; do as you wish.
 
 Ehm.  No, please keep saying.  Your comments have been extremely useful
 as a means to improve the manpages so far :-)