[comp.sources.bugs] man page for hold

mike@cimcor.mn.org (Michael Grenier) (07/17/88)

The recently posted program 'hold' in comp.sources.misc should probably
have line 28 changed to something like what is in 26 to put the
temporary file into the local directory. Otherwise the program bombs
when attemping to run it outside of the /usr partition as it can't link
across partition boundries.

I hacked a a small man page.

    -Mike Grenier
     mike@cimcor.mn.org
     {rutgers, amdahl, ihnp4}!bungia!cimcor!mike

-----cut-----
.PU
.TH HOLD 1 local
.SH NAME
hold \- terminate a pipe into a file
.SH SYNOPSIS
.ll +8
.B hold
filename
.ll -8
.SH DESCRIPTION
.I Hold
will read stdin until end of file (usually a pipe) putting the output
into a temporary file. It will move the temporary file to the name given
as it argument. This command is useful in situations where one wants to
return the output of a pipe back into one of the files being used by the
pipe.
.SH "EXAMPLES"
.nf
	sed 's/old/new/' fred| hold fred
which allows the new version to overwrite the the orginal 'fred'.

	tail SYSLOG | hold SYSLOG
which deletes all but the last few lines of SYSLOG.
.fi
.SH "SEE ALSO"
sh(1)
.SH "BUGS"