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