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 .MR 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 .MR mail (1) .
17 .PP
18 Although less refined than standard archives from
19 .I 9ar
20 (see
21 .MR 9c (1) )
22 or
23 .MR tar (1) ,
24 a
25 .IR bundle
26 file
27 is self-documenting and complete; little preparation is required on
28 the receiving machine.
29 .SH EXAMPLES
30 .TP
31 .L
32 bundle mkfile *.[ch] | mail kremvax!boris
33 Send a makefile to Boris together with related
34 .L .c
35 and
36 .L .h
37 files.
38 Upon receiving the mail, Boris may save the file sans postmark,
39 say in
40 .BR gift/horse ,
41 then do
42 .TP
43 .L
44 cd gift; sh horse; mk
45 .SH SOURCE
46 .B \*9/bin/bundle
47 .SH SEE ALSO
48 .I 9ar
49 (in
50 .IR 9c (1)), 
51 .IR tar (1), 
52 .MR mail (1)
53 .SH BUGS
54 .I Bundle
55 will not create directories and is unsatisfactory for non-text files.
56 .PP
57 Beware of gift horses.