[src/trunk]: src/usr.bin/xargs PR/44259: Aleksey Cheusov: xargs: -r option is...

[christos <christos%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/c7a80f7525fa
branches:  trunk
changeset: 759952:c7a80f7525fa
user:      christos <christos%NetBSD.org@localhost>
date:      Tue Dec 21 20:30:13 2010 +0000

description:
PR/44259: Aleksey Cheusov: xargs: -r option is supported but not documented
Synced with the FreeBSD doc.

diffstat:

 usr.bin/xargs/xargs.1 |  36 ++++++++++++++++++++++++++++++++----
 1 files changed, 32 insertions(+), 4 deletions(-)

diffs (66 lines):

diff -r e03f8f927772 -r c7a80f7525fa usr.bin/xargs/xargs.1
--- a/usr.bin/xargs/xargs.1     Tue Dec 21 19:18:46 2010 +0000
+++ b/usr.bin/xargs/xargs.1     Tue Dec 21 20:30:13 2010 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: xargs.1,v 1.20 2007/12/02 19:47:56 wiz Exp $
+.\" $NetBSD: xargs.1,v 1.21 2010/12/21 20:30:13 christos Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -32,10 +32,10 @@
 .\" SUCH DAMAGE.
 .\"
 .\"    @(#)xargs.1     8.1 (Berkeley) 6/6/93
-.\" $FreeBSD: src/usr.bin/xargs/xargs.1,v 1.37 2006/09/29 15:20:48 ru Exp $
+.\" $FreeBSD: src/usr.bin/xargs/xargs.1,v 1.40 2010/12/11 08:32:16 joel Exp $
 .\" $xMach: xargs.1,v 1.2 2002/02/23 05:23:37 tim Exp $
 .\"
-.Dd April 18, 2007
+.Dd December 21, 2010
 .Dt XARGS 1
 .Os
 .Sh NAME
@@ -43,7 +43,7 @@
 .Nd "construct argument list(s) and execute utility"
 .Sh SYNOPSIS
 .Nm
-.Op Fl 0opt
+.Op Fl 0oprt
 .Op Fl E Ar eofstr
 .Oo
 .Fl I Ar replstr
@@ -219,6 +219,34 @@
 causes the command to be executed, any other response causes it to be
 skipped.
 No commands are executed if the process is not attached to a terminal.
+.It Fl r
+Compatibility with GNU
+.Nm .
+The GNU version of
+.Nm
+runs the
+.Ar utility
+argument at least once, even if
+.Nm
+input is empty, and it supports a
+.Fl r
+option to inhibit this behavior.
+The
+.Fx
+version of
+.Nm
+does not run the
+.Ar utility
+argument on empty input, but it supports the
+.Fl r
+option for command-line compatibility with GNU
+.Nm ,
+but the
+.Fl r
+option does nothing in the
+.Fx
+version of
+.Nm .
 .It Fl R Ar replacements
 Specify the maximum number of arguments that
 .Fl I