--------------------------------------------------------------
                    TETRAPACK Version 2.1
--------------------------------------------------------------

   TetraPack Version 2.1 is a  new  version  of  TetraCrunch with
rewritten memory management routines, a new decruncher and a mega
crunch option which  allows  crunching  of  programs up to $7ff00
bytes long (511.75 Kb!!). The  cruncher  is (and has always been)
the very best on the 'market' at this moment.

                            CREDITS:

    User Interface, Decrunchers, Research, and Crunchers by:

                           ANTIACTION.

        With thanks to LORD BLITTER, IL SCURO, and LASER.


INSTRUCTIONS
------------

  There are actually two  crunchers  in  TetraPack, one 'Amateur'
version, which handles normal  programs  in  much the same way as
Byte  Killer,  Flash-Packer  (RSI),  and  TetraCrunch.  And  then
there's a  'Professional'  version,  which  handles programs from
$0000-$7ffff. The  professional  version  should  only be used to
pack games or demos which  doesn't  use the Operating System. For
example: KATAKIS, TLC POWERTRAX, PANDORA, NETHERWORLD, NEBULUS et
cetera. The name 'professional'  implies  that  this version only
should be used by experienced programmers and crackers.

  The following instructions  applies  both to Mega-Crunch (Pro),
and The normal crunch.

NOTE: Whenever T.P.  asks  for  anything  else  than  RETURN or a
hexadecimal number, you can  type  an  asterisk (*) followed by a
command or program name to execute  a command/Program, useful for
loading a monitor and alter something before crunching!!

  First TetraPack asks:

Mega-Crunch (Y/N) ? 

Here you simply type Y if you want  megacrunch, and N if you want
normal crunch. Next, the program asks:

Low-Mem: $

Here you are supposed to  enter  the  lowest  address  which your
program uses. Next, TP asks:

High-Mem: $

Here you should enter  the  highest  address  which your programs
uses. Actually  you  should  always  specify  a  high-mem that is
higher that the actual  program's  last  address. (Because of the
way the first pass cruncher works). Also,  another thing to  take
into account when selecting high-mem's  is the fact that when the
program later on is loaded  from disk, it will possibly be loaded
into a position so  that it overlaps  the decrunch-area, to avoid
this, ALWAYS CHOOSE A  HIGH-MEM OF AT  LEAST $50000. THIS IS VERY
IMPORTANT!!! (USING A HIGH HIGH-MEM DOES NOT AFFECT THE PROGRAM
SIZE BY MORE THAN APPROX. 5 BYTES PER EVERY 64 KBYTES!! SO USE AS
HIGH HIGH-MEM's AS POSSIBLE!)


  Next TP clears the allocated memory to obtain optimal crunching
performance. Now TetraPack asks:

Scan-Width ($10-$8000): $

This number specifies how many  bytes  forward the equal-sequence
packer should look for an equal  sequence,  the  general rule is:
the higher a scan-width, the  smaller  program,  but it will also
take longer time to crunch. However,  this is not always true, as
you soon shall see the optimal scan-width  is almost always $800.
When selecting a  Scan-Width,  do  not  just take one out of thin
air, like $35d or $57, these  are  not very efficient. No, always
use an even power of two, like $40,  $80, $100, $200, $400, $800,
$1000, $2000, $4000, $8000. NOTHING INBETWEEN!!! Another rule is,
if you double the scan-width, you also double the crunching time.

  The next stage is to enter all  files  to  load into memory, so
the next question is:

Load type (r=Reloc, o=Plain, t=TrackDisk):

  As you can see, there are several  different types of loads, an
explanation:

R - RELOC:

This option loads a CLI executable  file into a fixed location in
memory, i.e. a file saved from  seka  with the command WO, or the
Object file from DEVPAC.  One  should  note,  that you should not
crunch CLI commands as DIR etc. with this cruncher, for that, use
the TNM-Cruncher, ANC Cruncher, Relokit, or any similar cruncher.
So what can this load-option  do??  Well,  it is VERY useful when
putting demo's  together,  as  you  can  save  the Object code as
Relocateable (CLI) code, and then,  when you are going to crunch,
you can load the code into any  memory  location you want. Useful
for MegaDemos (I can tell...)!!. Also,  you can crunch some games
using this option, like Thundercats,  for example, which is saved
as one reloc-file.

O - PLAIN:

This option  simply  loads  a  file  into  memory,  and  makes no
alterations to it's contents,  I.E.  you  can load a text file, a
picture, a sample or anything else  into memory. Works like RI in
SEKA.

T - TRACKDISK:

This option loads data straight from AmigaDOS sectors.It asks for
OFFSET, and for LENGTH, these should be entered as even multiples
of $200. The values are exactly  like  those put into the ExtTDIo
structure when doing bootblock loaders etc. Useful when crunching
games!!!


You can go on loading  files/sectors as many times you want. When
you are finished with the loading of data, just press return, and
TetraPack will start it's REAL work...

When it is finished with the  crunching,  it will display how big
the crunched file is, and how many bytes was won, press RETURN to
continue.

Now TP asks you to enter the JMP/JSR address, which simply is the
starting address of your code (start of program).

When you have entered the JMP address, you will be asked:

Next TetraPack asks something like:
Flash-register: etc....

Here you choose in which color register the depacker should place
the flash values, $00 is background, $01 foreground 1 etc. To get
rid of the  flashing, simply  select $10. (Not  used on workbench
screen). Next TetraPack asks:

PRO-DECRUNCHER? (Y/N):

If you want the 'pro' version of the decruncher, then answer yes,
if you don't, just press return, or answer no.  If you select the
pro-decruncher, you will have the same decrunch-possibilities as
in the MEGA version of the cruncher.

If you are working  in  MEGACRUNCH  mode,  or if you answered yes
on the question above, you  will now get  some further questions,
these are described later.

At this point TetraPack asks for a name, which is the name of the
crunched file. If you don't want to  save the crunched file, just
press RETURN, or enter NIL:, to avoid saving.

Next TetraPack asks if you would want  to save again, answer Y or
N. If you answer No, TetraPack will ask you:

Want to run? (Y/N): 

If you answer Y here, TetraPack will run the packed program with-
out reloading it. If you answer NO, TetraPack will end.

                             MEGACRUNCH