From garys@opusnet.com  Fri Jul 29 03:54:33 2005
Return-Path: <garys@opusnet.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 3785016A41F
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 29 Jul 2005 03:54:33 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from opusnet.com (mail.opusnet.com [209.210.200.6])
	by mx1.FreeBSD.org (Postfix) with ESMTP id E387643D45
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 29 Jul 2005 03:54:32 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from localhost.localhost [70.98.246.232] by opusnet.com with ESMTP
  (SMTPD32-8.05) id A8775DBF0102; Thu, 28 Jul 2005 20:54:31 -0700
Received: from localhost.localhost (localhost.localhost [127.0.0.1])
	by localhost.localhost (8.13.3/8.13.3) with ESMTP id j6T3tWmw082123
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 28 Jul 2005 20:55:32 -0700 (PDT)
	(envelope-from garys@opusnet.com)
Received: (from jojo@localhost)
	by localhost.localhost (8.13.3/8.13.3/Submit) id j6T3tRWQ082122;
	Thu, 28 Jul 2005 20:55:27 -0700 (PDT)
	(envelope-from garys@opusnet.com)
Message-Id: <9iek9ib70w.k9i@mail.opusnet.com>
Date: Thu, 28 Jul 2005 20:55:27 -0700
From: "Gary W. Swearingen" <garys@opusnet.com>
Reply-To: garys@opusnet.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: chmod(1) manpage's BUGS entry is either wrong or too cryptic
X-GNATS-Notify:

>Number:         84268
>Category:       docs
>Synopsis:       chmod(1) manpage's BUGS entry is either wrong or too cryptic
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jul 29 04:00:26 GMT 2005
>Closed-Date:    Tue Jun 14 22:52:44 UTC 2011
>Last-Modified:  Tue Jun 14 23:00:20 UTC 2011
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 5.4-RELEASE i386
>Organization:
none
>Environment:
n/a
>Description:

It says:  There's no perm option for the naughty bits.

If true, it needs to explain "naughty bits".  There's a "perm option"
for SUID, GUID, and sticky bits. What else is naughty?

>How-To-Repeat:
n/a

>Fix:
Remove the BUGS section.
>Release-Note:
>Audit-Trail:

From: Ceri Davies <ceri@submonkey.net>
To: garys@opusnet.com
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/84268: chmod(1) manpage's BUGS entry is either wrong or too cryptic
Date: Sun, 31 Jul 2005 14:39:09 +0100

 On 29 Jul 2005, at 04:55, Gary W. Swearingen wrote:
 >
 > It says:  There's no perm option for the naughty bits.
 >
 > If true, it needs to explain "naughty bits".  There's a "perm option"
 > for SUID, GUID, and sticky bits. What else is naughty?
 
 I think that might actually be a joke.
 
 Failing that, it means 'S' and 'T'.
 
 Ceri
 -- 
 Only two things are infinite, the universe and human stupidity, and I'm
 not sure about the former.                        -- Einstein (attrib.)
 
 

From: garys@opusnet.com (Gary W. Swearingen)
To: Ceri Davies <ceri@submonkey.net>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/84268: chmod(1) manpage's BUGS entry is either wrong or
 too cryptic
Date: Sun, 31 Jul 2005 08:27:19 -0700

 Ceri Davies <ceri@submonkey.net> writes:
 
 > Failing that, it means 'S' and 'T'.
 
 Then the BUG entry doesn't say what it means and will waste people's
 time trying to figure out what it does mean.
 
 I still think the BUGS section should be removed.
 
 Or I can make a new patch with:
 
   There is no "perm" option which sets the sticky bit and also unsets
   the execute/search bit, and vice-versa, depending upon the "op"
   value.  The same applies to each of the setuid and setgid bits.
 
   There once was a man from Nantucket...
 
 I sure don't see that as a BUG; just a (good) design decision.

