*************************************
** Alien Breed: Tower Assault v1.4 **
*************************************

##############
## Overview ##
##############
 The source code to Tower Assault is quite large and is not the easiest Z80
program to compile. The file "towerdat.bin" is appended to the end of the
source during the assembling process although this isn't too complicated if
you follow the instructions below and use the files that I've included in
this zip.

 The source is spread across multiple files. I've done this because when I
had to fix errors and change parts of the program, it was easier to go
straight to the file with the routine I wanted to edit rather than searching
through one big file. The main file, "tower.z80", contains the intro and main
routines and also the smaller miscellaneous routines. The rest of the
routines I've tried to group into the other files.

 I've commented bits of the code but not much mainly because much of the code
was written in a hurry so that I wouldn't lose the ideas I had floating
around in my head. Therefore, you might find it hard to understand the logic
of the code. If you have specific questions you are welcome to email me about
the source code.

 As I've mentioned in all the source files, you are welcome to use bits of
the code as long as you give me credit. I'd appreciate it if you don't
release a modified version of the program without consulting me first because
it's not hard to make a program this size crash the calculator.

 Anyways, enjoy ploughing through the code, hopefully you guys/gals benefit
from it :)

WARNING: This is very important only for TI-83+ owners. Because of
         limitations on the size of programs on the 83+ and the large size of
         this game, it is not advisable for you to add to much to the size of
         the program. If you add too much, the calculator is likely to crash
         and I take no responsibility for this!

###################################
## Source Code Compilation Notes ##
###################################
 The compilation of Tower Assault is made a little difficult by the fact that
the file "towerdat.bin" is appended to the end of the code during assembly,
although this can be done using the "COPY /B" DOS command. To properly
compile Tower Assault, place all required files and the following batch file
in the same directory. Then create a batch file with the following content
and name it something like "build.bat".

 If you don't know how to create a batch file, here's how:
1. Using Windows Explorer, go to the directory that you've copied all the
   files to.
2. Click "File", "New" then "Text Document". Call it something like
   "build.bat".
3. When it asks if you are sure you want to change the file extension, click
   "Yes".
4. Right click on the file you've just created.
5. Select "Edit".
6. A notepad window should come up, paste the text below into it, select
   "Save" from the "File" menu, then exit.

 Use this batch file:
###########################################################
@ECHO OFF

ECHO Assembling ALIEN BREED: TOWER ASSAULT for the TI-83+...
ECHO #define TI83P >TEMP.Z80
TYPE TOWER.Z80 >>TEMP.Z80
TASM -80 -B -I TEMP.Z80 TOWER.BIN
IF ERRORLEVEL 1 GOTO TASMERRORS
COPY /B TOWER.BIN + TOWERDA_.BIN TOWER.BIN
DEVPAC8X TOWER

ECHO.
ECHO Assembling ALIEN BREED: TOWER ASSAULT for the TI-83...
ECHO #define TI83 >TEMP.Z80
TYPE TOWER.Z80 >>TEMP.Z80
TASM -80 -B -I TEMP.Z80 TOWER.BIN
IF ERRORLEVEL 1 GOTO TASMERRORS
COPY /B TOWER.BIN + TOWERDAT.BIN TOWER.BIN
DEVPAC83 TOWER

GOTO END

:TASMERRORS
ECHO Alien Breed: Tower Assault compilation Error!

:END
IF EXIST TEMP.Z80 DEL TEMP.Z80 > NUL
IF EXIST TEMP.LST DEL TEMP.LST > NUL
IF EXIST TOWER.BIN DEL TOWER.BIN > NUL

ECHO.
###########################################################

 This batch file should work. If you have any troubles compiling Tower
Assault, don't hesistate to email me at james@calc.org.
