tbundle.1 - plan9port - [fork] Plan 9 from user space
 (HTM) git clone git://src.adamsgaard.dk/plan9port
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) LICENSE
       ---
       tbundle.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.