
                             ===================
                             !Split Version 2.01
                             ===================

                             1994 Adam Hamilton.


    This application is FreeWare and may be freely distributed provided :-

      *  No charge is made other than to cover the cost of the medium.
      *  All files, including this !Help file, are included unaltered.

    Bug reports and comments may be sent to me at this address :-

                        Adam Hamilton,
                         23 Northmeadow Road,
                          Cricklade,
                           Swindon,
                            Wiltshire,  SN6 6LT,
                             England.

    I may also be contacted by E-Mail:    aph@swindon.gpsemi.com

   This program is supplied 'as is' with no guarantee of its suitability for
   any purpose. I will not be held responsible for any loss of data occurring
   through the use or misuse of this program.

================================================================================

Introduction
~~~~~~~~~~~~

      !Split was written to ease the transportation of large files from one
   computer to another (not necessarily the same make). No attempt to compress
   the file is made, as it is assumed this has already been done. !Split will
   split a file into a number of smaller files, and will join them again when
   required.


How to use !Split
~~~~~~~~~~~~~~~~~

      !Split can be started either by running the application directly or by
   a double click on a split file (see 'joining files').

   Splitting files
   ===============

      Pressing Select on the iconbar icon or dragging a file to the icon, you
   will see the main Split window. Here is a description of each function:-

   Source      - This is for the file you want to split, you can either type
                 the filename, or drag the file to the window (if you drag,
                 the 'Filename' field will automatically get filled in for you
                 but you can still change it if you want).

   File Size   - This is the largest file size in K (1024 bytes), that you
                 want each part saved as. A default value can be set in the
                 !Run file inside the application directory e.g.

                 Run <Split$Dir>.!RunImage -filesize 710 %*0

                 When next run, the default value will now be suitable for
                 double density DOS formatted disks of 720 K

   Filename    - This is the 'base' filename you want to call each split
                 file, e.g. if the base name is MyProg then the split
                 files will be saved as MyProg01, MyProg02, ... etc.

   Single Save - If this option is set, !Split will automatically save all
                 parts to the same directory, only one drag is needed.
                 The default status of this button can also be set in the !Run
                 file, just add the option -singlesave to the Run command e.g.

                 Run <Split$Dir>.!RunImage -singlesave %*0

                 This will set the default single save as on.
                 Any combination of -singlesave and -filesize can be used on
                 the same line. 

   Split       - This will start the splitting process.


   Note : You may open and close filer windows, or change floppy disks between
          saving each part.


   Joining files
   =============

      To join files back together, either double click on a split file icon,
   drag the file to the iconbar icon, or press Adjust on the the iconbar icon.
   This will open the join window. If you pressed Adjust, you must drag the
   first part of the split files to the join window. You now need to tell !Split
   where to put the joined file. To do this, simply drag the file icon to the
   directory viewer where you would like the joined file to be saved. (There
   are brief instructions to help you). You will then be prompted to drag the
   next part to the join window (you can also double click on the file), this
   should be repeated until all the parts have been joined. The window will
   then automatically close. If the remaining parts of the file are in the
   same directory you may select them, and drag them to the window.

      Pressing Cancel will, of course, cancel the joining operation and close
   the window. Please note, if joining has already started, and the operation
   is stopped, the parts already joined will remain as a data file.


Customizing
~~~~~~~~~~~

      You can customize !Split to have default settings in the Split window
   (see 'splitting files'). You may also increase the buffer size for reading
   and writing files. This is done by increasing the value of the -max option
   on the WimpSlot command in !Run and will slightly speed up the splitting
   and joining functions e.g.

   WimpSlot -min 192k -max 640k


History
~~~~~~~

   Version 1.00 - 1.08 : These were the original command line versions compiled
      on several different computers.

   Version 1.10        : This version has a new file format, a header is put
      at the beginning of each part. This is used to join things in the correct
      order. *NOTE* this version is compatible with the desktop version (2.00
      and greater), and is supplied inside this application directory.

   Version 2.00 (Beta) : First desktop version.


   Version 2.01        : This version. Added ability to open join window with
      the Adjust button, and drag files to the window. This made it easier to
      start the joining procedure if the files aren't filetyped as 'Split'.
      Fixed bug with ArcFS image filesystem - doesn't complain about archives
      any more.


Files supplied
~~~~~~~~~~~~~~

   !Boot
   !Help                  - This file.
   HelpPS                 - PostScript version of this file.
   !Run
   !RunImage              - Main program.
   !Sprites, !Sprites22
   Templates              - Windows.
   Template2D             - Templates for RiscOS 2.
   Template3D             - 3D Templates, RiscOS 3 only.
      Copy whichever version you want to use, to 'Templates'
   ACORN                  - Directory, contains command line version.
   PC                     - Directory, contains command line version.
   SUN                    - Directory, contains command line version.
   VAX                    - Directory, contains command line version.
   HPUX                   - Directory, contains command line version.

   Command line versions are called splitf and joinf because on some systems
   programs already exist called split and join.

================================================================================
