From kstailey@hermes.tubas.net  Tue Dec  9 04:54:04 2003
Return-Path: <kstailey@hermes.tubas.net>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id AC8CA16A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  9 Dec 2003 04:54:04 -0800 (PST)
Received: from rwcrmhc12.comcast.net (rwcrmhc12.comcast.net [216.148.227.85])
	by mx1.FreeBSD.org (Postfix) with ESMTP id BDB9C43D2D
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  9 Dec 2003 04:54:03 -0800 (PST)
	(envelope-from kstailey@hermes.tubas.net)
Received: from hermes.tubas.net ([69.138.231.17])
          by comcast.net (rwcrmhc12) with ESMTP
          id <2003120912540301400bo516e>; Tue, 9 Dec 2003 12:54:03 +0000
Received: from hermes.trickster.gods (localhost.trickster.gods [127.0.0.1])
	by hermes.tubas.net (8.12.10/8.12.10) with ESMTP id hB9Cs2Gv074079
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 9 Dec 2003 07:54:02 -0500 (EST)
	(envelope-from kstailey@hermes.trickster.gods)
Received: (from kstailey@localhost)
	by hermes.trickster.gods (8.12.10/8.12.10/Submit) id hB9Cs1as074078;
	Tue, 9 Dec 2003 07:54:01 -0500 (EST)
	(envelope-from kstailey)
Message-Id: <200312091254.hB9Cs1as074078@hermes.trickster.gods>
Date: Tue, 9 Dec 2003 07:54:01 -0500 (EST)
From: Ken Stailey <kstailey@yahoo.com>
Reply-To: Ken Stailey <kstailey@yahoo.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: stat(2) man page does not mention sticky(8) man page
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         60068
>Category:       docs
>Synopsis:       stat(2) man page does not mention sticky(8) man page
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    dds
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Dec 09 05:00:36 PST 2003
>Closed-Date:    Thu Dec 25 22:32:10 GMT 2003
>Last-Modified:  Thu Dec 25 22:32:10 GMT 2003
>Originator:     Ken Stailey
>Release:        FreeBSD 4.9-STABLE i386
>Organization:
self
>Environment:
System: FreeBSD hermes.trickster.gods 4.9-STABLE FreeBSD 4.9-STABLE #45: Sat Dec 6 11:57:53 EST 2003 kstailey@hermes.trickster.gods:/usr/obj/usr/src/sys/HERMES i386


	
>Description:
The stat(2) manpage only has obsolete documention about the sticky bit.
There is not even a cross-reference to the sticky(8) man page.

>How-To-Repeat:
"man 2 stat"

>Fix:
At the least:

--- stat.2      14 Dec 2001 18:34:01 -0000      1.16.2.7
+++ stat.2      8 Dec 2003 13:44:55 -0000
@@ -188,7 +188,7 @@
 #define        S_IFWHT  0160000  /* whiteout */
 #define S_ISUID 0004000  /* set user id on execution */
 #define S_ISGID 0002000  /* set group id on execution */
-#define S_ISVTX 0001000  /* save swapped text even after use */
+#define S_ISVTX 0001000  /* save swapped text even after use; see sticky(8) */
 #define S_IRUSR 0000400  /* read permission, owner */
 #define S_IWUSR 0000200  /* write permission, owner */
 #define S_IXUSR 0000100  /* execute/search permission, owner */
@@ -255,6 +255,7 @@
 .Xr chmod 2 ,
 .Xr chown 2 ,
 .Xr utimes 2 ,
+.Xr sticky 8 ,
 .Xr symlink 7
 .Sh BUGS
 Applying

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->dds 
Responsible-Changed-By: dds 
Responsible-Changed-When: Wed Dec 10 15:16:32 GMT 2003 
Responsible-Changed-Why:  
Got email from the submitter as last committer in the page.


http://www.freebsd.org/cgi/query-pr.cgi?pr=60068 
State-Changed-From-To: open->patched 
State-Changed-By: dds 
State-Changed-When: Wed Dec 10 15:17:40 GMT 2003 
State-Changed-Why:  
Added the suggested sticky(8) xref in -HEAD. 
Did not modify the suggested comment change to keep it in sync with the 
actual header file. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=60068 
State-Changed-From-To: patched->closed 
State-Changed-By: dds 
State-Changed-When: Thu Dec 25 22:30:17 GMT 2003 
State-Changed-Why:  
MFC change to RELENG_4 and no objection on the patch from the submitter. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=60068 
>Unformatted:
