FSplit 1.0a
© 1996, by Jody Tierney

Legal
-===-
  FSplit is copyright © 1996, by Jody Tierney, with all reights reserved.
FSplit is FreeWare; it may be freely distributed so long as no profit is made
from it.  No warranty is provided, and I will not be responsible for any
damages caused, directly or indirectly, from the use or misuse of this program.


Introduction
-==========-
  FSplit is capable of splitting a large file into smaller pieces.  Even more
useful is the fact that these pieces may then be rejoined, using the standard
AmigaDOS Join command, to recreate the original file.
  FSplit was written in Amiga E.


Usage
-===-
  FSplit <filename> [TO <filename>] [CHUNKS <n> | CHUNKSIZE <n>]

    - <filename> - The name of the file to dismember.  Required.

    - TO (or AS) <filename> - The path and base name for the pieces of
                             <filename>.  This name will have a suffix of
                             "-xxx" appended to it, where "xxx" is an index
                             number.  Optional; if unspecified then the name of
                             the original file is used.

    - CHUNKS (or C) <n> - How many pieces to split <filename> into, from 2 to
                         999.  Optional; the default is 2.

    - CHUNKSIZE (or CS) <n> - Instructs FSplit to break <filename> into chunks
                             of <n> kilobytes.  Optional; if specified, then
                             the CHUNKS parameter is ignorred.


Examples
-======-
  We'll use a 453520-byte file names "BigFile" as our guinea pig.

  - FSplit BigFile

    Result:  Two files, "BigFile-001" and "BigFile-002", with sizes of 226304
            and 227216, respectively.


  - FSplit BigFile TO RAM:NotSoBig CHUNKS 10

    Result:  Ten files in RAM: named NotSoBig-001, ..., NotSoBig-010.  File
            lengths of 45056 bytes for the first nine, and 48016 for
            NotSoBig-010.


  - FSplit BigFile C 700 CHUNKSIZE 50

    Result:  Since the CHUNKSIZE parameter exists, "C 700" is bypassed, and
            9 files are output, "BigFile-001" to "BigFile-009".  Files "001" to
            "008" are 51200 bytes (50K) long, with the remaining 43920 bytes
            in file "009".


  To restore Bigfile (from out first example):

  - Join BigFile-001 BigFile-002 TO BigFile


Thanks To
-=======-
  - God - Life, the universe, & everything.

  - Wouter van Oortmerssen - Amiga E.

  - Greg Donner - The idea for FSplit.

  - Ramones
    Blondie - Music to program by.


Author
-====-
     Jody Tierney
   29118 Lark Street
Elkhart, IN, 46514-9579
         USA

E-Mail:  jtierney@cyberlink-inc.com
   WWW:  www.cyberlink-inc.com/jtierney