home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / utility / system / leonard6 / leonard6.txt < prev   
Text File  |  1990-09-19  |  6KB  |  141 lines
  1.  
  2.  *---------------------------------------------------------------------*
  3.  |                                                                     |
  4.  |                    Leonard6, the Crash Handler                      |
  5.  |                        by John Eidsvoog                             |
  6.  |                   Copyright 1990 John Eidsvoog                      |
  7.  |                 Release date: September 18, 1990                    |
  8.  |                                                                     |
  9.  |  This software and the accompanying documentation are freeware and  |
  10.  |  may be distributed freely as long as it remains intact, complete,  |
  11.  |  and unaltered.  It may not be sold or included with any commercial |
  12.  |  package without the written consent of the author.                 |
  13.  |                                                                     |
  14.  *---------------------------------------------------------------------*
  15.  
  16.  
  17.  
  18. THE INSPIRATION BEHIND LEONARD6
  19. -------------------------------
  20.  
  21. An official at Atari (who shall remain nameless) has joked publicly that
  22. Atari plans to have a head with little ones and zeros appear whenever a
  23. program crashes on the TT.  The more we thought about it, the more we
  24. realized that it might actually be a good advertising gimmick, not only
  25. on the TT but also on the ST. 
  26.  
  27. To show that we at CodeHead Software have a sense of humor, I decided to
  28. create a program that would replace the usual Atari "bombs" with little
  29. heads with ones and zeros in them.  Since this program works on all STs
  30. _and_ the TT, it further shows that we do indeed know how to make our
  31. software TT-compatible. 
  32.  
  33. The little head-shaped bomb replacements have been nicknamed leonards
  34. after the movie "Leonard - Part VI", which was quite a bomb itself.  Any
  35. similarities between the name or images used in Leonard6 and any real or
  36. imaginary figures or persons are purely coincidental.  This package was
  37. also created with a definite tongue planted in a rather large cheek. 
  38.  
  39.  
  40.  
  41. HOW TO SET IT UP
  42. ----------------
  43.  
  44. Leonard6 is a resident program.  It can be installed from the desktop or
  45. from your AUTO folder.  You can install it from the desktop (or HotWire)
  46. by simply running the program, at which time the installation message
  47. will quickly flash on the screen and return you to the desktop (or
  48. HotWire).
  49.  
  50. If you want to permanently add Leonard6 to your normal setup, simply
  51. copy it into your AUTO folder.  It will then be installed every time you
  52. boot up from that disk.  A brief message will appearing showing you that
  53. it is installed. 
  54.  
  55. If you use a resident debugger such as TEMPLMON.PRG or AMONST.PRG, you
  56. should install LEONARD6.PRG so that it runs after that debugger in your
  57. AUTO folder.  That way every time a system error occurs, the appropriate
  58. number of leonards will appear and your debugger will be invoked. 
  59. You'll be able to view the leonards by flipping to your view screen (F2
  60. in TempleMon, or 'V' in AmonST). 
  61.  
  62.  
  63.  
  64. HOW IT WORKS
  65. ------------
  66.  
  67. Leonard6 installs itself in the first 8 exception vectors, which
  68. normally point to the system's bomb-handler routine.  It replaces the
  69. routine which shows bombs on the screen for those vectors.  The vectors
  70. handled by Leonard6 and the respective number of leonards that will
  71. appear are:
  72.  
  73.      2 - Bus error
  74.      3 - Address error
  75.      4 - Illegal instruction
  76.      6 - Chk instruction
  77.      7 - Trapv instruction
  78.      8 - Privilege violation
  79.      9 - Trace mode
  80.  
  81. These are the most frequent types of system errors.  Exceptions with
  82. larger numbers will be handled by the normal system bomb-handler
  83. routine. 
  84.  
  85. If you have a resident debugger, Leonard6 will fall through to the
  86. debugger routines, otherwise it will handle errors the same as the
  87. operating system does by terminating the current program (with a Pterm). 
  88.  
  89.  
  90.  
  91. CRASHER.PRG
  92. -----------
  93.  
  94. CRASHER.PRG is a program which simulates an illegal instruction error
  95. with Leonard6 installed so that you don't have to install Leonard6 and
  96. wait for a system error to occur.  This will help you decide if you want
  97. to install Leonard6 in your system or not.  CRASHER.PRG will not harm
  98. your system or create any problems with resident programs or
  99. accessories.  It will simply display four leonards and wait for you to
  100. press a key to terminate the program. 
  101.  
  102.  
  103.  
  104. POINTS TO NOTE
  105. --------------
  106.  
  107. 1.  Due to the larger size of the leonards compared to the size of a
  108. bomb image, on a color monitor you will only see the first 6 leonards. 
  109. Up to nine leonards are supported on a monochrome monitor. 
  110.  
  111. 2.  A divide-by-zero exception is ignored and will be immediately
  112. processed by an 'rte' instruction.  This is useful because some programs
  113. have divide-by-zero errors which TOS will ignore but TEMPLMON will
  114. intercept.  Since this can be quite irritating, Leonard6 will pass you
  115. directly back to the program without displaying any errors.  If you want
  116. to test your programs for divide-by-zero errors, you should remove
  117. Leonard6. 
  118.  
  119.  
  120.  
  121. COPYRIGHT STUFF
  122. ---------------
  123.  
  124. LEONARD6.PRG, CRASHER.PRG, and this document are Copyright 1990 John
  125. Eidsvoog.  They are freeware and may be distributed freely as long as
  126. they are unaltered and not included with any commercial products without
  127. the written consent of the author. 
  128.  
  129. Please note that Leonard6 is not a CodeHead Software product.  All
  130. CodeHead Software products are commercial programs which must be
  131. purchased through normal commercial channels.
  132.  
  133. Neither this document file (LEONARD6.TXT) nor the program files
  134. (LEONARD6.PRG and CRASHER.PRG) may be altered in any way.  Copies of
  135. these files may not be sold, and this document may not be reprinted,
  136. without the express written permission of John Eidsvoog. 
  137.  
  138. I've tried to make Leonard6 as bug-free as possible.  Nevertheless, I
  139. cannot be responsible for any damages which may occur as a result of the
  140. use (or misuse) of Leonard6.
  141.