home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / util / p-compress2-1.2.lha / P-Compress2-1.2 / P-Compress2.doc < prev    next >
Encoding:
Text File  |  1994-06-01  |  8.1 KB  |  207 lines
  1.  
  2.                            P - C O M P R E S S 2 V1.1 
  3.  
  4.  
  5.     INTRODUCTION 
  6.  
  7.      
  8.      P-Compress2 has been completely re-written in Assembler for System2 (at
  9.   least 2.04 required) and System3, with a greatly improved user interface and
  10.   some major new options:
  11.  
  12.    *  Alternative `SuperC' compression - more efficient, compression slower,
  13.       decompression a lot slower.
  14.  
  15.    *  Appicon facility - drop in files, drawers or whole disks for hands-off
  16.       compression/decompression
  17.  
  18.    *  Menu alternatives to all gadget inputs.
  19.  
  20.    *  Configuration file.
  21.  
  22.      One facility from the old P-Compress is missing - PACK.  This is likely to
  23.   reappear as a very simple multi-disk archive/backup tool for people who don't
  24.   like or need the elaborations of current offerings.
  25.  
  26.      Compatability with P-Compress (latest version V2.9) is maintained and
  27.   System 1.3 machines can continue to use this.
  28.   
  29.      Like its predecessor it will compress single files, drawers or complete
  30.   disks, preserving disk and drawer structures.  Drawers and disks can be
  31.   copied from one place to another, selected files or classes of files being
  32.   compressed and the remainder just copied.  P-Compressed files (both standard
  33.   and SuperC compression), including sounds, pictures and animations, can be
  34.   displayed by P-Reader V7.1 without prior decompression, and P-Compressed
  35.   texts (standard compression only) can be loaded into and saved from P-Writer
  36.  
  37.      Standard compression is LZH using code by Barthel and Krekel, modified to
  38.   limit memory requirements.  SuperC compression is based on Meixner's
  39.   innovative SHRINK archiver, with improvement in speed and for most types of
  40.   file a (very small) gain in efficiency.  The penalty for using SuperC is that
  41.   compression time is considerably increased and roughly equals decompression
  42.   time.
  43.  
  44.    COMPARISON WITH ALTERNATIVE PROGRAMMES 
  45.  
  46.     Archivers:  eg  LHArc, PKAZip.
  47.  
  48.      Archivists are well provided for at present with the fast and efficient
  49.   LHA and the slower but even more efficient SHRINK.  P-Compress2 does not
  50.   compete in this area, or in the area of HD Backup.
  51.  
  52.     General compression tools: eg Power Packer
  53.  
  54.     An excellent programme in its day the current PD version of PowerPacker is
  55.   completely outclassed by practically everything, although the speed of the
  56.   commercial version may justify some continued use.  The NUKE module in the
  57.   XPK package has a useful balance of speed and efficiency, although the latter
  58.   is poorer than the standard P-Compress and a long way below SuperC.  No two
  59.   people will ever agree on the optimum balance of speed and efficiency, but
  60.   it is worth remembering that the PRIMARY function of compression is to save
  61.   space rather than time.
  62.   
  63.  
  64.    INSTRUCTIONS 
  65.  
  66.     Gadgets and the corresponding menu items are generally interchangeable; the
  67.   gadgets are described individually, mention only being made of the menu item
  68.   where its function is different.
  69.  
  70.     COMPRESS    Click to select compression
  71.     DECOMPRESS  Click to select decompression
  72.  
  73.     If neither is selected the input will just be copied to the output
  74.     
  75.     FROM   Click on the word `FROM' to get a file-requester. 
  76.     TO     Click on the word `TO' to get a file-requester.
  77.  
  78.     The file names selected will appear in the `from' and `to' string gadgets
  79.    where they can be modified or changed.  Alternately if the file names are
  80.    known they can be written directly into the string gadgets.  Press RETURN
  81.    after entering each name.
  82.  
  83.     If a drawer or disk is entered at FROM, but an existing file at TO, the
  84.    program will object.
  85.  
  86.     If TO is left blank, files will be compressed/decompressd to the current
  87.    directory.
  88.  
  89.     You can compress or decompress back over the original - enter the same
  90.    reference in both FROM and TO.  To give a measure of protection an inter-
  91.    mediate file is used (ram:m).
  92.  
  93.    COMPRESSION SETTINGS
  94.      
  95.     DATA FILES  The required operation (compression or decompression) will be
  96.                 carried out if the file selected is a data file, or on any data
  97.                 files in the selected drawer.
  98.  
  99.     EXEC FILES  As above, but for executables (a definition which includes such
  100.                 files as libraries and handlers).
  101.  
  102.     ICONS       As above, but for icons.
  103.  
  104.       Files of types not selected will just be copied.
  105.  
  106.     ASK         If a drawer or disk is being handled the program will pause at
  107.                 each file and ask for instructions.
  108.  
  109.     STRIP       Executable files will be stripped of hunks that are not needed
  110.                 in normal operations (such as debug or symbol hunks). Hunks
  111.                 lost cannot be restored.  STRIP can be combined with
  112.                 compression, but not with decompression.
  113.  
  114.     SUPERC      Selects higher efficiency compression.
  115.  
  116.  
  117.    ACTION
  118.  
  119.     CHANGE COLORS  Clicking the requester cycles through the available colors.
  120.                 Yhat the equivalent menu items select a color-table directly.
  121.  
  122.     CANCEL      Clears all flags and entries.
  123.  
  124.     OVERWRITE   Allows existing files to be overwritten with new data.  If this
  125.                 flag is not set the program will ask for instructions before
  126.                 overwriting.
  127.  
  128.     GO          Click to start the operation.  A 'Progress' window will open
  129.                 to tell you what is happening.  (Fatal warnings, or notices
  130.                 that require an answer will come up in requesters rather than
  131.                 in this window).
  132.  
  133.     OPEN COMPICON  Clicking this closes the main screen and opens an Appicon
  134.                 (named CompIcon) on WorkBench which can then be used to
  135.                 compress or decompress in accordance with the set flags.  See
  136.                 the section COMPICON below.
  137.  
  138.     QUIT        Quit.
  139.  
  140.    There are two additional menu items:
  141.  
  142.     Save Flags  Saves flag and color settings to a file "P-Compress.pref" in
  143.                 your S: directory. 
  144.  
  145.     About       Puts up a small window with some information about the program.
  146.  
  147.      
  148.    COMPICON 
  149.  
  150.     To use the CompIcon first open P-Compress2 normally, select Compress or
  151.   Decompress, and if compressing set the compression flags as necessary. 
  152.   Click Open Compicon.  The main screen will close and the CompIcon will
  153.   appear on the Workbench screen (Workbench must be open).  If you now drop
  154.   any icon into into the Compicon the files called by the icon (single file,
  155.   drawer or disk) will be compressed or decompressed in accordance with the
  156.   set flags.  Note that the Overwrite flag will be set automatically.
  157.   A window will be opened to keep you informed of progress.
  158.  
  159.     When the Compicon is no longer required double-click it to reopen the main
  160.   window.
  161.  
  162.  
  163.    GENERAL 
  164.  
  165.     The space available on a disk or hard-disk partition is checked when
  166.   necessary, and if it appears insufficient you will be asked for instructions.
  167.   For very small files it may be worth continuing (click OK), otherwise click
  168.   QUIT.
  169.  
  170.     Before decompressing compressed files a checksum (CRC) is read and checked
  171.   - if an error is found an appropriate warning will be given and the
  172.   offending file passed over.
  173.  
  174.     If a file is found to be compressed by PowerPacker (other than self-
  175.   executing program files) it will automatically be decompressed before the
  176.   called-for operation - compression, decompression, or just copying - is
  177.   carried out.
  178.  
  179.  
  180.            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  181.  
  182.     P-Compress is Freeware.  It may be copied and distributed freely and used
  183.   without charge for non_commercial purposes.  Authority for commercial use
  184.   should be obtained from the author below.
  185.  
  186.     No responsibility can be accepted for any loss occasioned by use of these
  187.   programmes.
  188.  
  189.     Comments, suggestions, bug-reports all welcome.
  190.  
  191.    Chas A. Wyndham,
  192.    1265 Canning Mills Road,
  193.    Roleystone,
  194.    WA 6111.
  195.    Australia 
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.