home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD2.bin / bbs / util / pplib-1.6.lha / PPlib / README < prev    next >
Text File  |  1993-12-21  |  10KB  |  214 lines
  1.  
  2.                       **********************************
  3.  
  4.                           powerpacker.library V36
  5.  
  6.                           Release 1.6
  7.  
  8.                           (c) 1991-1993 Nico François
  9.  
  10.                       **********************************
  11.  
  12.  
  13.     First of all read the DISTRIBUTION file for information on... er well...
  14. distribution :-)
  15.  
  16.     Several people suggested the development of a library to help programs
  17. decrunch files crunched with PowerPacker, and that is exactly what this is.
  18.     This library tries to make it very easy to support PowerPacked files. It
  19. is a standard Amiga shared, runtime library and is called exactly like all
  20. the other Amiga libraries. Using this library it will be a lot simpler to make
  21. your program 'PowerPacker compatible' than with the previously distributed
  22. decrunch source.
  23.  
  24.     To install powerpacker.library copy it to your LIBS: directory by hand,
  25. or run the installation script 'Install' (by using 'Execute' or by double-
  26. clicking its icon).
  27.  
  28.     You should also install reqtools.library in LIBS:.  It is needed for
  29. the requester functions in powerpacker.library.  The installation script
  30. will automatically install reqtools.library.
  31.  
  32.  
  33.     WARNING:  powerpacker.library patches the exec/FreeMem() vector!  This
  34.     ~~~~~~~~  had to be done for backwards compatibility.  Some virus
  35.               checkers look at this vector and issue a warning!
  36.  
  37.  
  38.     Using powerpacker.library
  39.     -------------------------
  40.  
  41.     If you are a C programmer all you need to do is include the correct
  42. headers and open powerpacker.library. After that you can use the functions in
  43. the library as if they were C functions. If your program quits it must of
  44. course close the library again. See 'example.c' for a very simple example.
  45.  
  46.     If you are using SAS/C 5.10 and you don't want to use pragmas, or if
  47. you are using version 4.0 or lower, you must link with LIB:pp.lib (small code)
  48. or LIB:ppnb.lib (large code).  You'll find the .lib files in the Glue/SAS-C
  49. directory.
  50.  
  51.     From version 1.3c onwards Dice C is also supported.  You can find two
  52. libraries to link with in the Glue/Dice directory. Link with powerpackers.lib
  53. (stack args) or powerpackersr.lib (registerized args), both small data model.
  54.  
  55.     PPLib 1.4 now also includes libraries for the Manx C compiler.  You can
  56. find them in the Glue/Manx-C directory.
  57.  
  58.     Assembly programmers should also include the correct files and open
  59. powerpacker.library. To call a function they must load A6 with the library
  60. base, put the arguments in the appropriate registers and jump to the library
  61. vector offset of the function they want to call. See 'example.asm' for a very
  62. simple example.
  63.  
  64.     All library functions are explained in the file 'pplib.doc'.
  65.  
  66.                                                        Enjoy.
  67.  
  68.  
  69.                                LIBRARY HISTORY:
  70.  
  71. *****************************************************************************
  72. RELEASE 1.0 (Library Version 33.1)
  73.  
  74.     First release.
  75.  
  76. *****************************************************************************
  77. RELEASE 1.1 (Library Version 34.1)
  78.  
  79.     Added 'ppOverlayDecrHdr' for use of library from overlay decrunch header.
  80.     Requesters now have depth and close gadgets.
  81.     Faster decrunching in 'pp...DecrHdr' code.
  82.  
  83. *****************************************************************************
  84. RELEASE 1.1a (Library Version 34.2)
  85.  
  86.     Bug fixed: A6 was not preserved in ppLoadData!
  87.     Oberon interface to the library included.
  88.  
  89. *****************************************************************************
  90. RELEASE 1.2 (Library Version 35.254)
  91.  
  92.     PowerPacker 4.0's library decrunch header needs this version to work.
  93.       Some things have changed to crunch files even better :-)
  94.     After relocation of loaded executable the instruction and data caches
  95.       are cleared.  This should insure compatibility with the 68040.
  96.       Note that this only applies to Amigas running Kickstart 2.0 (V37).
  97.     Crunching code added to library (4 new functions):
  98.       ppAllocCrunchInfo, ppFreeCrunchInfo, ppCrunchBuffer, ppWriteDataHeader.
  99.     One new requester function: ppEnterPassword.
  100.     The requester functions ppGetString and ppGetLong are now declared
  101.       obsolete!  They can now be found (much improved) in 'reqtools.library'.
  102.     'reqtools.library' _MUST_ be installed in your system for the the old
  103.       (obsolete) requester functions to work!  ppGetPassword and
  104.       ppEnterPassword also call functions in 'reqtools.library'.
  105.     ppErrorMessage function added to get default error messages.
  106.     Support for crunched LoadSeg files added for use with PPLoadSeg 1.1.
  107.     Stricter check for unknown data headers.
  108.  
  109. *****************************************************************************
  110. RELEASE 1.3 (Library Version 35.255)
  111.  
  112.     Fixed serious bug: PPLoadSeg files were incorrectly decrunched!
  113.     Now distributed with release 1.0a of reqtools.library.
  114.     Improved installation script.
  115.  
  116. *****************************************************************************
  117. RELEASE 1.3a (Library Version 35.256)
  118.  
  119.     Fixed serious bug: in low memory situations ppAllocCrunchInfo crashed!!
  120.     Small changes and enhancements to autodocs.
  121.  
  122. *****************************************************************************
  123. RELEASE 1.3b (Library Version 35.256)
  124.  
  125.     Updated Oberon interface by Kai Bolay included.
  126.     Release 1.0b of reqtools.library included.
  127.  
  128. *****************************************************************************
  129. RELEASE 1.3c (Library Version 35.256)
  130.  
  131.     Libraries (powerpackers.lib and powerpackersr.lib) for Dice C included.
  132.     Release 1.0c of reqtools.library included.
  133.  
  134. *****************************************************************************
  135. RELEASE 1.4 (Library Version 35.274)
  136.  
  137.     Command files using PowerPacker 3.0b's or 4.0a's library header will
  138.       decrunch faster.
  139.     Decrunching code optimized.  About 20% faster.
  140.     LoadPPLib will no longer return an error code when run on Kickstart 2.0
  141.       or higher.  It just won't load powerpacker.library and reqtools.library
  142.       in memory.  It can now safely be used in startup-sequences of disks for
  143.       both Kickstart 1.2/1.3 and 2.0.
  144.     Edited autodoc for ppDecrunchBuffer() a bit.  Hope this helps Michael
  145.       Berg :-)  (Michael, if you are reading this, your optimized decrunch
  146.       code in PowerPackerPatcher 1.4b turned out to be just as fast as the
  147.       original code.  A 'lsr.l d1,d0' takes just as many clock cycles as a
  148.       'lsr.l #1,d0'!  I suppose you compared your "optimized" decruncher to
  149.       an old PowerPacker decruncher since I optimized the decruncher by 15 to
  150.       20% when I released version 3.0a.  I suggest you use ppDecrunchBuffer()
  151.       for your next release of PowerPackerPatcher since it is now faster.)
  152.     No longer uses partial FreeMem()s as it seems these are illegal.
  153.     Latest revision of Oberon interface included.
  154.     Aztec C interface to the library included.
  155.     Release 1.0d of reqtools.library included.
  156.  
  157. *****************************************************************************
  158. RELEASE 1.5 (Library Version 35.344)
  159.  
  160.     DECRUNCHING SPEED GREATLY IMPROVED!  Thanks to Alain Penders for his
  161.       great ideas to speed up decrunching.  Decrunching is almost twice as
  162.       fast.  Together with the 20% speedup achieved in release 1.4 of
  163.       powerpacker.library this means decrunching is double the speed it was
  164.       originally (version 1.3 and before)!  For the Imploder fans out there,
  165.       PowerPacker decrunches faster than Imploder now.
  166.       Also note that it is now MUCH better to use the Library Header feature
  167.       of PowerPacker 4.0a as the resulting executable will decrunch twice as
  168.       fast!
  169.     Bug fixed:  buffer overflow wasn't always detected correctly.  This could
  170.       result in files crunching incorrectly.  Luckily the chances of this
  171.       happening were very small, but it is fixed now anyway.
  172.     Small changes to autodoc regarding generating encrypted files.
  173.     Bug fixed in Dice library, ppCalcChecksum() was not included.
  174.  
  175. *****************************************************************************
  176. RELEASE 1.5a (Library Version 35.347)
  177.  
  178.     Anoth