.\" @(#)  /u/des/src/vip/vip.man  1.3  97/08/21  17:39:00
.\" Copyright (c) 1997, Daniel E. Singer
.\" All Rights Reserved
.\" view this document using [tn]roff with the -man option
.TH vip 1 "05 August 1997" "ToolMan"
.\" ------------------------------------------------------------------------
.\" define string D to be a dash appropriate for nroff or troff
.if n .ds D -
.if t .ds D \-
.SH NAME
vip \- edit interactively in a pipeline
.SH SYNOPSIS
.BR vip " [ " \*Dno " ] [ "
.IR command " ]"
.\" ------------------------------------------------------------------------
.SH DESCRIPTION
.B vip
(\fBvi\fR \fBp\fRipe) allows you to interactively edit at any point
in a pipeline.
It can be used syntactically like a filter.
.\" ------------------------------------------------------------------------
.SH OPTIONS
The following options are supported:
.TP
.B \*Dn
Close standard input, if it is from a keyboard.
.TP
.BR \*Do
Do not send the edited text to standard output.
.\" ------------------------------------------------------------------------
.SH OPERANDS
The following operands are supported:
.TP 10
.IR command
Command to run to produce initial text for editing.
Default is standard input.
.\" ------------------------------------------------------------------------
.SH ENVIRONMENT
The following environment variables are used:
.TP 10
.B VISUAL, EDITOR
Checked in that order for the name of the text editor to use.
Default is
.BR vi (1).
.TP
.B TMPDIR
Directory to use for temporary file.
Default is \fB/usr/tmp\fR.
.\" ------------------------------------------------------------------------
.SH DIAGNOSTICS
Returns the exit status from the edit session.
.\" ------------------------------------------------------------------------
.SH FILES
.TP 10
\fB/usr/tmp/vip.\fIpid\fR
Temporary file for holding input from standard input or \fIcommand\fR.
.\" ------------------------------------------------------------------------
.SH "SEE ALSO"
.BR sh (1),
.BR vi (1),
.br
\*(lqToolMan Edits Pipes \*D \fIInteractively!\fR,\*(rq
\fI;login:\fR magazine (USENIX Association), October 1997.
.\" ------------------------------------------------------------------------
.SH BUGS
.PP
\fBvip\fR does not like to be run without a tty device available.
.PP
\fBvip\fR uses a temporary file.
.SH AUTHOR
\fBvip\fR was written at the
Department of Computer Science at Duke University,
by Daniel E. Singer (a.k.a. ToolMan).