home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d569 / pploadseg.lha / PPLoadSeg / PPLoadSeg.doc < prev    next >
Text File  |  1991-11-21  |  7KB  |  166 lines
  1.  
  2.  
  3.                           PPLoadSeg 1.1 User Manual
  4.  
  5.                                  Oct 30, 1991
  6.  
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.    The programs and files in this distribution are freely distributable, but
  13. are also copyright (c) Nico François.  They may be freely distributed as long
  14. as no more than a nominal fee is charged to cover time and copying costs.
  15.    No commercial usage is permitted without written permission from the
  16. author.  Everything in this distribution must be kept together, in original
  17. unmodified form.
  18.    The above is generally known as freeware.
  19.  
  20.    If you have suggestions or remarks about this program, or if you find
  21. any bugs, please let me know.
  22.  
  23.    Write to the following address:
  24.  
  25.                                 Nico François
  26.                                 Corbielaan 13
  27.                                 B-3060 Bertem
  28.                                 BELGIUM
  29.  
  30.  
  31. Contents
  32. ========
  33.  
  34. 1. An introduction
  35.  
  36. 2. Usage
  37.  
  38.  
  39. 1. An introduction
  40. ==================
  41.  
  42.      Yet another PowerPacker support utility.  If you don not know what
  43. PowerPacker is I suggest you check out the shareware version on Fish disk #253
  44. or buy the (much improved) commercial version from UGA, JumpDisk or your local
  45. dealer.
  46.  
  47.      This program will add a little magic to your Amiga.  It allows you to
  48. crunch libraries, devices, printer drivers, fonts, etc. with PowerPacker while
  49. they will still remain 100% functional.  It also allows you to crunch programs
  50. as data files (so without a decrunch header) while you will still be able to
  51. run them.  Black magic ?  No.  Patch magic :-)
  52.  
  53.      The idea is not new.  The Imploder has provided the facility for a while,
  54. as lots of people pointed out to me.  It was therefore (naturally) a much
  55. heard suggestion for "the next version of" PowerPacker.  Well, here it is,
  56. _without_ a new version of PowerPacker!
  57.  
  58.      It is advised you copy PPLoadSeg to C: and install it as the first
  59. command in your startup-sequence.  PPLoadSeg requires powerpacker.library so
  60. install this in Libs: if you haven't done so already.
  61.      An installation icon has been provided to do the things mentioned
  62. above automatically, just double-click it.
  63.  
  64.      Once installed PPLoadSeg takes up no more than about 500 bytes of your
  65. precious memory.  I doubt that this will cause much memory problems :-)
  66.  
  67.      PPLoadSeg is compatible with and supports Kickstart & Workbench 2.0.
  68.  
  69.  
  70. 2. Usage 
  71. ========
  72.  
  73.      Usage is a doddle.  You have to do absolutely nothing!  You may crunch
  74. libraries, devices, printer drivers, fonts and they will be loaded like
  75. nothing happened (except that you will have gained a lot of space on your
  76. disks).  The only thing you have to do is crunch them as command files, but
  77. save then as *DATA* files!  Do not append '.pp' to the file name, so overwrite
  78. the original file with the crunched one.
  79.  
  80.      If you have PowerPacker version 4.0a or higher you can crunch files using
  81. the 'LoadSeg File' mode.  This will crunch the files even better.  Note that
  82. you must also install powerpacker.library version 35 or higher for PPLoadSeg
  83. to recognize these crunched LoadSeg files.  Since PowerPacker 4.0a uses this
  84. version of the library as well this will probably be ok.
  85.  
  86.      PPLoadSeg patches LoadSeg (as you might have guessed).  LoadSeg is a
  87. function in dos.library that is used to load most system things, like
  88. libraries and devices.  PPLoadSeg replaces LoadSeg with a function that
  89. knows about PowerPacked files.  This new improved LoadSeg will recognize and
  90. decrunch crunched files and hand them over to DOS like they were loaded
  91. normally and nothing extraordinary happened.
  92.  
  93.      The Workbench loads programs using LoadSeg, so it is possible to save
  94. programs that will be loaded from Workbench as data files (no decrunch
  95. header!).  A lot of shells (like the AmigaDOS 2.0 shell) will also load
  96. commands using LoadSeg, so here you can save crunched commands as data (or
  97. as crunched LoadSeg files) as well.  Sadly the standard AmigaDOS 1.3 shell
  98. does NOT use LoadSeg.
  99.  
  100.      It won't hurt to experiment!  If you try to crunch something and it turns
  101. out it isn't loaded using LoadSeg the program loading the crunched file will
  102. simply complain (if it is written correctly!) and no harm will be done.  Just
  103. decrunch the file and everyhting will be ok again.
  104.  
  105. NOTE: - PPLoadSeg is intelligent about the way it patches LoadSeg.  If you
  106.         run other programs that patch LoadSeg it is possible they will crash
  107.         if they are run after PPLoadSeg.  Note that this is not PPLoadSeg's
  108.         fault!  PPLoadSeg should therefore be run AFTER these commands by
  109.         putting these commands BEFORE PPLoadSeg in your startup-sequence.
  110.         Utilities that might patch LoadSeg are e.g. linkvirus detectors.
  111.       - PPLoadSeg has been succesfully tested with: libraries, devices,
  112.         printer drivers, keymaps, fonts, and _some_ handlers.
  113.       - As said above it is suggested that you crunch as a command file and
  114.         save as a data file.  It is possible to crunch AND save as data, but
  115.         there is a small risk in that case.  PowerPacker does not support all
  116.         hunks (e.g. debug hunks) and by crunching as a command file you make
  117.         sure PowerPacker will be able to handle all hunks in the file.
  118.         The next version of PowerPacker will have a special setting for
  119.         crunching libraries and devices.
  120.         If you have PowerPacker 4.0a simply crunch using the 'LoadSeg File'
  121.         mode and ignore the above.
  122.       - On Kickstart 2.0 PPLoadSeg will also patch NewLoadSeg.
  123.       - Don't try to crunch 'powerpacker.library'!  Figure out for yourself
  124.         why not :-)
  125.  
  126.  
  127.                            As always, I hope you find this program useful!
  128.  
  129.  
  130.                               PROGRAM HISTORY:
  131.  
  132. *****************************************************************************
  133. VERSION 1.0
  134.  
  135.      First release.
  136.  
  137. *****************************************************************************
  138. VERSION 1.1
  139.  
  140.      Added embedded version string for use with 2.0 Version command.
  141.      Processor cache is cleared after relocation for 68040 compatibility.
  142.        (Only on Kickstart 2.0 V37!).
  143.      In conjunction with V35 powerpacker.library supports LoadSeg files
  144.        crunched with PowerPacker Professional 4.0a.  These files are up to
  145.        10% shorter than files crunched as data files.
  146.  
  147.      Release 30-10-91
  148.      ~~~~~~~~~~~~~~~~
  149.      Distributed with powerpacker.library 35.255.
  150.  
  151. *****************************************************************************
  152.  
  153. PPLoadSeg 1.1 written by Nico François (Yes, Nico is my first name :-)
  154.  
  155.  
  156. "As breathing flows
  157.  my mind secedes
  158.  I bleed"           - The Pixies
  159.  
  160.  
  161. (c) 1991 Nico François
  162.  
  163.                                    //
  164.                        Thanks to \X/ Amiga for being the best computer ever !
  165.  
  166.