.TH CATSF 1csound CARL 
.SH NAME
catsf 
- concatenate sound files
.SH SYNOPSIS
.B catsf 
[-h] [-c] [-rN] source [[-rN] source]...  destination
.RS .5i
.nf
-rN repeat the next file N times
-c  force file to be contiguous
-h gives a help message
.RE
.SH DESCRIPTION
.B catsf 
concatenates the source 
sound 
files to the destination 
sound 
file.
(The sources can be any 
sound file, including the same one named any
number of times.)  The -r flag takes an option N of the number of times
to repeat the following file.
.PP
The attributes of the destination file are determined by the attributes
of the first source file.  These attributes include packing mode, number
of channels and protection.
A check is made on all files to be concatenated to make sure they agree
in packing mode and number of channels.
.PP
The output file also inherets the contiguous/non-contiguous attribute
of the first named input file.  If it is non-contiguous and you want
it contiguous, use the -c flag.
.PP
To obtain intervening silences between concatenated files, use files
with zeros in them of the appropriate lengths (use e.g., wave(1CARL)).
.PP
NOTE:
.B catsf
always treats the last file in the list as the destination.  If you leave
this off, you may end up concatenating all the files into the last named
source file, thereby loosing it.
.SH AUTHOR
Gareth Loy
.SH SEE ALSO
cpsf(1csound), mvsf(1csound), rmsf(1csound).
.SH DIAGNOSTICS
You may not concatenate a file to itself.
You may not concatenate files with conflicting attributes.
.SH BUGS
There is a silent limit of 64 files that can be concatenated at one blow.
.PP
If the first file is contiguous the file created by concatenation
will be too by default, and ifthe total size of the file 
is bigger than the largest block on the
disk, you will get the message "allocsf: out of space!".
