
PPK 1.1, part of the UnSquish distribution
==========================================

PPK is a simple Powerpacker compressor.  I wrote it for myself, but
decided to include in in this distribution as others might benefit
from it.  It requires powerpacker.library v36 or above, included in
the libs/ directory.  PPK requires AmigaOS release 2.00 or greater
(Exec v36 or above).


Usage
¯¯¯¯¯
Shell usage only.  There's no icon, and it won't run from Workbench.

Format:   PPK <file> [EFFICIENCY <efficiency>] [SPEEDUP <speedup>]
          [SUFFIX] [MEMHOG]

Template: PPK FILE/A,EFF=EFFICIENCY/K,SP=SPEEDUP/K,SUFF=SUFFIX/S,MEMHOG/S

The simplest usage of PPK is to type
  PPK foo
to compress the file "foo".  PPK will default to "best" efficiency,
and a large speedup buffer.  The compressed file will replace the
decompressed file.  PPK may be aborted by pressing Ctrl-C.

The EFFICIENCY parameter can be used to override the default efficiency.
You may specifiy FAST, MEDIOCRE, GOOD, VERYGOOD or BEST.  Alternatively,
you may supply a numeric argument between 1 and 5; 1 corresponding to
FAST and 5 to BEST.

For example, to crunch file "foo" with "mediocre" quality:
  PPK foo efficiency=mediocre
or
  PPK foo efficiency=2

EFFICIENCY may be abbreviated to EFF, ie
  PPK foo eff=2

The SPEEDUP parameter (which may be abbreviated to SP) sets the size
of the speedup buffer.  You may choose between SMALL, MEDIUM and LARGE.
Again, a numeric argument (1, 2, or 3) may be specified.

Eg to crunch file "bar" with a small speedup buffer, do
  PPK bar speedup=1
or
  PPK bar speedup=small
or
  PPK bar sp=1
etc

The SUFFIX switch (which may be abbreviated to SUFF) causes PPK to
append a .pp suffix to the file after it has been crunched, and not to
delete the original file.  This is similar to XPK's -s switch.

Some files get bigger before they get smaller.  PPK will abort with
a buffer overflow if this happens.  If you get a buffer overflow, you
might try setting PPK's MEMHOG switch.  This causes PPK to allocate
twice as much memory as it needs, in order to provide a big enough
buffer to prevent buffer overflow.  Sometimes it works.

PPK is pure and may be made resident.


Legal Matters
¯¯¯¯¯¯¯¯¯¯¯¯¯
powerpacker.library is © of Nico François.
PPK is © of Stephen Williams.  It is intended for distribution only as
part of the UnSquish package.  For full distribution information,
read UnSquish.guide.


How to contact the author
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Read UnSquish.guide for full information.
