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
This commit is contained in:
Fernando Apesteguía 2020-06-11 15:14:39 +00:00
parent 86e794eb65
commit 20994eafc4
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=362060

View File

@ -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