HELP FAULT                                   Jocelyn Paine November 1992


This module defines a routine for reporting program bugs. You can load
it by doing
    lib fault;
If using Eden, this will have been done for you.


This module exports a routine named 'FAULT'. I call this to report
``shouldn't happen'' errors, such as 'else' statements that should never
be reached. For example, you might use it in a context such as
    switchon dir
    case = "north" then ... do something ...
    case = "east"  then ... do something ...
    case = "south" then ... do something ...
    case = "west"  then ... do something ...
    else
        FAULT( 'bad direction', [%dir%] );
    endswitchon;


PUBLIC FAULT( Message ):

Displays Message (which can be any text), and returns to the Pop
top-level. If FAULT has a second argument, this is printed after the
message. In the current version, FAULT in fact calls 'mishap': see HELP
MISHAP.
