docs/60068: stat(2) man page does not mention sticky(8) man page

[Ken Stailey]

>Number:         60068
>Category:       docs
>Synopsis:       stat(2) man page does not mention sticky(8) man page
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Dec 09 05:00:36 PST 2003
>Closed-Date:
>Last-Modified:
>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 at 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:
>Unformatted: