home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / dirs / pplib_371.lzh / PPLib / README < prev    next >
Text File  |  1990-10-08  |  3KB  |  80 lines
  1.  
  2.                       **********************************
  3.  
  4.                           powerpacker.library  V34.1
  5.  
  6.                           Release 1.1
  7.  
  8.                           (c) Jul 1990 Nico François
  9.  
  10.                       **********************************
  11.  
  12.  
  13.     First of all read the DISTRIBUTION file for information on... euh 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.  
  29.     Using powerpacker.library
  30.     -------------------------
  31.  
  32.     If you are a C programmer all you need to do is include the correct
  33. headers and open powerpacker.library. After that you can use the functions in
  34. the library as if they were C functions. If your program quits it must of
  35. course close the library again. See 'example.c' for a very simple example.
  36.     If you are using Lattice C 5.0 and you don't want to use pragmas, or if
  37. you are using version 4.0 or lower, you must define NO_PRAGMAS before
  38. including 'proto/powerpacker.h' and link with ppSCglue.o (small code) or
  39. ppLCglue.o (large code).
  40.     Programmers that use Manx C can use 'Bind' to generate the glue routines
  41. they need (or if they are using 5.0 they can of course use pragmas for in-line
  42. library calls).
  43.  
  44.     Assembly programmers should also include the correct files and open
  45. powerpacker.library. To call a function they must load A6 with the library
  46. base, put the arguments in the appropriate registers and jump to the library
  47. vector offset of the function they want to call. See 'example.asm' for a very
  48. simple example.
  49.  
  50.     All library functions are explained in the file 'pplib.doc'.
  51.  
  52.                                                        Enjoy.
  53.  
  54.  
  55.                                LIBRARY HISTORY:
  56.  
  57. *****************************************************************************
  58. RELEASE 1.0 (Library Version 33.1)
  59.  
  60.     First release.
  61.  
  62. *****************************************************************************
  63. RELEASE 1.1 (Library Version 34.1)
  64.  
  65.     Added 'ppOverlayDecrHdr' for use of library from overlay decrunch header.
  66.     Requesters now have depth and close gadgets.
  67.     Faster decrunching in 'pp...DecrHdr' code.
  68.  
  69. *****************************************************************************
  70.  
  71. powerpacker.library written by Nico François (Yes, Nico is my first name :-)
  72.                     thanks to Moroder Andreas for the useful suggestions.
  73.  
  74.  
  75. (c) 1990 Nico François / PowerPeak
  76.  
  77.                                    //
  78.                        Thanks to \X/ Amiga for being the best computer ever !
  79.  
  80.