home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 3 / goldfish_volume_3.bin / files / dev / e / stderr / stderr3.2.readme < prev    next >
Encoding:
Text File  |  1994-10-01  |  2.2 KB  |  71 lines
  1. Short:    Provide stderr port for E 3.0b
  2. Author:   Joseph E. Van Riper III
  3. Uploader: jvanriper@uncavx.unca.edu
  4. Type:     dev/e
  5.  
  6. Long:
  7.  
  8. UPDATE INFO:
  9.  
  10. * StdErr 3.2 fixes something truly stupid in 3.1 in which it
  11. would cause everyone's programs to have a version string of
  12. 'StdErr 3.1'.. which would pretty well defeat the whole
  13. purpose behind having a version string in the first place.
  14. I do not have any idea what I was thinking.  Otherwise, it's
  15. exactly the same thing as 3.1.
  16.  
  17. * StdErr 3.1 fixes some potential bugs, and has a nicer
  18. internal error-handling scheme (gives you a better idea what
  19. has gone wrong internally than before).
  20.  
  21. It also has a $VER: string, so I'll finally be doing
  22. something slightly closer to standards <grin>.
  23.  
  24. STANDARD INFO:
  25.  
  26. StdErr is an Amiga E module providing a flexible, durable,
  27. downright NICE standard error port, in an object oriented
  28. fashion (sorta).
  29.  
  30. You don't have to worry about global variables or arcane
  31. brew ha ha or whatever.. in fact, all the stderr commands
  32. are prefaced with 'err_', and otherwise look as closely like
  33. the standard Amiga E functions as possible (eg, err_WriteF
  34. is the function to write something to the stderr port).
  35.  
  36. Further, there's nothing to initialize!  StdErr handles it
  37. for you.  The only thing YOU have to do is make sure you
  38. call 'err_Dispose()' at the end of your program.
  39.  
  40. Be sure to either read the documentation or examine the
  41. example source code.
  42.  
  43. FEATURES:
  44.  
  45. Standard error port (รก la CONSOLE:).
  46. Error reports directed to a file (will automatically create
  47.   a header before the error, with date and time of error,
  48.   [err_New]).
  49. Automatic Fault/IoErr() handling (no more mysteries for your
  50.   users).
  51. Supports Workbench (err_Dispose is the key to this.. tells
  52.   the user how to close the window if it was opened).
  53. Direction of StdErr message may be changed at any time.
  54. Preface for Fault handling may be changed at any time (via
  55.   err_Name)
  56. Works with Amiga E 3.0b (for earlier versions of Amiga E,
  57.   you'll need to find an earlier version of StdErr to use as
  58.   a pmodule with EPP.. which isn't quite as slick as this
  59.   version).
  60.  
  61. THINGS TO DO:
  62.  
  63. Perhaps, when using a Workbench, open a window that can be
  64. closed by the gadget instead of having to press RETURN.
  65.  
  66. BUGS:
  67.  
  68. None noticed.
  69.  
  70. Should work on all normal Amiga computers.
  71.