GUI-Guru Version 0.9b

                 a Graphical User Interface Guru analyser

                     by DM Hollway 29th November 1993


Standard American Legal Disclaimer-type thing:

 This piece of software is supplied "as-is"; the author cannot be held
 liable for any loss or damage occurred as a result of the use of this
 software.  Even if your cat spontaneously combusts,  or a piano falls 
 on you,  as a direct result of your  using this program, it's *NOT MY
 FAULT*.


System Requirements

    Any Amiga with 512K RAM or more, and Kickstart 1.3 or higher
    (GUI-Guru is enhanced under Kickstart 2.0 and above)
    
    GUI-Guru has been tested on the following Amiga configurations:

    A4000, EC030 @ 25MHz, 2MB Chip, 4MB Fast, Kickstart 3.0  (v39.106)

    A4000, EC030 @ 25MHz, 2MB Chip, 4MB Fast, Kickstart 2.04 (v37.175)

    A4000, EC030 @ 25MHz, 2MB Chip, 4MB Fast, Kickstart 1.3  (v34.005)

    A500,  68000 @  7MHz, 1MB Chip, 2MB Fast, Kickstart 1.3  (v34.005)

    A1200, 68020 @ 14MHz, 2MB Chip, 0MB Fast, Kickstart 3.0  (v39.106)


    I'd therefore hazard a guess that GUI-Guru will work on any Amiga
    system meeting the above requirements (go on, prove me wrong..;)
    
**NOTE: Although GUI-Guru *will* work under 1.3, the window might appear a
  little odd, due to the white & black colours being reversed under 1.3.
  There's nothing I can do about this; GUI-guru will still work fine!


Running GUI-Guru

    GUI-Guru can be run from either the workbench (by clicking on its
icon) or from the CLI/Shell.

    GUI-Guru supports the following command-line options:

    GUIGuru        -   starts the program and displays the main window.

    GUIGuru ?      -   displays usage information about the program.

    GUIGuru [X]    -   starts the program and displays the window, and
                       displays in the window the meaning of Guru number
                       [X].

   Plus a secret command line option - I leave it to you to discover it!

What is GUI-Guru?

    Almost every Amiga owner has seen a "Guru" (or "Software Failure" as it's
known under Kickstart 2.0 and above). That flashing red box causes a shudder
of fear to pass through even the most hardened amiga expert. But the Guru 
has a purpose; the two numbers displayed in the flashing red box can tell
you the reason why the Amiga crashed. The numbers take the following form:

                        12 34 5678 . ABCDEFGH

The right-hand eight digits give the location in your Amiga's memory at which
the problem occurred. The leftmost eight digits, however, give the most
useful information. They can tell you which area (or SUBSYTEM) of the Amiga's
operating system crashed, and they can also give specific information on the
cause of the problem.
  But what do these mystical numbers mean? GUI-Guru is a program to display
the meaning of Guru numbers in an attractive graphical form. On running
GUI-Guru, a small window will open on your workbench screen. The window looks
something like this:

      (1)--->[]Gui-Guru v0.9b=======================|]
             |           _________                   |
             | Number:  |_(2)_____| (8 digit number) |
             |            __________________________ |
             |Subsystem: | (3)                     | |
             |           |                         | |
             |General:   | (4)                     | |
             |           |                         | |
             |Specific:  |_(5)_____________________| |
             |  _______                    ________  |
    (6)----->| | About |                  |  Quit  |<-----(7)
             +--=======--------------------========--+


What does it all mean?

      The areas of the window have the following purpose:

 (1) This is the CLOSE gadget. Click here with the mouse to exit the
     program.

 (2) This is a STRING gadget; to enter a number, click in this gadget and
     type in the guru number.

 (3) On typing in a number, this area of the window will show the subsystem
     of the amiga that reported the crash, for example "workbench".

 (4) This area of the window displays general details of the fault, if
     available.

 (5) Specific details of *why* the subsystem indicated in (3) crashed are
     displayed here.

 (6) Click here to display some information about the program and the
     author.

 (7) Click here to exit the program (as for (1), above).


Distribution

    This program is FREEWARE. You may freely copy and distribute this
program, but you may not charge more than a reasonable amount for the media 
on which the program is stored ("reasonable" denotes the amount typically
charged by PD libraries).
    This program may be included in software collections (eg Fred Fish's
excellent disk library, CDPD, Aminet, TBAG etc) provided that the author is notified
by E-mail (see below) prior to the inclusion.

Contacting the Author

    Should you feel an overwhelming urge to show your appreciation of
this program, the author can be contacted at:

  E-Mail (Internet): dmh-a@minster.york.ac.uk
                or   dmh11@tower.york.ac.uk

  but only until June 1994; after that date the author will be whooping it
up at a secret location in Switzerland..

  Or if you want to send me gifts (4MB x 32-bit SIMMS are always welcome, as
are SCSI controllers, multisync monitors etc :)

 SnailMail:          DM Hollway
                     Langwith College
                     University of York
                     Heslington
                     York
                     YO1 5DD


Remember: Only   //Amiga makes it possible!
               \X/ "Life begins at '030 and gets fun at '040.
                    Senility strikes at '86"

Picture this: Commodore release a new Amiga. It's HP/PA RISC-based,
supports 2 gigabyte of CHIP memory, 8 gigabyte of FAST memory, has
display resolutions of up to 4096x1280x16.7Million colours, comes with
a 1 terabyte hard drive, two HD floppies and a CD drive as standard,
and retails for £299.99.
    What's the first question the computer world asks about the new machine?

    "Is it PC compatible?"