mirror of
https://github.com/9fans/plan9port.git
synced 2025-01-12 11:10:07 +00:00
d32deab17b
Suggested by G. Brandon Robinson.
57 lines
1,014 B
Groff
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.
|