home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 116 / af116sub.adf / UnSquish.lzx / UnSquish / Freebies / PPK.doc < prev    next >
Text File  |  1982-09-08  |  3KB  |  76 lines
  1.  
  2. PPK 1.1, part of the UnSquish distribution
  3. ==========================================
  4.  
  5. PPK is a simple Powerpacker compressor.  I wrote it for myself, but
  6. decided to include in in this distribution as others might benefit
  7. from it.  It requires powerpacker.library v36 or above, included in
  8. the libs/ directory.  PPK requires AmigaOS release 2.00 or greater
  9. (Exec v36 or above).
  10.  
  11.  
  12. Usage
  13. ¯¯¯¯¯
  14. Shell usage only.  There's no icon, and it won't run from Workbench.
  15.  
  16. Format:   PPK <file> [EFFICIENCY <efficiency>] [SPEEDUP <speedup>]
  17.           [SUFFIX] [MEMHOG]
  18.  
  19. Template: PPK FILE/A,EFF=EFFICIENCY/K,SP=SPEEDUP/K,SUFF=SUFFIX/S,MEMHOG/S
  20.  
  21. The simplest usage of PPK is to type
  22.   PPK foo
  23. to compress the file "foo".  PPK will default to "best" efficiency,
  24. and a large speedup buffer.  The compressed file will replace the
  25. decompressed file.  PPK may be aborted by pressing Ctrl-C.
  26.  
  27. The EFFICIENCY parameter can be used to override the default efficiency.
  28. You may specifiy FAST, MEDIOCRE, GOOD, VERYGOOD or BEST.  Alternatively,
  29. you may supply a numeric argument between 1 and 5; 1 corresponding to
  30. FAST and 5 to BEST.
  31.  
  32. For example, to crunch file "foo" with "mediocre" quality:
  33.   PPK foo efficiency=mediocre
  34. or
  35.   PPK foo efficiency=2
  36.  
  37. EFFICIENCY may be abbreviated to EFF, ie
  38.   PPK foo eff=2
  39.  
  40. The SPEEDUP parameter (which may be abbreviated to SP) sets the size
  41. of the speedup buffer.  You may choose between SMALL, MEDIUM and LARGE.
  42. Again, a numeric argument (1, 2, or 3) may be specified.
  43.  
  44. Eg to crunch file "bar" with a small speedup buffer, do
  45.   PPK bar speedup=1
  46. or
  47.   PPK bar speedup=small
  48. or
  49.   PPK bar sp=1
  50. etc
  51.  
  52. The SUFFIX switch (which may be abbreviated to SUFF) causes PPK to
  53. append a .pp suffix to the file after it has been crunched, and not to
  54. delete the original file.  This is similar to XPK's -s switch.
  55.  
  56. Some files get bigger before they get smaller.  PPK will abort with
  57. a buffer overflow if this happens.  If you get a buffer overflow, you
  58. might try setting PPK's MEMHOG switch.  This causes PPK to allocate
  59. twice as much memory as it needs, in order to provide a big enough
  60. buffer to prevent buffer overflow.  Sometimes it works.
  61.  
  62. PPK is pure and may be made resident.
  63.  
  64.  
  65. Legal Matters
  66. ¯¯¯¯¯¯¯¯¯¯¯¯¯
  67. powerpacker.library is © of Nico François.
  68. PPK is © of Stephen Williams.  It is intended for distribution only as
  69. part of the UnSquish package.  For full distribution information,
  70. read UnSquish.guide.
  71.  
  72.  
  73. How to contact the author
  74. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  75. Read UnSquish.guide for full information.
  76.