From d6872925c8b6b13b59a1ece32416aa8ef9c12c70 Mon Sep 17 00:00:00 2001 From: Christian Neukirchen Date: Wed, 30 Jul 2014 18:25:14 +0200 Subject: initial import of OpenBSD tools --- src/usr.bin/apply/apply.1 | 145 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 145 insertions(+) create mode 100644 src/usr.bin/apply/apply.1 (limited to 'src/usr.bin/apply/apply.1') diff --git a/src/usr.bin/apply/apply.1 b/src/usr.bin/apply/apply.1 new file mode 100644 index 0000000..ddcc3e7 --- /dev/null +++ b/src/usr.bin/apply/apply.1 @@ -0,0 +1,145 @@ +.\" $OpenBSD: apply.1,v 1.23 2007/05/31 19:20:07 jmc Exp $ +.\" $NetBSD: apply.1,v 1.4 1996/03/18 23:16:57 jtc Exp $ +.\" +.\" Copyright (c) 1983, 1990, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)apply.1 8.2 (Berkeley) 4/4/94 +.\" +.Dd $Mdocdate: May 31 2007 $ +.Dt APPLY 1 +.Os +.Sh NAME +.Nm apply +.Nd apply a command to a set of arguments +.Sh SYNOPSIS +.Nm apply +.Op Fl Ar # +.Op Fl d +.Op Fl a Ar magic +.Ar command argument ... +.Sh DESCRIPTION +.Nm +runs the named +.Ar command +on each given +.Ar argument +in turn. +.Pp +Character sequences of the form +.Dq Li \&%d +in +.Ar command , +where +.Sq d +is a digit from 1 to 9, are replaced by the +.Li d Ns 'th +following unused +.Ar argument . +In this case, the largest digit number of arguments are discarded for +each execution of +.Ar command . +.Pp +The options are as follows: +.Bl -tag -width Ds +.It Fl Ns Ar # +Normally arguments are taken singly; the optional number +.Fl Ns Ar # +specifies the number of arguments to be passed to +.Ar command . +If the number is zero, +.Ar command +is run, without arguments, once for each +.Ar argument . +.Pp +If any sequences of +.Dq Li \&%d +occur in +.Ar command , +the +.Fl Ns Ar # +option is ignored. +.It Fl a Ar magic +Use +.Ar magic +as the magic character instead of the default +.Ql % . +.It Fl d +Debug mode. +Print commands to the standard output but do not actually execute them. +.El +.Sh ENVIRONMENT +.Bl -tag -width SHELL +.It Ev SHELL +Pathname of shell to use. +If this variable is not defined, the Bourne shell is used. +.El +.Sh FILES +.Bl -tag -width /bin/sh -compact +.It Pa /bin/sh +default shell +.El +.Sh EXAMPLES +Operate similar to +.Xr ls 1 : +.Pp +.Dl "$ apply echo *" +.Pp +Compare the +.Pa a* +files to the +.Pa b* +files: +.Pp +.Dl "$ apply -2 cmp a1 b1 a2 b2 a3 b3" +.Pp +Run +.Xr who 1 +five times: +.Pp +.Dl "$ apply -0 who 1 2 3 4 5" +.Pp +Link all files in the current directory to the directory +.Pa /home/joe : +.Pp +.Dl "$ apply 'ln %1 /home/joe'" * +.Sh SEE ALSO +.Xr sh 1 , +.Xr xargs 1 +.Sh HISTORY +The +.Nm +command appeared in +.Bx 4.2 . +.Sh AUTHORS +Rob Pike +.Sh BUGS +Shell metacharacters in +.Ar command +may have bizarre effects; it is best to enclose complicated +commands in single quotes +.Pq '' . -- cgit 1.4.1