Return to apply.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / apply

Annotation of 43BSDReno/usr.bin/apply/apply.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983, 1990 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\"
                      5: .\"     @(#)apply.1    6.3 (Berkeley) 7/24/90
                      6: .\"
                      7: .Dd July 24, 1990
                      8: .Dt APPLY 1
                      9: .Os BSD 4.2
                     10: .Sh NAME
                     11: .Nm apply
                     12: .Nd apply a command to a set of arguments
                     13: .Sh SYNOPSIS
                     14: .Nm apply
                     15: .Op Fl ac
                     16: .Op Fl n
                     17: .Ar command args ...
                     18: .Sh DESCRIPTION
                     19: .Nm Apply
                     20: runs the named
                     21: .Ar command
                     22: on each
                     23: argument
                     24: .Ar arg
                     25: in turn.
                     26: Normally arguments are chosen singly; the optional number
                     27: .Fl n
                     28: specifies the number of arguments to be passed to
                     29: .Ar command .
                     30: If
                     31: .Fl n
                     32: is zero,
                     33: .Ar command
                     34: is run without arguments once for each
                     35: .Ar arg
                     36: Character sequences of the form
                     37: .Cx %
                     38: .Ar d
                     39: .Cx
                     40: in
                     41: .Ar command ,
                     42: where
                     43: .Ar d
                     44: is a digit from 1 to 9,
                     45: are replaced by the
                     46: .Ar d\'th
                     47: following unused
                     48: .Ar arg .
                     49: If any such sequences occur,
                     50: .Fl n
                     51: is ignored,
                     52: and the number of arguments passed to
                     53: .Ar command
                     54: is the maximum value of
                     55: .Ar d
                     56: in
                     57: .Ar command .
                     58: The character `%' may be changed by the
                     59: .Fl a
                     60: option.
                     61: .SH ENVIRONMENT
                     62: .Nm apply
                     63: checks the environment variable
                     64: .Ev SHELL
                     65: to find out which shell to use.
                     66: .Sh EXAMPLES
                     67: .Ds
                     68: .Tw apply \-2 cmp a1 b1 a2 b2 ...
                     69: .Tp Li apply echo a*
                     70: is similar to ls(1);
                     71: .Tp Li apply \-2 cmp a1 b1 a2 b2 ...
                     72: compares the `a' files to the `b' files;
                     73: .Tp Li apply \-0 who 1 2 3 4 5
                     74: runs who(1) 5 times; and
                     75: .Tp Li apply \(aaln %1 /usr/joe\(aa *
                     76: links all files in the current directory to the directory
                     77: .Pa /usr/joe .
                     78: .Tp
                     79: .De
                     80: .Sh SEE ALSO
                     81: .Xr sh 1
                     82: .Sh HISTORY
                     83: .Nm Apply
                     84: appeared in 4.2BSD.
                     85: .Sh AUTHOR
                     86: Rob Pike
                     87: .Sh BUGS
                     88: Shell metacharacters in
                     89: .Ar command
                     90: may have bizarre effects; it is best to enclose complicated
                     91: commands in single quotes (\(aa\ \(aa).
                     92: .Pp
                     93: There is no way to pass a literal `%2' if `%' is the
                     94: argument expansion character.

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