; ; report.sh ; ; A simple report box handler ; ; © 1994-1998 Straylight ; ;----- Licensing note ------------------------------------------------------- ; ; This file is part of Straylight's Sapphire library. ; ; Sapphire is free software; you can redistribute it and/or modify ; it under the terms of the GNU General Public License as published by ; the Free Software Foundation; either version 2, or (at your option) ; any later version. ; ; Sapphire is distributed in the hope that it will be useful, ; but WITHOUT ANY WARRANTY; without even the implied warranty of ; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ; GNU General Public License for more details. ; ; You should have received a copy of the GNU General Public License ; along with Sapphire. If not, write to the Free Software Foundation, ; 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. ;----- Overview ------------------------------------------------------------- ; ; Functions provided: ; ; report_register ; report_catchAll ; report_error [ :LNOT::DEF:report__dfn GBLL report__dfn ; --- report_register --- ; ; On entry: R0 == pointer to routine to use ; R1 == R12 to pass to the routine ; R2 == stack pointer to set when it gets control ; ; On exit: -- ; ; Use: Registers a resume point so that the application can recover ; from errors. Error messages are reported using errorBox. IMPORT report_register ; --- report_catchAll --- ; ; On entry: -- ; ; On exit: R13 modified ; ; Use: Sets up an exception handler to catch errors and other SEH ; exceptions. Errors are reported in the usual way, and the ; user is given the option to close the application. Other ; exceptions are reported as errors. IMPORT report_catchAll ; --- report_error --- ; ; On entry: R0 == pointer to error ; ; On exit: -- ; ; Use: Prompts the user about quitting the application in response ; to a really bad error. If the user decides to quit, we ; quit. Otherwise we return. IMPORT report_error ] ;----- That's all, folks ---------------------------------------------------- END