From: Ceri Davies <ceri@submonkey.net>
To: "Gary W. Swearingen" <garys@opusnet.com>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/84268: chmod(1) manpage's BUGS entry is either wrong or too cryptic
Date: Mon, 1 Aug 2005 23:14:09 +0100

 On 31 Jul 2005, at 15:30, Gary W. Swearingen wrote:
 >  Ceri Davies <ceri@submonkey.net> writes:
 >
 >
 >> Failing that, it means 'S' and 'T'.
 >>
 >
 >  Then the BUG entry doesn't say what it means and will waste people's
 >  time trying to figure out what it does mean.
 
 I agree.
 
 >  I still think the BUGS section should be removed.
 
 I agree.
 
 >  Or I can make a new patch with:
 >
 >    There is no "perm" option which sets the sticky bit and also unsets
 >    the execute/search bit, and vice-versa, depending upon the "op"
 >    value.  The same applies to each of the setuid and setgid bits.
 >
 >    There once was a man from Nantucket...
 >
 >  I sure don't see that as a BUG; just a (good) design decision.
 
 I agree.
 
 Anyone disagree?  (You have two days to say so).
 
 Ceri
 -- 
 Only two things are infinite, the universe and human stupidity, and I'm
 not sure about the former.                        -- Einstein (attrib.)
 
 

From: Daniel Gerzo <danger@rulez.sk>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/84268: chmod(1) manpage's BUGS entry is either wrong or too cryptic
Date: Mon, 2 Jan 2006 16:26:46 +0100

 --bg08WKrSYDhXBjb5
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 Ciao,
 
    let's do it ;)
 
 -- 
 Best Regards,
    Daniel Gerzo
 
 --bg08WKrSYDhXBjb5
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="chmod.1.diff"
 
 --- chmod.1~	Mon Jan  2 16:23:27 2006
 +++ chmod.1	Mon Jan  2 16:24:05 2006
 @@ -336,7 +336,3 @@
  .Nm
  command appeared in
  .At v1 .
 -.Sh BUGS
 -There is no
 -.Ar perm
 -option for the naughty bits.
 
 --bg08WKrSYDhXBjb5--

From: Pav Lucistnik <pav@FreeBSD.org>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/84268: chmod(1) manpage's BUGS entry is either wrong or
	too cryptic
Date: Mon, 02 Jan 2006 16:34:44 +0100

 Sounds like a well placed reference to Monty Python's naughty bits
 sketch to me. It survived there for 11 years - from the initial
 revision.
 
 -- 
 Pav Lucistnik <pav@oook.cz>
               <pav@FreeBSD.org>
 
 Go back to bed America, your government is in control again. Here's American
 Gladiators. Watch this, shut up. Here's 56 channels of it. Watch these
 pituitary retards bang their fuckin skulls together and congratulate you on
 living in the land of freedom.
   -- Bill Hicks

From: Ceri Davies <ceri@submonkey.net>
To: freebsd-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/84268: chmod(1) manpage's BUGS entry is either wrong or too cryptic
Date: Mon, 2 Jan 2006 17:13:20 +0000

 On 2 Jan 2006, at 15:40, Pav Lucistnik wrote:
 
 >  Sounds like a well placed reference to Monty Python's naughty bits
 >  sketch to me. It survived there for 11 years - from the initial
 >  revision.
 
 You mean this?  http://orangecow.org/pythonet/sketches/naughty.htm
 I still don't get it, I'm afraid.
 
 Ceri
