svn commit: r362060 - head/usr.bin/xargs

[Fernando Apesteguía]

Author: fernape (ports committer)
Date: Thu Jun 11 15:14:39 2020
New Revision: 362060
URL: https://svnweb.freebsd.org/changeset/base/362060

Log:
  xargs(1): Add EXAMPLES to man page
  
  Add EXAMPLES covering options I, J, L, n, P.
  
  While here, fix warning (STYLE: no blank before trailing delimiter: Fl P,)
  Bumping .Dd
  
  Approved by:	bcr@
  Differential Revision:	https://reviews.freebsd.org/D25214

Modified:
  head/usr.bin/xargs/xargs.1

Modified: head/usr.bin/xargs/xargs.1
==============================================================================
--- head/usr.bin/xargs/xargs.1	Thu Jun 11 14:57:30 2020	(r362059)
+++ head/usr.bin/xargs/xargs.1	Thu Jun 11 15:14:39 2020	(r362060)
@@ -33,7 +33,7 @@
 .\" $FreeBSD$
 .\" $xMach: xargs.1,v 1.2 2002/02/23 05:23:37 tim Exp $
 .\"
-.Dd August 4, 2015
+.Dd June 11, 2020
 .Dt XARGS 1
 .Os
 .Sh NAME
@@ -325,6 +325,32 @@ exits with a value of 126.
 If any other error occurs,
 .Nm
 exits with a value of 1.
+.Sh EXAMPLES
+Create a 3x3 matrix with numbers from 1 to 9.
+Every
+.Xr echo 1
+instance receives three lines as arguments:
+.Bd -literal -offset indent
+$ seq 1 9 | xargs -L3 echo
+1 2 3
+4 5 6
+7 8 9
+.Ed
+.Pp
+Duplicate every line from standard input:
+.Bd -literal -offset indent
+$ echo -e "one\\ntwo\\nthree" | xargs -I % echo % %
+one one
+two two
+three three
+.Ed
+.Pp
+Execute at most 2 concurrent instances of
+.Xr find 1
+every one of them using one of the directories from the standard input:
+.Bd -literal -offset indent
+echo -e "/usr/ports\\n/etc\\n/usr/local" | xargs -J % -P2 -n1 find % -name file
+.Ed
 .Sh SEE ALSO
 .Xr echo 1 ,
 .Xr find 1 ,
@@ -336,7 +362,7 @@ utility is expected to be
 .St -p1003.2
 compliant.
 The
-.Fl J , o , P, R
+.Fl J , o , P , R
 and
 .Fl S
 options are non-standard