From nobody@FreeBSD.org  Wed Dec  6 11:52:26 2006
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 6398116A54B
	for <freebsd-gnats-submit@FreeBSD.org>; Wed,  6 Dec 2006 11:52:26 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [69.147.83.33])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 9A95C43F55
	for <freebsd-gnats-submit@FreeBSD.org>; Wed,  6 Dec 2006 11:43:40 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.13.1/8.13.1) with ESMTP id kB6BiDNS075064
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 6 Dec 2006 11:44:13 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.13.1/8.13.1/Submit) id kB6BiDvN075063;
	Wed, 6 Dec 2006 11:44:13 GMT
	(envelope-from nobody)
Message-Id: <200612061144.kB6BiDvN075063@www.freebsd.org>
Date: Wed, 6 Dec 2006 11:44:13 GMT
From: Pete Slagle<freebsd-stable@voidcaptain.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: man page, xargs option not documented
X-Send-Pr-Version: www-3.0

>Number:         106416
>Category:       docs
>Synopsis:       man page, xargs option not documented
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Dec 06 12:00:27 GMT 2006
>Closed-Date:    Sat Dec 06 14:34:36 UTC 2008
>Last-Modified:  Sat Dec 06 14:34:36 UTC 2008
>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:
Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Mon Jan 15 23:40:22 UTC 2007 
Responsible-Changed-Why:  
I'll handle this. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=106416 
State-Changed-From-To: open->patched 
State-Changed-By: keramida 
State-Changed-When: Sat Jan 26 12:38:36 UTC 2008 
State-Changed-Why:  
Fixed in CURRENT.  I'll MFC in a couple of days, if there are 
no objections/tweaks/changes to the -r option description text. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=106416 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/106416: commit references a PR
Date: Sat, 26 Jan 2008 12:38:26 +0000 (UTC)

 keramida    2008-01-26 12:38:19 UTC
 
   FreeBSD src repository (doc committer)
 
   Modified files:
     usr.bin/xargs        xargs.1 
   Log:
   Document the no-op -r option of BSD xargs(1).
   
   PR:             docs/106416
   Submitted by:   Pete Slagle, freebsd-stable at voidcaptain.com
   MFC after:      3 days
   
   Revision  Changes    Path
   1.38      +30 -2     src/usr.bin/xargs/xargs.1
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 

From: Gavin Atkinson <gavin.atkinson@ury.york.ac.uk>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/106416: man page, xargs option not documented
Date: Sun, 1 Jun 2008 14:18:37 +0100 (BST)

 This still needs to be MFC'd to RELENG_7 and RELENG_6.  Both 1.38 and 1.39 
 of src/usr.bin/xargs/xargs.1 will need MFCing.
State-Changed-From-To: patched->closed 
State-Changed-By: keramida 
State-Changed-When: Sat Dec 6 14:34:08 UTC 2008 
State-Changed-Why:  
Patched in stable/6, stable/7 and releng/7.1 too. 
Thanks for the bug report :) 

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