.\" Copyright (c) 1983, 1990, 1993
.\"	The Regents of the University of California.  All rights reserved.
.\"
.\" %sccs.include.redist.man%
.\"
.\"     @(#)apply.1	8.2 (Berkeley) 04/04/94
.\"
.Dd 
.Dt APPLY 1
.Os BSD 4.2
.Sh NAME
.Nm apply
.Nd apply a command to a set of arguments
.Sh SYNOPSIS
.Nm apply
.Op Fl a Ns Ar c
.Op Fl Ns Ar #
.Ar command argument ...
.Sh DESCRIPTION
.Nm Apply
runs the named
.Ar command
on each
argument
.Ar argument
in turn.
.Pp
Character sequences of the form
.Dq Li \&%d
in
.Ar command ,
where
.Dq Li d
is a digit from 1 to 9, are replaced by the
.Li d Ns \'th
following unused
.Ar argument .
In this case, the largest digit number of arguments are discarded for
each execution of
.Ar command .
.Pp
The options are as follows:
.Bl -tag -width "-ac"
.It Fl Ns Ar #
Normally arguments are taken singly; the optional number
.Fl #
specifies the number of arguments to be passed to
.Ar command .
If the number is zero,
.Ar command
is run, without arguments, once for each
.Ar argument .
.Pp
If any sequences of
.Dq Li \&%d
occur in command, the
.Fl n
option is ignored.
.It Fl a Ns Ar c
The use of the character
.Dq Li %
as a magic character may be changed with the
.Fl a
option.
.El
.Sh ENVIRONMENT VARIABLES
The following environment variable affects the execution of
.Nm apply :
.Bl -tag -width SHELL
.It Ev SHELL
Pathname of shell to use.
If this variable is not defined, the Bourne shell is used.
.El
.Sh EXAMPLES
.Bl -tag -width apply -compact
.It Li "apply echo a*"
is similar to ls(1);
.It Li "apply \-2 cmp a1 b1 a2 b2 a3 b3"
compares the `a' files to the `b' files;
.It Li "apply \-0 who 1 2 3 4 5"
runs who(1) 5 times; and
.It Li "apply \'ln %1 /usr/joe\'" *
links all files in the current directory to the directory
.Pa /usr/joe .
.El
.Sh Files
.Bl -tag -width /bin/sh -compact
.It Pa /bin/sh
Default shell
.El
.Sh AUTHOR
Rob Pike
.Sh BUGS
Shell metacharacters in
.Ar command
may have bizarre effects; it is best to enclose complicated
commands in single quotes
.Pq Sq .
.Sh HISTORY
The
.Nm
command appeared in 
.Bx 4.2 .