home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / compress / p-fixlib.lha / P-FixLib.doc < prev    next >
Encoding:
Text File  |  1992-04-27  |  4.4 KB  |  101 lines
  1.  
  2.  
  3.  
  4.                            P - F I X L I B. V1.2 
  5.  
  6.  
  7.     P-FixLib is a programme that patches various library functions to allow
  8.    WorkBench to treat files compressed with P-Compress as normal files.  It 
  9.    works with executables, libraries, icons, handlers, texts, fonts - anything.
  10.  
  11.     Installation 
  12.  
  13.      No special libraries or handlers are needed. (but Arp Library is useful).
  14.      In Workbench double-click the icon.  
  15.      From a CLI call "P-Fixlib".
  16.      P-FixLib and its icon should not be compressed.
  17.      IconX (and probably XIcon) script files should not be compressed.
  18.     
  19.      Start-up
  20.  
  21.        System 2.0 - Drag the icon into the WBStartup drawer.
  22.  
  23.        System 1.3 - call P-FixLib in the start-up sequence and delete any call 
  24.      to close the cli.  No need to RUN or RUNBACK.  The MountList (in :Devs)
  25.      and any commands or executables called during startup must not be
  26.      compressed.  (not all calls are detailed in the startup-sequence and some
  27.      experiments may be needed before everything opens properly).
  28.  
  29.     Removal: 
  30.      In Workbench  double-click the icon again.
  31.      From a CLI call "P-FixLib" again.
  32.  
  33.      Operation: 
  34.      
  35.      System2.0:  Compressed programmes/files etc can be called either from
  36.     Workbench or CLI, and will work as though they had not been compressed. 
  37.     Uncompressed programes will of course also work normally.
  38.  
  39.      System 1.3:  Compressed executables may be called from WorkBench only.
  40.     The 1.3 Shell does not use DOS library when loading executables and as  
  41.     with all programmes of this type CLI-only executables should be left
  42.     uncrunched (including the WorkBench 'C' directory).  Libraries, fonts,
  43.     icons can be compressed, and will operate normally.
  44.      
  45.      While P-Fixlib is in operation any calls through the DOS library to
  46.     Examine a file for fib_size will return the decompressed length, not the
  47.     original compressed length .  Since any attempt to Open or use the
  48.     file will access its decompressed image it is the uncompressed length that
  49.     will be needed.  Saving a previously compressed file (eg from a Text
  50.     Editor after changes have been made) will save in uncompressed form - make
  51.     sure that there is room for it.
  52.  
  53.      P-Compress should not be used to compress files while P-FixLib is running
  54.     since there is no way in which it can tell whether a file is already
  55.     compressed or not.
  56.  
  57.      Files should have been compressed using P-Compress.  No special settings
  58.     are needed and all types of file including icons, libraries, fonts, can be 
  59.     handled.  P-Compress Packs are excluded unless first unpacked.  A complete 
  60.     disk can be compressed for use with P-FixLib with just a single application
  61.     of P-Compress. (first make sure that there is free space on the disk for
  62.     the first files to use as working space). 
  63.  
  64.      Technical 
  65.  
  66.      The programme uses the now familiar technique of altering vectors in DOS
  67.     library so that calls to Open or LoadSeg are diverted to a de-compression
  68.     routine before being returned to DOS control.  The patched functions are
  69.     Open, Close, LoadSeg, UnLoadSeg, Write, and Examine.  P-Fixlib is unlikely
  70.     to be compatible with any other function that similarly patches DOS
  71.     library.  P-Fixlib should be terminated before any such programme is used,
  72.     and the other programme should be removed before P-FixLib is re-installed.
  73.  
  74.      One bug (or is it just an undesirable feature?) is that occasionally,
  75.     after making changes to a compressed drawer or disk, icons will refuse to
  76.     appear.  Should this occur install FixLib and then look for and delete the
  77.     :.info or /.info file that will be found in the disk or drawer.  The
  78.     mechanism of the problem is as obscure as the exact function of this file,
  79.     but it is assumed that the detail within it gets out of kilter with the
  80.     actual content of the drawer.  A new .info file is subsequently produced
  81.     by DOS which is OK.
  82.      
  83.     P-FixLib is Freeware.  It may be copied and distributed freely and used
  84.    without charge for non_commercial purposes.  Authority for commercial use
  85.    should be obtained from the author below.
  86.  
  87.     No responsibility can be accepted for any loss occasioned by use of these
  88.    programmes.
  89.  
  90.      Comments, suggestions, bug-reports all welcome.
  91.  
  92.    Chas A. Wyndham,
  93.    1265 Canning Mills Road,   Roleystone,
  94.    WA 6111.
  95.    Australia 
  96.  
  97.  
  98.  
  99.  
  100.  
  101.