.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.