home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 3 / goldfish_volume_3.bin / files / util / pack / p-compress2 / p-compress2.doc < prev    next >
Encoding:
Text File  |  1993-07-13  |  7.4 KB  |  188 lines
  1.  
  2.                            P - C O M P R E S S 2 V2.1 
  3.                   
  4.                                                      (OS2+)
  5.  
  6.     INTRODUCTION 
  7.  
  8.      
  9.      All the old facilities are in this version PLUS a completely new compress-
  10.   ion module: FastC.  You now have a choice of three modes:
  11.  
  12.       FastC:  Compression and decompression much faster.  Efficiency only a
  13.       few % lower.
  14.  
  15.       StandardC:  An excellent compromise between speed and efficiency for
  16.       most purposes.
  17.  
  18.       SuperC: Slower than standard in both compression and decompression, but
  19.       a lot more efficient.
  20.  
  21.    The latest version of P-Reader (V8.2) is fully compatable and System 1.3
  22.   machines can use this to decompress/read/display files compressed with any
  23.   of the three modes.
  24.   
  25.      Like its predecessor it will compress single files, drawers or complete
  26.   disks, preserving disk and drawer structures.  Drawers and disks can be
  27.   copied from one place to another, selected files or classes of files being
  28.   compressed and the remainder just copied.  P-Compressed files, including
  29.   sounds, pictures and animations, can be displayed by P-Reader without prior 
  30.   decompression, and P-Compressed texts can be loaded into and saved from
  31.   P-Writer (StandardC only).
  32.  
  33.      Fast compression is simple LZ with a search depth of only $E00, but with
  34.   highly efficient handling of match position and length data.  Standard
  35.   compression is LZH using code by Barthel and Krekel, modified to limit memory
  36.   requirements.  SuperC compression is based on Meixner's innovative SHRINK
  37.   archiver, with improvement in speed and for most types of file a (very small)
  38.   gain in efficiency.  The penalty for using SuperC is that compression and
  39.   decompression times are increased by around 50%.
  40.  
  41.   
  42.    INSTRUCTIONS 
  43.  
  44.     Gadgets and the corresponding menu items are generally interchangeable; the
  45.   gadgets are described individually, mention only being made of the menu item
  46.   where its function is different.
  47.  
  48.     COMPRESS    Click to select compression
  49.     DECOMPRESS  Click to select decompression
  50.  
  51.     If neither is selected the input will just be copied to the output
  52.     
  53.     FROM   Click on the word `FROM' to get a file-requester. 
  54.     TO     Click on the word `TO' to get a file-requester.
  55.  
  56.     The file names selected will appear in the `from' and `to' string gadgets
  57.    where they can be modified or changed.  Alternately if the file names are
  58.    known they can be written directly into the string gadgets.  Press RETURN
  59.    after entering each name.
  60.  
  61.     If a drawer or disk is entered at FROM, but an existing file at TO, the
  62.    program will object.
  63.  
  64.     If TO is left blank, files will be compressed/decompressd to the current
  65.    directory.
  66.  
  67.     You can compress or decompress back over the original - enter the same
  68.    reference in both FROM and TO.  To give a measure of protection an inter-
  69.    mediate file is used (ram:m).
  70.  
  71.    COMPRESSION SETTINGS
  72.      
  73.     DATA FILES  The required operation (compression or decompression) will be
  74.                 carried out if the file selected is a data file, or on any data
  75.                 files in the selected drawer.
  76.  
  77.     EXEC FILES  As above, but for executables (a definition which includes such
  78.                 files as libraries and handlers).
  79.  
  80.     ICONS       As above, but for icons.
  81.  
  82.       Files of types not selected will just be copied.
  83.  
  84.     ASK         If a drawer or disk is being handled the program will pause at
  85.                 each file and ask for instructions.
  86.  
  87.     STRIP       Executable files will be stripped of hunks that are not needed
  88.                 in normal operations (such as debug or symbol hunks). Hunks
  89.                 lost cannot be restored.  STRIP can be combined with
  90.                 compression, but not with decompression.
  91.  
  92.     FASTC       Selects fast mode.
  93.  
  94.     STANDARDC   Selects standard mode.  (Default)
  95.  
  96.     SUPERC      Selects high efficiency mode.
  97.  
  98.  
  99.    ACTION
  100.  
  101.     CHANGE COLORS  Clicking the requester cycles through the available colors.
  102.                 Note that the equivalent menu items select a color-table
  103.                 directly.
  104.  
  105.     CANCEL      Clears all flags and entries.
  106.  
  107.     OVERWRITE   Allows existing files to be overwritten with new data.  If this
  108.                 flag is not set the program will ask for instructions before
  109.                 overwriting.
  110.  
  111.     GO          Click to start the operation.  A 'Progress' window will open
  112.                 to tell you what is happening.  (Fatal warnings, or notices
  113.                 that require an answer will come up in requesters rather than
  114.                 in this window).
  115.  
  116.     OPEN COMPICON  Clicking this closes the main screen and opens an Appicon
  117.                 (named CompIcon) on WorkBench which can then be used to
  118.                 compress or decompress in accordance with the set flags.  See
  119.                 the section COMPICON below.
  120.  
  121.     QUIT        Quit.
  122.  
  123.    There are two additional menu items:
  124.  
  125.     Save Flags  Saves flag and color settings to a file "P-Compress.pref" in
  126.                 your S: directory. 
  127.  
  128.     About       Puts up a small window with some information about the program.
  129.  
  130.      
  131.    COMPICON 
  132.  
  133.     To use the CompIcon first open P-Compress2 normally, select Compress or
  134.   Decompress, and if compressing set the compression flags as necessary. 
  135.   Click Open Compicon.  The main screen will close and the CompIcon will
  136.   appear on the Workbench screen (Workbench must be open).  If you now drop
  137.   any icon into into the Compicon the files called by the icon (single file,
  138.   drawer or disk) will be compressed or decompressed in accordance with the
  139.   set flags.  Note that the Overwrite flag will be set automatically.
  140.   A window will be opened to keep you informed of progress.
  141.  
  142.     When the Compicon is no longer required double-click it to reopen the main
  143.   window.
  144.  
  145.  
  146.    GENERAL 
  147.  
  148.     The space available on a disk or hard-disk partition is checked when
  149.   necessary, and if it appears insufficient you will be asked for instructions.
  150.   For very small files it may be worth continuing (click OK), otherwise click
  151.   QUIT.
  152.  
  153.     Before decompressing compressed files a checksum (CRC) is read and checked
  154.   - if an error is found an appropriate warning will be given and the
  155.   offending file passed over.
  156.  
  157.     If a file is found to be compressed by PowerPacker (other than self-
  158.   executing program files) it will automatically be decompressed before the
  159.   called-for operation - compression, decompression, or just copying - is
  160.   carried out.
  161.  
  162.     Compression can increase the size of very short files, or files which are
  163.   already compressed; if this happens the result will be discarded.
  164.  
  165.  
  166.            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  167.  
  168.     P-Compress is Freeware.  It may be copied and distributed freely and used
  169.   without charge for non_commercial purposes.  Authority for commercial use
  170.   should be obtained from the author below.
  171.  
  172.     No responsibility can be accepted for any loss occasioned by use of these
  173.   programmes.
  174.  
  175.     Comments, suggestions, bug-reports all welcome.
  176.  
  177.    Chas A. Wyndham,
  178.    1265 Canning Mills Road,
  179.    Roleystone,
  180.    WA 6111.
  181.    Australia 
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.