[misc] / create.1

.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>
Commit	Line	Data
3770fe80	1	.de VS
	2	.sp 1
	3	.RS
	4	.nf
	5	.ft B
	6	..
	7	.de VE
	8	.ft R
	9	.fi
	10	.RE
	11	.sp 1
	12	..
	13	.TH create 1 "5 February 2005" "Edgeware tools"
	14	.SH NAME
	15	create \- write new file safely
	16	.SH SYNOPSIS
	17	.B create
	18	.I file
	19	.I program
	20	.RI [ arguments ...]
	21	.SH DESCRIPTION
	22	The
	23	.B create
	24	program
	25	runs
	26	.VS
	27	.IR "program arguments " ...
	28	.VE
	29	redirecting standard output to
	30	.IR file \c
	31	.BR .new .
	32	If
	33	.I program
	34	exits successfully,
	35	.B create
	36	will rename the newly-written
	37	.IB file .new
	38	to simply
	39	.I file
	40	and exit zero; otherwise it deletes
	41	.IB file .new
	42	and exits the same as
	43	.I program
	44	did.
	45	.SH BUGS
	46	Doesn't exit correctly if subprogram was killed by a signal.
	47	.SH AUTHOR
71d8432e	48	Mark Wooding <mdw@distorted.org.uk>