Short:    Splitting utilities with gui. v.1.2 15/Nov/1998  OS 3.0 required. 
Uploader: vettorel@mail.psy.unipd.it (Vettorello Marco)
Author:   vettorel@mail.psy.unipd.it (Vettorello Marco)
Type:     util/misc

THESE TWO UTILS NEED AMOS.LIBRARY AND GUI.LIBRARY IN YOUR LIBS.
They are included in this archive.

     You can start them from WB (double click the icon - be sure stack is 
     set to 10000 at least) or from CLI (set stack to 10000)

It follows a little description of them:

--------------------------------------------------------------------------------

 MasterSplitt : choose the source file, then how many files you want 
          to create or  how big must be the files to be created.

          It uses -memory- such this : if you want to split a file of
          1000000 bytes you don't need the same contiguous memory area
          available but the memory area of the splitted files, for example 
          you want that file to be divided into 4 files then you need 250000 bytes 
          of free memory. At the end of the filename will be added  "_X" where X is 
          the number of the file.

          There is a -on line help-.

          In this version i've included a -Popup-winMenu-. :-) I wrote this 'cause
          i was really impressed looking at popup.library (a great library indeed).
          So i decided to emulate that library and the result is here. Let me Know
          something about it. Source code is available under request (when used in 
          your progs you should at least give credits to me :-).

          Sometimes when you indicate to divide a file into N files you may
          obtain N+1 files, the last 1 byte long. This depends on the
          lenght of the source file, for example: source file is 7 bytes
          long, you divide it into 3 files. You obtain 3 files of 2 bytes
          and one file 1 byte long. It's not a bug, but a feature (in my
          opinion).

--------------------------------------------------------------------------------

 SubSlink : choose the source file, then the destination file(s). 

          In this program you have to specify the -starting and ending bytes-
          for your file(s). For example you have a file of 1024 bytes, 
          you can save the first 256 bytes in a particular file and the 
          remaning 768 bytes in a different file. 
          You can specify as destination only 4 different file. (This may 
          change in future releases).

          At the end of the filename will be added  "_X" where X is the 
          number of the file. 

          Memory usage is the same as in MASTER: i.e. you need an amount 
          of free memory equal to the lenght of the biggest splitted file
          If the sorce file is 1,000,000 bytes long and you want it to be
          splitted into 4 different file then you need only 250,000 bytes 
          free.

   ====>  NB: THE FIRST BYTE IS NUMBER 0 (ZERO).
   ====>  When you indicate the starting bytes insert 0 (zero) if you want
   ====>  the file containig the first byte!!! But if you want to strip the
   ====>  first byte then indicate 1 as starting byte!! 

          Example: foo.file is 1024 bytes long. You want to divide it into
          2 files of the same length. 
          Then : First file - name ram:foo.file 
                            - starting byte is 0 (zero)
                            - ending byte is 512
     
                Second file - name ram:foo.file
                            - starting byte is 512
                            - ending byte is 1024      
          
          At the end of the filename will be added  "_X" where X is the number 
          of the file (only from 1 to 4).

          So we type:
          
          Ram Disk: >list

          foo.file_1               512 ----rwed Oggi      16:16:16
          foo.file_2               512 ----rwed Oggi      16:16:16
          foo.file                1024 ----rwed Oggi      16:04:19


 Development:
     they were developed on an A4000/040 AGA 8mb fast 2mb chip Atapi CD24x
     4.3Gb SAMSUNG HD using AMOSPro v2 and GuiExtension v1.7 by Pietro Ghizzoni..

 Freeware:
     these are free utilities. If you want send an e-mail.

 Disclaimer:
     THIS PROGRAM IS PROVIDED ON AN "AS IS" BASIS, NO WARRANTIES ARE MADE, 
     EITHER EXPRESSED OR IMPLIED. IN NO EVENT WILL I, VETTORELLO MARCO BE LIABLE 
     FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING 
     FROM ANY USE OR MISUSE OF THIS PROGRAM. THE ENTIRE RISK AS TO THE RESULTS 
     AND PERFORMANCE OF THIS PROGRAM IS ASSUMED BY YOU.     

 Address:
      Comments, suggestion and bugs reporting > vettorel@mail.psy.unipd.it

 Future:

      Add -Popup-Winmenu- to SubSlink.
      Infinite splitted files in SubSlink.

      A memory reported (if someone ask for it)

      Bug removing (i need bug reporting)

      A better documentation (AmigaguideŽ)
      
      At moment localization is not possible.

      Suggestion?