plan9port/man/man1/bundle.1

.TH BUNDLE 1
.SH NAME
bundle \- collect files for distribution
.SH SYNOPSIS
.B bundle
.I file ...
.SH DESCRIPTION
.I Bundle
writes on its standard output a shell script for
.IM rc (1)
or a Bourne shell
which, when executed,
will recreate the original
.IR files .
Its main use is for distributing small numbers of text files by
.IM mail (1) .
.PP
Although less refined than standard archives from
.I 9ar
(see
.IM 9c (1) )
or
.IM tar (1) ,
a
.IR bundle
file
is self-documenting and complete; little preparation is required on
the receiving machine.
.SH EXAMPLES
.TP
.L
bundle mkfile *.[ch] | mail kremvax!boris
Send a makefile to Boris together with related
.L .c
and
.L .h
files.
Upon receiving the mail, Boris may save the file sans postmark,
say in
.BR gift/horse ,
then do
.TP
.L
cd gift; sh horse; mk
.SH SOURCE
.B \*9/bin/bundle
.SH SEE ALSO
.I 9ar
(in
.IR 9c (1)), 
.IR tar (1), 
.IM mail (1)
.SH BUGS
.I Bundle
will not create directories and is unsatisfactory for non-text files.
.PP
Beware of gift horses.
Some man pages. 2005-01-03 06:40:20 +00:00			`.TH BUNDLE 1`
			`.SH NAME`
			`bundle \- collect files for distribution`
			`.SH SYNOPSIS`
			`.B bundle`
			`.I file ...`
			`.SH DESCRIPTION`
			`.I Bundle`
			`writes on its standard output a shell script for`
tmac: introduce real manual reference macro instead of overloading IR The overloading of IR emits magic \X'...' sequences that turn into HTML manual links. But not all such IR invocations should be manual links; those had to be written to avoid the IR macro before. Worse, the \X'...' ending the IR causes troff to emit only a single space after a period. Defining a new IM macro for manual references fixes both problems. Fixes #441. 2020-08-14 03:41:59 +00:00			`.IM rc (1)`
Some man pages. 2005-01-03 06:40:20 +00:00			`or a Bourne shell`
			`which, when executed,`
			`will recreate the original`
			`.IR files .`
			`Its main use is for distributing small numbers of text files by`
tmac: introduce real manual reference macro instead of overloading IR The overloading of IR emits magic \X'...' sequences that turn into HTML manual links. But not all such IR invocations should be manual links; those had to be written to avoid the IR macro before. Worse, the \X'...' ending the IR causes troff to emit only a single space after a period. Defining a new IM macro for manual references fixes both problems. Fixes #441. 2020-08-14 03:41:59 +00:00			`.IM mail (1) .`
Some man pages. 2005-01-03 06:40:20 +00:00			`.PP`
			`Although less refined than standard archives from`
			`.I 9ar`
			`(see`
tmac: introduce real manual reference macro instead of overloading IR The overloading of IR emits magic \X'...' sequences that turn into HTML manual links. But not all such IR invocations should be manual links; those had to be written to avoid the IR macro before. Worse, the \X'...' ending the IR causes troff to emit only a single space after a period. Defining a new IM macro for manual references fixes both problems. Fixes #441. 2020-08-14 03:41:59 +00:00			`.IM 9c (1) )`
Some man pages. 2005-01-03 06:40:20 +00:00			`or`
tmac: introduce real manual reference macro instead of overloading IR The overloading of IR emits magic \X'...' sequences that turn into HTML manual links. But not all such IR invocations should be manual links; those had to be written to avoid the IR macro before. Worse, the \X'...' ending the IR causes troff to emit only a single space after a period. Defining a new IM macro for manual references fixes both problems. Fixes #441. 2020-08-14 03:41:59 +00:00			`.IM tar (1) ,`
Some man pages. 2005-01-03 06:40:20 +00:00			`a`
			`.IR bundle`
			`file`
			`is self-documenting and complete; little preparation is required on`
			`the receiving machine.`
			`.SH EXAMPLES`
			`.TP`
			`.L`
			`bundle mkfile *.[ch] \| mail kremvax!boris`
			`Send a makefile to Boris together with related`
			`.L .c`
			`and`
			`.L .h`
			`files.`
			`Upon receiving the mail, Boris may save the file sans postmark,`
			`say in`
			`.BR gift/horse ,`
			`then do`
			`.TP`
			`.L`
Many small edits. 2005-01-13 04:49:19 +00:00			`cd gift; sh horse; mk`
Some man pages. 2005-01-03 06:40:20 +00:00			`.SH SOURCE`
use macro for /usr/local/plan9 2005-01-11 17:37:33 +00:00			`.B \*9/bin/bundle`
Some man pages. 2005-01-03 06:40:20 +00:00			`.SH SEE ALSO`
			`.I 9ar`
			`(in`
			`.IR 9c (1)),`
			`.IR tar (1),`
tmac: introduce real manual reference macro instead of overloading IR The overloading of IR emits magic \X'...' sequences that turn into HTML manual links. But not all such IR invocations should be manual links; those had to be written to avoid the IR macro before. Worse, the \X'...' ending the IR causes troff to emit only a single space after a period. Defining a new IM macro for manual references fixes both problems. Fixes #441. 2020-08-14 03:41:59 +00:00			`.IM mail (1)`
Some man pages. 2005-01-03 06:40:20 +00:00			`.SH BUGS`
			`.I Bundle`
			`will not create directories and is unsatisfactory for non-text files.`
Many small edits. 2005-01-13 04:49:19 +00:00			`.PP`
Some man pages. 2005-01-03 06:40:20 +00:00			`Beware of gift horses.`