c64 CRUSHer manual
------------------

If you want to make a CRUSHed c64 executable you must have _one_ binary file
you want to crush. If you have more than one file - link them together leaving
zeros in non-used memory areas. Your file can _not_ be placed in memory
area different than $440 to $fff0 - if it does - use the PACK64 packer first
(available together with 6502TASS as well).
When you are ready to crush your file, type:

CRUSH <packing_speed> <file_to_pack> [packed_file]

the <packing_speed> must be a number between 0 and 6 (6=the best compression).
There's no problem to _always_ use 6 as packing even 64kB file won't take
more than a second even on a slow 486.
<file_to_pack> must be a name of your source binary file. Be sure that it
has correct load-address (1st two bytes of the file) or the decompressor
will fail!
[packed_file] is a destination name which is not necessary - when you don't
use it: CRUSHer will generate a 'crushed' file (suggested).

Now, you have to configure the depacker: edit the file 'decrush.tas' and
modify following variables:
speed - *must* be the value you packed your file with (packing_speed)
sysline - type 1 if you want a Basic SYS line and 0 if you don't
linenum - number of the Basic SYS line
val01 - required $01 system register to run you program
cliflag - 1 will enable interrupts after depack, 0 won't
exeaddr - starting address of your program
You can also modify the text which will appear after the SYS line.

Now, you can easily assemble 'decrush.tas' using following command-line:

TASS /a DECRUSH.TAS

Be sure, you have registered your TASS _before_!

The output file (DECRUSH.O64) can be now renamed and is ready to use!
