Subversion Repositories planix.SVN

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 - 1 
.TH BUNDLE 1
2 
.SH NAME
3 
bundle \- collect files for distribution
4 
.SH SYNOPSIS
5 
.B bundle
6 
.I file ...
7 
.SH DESCRIPTION
8 
.I Bundle
9 
writes on its standard output a shell script for
10 
.IR rc (1)
11 
or a Bourne shell
12 
which, when executed,
13 
will recreate the original
14 
.IR files .
15 
Its main use is for distributing small numbers of text files by
16 
.IR mail (1).
17 
.PP
18 
Although less refined than standard archives from
19 
.IR ar (1)
20 
or
21 
.IR tar (1),
22 
a
23 
.IR bundle
24 
file
25 
is self-documenting and complete; little preparation is required on
26 
the receiving machine.
27 
.SH EXAMPLES
28 
.TP
29 
.L
30 
bundle mkfile *.[ch] | mail kremvax!boris
31 
Send a makefile to Boris together with related
32 
.L .c
33 
and
34 
.L .h
35 
files.
36 
Upon receiving the mail, Boris may save the file sans postmark,
37 
say in
38 
.BR gift/horse ,
39 
then do
40 
.TP
41 
.L
42 
cd gift; rc horse; mk
43 
.SH SOURCE
44 
.B /rc/bin/bundle
45 
.SH SEE ALSO
46 
.IR ar (1),
47 
.IR tar (1),
48 
.IR mail (1)
49 
.SH BUGS
50 
.I Bundle
51 
will not create directories and is unsatisfactory for non-text files.
52 
.PP
53 
Beware of gift horses.