home *** CD-ROM | disk | FTP | other *** search
/ Graphics 16,000 / graphics-16000.iso / archivrs / amiga / pplib.lzh / PPLib / README < prev    next >
Text File  |  1991-11-10  |  5KB  |  123 lines
  1.  
  2.                       **********************************
  3.  
  4.                          powerpacker.library  V35.256
  5.  
  6.                          Release 1.3a
  7.  
  8.                          (c) 1991 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.     Using powerpacker.library
  34.     -------------------------
  35.  
  36.     If you are a C programmer all you need to do is include the correct
  37. headers and open powerpacker.library. After that you can use the functions in
  38. the library as if they were C functions. If your program quits it must of
  39. course close the library again. See 'example.c' for a very simple example.
  40.     If you are using SAS/C 5.10 and you don't want to use pragmas, or if
  41. you are using version 4.0 or lower, you must link with LIB:pp.lib (small code)
  42. or LIB:ppnb.lib (large code).
  43.     Programmers that use Manx C can use 'Bind' to generate the glue routines
  44. they need (or if they are using 5.0 they can of course use pragmas for in-line
  45. library calls).
  46.  
  47.     Assembly programmers should also include the correct files and open
  48. powerpacker.library. To call a function they must load A6 with the library
  49. base, put the arguments in the appropriate registers and jump to the library
  50. vector offset of the function they want to call. See 'example.asm' for a very
  51. simple example.
  52.  
  53.     All library functions are explained in the file 'pplib.doc'.
  54.  
  55.                                                        Enjoy.
  56.  
  57.  
  58.                                LIBRARY HISTORY:
  59.  
  60. *****************************************************************************
  61. RELEASE 1.0 (Library Version 33.1)
  62.  
  63.     First release.
  64.  
  65. *****************************************************************************
  66. RELEASE 1.1 (Library Version 34.1)
  67.  
  68.     Added 'ppOverlayDecrHdr' for use of library from overlay decrunch header.
  69.     Requesters now have depth and close gadgets.
  70.     Faster decrunching in 'pp...DecrHdr' code.
  71.  
  72. *****************************************************************************
  73. RELEASE 1.1a (Library Version 34.2)
  74.  
  75.     Bug fixed: A6 was not preserved in ppLoadData!
  76.     Oberon interface to the library included.
  77.  
  78. *****************************************************************************
  79. RELEASE 1.2 (Library Version 35.254)
  80.  
  81.     PowerPacker 4.0's library decrunch header needs this version to work.
  82.       Some things have changed to crunch files even better :-)
  83.     After relocation of loaded executable the instruction and data caches
  84.       are cleared.  This should insure compatibility with the 68040.
  85.       Note that this only applies to Amigas running Kickstart 2.0 (V37).
  86.     Crunching code added to library (4 new functions):
  87.       ppAllocCrunchInfo, ppFreeCrunchInfo, ppCrunchBuffer, ppWriteDataHeader.
  88.     One new requester function: ppEnterPassword.
  89.     The requester functions ppGetString and ppGetLong are now declared
  90.       obsolete!  They can now be found (much improved) in 'reqtools.library'.
  91.     'reqtools.library' _MUST_ be installed in your system for the the old
  92.       (obsolete) requester functions to work!  ppGetPassword and
  93.       ppEnterPassword also call functions in 'reqtools.library'.
  94.     ppErrorMessage function added to get default error messages.
  95.     Support for crunched LoadSeg files added for use with PPLoadSeg 1.1.
  96.     Stricter check for unknown data headers.
  97.  
  98. *****************************************************************************
  99. RELEASE 1.3 (Library Version 35.255)
  100.  
  101.     Fixed serious bug: PPLoadSeg files were incorrectly decrunched!
  102.     Now distributed with release 1.0a of reqtools.library.
  103.     Improved installation script.
  104.  
  105. *****************************************************************************
  106. RELEASE 1.3a (Library Version 35.256)
  107.  
  108.     Fixed serious bug: in low memory situations ppAllocCrunchInfo crashed!!
  109.     Small changes and enhancements to autodocs.
  110.  
  111. *****************************************************************************
  112.  
  113. powerpacker.library written by Nico Franτois (Yes, Nico is my first name :-)
  114.                     thanks to Moroder Andreas for the useful suggestions.
  115.                               Kai Bolay for writing the Oberon interface.
  116.  
  117.  
  118. (c) 1991 Nico Franτois / PowerPeak
  119.  
  120.                                    //
  121.                        Thanks to \X/ Amiga for being the best computer ever !
  122.  
  123.