Split
                                   *****

                       Documentation by Thies Wellpott
                       (excuse my bad English, please)


1. Copyright
************

Split is public domain, do with it what you want but be fair and include
"Split", "Split.doc" and "Split.c" with your distribution.


2. Warrenty
***********

YOU USE THIS PROGRAM COMPLETELY ON YOUR OWN RISK! If you destroy any file,
your computer, your car or even the whole universe or any part of it while
using it, do not blame me, it is not my fault!


3. Introduction
***************

Do you now the Join command in C: ? Did you ever search for the opposite? I
did and found some programs which managed to split a file into parts, but
they all where slow (why?). Split is a short and fast solution.


4. Usage
********

Split is runnable only from the CLI/Shell. It runs with Kickstart 1.2/1.3
and OS 2.0. If you start Split with no or wrong arguments or with a ? as
the first argument you will get a usage info:

›4mSplit V1.00 (28.06.92)›0m by Thies Wellpott

Usage: Split <infile> <outfile> size1 [size2 [size3] ...]


infile   is the name of the file you want to split
outfile   is the base name the destination files will have
size(1|2|3)   are the sizes of the parts either as a decimal number which
   means bytes or as a decimal number ending with a "k" (or a "K") which
   means kbytes (1024 bytes).


Examples:

1> Split c:ed ram:spled 123 3K 2K 456 1000

produces (if c:ed has 25044 bytes) the following six files in "ram:" :
spled.0     123  \
spled.1    3072   \
spled.2    2048    )- the defined sizes
spled.3     456   /
spled.4    1000  /
spled.5   18345  - the rest of the file


1> Split exec.doc exec.doc 10K 10K 10K 100K 20K

produces (exec.doc has 128682 bytes) in the current directory:
exec.doc.0  10240
exec.doc.1  10240
exec.doc.2  10240
exec.doc.3  97962

and outputs "outfile 3 truncated!" because exec.doc has too less bytes to
be split into six files (five specified plus the rest), so there are
produced as many files as possible and then the operation is aborted (I
hope you understand).



Send bug reports, hints, and ideas to:

        Thies Wellpott
        Moorhauser Weg 14
        2948 Schortens 1

        Germany

        (sorry, no e-mail)