From owner-freebsd-doc  Fri Jan 24 15:20: 6 2003
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 0BD9237B401
	for <freebsd-doc@hub.freebsd.org>; Fri, 24 Jan 2003 15:20:04 -0800 (PST)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id A8B3743E4A
	for <freebsd-doc@hub.freebsd.org>; Fri, 24 Jan 2003 15:20:03 -0800 (PST)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.12.6/8.12.6) with ESMTP id h0ONK3NS033214
	for <freebsd-doc@freefall.freebsd.org>; Fri, 24 Jan 2003 15:20:03 -0800 (PST)
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.12.6/8.12.6/Submit) id h0ONK2LH033213;
	Fri, 24 Jan 2003 15:20:02 -0800 (PST)
Date: Fri, 24 Jan 2003 15:20:02 -0800 (PST)
Message-Id: <200301242320.h0ONK2LH033213@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
Cc: 
From: Giorgos Keramidas <keramida@freebsd.org>
Subject: Re: docs/46415: Proposed change in man-page wording for "chown"
Reply-To: Giorgos Keramidas <keramida@freebsd.org>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org

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

From: Giorgos Keramidas <keramida@freebsd.org>
To: bug-followup@freebsd.org
Cc: System Administrator <root@asarian-host.net>,
	"Gary W. Swearingen" <swear@attbi.com>
Subject: Re: docs/46415: Proposed change in man-page wording for "chown"
Date: Sat, 25 Jan 2003 01:15:08 +0200

 swear@attbi.com (Gary W. Swearingen) wrote:
 >It could be more clear about being recursive.  Maybe:
 >
 >  -R  Change the user ID and/or the group ID of the directory entries
 >      specified by the "file" arguments and, recursively, the contents
 >      of any directory subtrees named by those directory entries.
 >
 >(A little verbose, even redundant -- but clear, IMO.  I'd probably end
 >it "... subtrees so specified." if it didn't sound too archaic.)
 
 The current description of -R in chown(8) is the same in the current
 and stable branches:
 
    -R   Change the user ID and/or the group ID for the file hierarchies
         rooted in the files instead of just the files themselves.
 
 Instead of replacing it altogether with a new version, we could add a
 note to it.  I was thinking of something like:
 
     Index: chown.8
     ===================================================================
     RCS file: /home/ncvs/src/usr.sbin/chown/chown.8,v
     retrieving revision 1.20
     diff -u -r1.20 chown.8
     --- chown.8	14 Jul 2002 14:42:43 -0000	1.20
     +++ chown.8	24 Jan 2003 23:09:45 -0000
     @@ -82,6 +82,11 @@
      .It Fl R
      Change the user ID and/or the group ID for the file hierarchies rooted
      in the files instead of just the files themselves.
     +Be careful when you use wildcard patterns that include a dot
     +.Ql \&.
     +character, since when expanded by your shell it might result in
     +.Nm
     +changing files outside of the current directory.
      .It Fl f
      Don't report any failure to change file owner or group, nor modify
      the exit status to reflect such failures.
 
 What do you think?
 

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message