.\" $Id: sapply.man,v 1.1 2012/11/09 21:03:43 ksb Exp $
.\" by Kevin Braunsdorf
.\" $Compile: Display%h
.\" $Display: ${groff:-groff} -Tascii -man %f | ${PAGER:-less}
.\" $Display(*): ${groff:-groff} -T%s -man %f
.\" $Install: %b -mDeinstall %o %f && cp %f $DESTDIR/usr/local/man/man1/sapply.1
.\" $Deinstall: ${rm-rm} -f $DESTDIR/usr/local/man/[cm]a[nt]1/sapply.1*
.\" by KS Braunsdorf
.TH SAPPLY 1L LOCAL
.SH NAME
sapply - xapply across screen's virtual terminals
.SH SYNOPSIS
.ds PN "sapply
\fI\*(PN\fP \fB\-f\fP [\fB\-P\fP\fIjobs\fP] [\fB\-Azn\fP] [\fB\-\fP\fIcount\fP] [\fB\-a\fP\~\fIc\fP] [\fB\-e\fP\~\fIvar=dicer\fP] [\fB\-N\fP\~\fIelse\fP] [\fB\-p\fP\~\fIpad\fP] \fIcmd\fP [\fIfiles\fP]
.br
\fI\*(PN\fP [\fB\-P\fP\fIjobs\fP] [\fB\-Azn\fP] [\fB\-\fP\fIcount\fP] [\fB\-a\fP\~\fIc\fP] [\fB\-e\fP\~\fIvar=dicer\fP] [\fB\-N\fP\~\fIelse\fP] [\fB\-p\fP\~\fIpad\fP] \fIcmd\fP [\fIwords\fP]
.br
\fI\*(PN\fP \-\fBV\fP
.br
\fI\*(PN\fP \-\fBh\fP

.SH DESCRIPTION
\fISapply\fP must be run from a \fBscreen\fP.  It creates \fIcount\fP new
screens.  Each of these screens assumes a task started by \fBxapply\fP.
As tasks \fBexit\fP a new task is attached to the idle screen.  This allows
some interation with the tasks which would normally be impossible as
input and output would be mixed.

.SH OPTIONS
If the program is called as \fI\*(PN\fP then no options are forced.
.TP
.nf
\fB\-\fP\fIcount\fP
.fi
Passed on to \fBxapply\fP.
.TP
.nf
\fB\-a\fP \fIc\fP | \fB\-e\fP \fIIvar=dicer\fP | \fB\-S\fP \fIshell\fP | \fB\-p\fP \fIpad\fP
.fi
As specified under \fBxapply\fP.
.TP
.nf
\fB\-A\fP | \fB\-f\fP | \fB\-z\fP
.fi
Swithes for \fBxapply\fP.
.TP
\fB\-P\fP\fIjobs\fP
Number of tasks to run in parallel, passed on to \fBxapply\fP.
.TP
\fB\-V\fP
Show version information.

.SH EXAMPLES
Start a \fBscreen\fP before running any example programs.

.SH BUGS
It is possible to interrupt the \fI\*(PN\fP process in the screen
window which started it.  That usaully limits your success, a lot.
.SH AUTHOR
KS Braunsdorf
.br
NonPlayer Character Guild
.br
ksb
.SH "SEE ALSO"
sh(1), xapply(1l)