APPLY(1)

NAME
apply - Run a command many times with different arguments

SYNOPSIS
apply [-a c] [-d] [-#] command argument [argument ...]

DESCRIPTION
apply runs the given command multiple times, with different arguments. Without arguments, command is run once for each argument. If the command contains strings of the form %d+, the d'th next unused argument will be substituted.

  OPTIONS
apply accepts the following options:

-a c
    Use the character c instead of % for interpolation of arguments.

-d  Print each constructed command but do not execute it.

-#  If an option of the form -# is given, with # a number, apply uses that many arguments for each call of command. If -0 is given as an option, command is called without arguments, and it is called as many times as there are arguments following command on the command line.

    This option is ignored if command has magic %d+ sequences.

ENVIRONMENT
The working of apply is not influenced by any environment variables.

CAVEATS
When command has magic %d+ sequences, the string after interpolation of the arguments is handed to a shell for interpretation of meta characters. This shell is determined by Perl, during its building phase, and is typically "/bin/sh -c" on Unix platforms.

BUGS
apply does not honor the users $SHELL environment variable.

REVISION HISTORY
    $Log: apply,v $
    Revision 1.2  2004/08/05 14:17:43  cwest
    cleanup, new version number on website

    Revision 1.1  2004/07/23 20:09:59  cwest
    initial import

    Revision 1.1  1999/02/27 03:36:18  abigail
    Initial revision

AUTHOR
The Perl implementation of apply was written by Abigail, perlpowertools@abigail.be.

COPYRIGHT and LICENSE
This program is copyright by Abigail 1999.

This program is free and open software. You may use, copy, modify, distribute and sell this program (and any modified variants) in any way you wish, provided you do not restrict others to do the same.