docs/156815: manpage should describe that chmod kicks +t for file

[NARUSE at FreeBSD.org]

>Number:         156815
>Category:       docs
>Synopsis:       manpage should describe that chmod kicks +t for file
>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:   Wed May 04 14:20:08 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     NARUSE, Yui
>Release:        8.2
>Organization:
>Environment:
FreeBSD windy.airemix.net 8.2-RELEASE FreeBSD 8.2-RELEASE #0: Thu Feb 17 02:41:51 UTC 2011     root at mason.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  amd64

>Description:
FreeBSD's chmod(1) and chmod(2) can't set sticky bit to non-directories not in jail. (ufschmod in sys/ufs/ufs/ufs_vnops.c)
But manpages doesn't describe about it.
>How-To-Repeat:
% touch /tmp/a                                                                     % chmod +t /tmp/a                                                                  chmod: /tmp/a: Inappropriate file type or format
>Fix:


>Release-Note:
>Audit-Trail:
>Unformatted: