sys/man/1/bundle

   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.