home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 6 / AACD06.ISO / AACD / System / SnoopDos / Readme.source < prev    next >
Text File  |  2000-01-12  |  4KB  |  94 lines
  1.  
  2.                         SnoopDos 3.0 -- Source Code Release
  3.  
  4.            Copyright © Eddy Carroll, September 1994. Freely distributable.
  5.  
  6.            Updated by Luca Longone and Massimo Tantignone in January 2000.
  7.  
  8.  
  9. NOTE ABOUT THE 3.1 UPDATE
  10.  
  11.     This update removes an Enforcer hit which can happen with version 3.0
  12.     when a program is launched from ToolManager's dock and SnoopDos is
  13.     running with its "SendRexx" patch turned on. Said hit doesn't seem to
  14.     cause any harm, however it can be an annoyance for people which have
  15.     Enforcer running all the time.
  16.     The hit is apparently due to the way ToolManager sets up its message
  17.     port and only happens when SnoopDos 3.0 is running. Since we can't fix
  18.     ToolManager right now, we made SnoopDos able to avoid the hit, by adding
  19.     a safety check on the memory type at line 4466 in the "patches.c" module.
  20.  
  21.     The following files have been updated for this release:
  22.  
  23.     snooptext.h           snooptext.ct           snooptext.cd
  24.     SnoopDos.Roadmap      snoopdos.c             patches.c
  25.  
  26.     All files other than "patches.c" have been changed just to update the
  27.     version information; no changes were made to the actual code.
  28.  
  29.     You can find the archive with the executable compiled from this source
  30.     code on Aminet (util/moni/snoopdos31.lha).
  31.  
  32.     Note: references to PGP in the documentation aren't valid anymore for
  33.     SnoopDos versions greater than 3.0. If you need authentication, please
  34.     write to one of the following e-mail addresses:
  35.  
  36.     llong@tin.it, hexaae@tiscalinet.it (Luca Longone)
  37.     tanti@intercom.it (Massimo Tantignone)
  38.     ecarroll@iol.ie (Eddy Carroll)
  39.  
  40.     The rest of this file is unchanged from the original Readme.source file
  41.     as found in the SnoopDos 3.0 source code distribution.
  42.  
  43.  
  44. INTRODUCTION
  45.  
  46.     SnoopDos patches a variety of AmigaDOS library functions that
  47.     are commonly called by other programs and allows you to monitor
  48.     the activities carried out by those programs.
  49.  
  50.     The source code allows you to examine how SnoopDos operates. You
  51.     may find it useful as example code if you are interested in any
  52.     of the following:
  53.  
  54.       - patching system library functions
  55.       - creating font-sensitive gadtools or BOOPSI GUI interfaces
  56.         without the help of a third party GUI library
  57.       - accessing AmigaGuide help
  58.       - copying text to the clipboard
  59.       - allowing localisation of all program text strings
  60.       - supporting drag & drop operations
  61.       - seeing how a medium sized Amiga application is constructed
  62.  
  63.     I don't claim that this code is perfect but it does have the advantage
  64.     of actually working, so it's a useful starting point.
  65.  
  66.     You will probably also want to obtain the companion binary archive
  67.     snoopdos30.lha, available in the /pub/aminet/util/moni directory on
  68.     AmiNet. This contains the SnoopDos executable, and also an extensive
  69.     AmigaGuide help file which should prove useful while browsing the
  70.     source code.
  71.  
  72.     See the file SnoopDos.Roadmap inside the source directory for information
  73.     about how the source code is organised.
  74.  
  75.  
  76. DISTRIBUTION CONDITIONS
  77.  
  78.     You may freely use portions of the SnoopDos source code in your
  79.     own programs if you wish. However, if you use two or more complete
  80.     functions from the SnoopDos code, you must acknowledge the origin
  81.     of those functions in your documentation and source code.
  82.  
  83.     You may modify the SnoopDos source code to create new versions of
  84.     SnoopDos for your own use only. You may not redistribute such new
  85.     versions without my explicit permission.
  86.  
  87.  
  88. AUTHOR
  89.  
  90.     You can contact the author at:
  91.  
  92.         ecarroll@maths.tcd.ie
  93.         ecarroll@cix.compulink.co.uk
  94.