V10/man/man1/bundle.1

Compare this file to the similar file:
Show the results in this format:

.TH BUNDLE 1
.CT 1 comm_users 
.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 sh (1)
that, 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),
.IR cpio (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 makefile *.[ch] | mail elsewhere!mark
Send a makefile to Mark together with related
.L .c
and
.L .h
files.
Upon receiving the mail, Mark may save the file sans postmark,
say in
.BR gift/horse ,
then do
.TP
.L
cd gift; sh horse; make
.SH SEE ALSO
.IR ar (1), 
.IR cpio (1),
.IR tar (1), 
.IR mail (1)
.SH BUGS
.I Bundle
will not create directories and is unsatisfactory for non-ASCII files.
.br
Beware of gift horses.