42 lines
1.6 KiB
Groff
42 lines
1.6 KiB
Groff
.TH GATHER 1
|
|
.SH NAME
|
|
gather \- gather up the files in a directory for transmission
|
|
.SH SYNOPSIS
|
|
\fBgather\fR [\fB\-s\fR] \fIsource_dir [\fB\-d\fR] dest_dir\fR [\fB\-b\fR] \fIbytes\fR [\fB\-f\fR] \fIfile\fR\fR
|
|
.br
|
|
.de FL
|
|
.TP
|
|
\\fB\\$1\\fR
|
|
\\$2
|
|
..
|
|
.de EX
|
|
.TP 20
|
|
\\fB\\$1\\fR
|
|
# \\$2
|
|
..
|
|
.SH OPTIONS
|
|
.FL "\-b" "Desired number of bytes per output file"
|
|
.FL "\-d" "Destination directory"
|
|
.FL "\-f" "Base name of output files"
|
|
.FL "\-s" "Source directory"
|
|
.SH EXAMPLES
|
|
.EX "gather" "Collect files in current dir into 60K archives"
|
|
.EX "gather \-d dir" "Put the archives in \fIdir\fR
|
|
.EX "gather \-b 90000" "Try to produce 90K archives"
|
|
.EX "gather \-s .. \-d targ \-b 5000" "Try to produce 5K archives"
|
|
.SH DESCRIPTION
|
|
.PP
|
|
It is often useful to collect all the files in a directory into one or
|
|
more archives for transmission by mail. This program collects all the
|
|
files in the source directory (default: current directory) and puts
|
|
them into a shar archive. The shar archive is then compressed and
|
|
uuencoded. An attempt is made to have the final \fI.uue\fR file be
|
|
about the given size (default: 60K), but since \fIgather\fR cannot really
|
|
predict how much \fIshar\fR will add to the file, how much \fIcompress\fR
|
|
will reduce the file, and how much \fIuue\fR will add again, the sizes
|
|
can fluctuate. If the \fB\-f \fIfile\fR flag is given, the archives will
|
|
be given the names \fIfile_00.uue\fR, \fIfile_01.uue\fR etc. If \fB\-f\fR
|
|
is not given, the name of the source directory is used as the base name.
|
|
Since 7 characters of suffix are appended, the base name should not exceed
|
|
7 characters.
|