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:
parent
86e794eb65
commit
20994eafc4
@ -33,7 +33,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" $xMach: xargs.1,v 1.2 2002/02/23 05:23:37 tim Exp $
|
.\" $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
|
.Dt XARGS 1
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
@ -325,6 +325,32 @@ exits with a value of 126.
|
|||||||
If any other error occurs,
|
If any other error occurs,
|
||||||
.Nm
|
.Nm
|
||||||
exits with a value of 1.
|
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
|
.Sh SEE ALSO
|
||||||
.Xr echo 1 ,
|
.Xr echo 1 ,
|
||||||
.Xr find 1 ,
|
.Xr find 1 ,
|
||||||
@ -336,7 +362,7 @@ utility is expected to be
|
|||||||
.St -p1003.2
|
.St -p1003.2
|
||||||
compliant.
|
compliant.
|
||||||
The
|
The
|
||||||
.Fl J , o , P, R
|
.Fl J , o , P , R
|
||||||
and
|
and
|
||||||
.Fl S
|
.Fl S
|
||||||
options are non-standard
|
options are non-standard
|
||||||
|
Loading…
Reference in New Issue
Block a user