From nobody@FreeBSD.org  Wed Jun 11 09:09:55 2008
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 2378D106566B
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 11 Jun 2008 09:09:55 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id F34C08FC15
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 11 Jun 2008 09:09:54 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.2/8.14.2) with ESMTP id m5B99sk2037293
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 11 Jun 2008 09:09:54 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.2/8.14.1/Submit) id m5B99s1T037292;
	Wed, 11 Jun 2008 09:09:54 GMT
	(envelope-from nobody)
Message-Id: <200806110909.m5B99s1T037292@www.freebsd.org>
Date: Wed, 11 Jun 2008 09:09:54 GMT
From: Ighighi <ighighi@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: sticky(8) should be sticky(7)
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         124468
>Category:       docs
>Synopsis:       sticky(8) should be sticky(7)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    remko
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jun 11 09:10:04 UTC 2008
>Closed-Date:    Tue Mar 06 10:20:44 UTC 2012
>Last-Modified:  Tue Mar  6 10:30:09 UTC 2012
>Originator:     Ighighi
>Release:        6.3-STABLE
>Organization:
>Environment:
FreeBSD 6.3-STABLE #0: Wed Jun  4 15:18:20 VET 2008
>Description:
There's no sticky(8) command in *BSD.  The proper place is in (7), as is the
case with NetBSD (fixed 4 years ago).

Take a look at:
http://cvsweb.netbsd.org/bsdweb.cgi/src/share/man/man7/sticky.7

It may be worth to merge the info present there.
>How-To-Repeat:

>Fix:


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->remko 
Responsible-Changed-By: remko 
Responsible-Changed-When: Thu Jun 12 10:53:48 UTC 2008 
Responsible-Changed-Why:  
I'll take it. 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/124468: commit references a PR
Date: Thu, 24 Feb 2011 13:03:53 +0000 (UTC)

 Author: remko
 Date: Thu Feb 24 13:03:47 2011
 New Revision: 218998
 URL: http://svn.freebsd.org/changeset/base/218998
 
 Log:
   Move the sticky manual from section 8 to section
   7 like NetBSD has, since this is not a command
   on itself.
   
   PR:		124468
   MFC after:	1 week
 
 Added:
   head/share/man/man7/sticky.7
      - copied, changed from r196178, head/share/man/man8/sticky.8
 Deleted:
   head/share/man/man8/sticky.8
 Modified:
   head/share/man/man7/Makefile
   head/share/man/man8/Makefile
 
 Modified: head/share/man/man7/Makefile
 ==============================================================================
 --- head/share/man/man7/Makefile	Thu Feb 24 11:09:41 2011	(r218997)
 +++ head/share/man/man7/Makefile	Thu Feb 24 13:03:47 2011	(r218998)
 @@ -25,6 +25,7 @@ MAN=	adding_user.7 \
  	security.7 \
  	sprog.7 \
  	stdint.7 \
 +	sticky.7 \
  	tuning.7
  
  MLINKS=	intro.7 miscellaneous.7
 
 Copied and modified: head/share/man/man7/sticky.7 (from r196178, head/share/man/man8/sticky.8)
 ==============================================================================
 --- head/share/man/man8/sticky.8	Thu Aug 13 10:31:02 2009	(r196178, copy source)
 +++ head/share/man/man7/sticky.7	Thu Feb 24 13:03:47 2011	(r218998)
 @@ -33,7 +33,7 @@
  .\" $FreeBSD$
  .\"
  .Dd June 5, 1993
 -.Dt STICKY 8
 +.Dt STICKY 7
  .Os
  .Sh NAME
  .Nm sticky
 
 Modified: head/share/man/man8/Makefile
 ==============================================================================
 --- head/share/man/man8/Makefile	Thu Feb 24 11:09:41 2011	(r218997)
 +++ head/share/man/man8/Makefile	Thu Feb 24 13:03:47 2011	(r218998)
 @@ -10,7 +10,6 @@ MAN=	crash.8 \
  	rc.sendmail.8 \
  	rc.subr.8 \
  	rescue.8 \
 -	sticky.8 \
  	yp.8
  
  MLINKS=	rc.8 rc.atm.8 \
 _______________________________________________
 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: open->patched 
