home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsf / jfshared / Modules / RecErrors / !Help < prev    next >
Encoding:
Text File  |  1995-08-09  |  3.3 KB  |  82 lines
  1.                                 RecErrors
  2.                                 =========
  3.      
  4. Introduction
  5. ------------
  6.    Robin Abecasis asked me, sometime ago now, to write a module which could
  7. tell him all the errors which had occured whilst he had not been with the
  8. bulletin board he runs. If an error occurs on the bulletin board a box
  9. usually appears with OK on it. And this stops everything dead.
  10.    Fortunately, somebody thought of this and wrote the NoError module. This
  11. will click on the OK button after about 5 seconds and the BBS can continue.
  12. Unfortunately if you aren't there you can't see what the error was. And if
  13. you were there, there would be no need for NoError.
  14.    So here comes RecErrors, a program which will log all these errors into a
  15. file so that you can see what has happened.
  16.  
  17. Usage
  18. -----
  19.    Run the !Run file. That's it.
  20.    Hopefully, the code will be assembled with no errors and all that in
  21. future will be required is the running of the !Load file.
  22.    To set the filename of the log file alter the !Load file, or set the
  23. variable RecordErrors$File to point somewhere useful.
  24.    As this is a very early version, do NOT set RecordErrors$File to a stupid
  25. filename (ie one which would cause an error) becuase it can't handle it yet.
  26.     
  27. How it works
  28. ------------
  29.    The module uses the WimpSWIVe module by Andrew Clover of Doggysoft. This
  30. allows modules to easily patch calls to the Wimp SWI base, and allows
  31. RecErrors to get in on all calls to ReportError and to send the information
  32. into a file for looking at. The file is opened only when needed, so it is
  33. perfectly safe to do silly things like *Close and other pointless things. The
  34. file also has it's type set after each error.
  35.  
  36. Disclaimer
  37. ----------
  38.   The author accepts no responsibility for any problems which this
  39. application may cause or loss of data resulting in its use. This application
  40. is Public Domain. This means that it may be distributed, so long as no charge
  41. other than copying costs are charged for it.
  42.   
  43. Bugs
  44. ----
  45. • Do not give silly filenames to RecordErrors$File, it shouldn't cause any
  46.   problems, but I wouldn't count on it.
  47.  
  48. Source code
  49. -----------
  50.    This program requires the !JFPatch pre-assembler to make the code. This is
  51. a simple text-to-basic assembler which takes a text assembler file, makes a
  52. basic program from it to assemble, assembles it and returns any errors.
  53. Currently, it is under development and requires a lot of work before it will
  54. be released in any form. As such, the patch file is mostly useless, but must
  55. be distributed with the resultant module.
  56.    All source code an the resultant module must be distributed together.
  57.         
  58. Contact                
  59. -------
  60. Any comments, queries, donations or bug reports can be sent to :
  61.  
  62. Fidonet NetMail :  Justin Fletcher at Arcade (0181 655 4412) [2:254/27]
  63. E-Mail : Gerph@arcade.demon.co.uk
  64.  
  65. Snail Mail :
  66.     Justin Fletcher
  67.     “Galadriel”
  68.     17b Cromwell Road,
  69.     Weeting,
  70.     Brandon,
  71.     Suffolk.
  72.     IP27 0QT
  73.  
  74. History
  75. -------
  76. 23 Apr 1995 : Basic module written for WimpSWIVe. Now v1.00
  77. 24 Apr 1995 : Improved to handle no file/ error from message. Now v1.01
  78. 24 Apr 1995 : Checks bit 5 for transient error boxes. Now v1.02
  79. 28 Apr 1995 : Sent to Arcade. v1.02
  80. 14 May 1995 : Error copied to workspace to fix bug with filecore. Now v1.03
  81. 14 May 1995 : Option to include users name in log file. Now v1.04
  82.