From owner-freebsd-doc@FreeBSD.ORG  Sun Jul 31 21:30:15 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 A3A8416A41F
	for <freebsd-doc@hub.freebsd.org>; Sun, 31 Jul 2005 21:30:15 +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 6C65D43D48
	for <freebsd-doc@hub.freebsd.org>; Sun, 31 Jul 2005 21:30:15 +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 j6VLUFTt003719
	for <freebsd-doc@freefall.freebsd.org>; Sun, 31 Jul 2005 21:30:15 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j6VLUFwP003717;
	Sun, 31 Jul 2005 21:30:15 GMT (envelope-from gnats)
Date: Sun, 31 Jul 2005 21:30:15 GMT
Message-Id: <200507312130.j6VLUFwP003717@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: garys@opusnet.com (Gary W. Swearingen)
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: "Gary W. Swearingen" <garys@opusnet.com>
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 21:30:15 -0000

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

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

 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''.  Many users don't know or care about system libraries
 that do file creation or directory modification.  The fact is that
 some software creates it with one group and some creates it with
 another group.  Thus my "generally".
 
 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".
 
 > Documenting the implications of write permission is important, but
 > please let us not modify perfectly fine parts of the manpage :-/
 
 The only thing my new paragraph was modifying was the DESCRIPTION
 section.  I'm not sure which perfectly fine parts you mean.
 
 I've probably said enough; do as you wish.