FIT Version 3.0 (C)1990-1995 Turgut Kalfaoglu, <TURGUT@TREARN.BITNET>
"The Original Disk->Diskette Copier"

Shareware Evaluation Copy
-------------------------

FIT is a shareware product. This means that the author allows you UP TO 
30 days to evaluate and decide if this product is useful to you. At the 
end of this period, if you are satistified with FIT, you must register 
it by sending your $20 donation to the address shown below:

   Turgut Kalfaoglu
   1378 Sok. 8/10
   Alsancak, Izmir 35210
   Turkey

Personal checks (U.S. banks) must be made out to "Turgut Kalfaoglu". See 
REGISTER.TXT for details.

Highlights:
-----------
   * Fast, Multithreaded, Reliable 32-bit Operation
   * Advanced File Sorting mechanism to minimise diskettes
     required.
   * Optional Logging of operation to log file.
   * Easy and Transparent Registration

Synopsis
--------

FIT allows you to copy all the files matching to your specifications to 
any number of diskettes. FIT will arrange the files so that there will 
be very little free space left at each diskette. When a diskette gets 
full, it will prompt you for another. It will resume as soon as the new 
diskette is introduced.

Diskettes "fed" to FIT need not be totally empty: They can contain other 
files - FIT will simply use up whatever remaining space is available on 
that diskette. The only exception is the /H "Try Harder" option, which 
needs to assume that each diskette is as empty as the first diskette in 
order to calculate the best diskette arrangement. Thus, if /H option is 
used, you must either supply blank (formatted) diskettes, or specify the 
/W option as well so FIT empties the diskettes itself.

Normally FIT does not stop the diskette drive between diskette changes 
to save time. Using the /P option, you can tell it to pause each time a 
new diskette is needed. If /P is omitted, it will sense the new diskette 
as soon as it is introduced. If you prefer this mode of operation, you 
may consider putting SET FITCMD=/P command in your CONFIG.SYS.

FIT is a true 32-bit application that benefits from the multitasking 
abilities of OS/2. It uses a separate thread to do the "writing", 
freeing the reading thread to read ahead of time. This allows fastest 
copying times, especially for systems where multiple I/O paths are 
available.

The two active threads can be seen in action while FIT runs. While one 
thread reads ahead, the second thread writes the information to 
diskette. This is accomplished by the use of double-buffers. In other 
words, each time new data is read, one of the two buffers is chosen to 
read the data into, while the other buffer is being used by the writing 
thread. With this scheme, the writing thread never has to wait for more 
data to arrive, since read thread always has one buffer-full of data 
already loaded.

Usage
-----

FIT is similar to OS/2's COPY command, except the last parameter MUST be 
a drive letter. Since FIT is intended to be used with diskette drives, 
no path specification is permitted for the target parameter.

        FIT [options] source_filenames destination_drive

Options are:

    /P    Pause between diskettes. This option stops drive motor between 
          diskettes.
    /M    Move file. After each successful file copied, FIT erases the 
          file from its origin.
    /L logfile    Logs copying information to the file whose name is 
          specified in the command line.
    /W    Wipe Diskette option. If this option is specified, ALL 
          'normal' and 'Read-Only' files on the diskette are deleted 
          prior to copying. Each introduced diskette will first be 
          erased.
   /H secs   Enables FIT to use its advanced fitting algorithm to try to 
          find a better arrangement of the files for up to 'secs' 
          seconds. If 'secs' is omitted, it defaults to 15 seconds of 
          searching. If more than a few hundred files are being copied, 
          a 'secs' parameter of 30 or higher is recommended. /R    
          Register. Enables you to register your copy of FIT.

These options can also be made default by assigning an environmental
variable to them, such as:
SET FITCMD=/P /H 30
in your CONFIG.SYS, would make the pausing between diskettes the
default.

Usage Examples:
---------------
                FIT *.EXE A:
                FIT *.EXE *.DOC C:\OS2\*.* A:
                FIT /M /P \*.* B:

Limitations:
------------
  * Up to 6000 files can be processed at one run (up from 2048 for 
    FIT 2.x)
  * FIT cannot delete HIDDEN or SYSTEM files from diskettes, with the /W 
    wipe option. It can only handle NORMAL and READ ONLY files.

Release History:
----------------

1991 - Initial release of FIT 1.0 for DOS
1992 - FIT 1.1 for DOS and OS/2
1993 - FIT 2.0
1995 - FIT 3.0

