home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / amigalib / d994 / theguru.lha / TheGuru / Docs / Guru.doc < prev    next >
Encoding:
Text File  |  1994-04-05  |  6.6 KB  |  164 lines
  1.  
  2. Program : The guru v2.3 (Feb. 3,1994 - document)
  3. Language: Assembly
  4. Author  : E.Lensink
  5.  
  6. DISCLAIMER:
  7.  Although I (the author) have thoroughly tested 'The Guru' and have done 
  8.  everything possible to make the program reliable, you use it at your own
  9.  risk! I am not responsible for any damage caused by using this program,
  10.  either direct or indirect. If this program spontaneously crashes your
  11.  computer, melts your car, blows your nose, or explodes your grandma :-),
  12.  I AM NOT RESPONSIBLE !!!
  13.  
  14. DISTRIBUTION:
  15.  'The Guru' may be included in PD. libraries, on coverdisks, on CD's etc.
  16.  The files may be archived as long as they are unaltered after dearchieving.
  17.  The only restriction I make is that it may NOT BE SOLD for profit,
  18.  and that you keep all the files together. You should have the following
  19.  files:
  20.  
  21.               DOS_Err.data                9051 
  22.               Guru2.3                    10784 
  23.               Guru2.3c                   38572 
  24.               GURU_Err.data              19494 
  25.               SimErr                       972
  26.               Docs                    (drawer)
  27.  
  28.  If your set is not complete, or the filesizes are different you should
  29.  not use the programs. (hacked versions, viruses etc.) 
  30.  
  31.  You'll probably have noticed that there are two versions of 'The Guru'.
  32.  The only difference is that the normal 2.3 version loads its data from
  33.  disk, therefore the files DOS_Err.data and GURU_Err.data must be in the
  34.  same directory as Guru2.3. 
  35.  The 2.3c version is an all-in-one version, the data files are hidden 
  36.  safe away inside the program. You can put this anywhere you want on your
  37.  disk or hard drive.
  38.  
  39. TUTORIAL:
  40.  Every amiga owner has seen a guru message or software error as they are
  41.  called in kickstart 2.0 and above  at least once in his/her life. That 
  42.  nasty red flashing box has a purpose; the two numbers in the box can tell
  43.  you why your amiga crashed. The numbers take the following form:
  44.  +----------------------------------------------------------------------+
  45.  |     Software failure.        Press left mouse button to continue.    |
  46.  |                                                                      |
  47.  |                 Error: 12345678   Task: 12345678                     |
  48.  +----------------------------------------------------------------------+
  49.  
  50.  You see two numbers here, one behind error and one behind task.
  51.  The one behind task is the address in memory where the crash occurred.
  52.  You can use a monitor and/or dissassembler on that address to see the
  53.  instruction(s) that caused the error. The number behind error is the
  54.  real important one, it tells you precisely what error occurred. (If you
  55.  are a programmer it tells you what stupid error you've made !) 
  56.  Unfortunately a number alone doesn't mean much... but this is where
  57.  'The Guru' comes in. 'The Guru' will decode the message for you into
  58.  a more understandable form. You only have to follow three easy-to-understand
  59.  steps:
  60.         1- When the software error appears press the left mouse button
  61.            Your computer will reboot.
  62.         2- Use the workbench or the shell to start the 'The Guru' program.
  63.         3- Click the LAST button, then the GURU button and a miracle 
  64.            happens (well, not quite, but at least you know what has gone
  65.            wrong...)
  66.  
  67.  To test 'The Guru' you can run the program SimErr, which is included in this
  68.  distribution. Just run SimErr, then start at step 2 above.
  69.  If everything went right you should see something like this in the 'The Guru'
  70.  window:
  71.  
  72.           GURU NUMBER:
  73.             82011234: Deadend Alert
  74.  
  75.           DESCRIPTION (graphics):
  76.             AN_GfxNoLCM: Emergency memory not
  77.             available
  78.  
  79.           RECOVERY SUGGESTION:
  80.             Clipping graphics in your own program
  81.             might help ?!
  82.  
  83.  All this means: Your computer crashed because the graphics.library didn't
  84.  have enough memory (mostly for graphics clipping) available.
  85.  Easy eh...
  86.  
  87.  But that's not all! You can also get help with DOS-errors like
  88.   
  89.   Couldn't run program x: error 121
  90.  
  91.  Just use the + and - buttons located above and below the three-digit number
  92.  in the 'The Guru' window to set the number to 121. Then click the DOS
  93.  button.
  94.  
  95.  You can set the guru number in a similar manner; use the + and - buttons 
  96.  above and below the eight digit number to set it. Then click the GURU
  97.  button.
  98.  
  99.  The ABOUT button gives information about the program, the QUIT button 
  100.  quits, and the DEFAULT button resets the program. (not your computer)
  101.  
  102. CUSTOMISING:
  103.  
  104.  'The Guru' can be a little bit customized by two tooltypes:
  105.  
  106.   IMMEDIATE   - Guess...
  107.   AUTOTOFRONT - The window pops to front as soon as it's activated.
  108.    (can be useful if the window is obscured by some other windows)
  109.  
  110. SYSTEM REQUIREMENTS:
  111.  'The Guru' should run on any amiga with at least kickstart 1.2 .
  112.  It has been successfully tested on the following configurations:
  113.  
  114.  A3000 : 2 Mb CHIP, 4 Mb FAST, Kickstart 2.04
  115.  A3000 : 2 Mb CHIP, - Mb FAST, Kickstart 1.3
  116.  A500+ : 2 Mb CHIP, - Mb FAST, Kickstart 2.04
  117.  A500+ : 2 Mb CHIP, - Mb FAST, Kickstart 1.3
  118.  A500  :0.5Mb CHIP,0.5Mb FAST, Kickstart 1.2
  119.  A1200 : 2 Mb CHIP, - Mb FAST, Kickstart 3.0 
  120.  
  121. GURU HISTORY:
  122.  
  123. version 1.0  (July 28,1993) : - Real crap version with bugs...
  124.                               - Released at SHN
  125.  
  126. version 1.1  (Aug.  1,1993) : - Fixed all bugs (I guess)
  127.                               - Never really released
  128.  
  129. version 2.0  (Oct. 31,1993) : This is a complete recode...
  130.                               - Better user interface
  131.                               - better descriptions
  132.  
  133. version 2.1  (Dec. 25,1993) : - Added customization by tooltypes in icon
  134.  
  135. version 2.2  (Jan.  ?,1994) : Fixed a bug - opened a font but didn't free it
  136.                               - Added zoom gadget in window
  137.  
  138. version 2.21 (Jan.  6,1994) : - Window is now NOCAREREFRESH (=300% faster)
  139.                               - Added RMBTRAP, just looks nicer
  140.  
  141. version 2.3  (Feb.  3,1994) : A lot of changes on this one...
  142.                               - Looks at screen palette for correct 3d
  143.                                 buttons. (The buttons looked inversed on 
  144.                                 a kick 1.3 machine with 2.0 color palette)
  145.                               - Changed the logo, looks nicer
  146.                               - Looks good on a 2-color workbench too !
  147.                                 (now all text is readable...)
  148.  
  149. BUG REPORTS:
  150.  
  151.  If you find a bug in The Guru please let me know.
  152.  Write down EXACTLY what you were doing at the time the bug showed up,
  153.  your configuration, and anything else that might be relevant.
  154.  
  155.  My address is:
  156.  E.Lensink
  157.  Notengaarde 33
  158.  3992 JR Houten
  159.  Holland
  160.  
  161.  I will not reply to any mail unless you include a self-addressed envelope
  162.  and stamp(s).
  163.  
  164.