Return to apply.1 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1

Annotation of 43BSDTahoe/man/man1/apply.1, revision 1.1.1.1

1.1       root        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: .\"
                      5: .\"    @(#)apply.1     6.1 (Berkeley) 4/29/85
                      6: .\"
                      7: .TH APPLY 1 "April 29, 1985"
                      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.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.