[unix-history] / usr / src / usr.bin / apply / apply.1

.\" Copyright (c) 1983 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)apply.1	6.1 (Berkeley) %G%
.\"
.TH APPLY 1 ""
.UC 5
.SH NAME
apply \- apply a command to a set of arguments
.SH SYNOPSIS
.B apply
[
.B \-a\fIc\fP
] [
.B \-\fIn\fP
] command args ...
.SH DESCRIPTION
.I Apply
runs the named
.I command
on each
argument
.I arg
in turn.
Normally arguments are chosen singly; the optional number
.I n
specifies the number of arguments to be passed to
.I command.
If
.I n
is zero,
.I command
is run without arguments once for each
.I arg.
Character sequences of the form %\fId\fP
in
.I command,
where
.I d
is a digit from 1 to 9,
are replaced by the
\fId\fP'th following unused
.I arg.
If any such sequences occur,
.I n
is ignored,
and the number of arguments passed to
.I command
is the maximum value of
.I d
in
.I command.
The character `%' may be changed by the
.B \-a
option.
.PP
Examples:
.RS
apply echo *
.RE
is similar to ls(1);
.RS
apply \-2 cmp a1 b1 a2 b2 ...
.RE
compares the `a' files to the `b' files;
.RS
apply \-0 who 1 2 3 4 5
.RE
runs who(1) 5 times; and
.RS
apply \(aaln %1 /usr/joe\(aa *
.RE
links all files in the current directory to the directory /usr/joe.
.SH "SEE ALSO"
sh(1)
.SH AUTHOR
Rob Pike
.SH BUGS
Shell metacharacters in
.I command
may have bizarre effects; it is best to enclose complicated
commands in single quotes \(aa\ \(aa.
.sp
There is no way to pass a literal `%2' if `%' is the
argument expansion character.
Commit	Line	Data
5e2129fc KM	1	.\" Copyright (c) 1983 Regents of the University of California.
	2	.\" All rights reserved. The Berkeley software License Agreement
	3	.\" specifies the terms and conditions for redistribution.
	4	.\"
e3cae795	5	.\" @(#)apply.1 6.1 (Berkeley) %G%
5e2129fc	6	.\"
e3cae795	7	.TH APPLY 1 ""
5e2129fc KM	8	.UC 5
	9	.SH NAME
	10	apply \- apply a command to a set of arguments
	11	.SH SYNOPSIS
	12	.B apply
	13	[
	14	.B \-a\fIc\fP
	15	] [
	16	.B \-\fIn\fP
	17	] command args ...
	18	.SH DESCRIPTION
	19	.I Apply
	20	runs the named
	21	.I command
	22	on each
	23	argument
	24	.I arg
	25	in turn.
	26	Normally arguments are chosen singly; the optional number
	27	.I n
	28	specifies the number of arguments to be passed to
	29	.I command.
	30	If
	31	.I n
	32	is zero,
	33	.I command
	34	is run without arguments once for each
	35	.I arg.
	36	Character sequences of the form %\fId\fP
	37	in
	38	.I command,
	39	where
	40	.I d
	41	is a digit from 1 to 9,
	42	are replaced by the
	43	\fId\fP'th following unused
	44	.I arg.
	45	If any such sequences occur,
	46	.I n
	47	is ignored,
	48	and the number of arguments passed to
	49	.I command
	50	is the maximum value of
	51	.I d
	52	in
	53	.I command.
	54	The character `%' may be changed by the
	55	.B \-a
	56	option.
	57	.PP
	58	Examples:
	59	.RS
	60	apply echo *
	61	.RE
	62	is similar to ls(1);
	63	.RS
	64	apply \-2 cmp a1 b1 a2 b2 ...
	65	.RE
	66	compares the `a' files to the `b' files;
	67	.RS
	68	apply \-0 who 1 2 3 4 5
	69	.RE
	70	runs who(1) 5 times; and
	71	.RS
72	apply \(aaln %1 /usr/joe\(aa *
73	.RE
74	links all files in the current directory to the directory /usr/joe.
75	.SH "SEE ALSO"
76	sh(1)
77	.SH AUTHOR
78	Rob Pike
79	.SH BUGS
80	Shell metacharacters in
81	.I command
82	may have bizarre effects; it is best to enclose complicated
83	commands in single quotes \(aa\ \(aa.
84	.sp
85	There is no way to pass a literal `%2' if `%' is the
86	argument expansion character.