Changeset View
Changeset View
Standalone View
Standalone View
usr.bin/xargs/xargs.1
Show All 27 Lines | |||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" @(#)xargs.1 8.1 (Berkeley) 6/6/93 | .\" @(#)xargs.1 8.1 (Berkeley) 6/6/93 | ||||
.\" $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 March 16, 2012 | .Dd July 29, 2015 | ||||
.Dt XARGS 1 | .Dt XARGS 1 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm xargs | .Nm xargs | ||||
.Nd "construct argument list(s) and execute utility" | .Nd "construct argument list(s) and execute utility" | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Nm | .Nm | ||||
.Op Fl 0oprt | .Op Fl 0oprt | ||||
▲ Show 20 Lines • Show All 157 Lines • ▼ Show 20 Lines | |||||
.Nm | .Nm | ||||
to run an interactive application. | to run an interactive application. | ||||
.It Fl P Ar maxprocs | .It Fl P Ar maxprocs | ||||
Parallel mode: run at most | Parallel mode: run at most | ||||
.Ar maxprocs | .Ar maxprocs | ||||
invocations of | invocations of | ||||
.Ar utility | .Ar utility | ||||
at once. | at once. | ||||
If | |||||
.Ar maxprocs | |||||
is set to 0, | |||||
.Nm | |||||
will run as many processes as possible. | |||||
wblock: "at a time" is kind of weird at the end of this sentence. It could be removed without changing… | |||||
Not Done Inline ActionsWhy would a negative value be allowed? gnu xargs does not allow one. This sentence does not mention the upper limit present in the code (and erroring out if not met), which is actually a good thing since the limit should be removed. mjg: Why would a negative value be allowed? gnu xargs does not allow one. This sentence does not… | |||||
Not Done Inline ActionsThe current text is good, but I wonder if this is better: If allanjude: The current text is good, but I wonder if this is better:
If
.Ar maxprocs
is set to 0,
.Nm… | |||||
.It Fl p | .It Fl p | ||||
Echo each command to be executed and ask the user whether it should be | Echo each command to be executed and ask the user whether it should be | ||||
executed. | executed. | ||||
An affirmative response, | An affirmative response, | ||||
.Ql y | .Ql y | ||||
in the POSIX locale, | in the POSIX locale, | ||||
causes the command to be executed, any other response causes it to be | causes the command to be executed, any other response causes it to be | ||||
skipped. | skipped. | ||||
▲ Show 20 Lines • Show All 143 Lines • Show Last 20 Lines |
"at a time" is kind of weird at the end of this sentence. It could be removed without changing the meaning of the sentence, or maybe reword for better clarity.