docs/106416: man page, xargs option not documented

[Pete Slagle]

>Number:         106416
>Category:       docs
>Synopsis:       man page, xargs option not documented
>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 Dec 06 12:00:27 GMT 2006
>Closed-Date:
>Last-Modified:
>Originator:     Pete Slagle
>Release:        6.1-RELEASE-p10
>Organization:
>Environment:
6.1-RELEASE-p10
>Description:
The xargs utility accepts the -r option on the command line, but this is not documented on the xargs(1) man page.

The relevant code is in
/usr/src/usr.bin/xargs/xargs.c
on line 166. The code file header is
$xMach: xargs.c,v 1.6 2002/02/23 05:27:47 tim Exp $

The option is a no-op, and is included for "GNU compatibility" according to the source. A mention of this fact on the man page might help those who are writing scripts that are intended to be portable.




>How-To-Repeat:
man xargs

>Fix:
Add -r to the list of accepted options on the xargs(1) man page, noting that it is accepted for compatibility and does nothing.

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