plan9port/man/man1/bundle.1
Russ Cox d32deab17b tmac: rename IM (italic manual) to MR (manual reference)
Suggested by G. Brandon Robinson.
2020-08-15 20:09:40 -04:00

57 lines
1,014 B
Groff

.TH BUNDLE 1
.SH NAME
bundle \- collect files for distribution
.SH SYNOPSIS
.B bundle
.I file ...
.SH DESCRIPTION
.I Bundle
writes on its standard output a shell script for
.MR rc (1)
or a Bourne shell
which, when executed,
will recreate the original
.IR files .
Its main use is for distributing small numbers of text files by
.MR mail (1) .
.PP
Although less refined than standard archives from
.I 9ar
(see
.MR 9c (1) )
or
.MR tar (1) ,
a
.IR bundle
file
is self-documenting and complete; little preparation is required on
the receiving machine.
.SH EXAMPLES
.TP
.L
bundle mkfile *.[ch] | mail kremvax!boris
Send a makefile to Boris together with related
.L .c
and
.L .h
files.
Upon receiving the mail, Boris may save the file sans postmark,
say in
.BR gift/horse ,
then do
.TP
.L
cd gift; sh horse; mk
.SH SOURCE
.B \*9/bin/bundle
.SH SEE ALSO
.I 9ar
(in
.IR 9c (1)),
.IR tar (1),
.MR mail (1)
.SH BUGS
.I Bundle
will not create directories and is unsatisfactory for non-text files.
.PP
Beware of gift horses.