svn commit: r185696 - stable/7/usr.bin/xargs

[Giorgos Keramidas]

Author: keramida (doc committer)
Date: Sat Dec  6 13:32:51 2008
New Revision: 185696
URL: http://svn.freebsd.org/changeset/base/185696

Log:
  MFC: r175680, r175728.
  
  Document the no-op -r option of BSD xargs(1).
  
  PR:		docs/106416
  Submitted by:	Pete Slagle, freebsd-stable at voidcaptain.com
  Approved by:	re (kib)

Modified:
  stable/7/usr.bin/xargs/   (props changed)
  stable/7/usr.bin/xargs/xargs.1

Modified: stable/7/usr.bin/xargs/xargs.1
==============================================================================
--- stable/7/usr.bin/xargs/xargs.1	Sat Dec  6 13:23:53 2008	(r185695)
+++ stable/7/usr.bin/xargs/xargs.1	Sat Dec  6 13:32:51 2008	(r185696)
@@ -37,7 +37,7 @@
 .\" $FreeBSD$
 .\" $xMach: xargs.1,v 1.2 2002/02/23 05:23:37 tim Exp $
 .\"
-.Dd December 30, 2005
+.Dd January 26, 2008
 .Dt XARGS 1
 .Os
 .Sh NAME
@@ -45,7 +45,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
@@ -221,6 +221,34 @@ in the POSIX locale,
 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