.de VS
.sp 1
.RS
.nf
.ft B
..
.de VE
.ft R
.fi
.RE
.sp 1
..
.TH create 1 "5 February 2005" "Edgeware tools"
.SH NAME
create \- write new file safely
.SH SYNOPSIS
.B create
.I file
.I program
.RI [ arguments ...]
.SH DESCRIPTION
The
.B create
program
runs
.VS
.IR "program arguments " ...
.VE
redirecting standard output to
.IR file \c
.BR .new .
If
.I program
exits successfully,
.B create
will rename the newly-written
.IB file .new
to simply
.I file
and exit zero; otherwise it deletes
.IB file .new
and exits the same as
.I program
did.
.SH BUGS
Doesn't exit correctly if subprogram was killed by a signal.
.SH AUTHOR
Mark Wooding <mdw@distorted.org.uk>