STOS FIXER VERSION 3.0
(C) 1994 Robert Quezada
Release date: May 10, 1994

USE THIS AT YOUR OWN RISK.  I WILL NOT BE RESPONSIBLE FOR ANY 
LOSS OF FILES.

Brief Description
-----------------
    This program was written using HiSoft Basic 2.10.  It calculates the STOS 
values required for STOS interpreter and STOS compiled programs for 
virtually all TOS versions.

Requirements
------------
    This should work on any TOS version, on machines with 512k minimum, 
and any resolution.  
    It requires that the file is not compressed (with ATOMIK, PACK-ICE, 
etc.).  It will check if the file is compressed and will often not write 
the changes to the file, but if it does, it changes the original file 
extension to .123, so that you will always have the original file.

NOTE:
-----

DO NOT USE THIS PROGRAM TO UPDATE COMP_xxx.PRG (the STOS 
compiler file) or C3D.PRG (the STOS 3D accessory program) BECAUSE 
THEY WILL NOT WORK PROPERLY AFTERWARDS.

    If the file is compressed, it can be decompressed with Mega Depack, 
which is available on GEnie(file #24286) and probably on other network 
systems.

FIXES
-----
Ver 2.0

   The joystick address finding routine has been fixed to work with less
joystick movement.  In order for it to work, the joystick must be in port 
#1 (not the mouse port, in case you didn't know).  Then, just follow the 
on screen instructions and then the address will be found.

Ver 2.1
     Can now be placed on the desktop and will fix STOS files if the 
programs are dragged onto it.  If your TOS supports that (which should be 
any TOS version 2.05 or higher), then click on STOSFX27.prg once, and 
then go to the INSTALL APPLICATION menu on the desktop.  You must 
install the default directory as APPLICATION and the parameter as FULL 
PATH.
     Then, you drag the icon onto the desktop and save the desktop, so all
those changes will be saved.  Every time you want to fix a file so it will 
work on your TOS version, all you have to do is drag the file to be fixed 
onto the STOS fixer's icon, it will fix the file for you and then return 
to the desktop.
     Run time STOS programs are now supported in this version.  They are 
fixed in the same way that compiled STOS programs are fixed.  One example 
of this would be Psycho Pig 2 (available on GEnie).  On disk 1, BOOT.PRG 
is a run time STOS program.

Version 2.6 (August 1993)
-----------
	NOT RELEASED TO PUBLIC DOMAIN
	Calculations of the last 2 values in the table were incorrect, but 
is now fixed for the Falcon030 and some other STs in previous versions.

Version 2.7 (NOVEMBER 1993)
-----------
	Now supports MULTITOS!!!!!  This file uses only 128kB of memory 
and should work with files of any size.  Files are only partially loaded in 
blocks no longer than 4096 bytes long, in order to conserve memory.
	I finally got this program to work.  I had to rewrite Version 2.1, 
because of a problem encountered with a cache program that erased all the 
files on my Falcon030.  That's why it took so long.
	Joystick calculating routine has been incredibly sped up so it only 
now takes about 1 second to get the correct value.
	In the window, there is now a listing of important values used by 
the program, so if there is any problem using it on your system, you can 
just tell me the numbers it found to help figure out the problem.
	DEFAULTS.DAT is now renamed to DEFxxxx.DAT where "xxxx" is the 
TOS version and all the values are listed in hexadecimal to make it easier to 
read.
	All *.PRG files can be dragged onto the STOSFX27.PRG icon(if using a 
TOS version that supports putting icons on the desktop).

Version 3.0 (May 1994)
-----------
	Translated to HiSoft BASIC 2.10 from GFA Basic due to the fact that I 
had the program crash under MultiTOS numerous times.  Now, it uses 
resource files to display the menu, instead of graphic calls.  This gives the 
program a cleaner look and provides 3-D buttons on AES versions that 
support it.
	It works really well under MultiTOS.  I have had no crashes as of yet 
while running it.
	A bug was fixed in this version.  If a directory had a "." in it, the "123" 
file created would be put some unknown place, instead of the correct 
directory.  This no longer is the case.

Other Notes
-----------
	FOR TOS Versions 4.0 and higher:
	--------------------------------
	The MMU cache doesn't need to be disabled.  Also, don't run the 
interpreter or game files under MultiTOS as they will cause an "Illegal 
instruction" error, or something like that, and they will not run.
	For some reason, after the addresses are put in the table, the 
program may not work.  Just change the ".PRG" extensions to ".TOS" for 
game files.  But the interpreter and run-time files must be auto-booted.  
All STOS files must be run in ST resolutions.
	Doing this should make the files work without a problem on your TOS 
version.  The speed increase is amazing in comparison with an 8 MHz STe.
(----------------------------------------------------------------------)

FOR EVERY TOS VERSION:

    After it finds the joystick address, it will ask you if you want to 
save the results as defaults.  If you select YES, then it will save the 
results to disk to the default file.  These values will then be in memory 
every time the program is run, so that when you want to allow other STOS 
compiled programs to work on your TOS, you don't have to go through 
constant testing of the joystick address.

    When it writes the file to disk with the changes, it also turns the
FastLoad option on.

    If you have any questions, comments, or anything else you want to tell 
me, or if this just doesn't work at all, send me e-mail to:
	(R.QUEZADA) on GEnie or
	(72122,2651) on CompuServe.

                                                    Robert Quezada.

    There may be a chance that this might not work on early STs with the 
TOS 2.06 conversion board.  I think that I have fixed the problem with the 
original program so that it will now work on those STs.  But if it 
doesn't, the default values that are supplied with the program are for TOS 
2.06

Also available:
	Punkman jr 2  (Atari Portfolio)
	-------------------------------
		Vertical scrolling Pacman clone that runs really fast and smooth.  
Instead of the normal 240x64 graphics resolution of the Portfolio, you get a 
scrolling screen with a 240x200 graphics resolution.