Bug 124468

Summary: sticky(8) should be sticky(7)
Product: Documentation Reporter: Ighighi <ighighi>
Component: Books & ArticlesAssignee: Remko Lodder <remko>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Ighighi 2008-06-11 10:10:04 UTC
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.
Comment 1 Remko Lodder freebsd_committer freebsd_triage 2008-06-12 11:53:48 UTC
Responsible Changed
From-To: freebsd-doc->remko

I'll take it.
Comment 2 dfilter service freebsd_committer freebsd_triage 2011-02-24 13:03:53 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"
Comment 3 Remko Lodder freebsd_committer freebsd_triage 2011-02-24 16:22:07 UTC
State Changed
From-To: open->patched

This had been committed to HEAD
Comment 4 dfilter service freebsd_committer freebsd_triage 2012-02-29 15:10:50 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"
Comment 5 dfilter service freebsd_committer freebsd_triage 2012-03-06 10:20:25 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"
Comment 6 Remko Lodder freebsd_committer freebsd_triage 2012-03-06 10:20:43 UTC
State Changed
From-To: patched->closed

Committed to all various stable/ branches.