home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 2: Collection B / 17Bit_Collection_B.iso / files / 2010.dms / in.adf / P-Compress / P-Compress.doc < prev    next >
Encoding:
Text File  |  1999-12-26  |  15.0 KB  |  305 lines

  1. PRE1
  2.  
  3.                            P - C O M P R E S S V2.3 
  4.     INTRODUCTION 
  5.  
  6.      P-Compress is a compression/de-compression tool designed to meet the great
  7.   majority of the requirements of users efficiently and economically while
  8.   being very easy to use.  It will compress single files, drawers or complete
  9.   disks, preserving disk and drawer structures.  Individual files can be joined
  10.   into a single PACK, similar to an archive and by using PACKs two uncompressed
  11.   disks will normally fit on one.  Drawers and disks can be copied from one
  12.   place to another, selected files or classes of files being compressed and the
  13.   remainder just copied.  P-Compressed files, including sounds, pictures and 
  14.   animations, can be displayed by P-Reader without prior decompression, and P-
  15.   Compressed texts can be loaded into and saved from P-Writer.  The latest
  16.   version of P-Reader is being used to display this file.
  17.  
  18.     Two important areas not covered at present are:
  19.       Hard-disk back-up. Use a specialised programme (eg BRU).
  20.       Self-extracting executables.  Use Imploder from Fish 422.
  21.  
  22.     One of the main uses of P-Compress may be to reduce the size of your own
  23.   personal library collection of utilities, data, games, code examples, stored
  24.   away for occasional reference.  By just compressing all data, leaving icons
  25.   and executables untouched, and using P-Reader as the basic text reader and
  26.   display tool, my own "library" of 35 disks reduced to 25.  Caution is needed
  27.   when doing this as data files used by the executables must be left unchanged.
  28.   Alternatively if the P-Suite utility P-Fixlib is to be used (which allows DOS
  29.   to treat compressed files as though they were uncompressed) the whole disk
  30.   can be compressed, doubling its capacity. 
  31.  
  32.      P-Compress employs the latest LZH compression technique using code by
  33.   Barthel and Krekel, modified to limit memory requirements. 
  34.  
  35.      This release also includes the small utility P-Unpack, whose sole purpose
  36.   in life is to unpack Packs.  Details are on Page 11.
  37.  
  38.  
  39.    COMPARISON WITH ALTERNATIVE PROGRAMMES 
  40.  
  41.     Whole disk compression tools:  eg LHWARP, Zoom.
  42.  
  43.      When used to PACK a complete disk P-Compress only compresses the files on
  44.   the disk and not such additional data as boot-blocks.  As a result output
  45.   will be smaller than that of true whole-disk tools. P-Unpack can write a
  46.   standard boot-block to the re-constituted disk.  Speed is comparable but
  47.   memory usage much lower.   If you really need to include everything on the
  48.   disk, Zoom is recommended.
  49.  
  50.     Archivers:  eg  LHArc, PKAZip.
  51.  
  52.     To suit their role in the maintenance of archives these include a host of
  53.   facilities which are of little or no use to most of us.  As a result they are
  54.   not easy to use. One effect of the complexity is that with some combinations
  55.   of commands and switches files can be lost. (Tip: always use the extended
  56.   filenames switch)  As far as performance goes P-Compress sacrifices about
  57.   0.1% in efficiency for the sake of decompression speed and low memory
  58.   requirement for large files.  It is faster and uses less memory than LHArcA
  59.   and much faster than LHArc.  PKAZip is very fast, efficiency usually poorer,
  60.   memory useage greatly excessive.  Large archived collections of files cannot
  61.   be handled by single-drive Amigas without expansion memory (unless a vast
  62.   number of disk-swops are acceptable),  PACKS can.
  63.  
  64.      General compression tools: eg Power Packer
  65.  
  66.     An excellent programme in its day the current PD version of PowerPacker is
  67.   completely outclassed by the new wave of LZH compression tools - although
  68.   decompression is fast.  As far as ease of use is concerned users should form
  69.   their own judgement.  PowerPacker has the ability to create self- extracting
  70.   executables which P-Compress does not do at present, however Imploder handles
  71.   this particular job better and more quickly.
  72.  
  73.    Some comparative performance figures are given at the end of these
  74.   instructions.
  75.  
  76.  
  77.    INSTRUCTIONS 
  78.    
  79.    P-Compress opens a window on Workbench showing:
  80.  
  81.     On the left   Progress window.
  82.     Top right     Decompress window.
  83.     Centre right  Compress window.
  84.     Bottom right  Execute window.
  85.  
  86.    Color selection gadget can be found at the top of the lower right P-Compress
  87.   logo.  Click it to cycle the available color palettes.
  88.  
  89.    If you have the Arp library installed the programme will use the Arp File-
  90.   Requester, otherwise a simple string gadget requester will appear.  If you 
  91.   are using the latter to call a drawer the entry must end with a slash /.
  92.  
  93.   P-Compress can be started from the cli or by double-clicking its icon.
  94.  
  95.     DECOMPRESSION 
  96.  
  97.   Click From.    File requester will come
  98.   up over the progress window. 
  99.   Enter or select the drawer, or
  100.   file to be de-compressed.  Click OK
  101.   (or cancel).  Selected reference
  102.   will be shown in the From box.
  103.    #! 1 42 5 0 decompress.brush
  104.     Click To.   File requester will
  105.   re-appear.  Enter/select a disk, file
  106.   or drawer as required. If an existing file other than a PACK is selected
  107.   but a drawer or disk was entered at From, a warning will appear.  Otherwise
  108.   new files will be opened as necessary. A PACK can only be decompressed to a 
  109.   disk or drawer -  a file entered at To will be ignored and the programme 
  110.   will look at its path to decide where to place the unpacked output.
  111.   Compressed files will be decompressed to the indicated location, uncompressed
  112.   files will be just copied.  Name and size of the file being handled appears 
  113.   in the progress window.  On completion a summary will appear at the bottom of
  114.   the Decompress window (except where only a single file has been called).
  115.    
  116.     The programme will recognise whether the input is a normal file or a PACK,
  117.   and will act accordingly.  PACK in the execute window need not be switched 
  118.   on.
  119.  
  120.     You can decompress back over the original - with the same reference entered
  121.   at From and To.  Sufficient space must be available on the disk to take the
  122.   file currently being decompressed as well as the original (later deleted).
  123.   
  124.     If you run out of disk space before decompression is complete you will be
  125.   asked to insert a new disk.  On completion delete any empty drawers on the
  126.   disks and transfer icons where necessary.  Note that when checking for space
  127.   no account is taken of whether an existing file is being overwritten.  This
  128.   can mean that the request is made when not strictly needed.  Collect the 
  129.   extra file or files on another disk and copy back.
  130.   
  131.     Before decompressing compressed files a checksum (CRC) is read and checked
  132.   - if an error is found an appropriate warning will be given and the
  133.   offending file passed over.
  134.  
  135.     Before an existing file is overwritten you will be asked to OK it.
  136.   Clicking OVERWRITE in the execute window suspends this feature, which is
  137.   also  suspended when a PACKed file is being decompressed.  Click GO in the 
  138.   execute window to start decompression, CANCEL to cancel the process, and QUIT
  139.   to close down.
  140.  
  141.    COMPRESSION 
  142.  
  143.    Select From and To in turn as before
  144.   and enter or select the source and
  145.   destination references.  Either a disk,
  146.   drawer or individual file may be
  147.   selected. If a disk or drawer is to be
  148.   compressed click on one or more of
  149.   the boxes listed below to indicate the
  150.   types of file to be compressed, the
  151.   remainder will just be copied.  Copied
  152.   files are not provided with Checksums.
  153.   #! 1 42 4 0 compress.brush 
  154.      DATA  "Project" type data files such as texts, IFF pics, animations etc.
  155.      ICONS You may want to leave icons uncompressed.
  156.      EXEC  Libraries and all executables.
  157.      HEXEC Executables are stripped of any debug or symbol hunks. In normal
  158.                        operation these are not needed.
  159.  
  160.     If you need to select specific individual files to be compressed or just
  161.   copied use ASK - the programme will halt at each file and ask for
  162.   instructions.
  163.  
  164.     If HEXEC is selected the stripped file will be put into a temporary file
  165.   RAM:S.  If EXEC is also selected RAM:S will then be compressed to the final
  166.   destination, otherwise it will be just copied; the sizes of the original
  167.   file, RAM:S, and the final output will be shown.
  168.  
  169.     Normally when compressing a file or drawer each file is transferred to an
  170.   equivalent place at the output location, new drawers being opened as needed,
  171.   so that the original structure of drawers and their contents is preserved.
  172.   Alternately a PACK can be created in which all the files are joined into one
  173.   compendium file or PACK.  An individual checksum is provided for each of the
  174.   files contained.  The name PACK will be appended to any filename that may be
  175.   inserted at To.  On decompression the original structure is re-created.  
  176.   HEXEC is not functional when compressing to a pack.
  177.  
  178.    If you run out of disk space before compression is complete you will be
  179.   asked to insert a new disk (except where a PACK is being made - a file
  180.   cannot be split between two disks).  (But see the comment in the decompress
  181.   section.)
  182.  
  183.     Click OVERWRITEPACK as necessary, and then GO to start compression.
  184.  
  185.     Progress and final summary will be shown as before.
  186.  
  187.     EXECUTION 
  188.  
  189.    Click OVERWRITE if existing files are to be overwritten.
  190.    CLICK PACK if you wish to put all the individual files into a single PACK.
  191.    Click GO to start compression or decompression, CANCEL to cancel the
  192.   process and QUIT to close down.
  193.     #! 1 42 3 0 exec.brush
  194.     Note that you may enter the same reference in From and To, allowing the
  195.   direct replacement of a file by its compressed (or decompressed) image. An
  196.   intermediate temporary file in RAM is used, which of course means that memory
  197.   consumption is increased.  The original is not overwritten unless the
  198.   compression or decompression operation returns correctly, however for safety
  199.   's sake it is always better to have a backup.
  200.     
  201.  
  202.    COMPARISONS 
  203.  
  204.      Three files have been used:
  205.        File 1 is a HAM picture.  Length 92872 bytes.  
  206.        File 2 is an executable file.  Length 28792 bytes. 
  207.        File 3 was made up by joining a general mixture of texts, executables
  208.          and icons into a single large file.  Length 608440 bytes.
  209.       
  210.                                Size            Compress        Decompress  
  211.   File 1
  212.     LHArcA                    51812            1min.08secs     33secs   
  213.     PowerPacker (fastest)     64412            2min.37secs     17secs
  214.     PowerPacker (best)        54196            23mins.45secs   16secs
  215.     PKAZip                    53407            45secs          21secs
  216.     P-Compress                52136            49secs          21secs
  217.  
  218.   File 2
  219.     LHArcA                    15788            26secs          11secs
  220.     PowerPacker (good)        17122            2min.11         9secs
  221.     PKAZip                    15919            24secs          7secs
  222.     P-Compress                15816            17secs          8secs
  223.  
  224.   File 3
  225.     LHArcA and PKAZip failed - out of memory.
  226.     PowerPacker not tried - out of patience.
  227.     P-Compress                287372           6m.28           1m.48
  228.  
  229.   In all cases compression/decompression was from disk to RAM: using an Amiga
  230.   500 with 1M of memory.  
  231.  
  232.                          P - U N P A C K V1.2           
  233.  
  234.     When sending out a disk containing a PACK you will normally include on the
  235.   disk the means of decoding it.  This can of course be P-Compress itself, but
  236.   the considerably smaller P-Unpack may be used instead.  The end result is
  237.   the same but P-Unpack provides two further advantages:
  238.  
  239.      It provides the efficient disk-swopping facilities needed by single-disk
  240.     -drive Amigas with memory that is not sufficient for the whole pack to be
  241.     copied to and decompressed from ram.
  242.  
  243.      By writing the icon with the ToolType "boot" the decompressed output disk 
  244.     is made bootable.  (Not functional for the single-floppy-drive user).
  245.  
  246.     P-Unpack is called as the Default Tool of a Project icon for a PACK file.  
  247.   When the icon is clicked the PACK will be decompressed and the original
  248.   structure of files and drawers copied to a disk. 
  249.  
  250.   Preparation - Sender
  251.  
  252.     The Pack should be created in the normal way with P-Compress.  Prepare
  253.   a PROJECT Icon for the Pack, and write P-Unpack as the Default Tool. Include
  254.   a path (e.g :c/P-Unpack) if necessary.  If the output disk is to be made
  255.   bootable write the single word boot into the Tool Types space.  Include
  256.   P-Unpack on the disk along with the Pack or Packs.  It is a good idea to
  257.   name the pack "CLICK-ME" or incorporate "click-me" into the icon so that the
  258.   recipient knows what to do. The recipient should not need any other 
  259.   instructions.
  260.      
  261.   Use - Recipient 
  262.  
  263.    The recipient will boot the received disk normally and faced with an icon
  264.   that incorporates the instruction Click-me will double-click it.  P-Unpack
  265.   will check the number of floppy drives connected.
  266.  
  267.     If there is more than one floppy drive connected a requester will appear
  268.   asking the user to select one, insert an empty disk, and click go.  Once
  269.   decompression is under way an Abort gadget is added.  Clicking on this will
  270.   stop the programme on completion of the current file.  If the pack includes
  271.   a disk icon, this will be adopted and seen if the disk is removed and
  272.   re-inserted.  If the Tool Type boot was written into the icon the output disk
  273.   will be bootable.  If the expanded PACK is larger than a single disk, a
  274.   notice will call for a new disk when the first is full.
  275.  
  276.     Where P-Unpack finds only one floppy drive a different requester will
  277.   appear asking the user to insert the source disk and click go.  Decompression
  278.   to RAM will continue for as long as memory is available and the user will
  279.   then be asked to insert the output disk - ram will be copied to this.  Disk
  280.   swopping will continue until decompression is complete - four or five swops
  281.   may be needed.  No early warning will be given of a full disk, but a new
  282.   disk can be inserted at any of the disk-swops. The output disk can not be
  283.   made bootable, otherwise the  final result is the same.
  284.  
  285.  
  286.            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  287.  
  288.     P-Compress and P-Unpack are Freeware.  They may be copied and distributed
  289.   freely and used without charge for non_commercial purposes.  Authority for
  290.   commercial use should be obtained from the author below.
  291.  
  292.     No responsibility can be accepted for any loss occasioned by use of these
  293.   programmes.
  294.  
  295.     Comments, suggestions, bug-reports all welcome.
  296.    Chas A. Wyndham,
  297.    1265 Canning Mills Road,
  298.    Roleystone,
  299.    WA 6111.
  300.    Australia 
  301.  
  302.  
  303.  
  304.  
  305.