bin/165873: tar(1) manpage advertises --uid and --gid which seem to be not implemented

[Stas Verberkt]

>Number:         165873
>Category:       bin
>Synopsis:       tar(1) manpage advertises --uid and --gid which seem to be not implemented
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Mar 09 10:10:09 UTC 2012
>Closed-Date:
>Last-Modified:
>Originator:     Stas Verberkt
>Release:        9.0-RELEASE
>Organization:
>Environment:
FreeBSD homey.local 9.0-RELEASE FreeBSD 9.0-RELEASE #0: Tue Jan  3 07:15:25 UTC 2012     root at obrian.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  i386
>Description:
Mr. Devin Teske reported on the freebsd-questions list that the switches --uid and --gid would result in an option not implemented failure, although these options are advertised in the manpage [1]. While looking through the source the option indeed seemed not to be there [2]. It was added to the manpage as part of a cleanup process [3].

[1] lists.freebsd.org/pipermail/freebsd-questions/2012-March/239182.html
[2] http://svnweb.freebsd.org/base/releng/9.0/usr.bin/tar/cmdline.c?view=markup
[3] http://svnweb.freebsd.org/base?view=revision&revision=207786
>How-To-Repeat:
execute tar to create an archive with as options "--uid 1337" or "--gid 1337".
>Fix:
Implement the feature or clean the manpage.

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