bundle.1 (1014B)
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.