7. PowerPacker 2.3b & the CLI
-----------------------------

     For your convenience, I have also written two CLI commands, one to
crunch and one to decrunch data files.
     From version 2.3 onwards the CLI commands use the magnificent ARP
library !!!  This means they have been greatly enhanced:  wildcards are fully
supported, options can be entered in any order, directories will be created
when needed, etc...  Make sure the arp.library is in your LIBS:  directory
when you run these commands.
     A usage line is given by typing 'Crunch' or 'Decrunch' without
arguments.  You'll get something like this:
_____________________________________________________________________________

1> Crunch
[1mPOWER-PACKER 2.3a[0m Data Cruncher.
[33m  Written by Nico François (POWER PEAK)[0m
Usage : Crunch <source> <destination> [EFFICIENCY 1-5] [COLOR 0-4] [CRYPT]
                                      [NOSUFF] [NOLED] [FORBID] [NOPER]
With:
  EFFICIENCY: 1 = Fast, 2 = Mediocre, 3 = Good (def), 4 = Very Good, 5 = Best
  COLOR     : 0/1 = Color 0/1, 2 = Pointer (def), 3 = Scroll, 4 = None
  CRYPT     : Encrypt file.
  NOSUFFIX  : Don't attach '.pp' suffix to filename.
  NOPER     : Don't print percentage.
  NOLED     : Disable led crunch.
Hit ^C to abort, ^D to abort crunching only.

1> Decrunch
[1mPOWER-PACKER 2.3a[0m Data Decruncher.
[33m  Written by Nico François (POWER PEAK)[0m
Usage : Decrunch <source> <destination> [COLOR 0-4] [OPT B|F] [SKIP] [QUIET]
With:
   COLOR: 0/1 = Color 0/1, 2 = Pointer (def), 3 = Scroll, 4 = None
   SKIP : Skip uncrunched files.
   QUIET: Be quiet.
If <destination> is '*' or is omited, files will be typed to Output().
Options effective when typing:
   OPT B will print a banner before and
   OPT F will print a formfeed after each file.
Hit ^C to abort, ^D to abort typing only.

1>
_____________________________________________________________________________

     These commands are useful to be included in your startup-sequence or to
read crunched text files quickly.

  Some examples:

     Crunch df0:source/*.c TO ram:source COL 4 NOLED

     This will result in a crunching of every C program in the df0:source
directory.  If the ram:source directory exists the files will be saved there,
if it doesn't it will be created if there is more than one C program in
df0:source.  The '.pp' suffix will be attached to the filenames.  The led
will not flicker, no crunch color is used.

     Decrunch >PRT: QUIET dh0:progs/*.asm.pp OPT BF COL 3

     Every crunched assembler program will be decrunched and printed, before
each file a banner will be printed, each file will start on a new page.  If
the file is encrypted you will be prompted for a password.  It is very
important that you use the QUIET option here, if you don't the copyright and
information lines will also be printed.  The mouse pointer will flash while
decrunching.

NOTE: - These commands only (de)crunch DATA files !!!!  (So to (de)crunch
        executable files, you'll still have to use PowerPacker 2.3b).