code: plan9front

ref: 5622b0bbd878dbc34045cc6fd37cffa64461eabe
dir: /sys/man/1/bundle/

View raw version
.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
.IR 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
.IR mail (1).
.PP
Although less refined than standard archives from
.IR ar (1)
or
.IR 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; rc horse; mk
.SH SOURCE
.B /rc/bin/bundle
.SH SEE ALSO
.IR ar (1), 
.IR tar (1), 
.IR mail (1)
.SH BUGS
.I Bundle
will not create directories and is unsatisfactory for non-text files.
.PP
Beware of gift horses.