State-Changed-From-To: open->patched 
State-Changed-By: trhodes 
State-Changed-When: Fri Jan 23 11:39:14 UTC 2009 
State-Changed-Why:  
Discussion on 'naughty bits' expanded.  Thanks. 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Fri Jan 23 11:39:14 UTC 2009 
Responsible-Changed-Why:  
Over to me. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=84268 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/84268: commit references a PR
Date: Fri, 23 Jan 2009 11:39:11 +0000 (UTC)

 Author: trhodes
 Date: Fri Jan 23 11:39:00 2009
 New Revision: 187627
 URL: http://svn.freebsd.org/changeset/base/187627
 
 Log:
   Note the implication of setting the 'w' permission on directories,
   while here, expand the 'naughty bits' comment in BUGS.
   
   PR:		84265 and 84268
   Reviewed by:	keramida
   Obtained from:	hints from ceri, keramida
 
 Modified:
   head/bin/chmod/chmod.1
 
 Modified: head/bin/chmod/chmod.1
 ==============================================================================
 --- head/bin/chmod/chmod.1	Fri Jan 23 11:11:29 2009	(r187626)
 +++ head/bin/chmod/chmod.1	Fri Jan 23 11:39:00 2009	(r187627)
 @@ -32,7 +32,7 @@
  .\"	@(#)chmod.1	8.4 (Berkeley) 3/31/94
  .\" $FreeBSD$
  .\"
 -.Dd December 22, 2006
 +.Dd January 23, 2009
  .Dt CHMOD 1
  .Os
  .Sh NAME
 @@ -281,6 +281,10 @@ Operations upon the other permissions on
  ``o'' by itself), in combination with the
  .Ar perm
  symbols ``s'' or ``t'', are ignored.
 +.Pp
 +The ``w'' permission on directories will permit file creation, relocation,
 +and copy into that directory.
 +Files created within the directory itself will inherit its group ID.
  .Sh EXAMPLES
  .Bl -tag -width "u=rwx,go=u-w" -compact
  .It Li 644
 @@ -343,4 +347,5 @@ command appeared in
  .Sh BUGS
  There is no
  .Ar perm
 -option for the naughty bits.
 +option for the naughty bits which are ``S'' and
 +``T'' respectively.
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: gjb 
State-Changed-When: Tue Jun 14 22:52:31 UTC 2011 
State-Changed-Why:  
MFCd to stable/7. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=84268 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/84268: commit references a PR
Date: Tue, 14 Jun 2011 22:52:38 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Tue Jun 14 22:52:24 2011
 New Revision: 223102
 URL: http://svn.freebsd.org/changeset/base/223102
 
 Log:
   MFC 187627 by trhodes:
   
   Note the implication of setting the 'w' permission on directories,
   while here, expand the 'naughty bits' comment in BUGS.
   
   PR:		84268
 
 Modified:
   stable/7/bin/chmod/chmod.1
 Directory Properties:
   stable/7/bin/chmod/   (props changed)
 
 Modified: stable/7/bin/chmod/chmod.1
 ==============================================================================
 --- stable/7/bin/chmod/chmod.1	Tue Jun 14 22:40:13 2011	(r223101)
 +++ stable/7/bin/chmod/chmod.1	Tue Jun 14 22:52:24 2011	(r223102)
 @@ -32,7 +32,7 @@
  .\"	@(#)chmod.1	8.4 (Berkeley) 3/31/94
  .\" $FreeBSD$
  .\"
 -.Dd December 22, 2006
 +.Dd January 23, 2009
  .Dt CHMOD 1
  .Os
  .Sh NAME
 @@ -281,6 +281,10 @@ Operations upon the other permissions on
  ``o'' by itself), in combination with the
  .Ar perm
  symbols ``s'' or ``t'', are ignored.
 +.Pp
 +The ``w'' permission on directories will permit file creation, relocation,
 +and copy into that directory.
 +Files created within the directory itself will inherit its group ID.
  .Sh EXAMPLES
  .Bl -tag -width "u=rwx,go=u-w" -compact
  .It Li 644
 @@ -343,4 +347,5 @@ command appeared in
  .Sh BUGS
  There is no
  .Ar perm
 -option for the naughty bits.
 +option for the naughty bits which are ``S'' and
 +``T'' respectively.
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
>Unformatted:
