/\______/\____/\____/\____/\____/\____/\____    /\______/\____/\____/\_/\____Ck
\_      \_    \_    \__  _\_    \____ \_    \_  \_      \_    \_    \_ \_    \_
 |  | |  |  |  |  ---||  | |  ---|    <|  ---| O |  | |  |  |  |  |__|  |  |__|
 |  |_|  |     |---  ||  | |  ---|  |  |---  | F |  |_|  |     |  |_ |  |  |  |
 |__| |__|__|__|_____||__| |_____|__|__|_____|   |__| |__|__|__|_____|__|_____|
                             IT'S A KIND OF MAGIC



                         -= GAME BOY TOOL 1.2 DOCS =-

==============================================================================
Smart Card headers
==============================================================================

GBTOOL can strip the Smart Card header from a file, so you can use the
file with Game Boy emulators/disassemblers. Example:

 GBTOOL S TETRIS.GB

This will create a new file TETRIS.BIN in the same directory as TETRIS.GB.
Optionally you may specify a name for the outputfile, like this:

 GBTOOL S TETRIS.GB GAME1.BOY

Instead of TETRIS.BIN, GAME1.BOY will be used as outputfile.
You can add a Smart Card header to files to make them work with the
Smart Card copiers, especially the older ones. Example:

 GBTOOL H SF2.BIN

This will create a new file SF2.GB in the same directory as SF2.BIN.
Optionally, you may specify a name for the outputfile, like this:

 GBTOOL H SF2.BIN SF2.SGB

==============================================================================
Internal ROM info
==============================================================================

Each Game Boy game has some information about it stored in it's ROM.
The information covers gametitle, ROM size, RAM size, cartridge configuration,
checksum, licensee, Super Game Boy features and complement checksum.
Usage:

 GBTOOL I MARIO.GB

==============================================================================
Patching files
==============================================================================

If you get a trainer, it's most likely to come as an IPS file.
GBTOOL can apply such an IPS file. Use it like this:

 GBTOOL A TL.IPS TRUELIES.BIN

==============================================================================
Fixing complement checksum
==============================================================================

The complement checksum is checked by the Game Boy hardware when you
"boot" a cartridge. If the calculated complement checksum doesn't match the
value in the ROM, the game won't start. If the complement checksum gets 
corrupted, GBTOOL can fix it. Type:

 GBTOOL C DKL.SGB

==============================================================================
Fixing checksums
==============================================================================

The checksum is not checked by the Game Boy's hardware, but a faulty checksum
could mean the file has been tampered with. Also, coders/hackers want to
calculate a checksum for their releases... You can calculate the
checksum for a file by typing:

 GBTOOL F MYINTRO.GB

==============================================================================
EPROM support
==============================================================================

GBTOOL can create an ASCII hexdump of a Game Boy file. This enables you
to burn your own EPROM. The format used is one that's very common for
EPROM burners and includes a checksum at the end of each line. Usage:

 GBTOOL D MARIO3.GB

This will create a file MARIO3.HEX in the same directory as MARIO3.GB.
Alternatively you may specify an filename for the hexdump yourself, like:

 GBTOOL D MARIO3.GB MARIO3.DMP

==============================================================================
Reading 800K/1.6M disks
==============================================================================

You could use a program such as M3 or FDREAD, but these are TSR and eat up
memory. Why these programs were written is a mystery to me, because
all they do is change the internal DOS tables. 
This must mean that DOS can read 800K/1.6M disks. To force DOS into reading
800K/1.6M disks, put this line as the first line in your CONFIG.SYS file:

 DRIVPARM=/D:0 /C /F:7 /H:2 /S:20 /T:80

This will work for most systems with a 3.5" HD drive as station A.
If your drive is not A: or is a DD (double density) drive, just change 
the parameters a bit. For more info on DRIVPARM usage, type this at the
DOS prompt:

 HELP DRIVPARM

When you've added the line in your CONFIG.SYS file, restart your system.
Now, with your 'upgraded' configuration file you can format a disk at 
1.6M capacity by typing at the prompt:

 FORMAT A:

Because the driveparameters are changed (from DOS' point of view), 
formatting a disk at 1.44M capacity is done by typing:

 FORMAT A: /F:1440