State-Changed-By: remko 
State-Changed-When: Thu Feb 24 16:22:07 UTC 2011 
State-Changed-Why:  
This had been committed to HEAD 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/124468: commit references a PR
Date: Wed, 29 Feb 2012 15:10:50 +0000 (UTC)

 Author: remko
 Date: Wed Feb 29 15:10:34 2012
 New Revision: 232302
 URL: http://svn.freebsd.org/changeset/base/232302
 
 Log:
   MFC r124468
   
   Move the sticky manual from section 8 to section
   7 like NetBSD has, since this is not a command
   on itself.
   
   PR:		124468
 
 Added:
   stable/7/share/man/man7/sticky.7
      - copied unchanged from r218998, head/share/man/man7/sticky.7
 Deleted:
   stable/7/share/man/man8/sticky.8
 Modified:
   stable/7/share/man/man7/Makefile
   stable/7/share/man/man8/Makefile
 Directory Properties:
   stable/7/share/man/   (props changed)
   stable/7/share/man/man7/   (props changed)
   stable/7/share/man/man8/   (props changed)
 
 Modified: stable/7/share/man/man7/Makefile
 ==============================================================================
 --- stable/7/share/man/man7/Makefile	Wed Feb 29 15:09:20 2012	(r232301)
 +++ stable/7/share/man/man7/Makefile	Wed Feb 29 15:10:34 2012	(r232302)
 @@ -23,6 +23,7 @@ MAN=	adding_user.7 \
  	security.7 \
  	sprog.7 \
  	stdint.7 \
 +	sticky.7 \
  	tuning.7
  
  MLINKS=	intro.7 miscellaneous.7
 
 Copied: stable/7/share/man/man7/sticky.7 (from r218998, head/share/man/man7/sticky.7)
 ==============================================================================
 --- /dev/null	00:00:00 1970	(empty, because file is newly added)
 +++ stable/7/share/man/man7/sticky.7	Wed Feb 29 15:10:34 2012	(r232302, copy of r218998, head/share/man/man7/sticky.7)
 @@ -0,0 +1,82 @@
 +.\" Copyright (c) 1980, 1991, 1993
 +.\"	The Regents of the University of California.  All rights reserved.
 +.\"
 +.\" Redistribution and use in source and binary forms, with or without
 +.\" modification, are permitted provided that the following conditions
 +.\" are met:
 +.\" 1. Redistributions of source code must retain the above copyright
 +.\"    notice, this list of conditions and the following disclaimer.
 +.\" 2. Redistributions in binary form must reproduce the above copyright
 +.\"    notice, this list of conditions and the following disclaimer in the
 +.\"    documentation and/or other materials provided with the distribution.
 +.\" 3. All advertising materials mentioning features or use of this software
 +.\"    must display the following acknowledgement:
 +.\"	This product includes software developed by the University of
 +.\"	California, Berkeley and its contributors.
 +.\" 4. Neither the name of the University nor the names of its contributors
 +.\"    may be used to endorse or promote products derived from this software
 +.\"    without specific prior written permission.
 +.\"
 +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 +.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 +.\" SUCH DAMAGE.
 +.\"
 +.\"     @(#)sticky.8	8.1 (Berkeley) 6/5/93
 +.\" $FreeBSD$
 +.\"
 +.Dd June 5, 1993
 +.Dt STICKY 7
 +.Os
 +.Sh NAME
 +.Nm sticky
 +.Nd sticky text and append-only directories
 +.Sh DESCRIPTION
 +A special file mode, called the
 +.Em sticky bit
 +(mode S_ISTXT),
 +is used to indicate special treatment
 +for directories.
 +It is ignored for regular files.
 +See
 +.Xr chmod 2
 +or
 +the file
 +.In sys/stat.h
 +for an explanation of file modes.
 +.Sh STICKY DIRECTORIES
 +A directory whose `sticky bit' is set
 +becomes an append-only directory, or, more accurately,
 +a directory in which the deletion of files is restricted.
 +A file in a sticky directory may only be removed or renamed
 +by a user if the user has write permission for the directory and
 +the user is the owner of the file, the owner of the directory,
 +or the super-user.
 +This feature is usefully applied to directories such as
 +.Pa /tmp
 +which must be publicly writable but
 +should deny users the license to arbitrarily
 +delete or rename each others' files.
 +.Pp
 +Any user may create a sticky directory.
 +See
 +.Xr chmod 1
 +for details about modifying file modes.
 +.Sh HISTORY
 +A
 +.Nm
 +command appeared in
 +.At 32v .
 +.Sh BUGS
 +Neither
 +.Xr open 2
 +nor
 +.Xr mkdir 2
 +will create a file with the sticky bit set.
 
 Modified: stable/7/share/man/man8/Makefile
 ==============================================================================
 --- stable/7/share/man/man8/Makefile	Wed Feb 29 15:09:20 2012	(r232301)
 +++ stable/7/share/man/man8/Makefile	Wed Feb 29 15:10:34 2012	(r232302)
 @@ -10,7 +10,6 @@ MAN=	crash.8 \
  	rc.sendmail.8 \
  	rc.subr.8 \
  	rescue.8 \
 -	sticky.8 \
  	yp.8
  
  MLINKS=	rc.8 rc.atm.8 \
 _______________________________________________
 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: remko 
State-Changed-When: Tue Mar 6 10:20:43 UTC 2012 
State-Changed-Why:  
Committed to all various stable/ branches. 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/124468: commit references a PR
Date: Tue,  6 Mar 2012 10:20:25 +0000 (UTC)

 Author: remko
 Date: Tue Mar  6 10:20:15 2012
 New Revision: 232593
 URL: http://svn.freebsd.org/changeset/base/232593
 
 Log:
   Merge r218998
   
   Move the sticky manual from section 8 to section
   7 like NetBSD has, since this is not a command
   on itself.
   
   PR: 124468
 
 Added:
   stable/8/share/man/man7/sticky.7
      - copied unchanged from r218998, head/share/man/man7/sticky.7
 Deleted:
   stable/8/share/man/man8/sticky.8
 Modified:
   stable/8/share/man/man7/Makefile
   stable/8/share/man/man8/Makefile
 Directory Properties:
   stable/8/share/man/   (props changed)
   stable/8/share/man/man7/   (props changed)
   stable/8/share/man/man8/   (props changed)
 
 Modified: stable/8/share/man/man7/Makefile
 ==============================================================================
 --- stable/8/share/man/man7/Makefile	Tue Mar  6 09:57:50 2012	(r232592)
 +++ stable/8/share/man/man7/Makefile	Tue Mar  6 10:20:15 2012	(r232593)
 @@ -23,6 +23,7 @@ MAN=	adding_user.7 \
  	security.7 \
  	sprog.7 \
  	stdint.7 \
 +	sticky.7 \
  	tuning.7
  
  MLINKS=	intro.7 miscellaneous.7
 
 Copied: stable/8/share/man/man7/sticky.7 (from r218998, head/share/man/man7/sticky.7)
 ==============================================================================
 --- /dev/null	00:00:00 1970	(empty, because file is newly added)
 +++ stable/8/share/man/man7/sticky.7	Tue Mar  6 10:20:15 2012	(r232593, copy of r218998, head/share/man/man7/sticky.7)
 @@ -0,0 +1,82 @@
 +.\" Copyright (c) 1980, 1991, 1993
 +.\"	The Regents of the University of California.  All rights reserved.
 +.\"
 +.\" Redistribution and use in source and binary forms, with or without
 +.\" modification, are permitted provided that the following conditions
 +.\" are met:
 +.\" 1. Redistributions of source code must retain the above copyright
 +.\"    notice, this list of conditions and the following disclaimer.
 +.\" 2. Redistributions in binary form must reproduce the above copyright
 +.\"    notice, this list of conditions and the following disclaimer in the
 +.\"    documentation and/or other materials provided with the distribution.
 +.\" 3. All advertising materials mentioning features or use of this software
 +.\"    must display the following acknowledgement:
 +.\"	This product includes software developed by the University of
 +.\"	California, Berkeley and its contributors.
 +.\" 4. Neither the name of the University nor the names of its contributors
 +.\"    may be used to endorse or promote products derived from this software
 +.\"    without specific prior written permission.
 +.\"
 +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 +.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 +.\" SUCH DAMAGE.
 +.\"
 +.\"     @(#)sticky.8	8.1 (Berkeley) 6/5/93
 +.\" $FreeBSD$
 +.\"
 +.Dd June 5, 1993
 +.Dt STICKY 7
 +.Os
 +.Sh NAME
 +.Nm sticky
 +.Nd sticky text and append-only directories
 +.Sh DESCRIPTION
 +A special file mode, called the
 +.Em sticky bit
 +(mode S_ISTXT),
 +is used to indicate special treatment
 +for directories.
 +It is ignored for regular files.
 +See
 +.Xr chmod 2
 +or
 +the file
 +.In sys/stat.h
 +for an explanation of file modes.
 +.Sh STICKY DIRECTORIES
 +A directory whose `sticky bit' is set
 +becomes an append-only directory, or, more accurately,
 +a directory in which the deletion of files is restricted.
 +A file in a sticky directory may only be removed or renamed
 +by a user if the user has write permission for the directory and
 +the user is the owner of the file, the owner of the directory,
 +or the super-user.
 +This feature is usefully applied to directories such as
 +.Pa /tmp
 +which must be publicly writable but
 +should deny users the license to arbitrarily
 +delete or rename each others' files.
 +.Pp
 +Any user may create a sticky directory.
 +See
 +.Xr chmod 1
 +for details about modifying file modes.
 +.Sh HISTORY
 +A
 +.Nm
 +command appeared in
 +.At 32v .
 +.Sh BUGS
 +Neither
 +.Xr open 2
 +nor
 +.Xr mkdir 2
 +will create a file with the sticky bit set.
 
 Modified: stable/8/share/man/man8/Makefile
 ==============================================================================
 --- stable/8/share/man/man8/Makefile	Tue Mar  6 09:57:50 2012	(r232592)
 +++ stable/8/share/man/man8/Makefile	Tue Mar  6 10:20:15 2012	(r232593)
 @@ -10,7 +10,6 @@ MAN=	crash.8 \
  	rc.sendmail.8 \
  	rc.subr.8 \
  	rescue.8 \
 -	sticky.8 \
  	yp.8
  
  MLINKS=	rc.8 rc.atm.8 \
 _______________________________________________
 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:
