home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / develop / here / shaggybug.doc next >
Text File  |  1995-02-27  |  3KB  |  78 lines
  1.                 L S D   P R E S E N T   S H A G G Y B U G
  2.  
  3.                              By Shagratt/LSD
  4.  
  5.  
  6. In this archive you will find;
  7.  
  8. comms.i - Source for Debugger handler with symbol converter
  9.  
  10. SimCrashBoot.dms - Simbug debugger and crash handler for non-dos disks
  11. SimCrashBoot.s   - Source for the above
  12.  
  13. CommsDemo.s - how to use the debugger handler
  14.  
  15. all necessary simbug 1.72 files (these are not by me!)
  16.  
  17. One problem with the A4000 was not having a Action Replay that worked.
  18. Unfortunaltly BlackHawks Aktion Replay didn't work on my A4000 at the
  19. time I wrote this. I decided to patch an available monitor/debugger to
  20. work for me. As SIMBUG had all the necessary options, I didn`t see the
  21. point in coding a new monitor/debugger.
  22.  
  23.  
  24. SO WHAT DOES THIS PACKAGE DO THAT THE SIMBUG PACKAGE DOESN'T?
  25.  
  26. SimBug always kicked out the OS well and worked with programs that had
  27. kicked out the OS but there is no provided way of attaching it to your
  28. demo/game for bug monitoring and debugging. Now there is. See 
  29. source/DemoComms.i.
  30.  
  31. This also converts the Symbol List (all your source labels) to SimBug so
  32. when you enter SimBug you have source with labels (With the Action Replay
  33. hardware etc. you only get a page full of numbers!)
  34.  
  35.  
  36. SIMCRASHBOOT
  37.  
  38. This is a two function program;
  39.  
  40. a) An execption handler, so is if a non-dos program gurus, SimBug will
  41.    leap in and show you where and let you debug.
  42.    
  43. b) An exception controled version which (if left running) will allow you
  44.    to summon SimBug by pressing the Right Mouse Button, this is achieved
  45.    by putting the processor in trace mode, which I have NEVER seen another
  46.    programmer do for a monitor/debugger, and its GREAT for monitor/
  47.    debuggers!
  48.    
  49. The included DMS file is a disk already setup with SimBug loaded from the
  50. BootBlock. The source file is only the BootBlock (This only works on 
  51. OS 2.xx+).
  52.  
  53. I debugged for my demo Jesus on E`s for AGA using this package and also
  54.  
  55. it was used by a collegue for developing the game Cliffhanger.
  56.  
  57. I have included ALL the source to this, as its unlikely I shall take this
  58. package much further. The idea is someone can play with it, and make it 
  59. even better, or maybe build it in to another package, also you can easily
  60. customise it! BUT AS I HAVE BEEN DECENT ENOUGH TO RELEASE THE SOURCE, PLEASE
  61. BE DECENT ENOUGH TO INCLUDE MY NAME WHEN RELEASING UPDATES ETC - DO NOT TAKE
  62. THE CREDIT FOR MY WORK!
  63.  
  64. These docs may seem rather vague, especially to a beginner, but this
  65. package isn`t realy suitable for Beginners! The source may not be well
  66. documented, but a competent coder will find his way around.
  67.  
  68. The bootblock source is for AsmOne, the rest is for DevPac 3.xx.
  69.  
  70.  
  71. LAST BIT!
  72.  
  73. Good luck with the coding Joe!
  74.  
  75. Fuckings to Borre the lamer!
  76.  
  77. end.
  78.