ROM2EXE (c) 1998-1999 Jindrich Kubec <kubecj@asw.cz>
Latest version could be found at http://www.asw.cz/~kubecj

This program is provided 'as is', no warranty will be taken
for any damage caused by it or by any use of it.

The whole package is placed under the GNU Public License, for further
information on redistribution see the included file "GPL.TXT".


Usage:
------
ROM2EXE cartimage exefile

cartimage is source file. It could be 8192 bytes long (8KB cart) or 16384
(16KB cart).

exefile is destination file.

There is nonzero possibility that the resulting file won't work. It could be
because cart could check if it's actually in read-only memory. In such case
PIL could be the solution.

The small stub destroys whole memory before running the cartridge code. There
is no possibility to return to DOS.

It is NOT RECOMMENDED to use this program with emulators. They always have
option to load cartridge images directly. And in such case they behave (or
should behave) as real Atari. This program should be used if you want to
run such cartridge image on real Atari computer.


What it does:
-------------
In fact nothing. It just adds two portions together: the correct stub file
and the cartridge image. In DOS it could be done for example (for 16KB image:)
copy /b 8000BFFF.STB + CART.IMG CART.EXE
Stub just changes RAMTOP, cleans memory and runs the cart.


History:
--------
Date		Author	Version	Description
12/28/1998	kubecj	1.0	First public version


Sources:
--------
For Atari stub XA65 assembler is needed. Check my homepage for it's location.
For PC executables DJGPP is used. It could be found at http://www.delorie.com.

Sources were written for GCC/Intel only. There will be only slight problems
to port it to different architectures/environments.

Makefile will need only slight changes.


Todo:
-----
I can't imagine anything now.


Known bugs:
-----------
None.



