Plan 9 from Bell Labs’s /usr/web/sources/patch/applied/doc-man-1-p9psync/bundle.orig

Copyright © 2021 Plan 9 Foundation.
Distributed under the MIT License.
Download the Plan 9 distribution.


.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.
.br
Beware of gift horses.

Bell Labs OSI certified Powered by Plan 9

(Return to Plan 9 Home Page)

Copyright © 2021 Plan 9 Foundation. All Rights Reserved.
Comments to [email protected].