home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / programming / maskthrow / ReadMe < prev    next >
Encoding:
Text File  |  1998-05-31  |  2.7 KB  |  68 lines
  1.  
  2.                         MaskThrowback version 1.10
  3.                        ============================
  4.  
  5. MaskThrowback is a small module that will prevent certain messages from
  6. appearing in throwback windows.  The aim of this is to stop Acorn C++ from
  7. spewing windowfulls of useless warnings, such as ``Non-ANSI #include''. 
  8. Acorn C++ does have a switch to disable these warnings, but unfortunately it
  9. disables all the useful warnings as well; hence this module.
  10.  
  11. It is just conceivable that someone might find a use for this other than
  12. hacking around Acorn's C++.
  13.  
  14.  
  15. How it works
  16. ------------
  17. MaskThrowback works by installing a filter on Wimp message 0x42583, the
  18. message used by the DDEUtils module to tell editors (such as Zap) to display
  19. a throwback message.  If the string in the message matches one of the
  20. wildcarded strings the modules was assembled with, the message is blocked.
  21.  
  22.  
  23. Changing the messages to block
  24. ------------------------------
  25. Messages can be added and removed from the file `hdr.masklist' (the format
  26. is straightforward).  The wildcard `*' can be used to match any string. 
  27. Feel free to disagree with my choice of warnings to mask.
  28.  
  29. Once you've edited the file, re-assemble the module by running
  30. !Makefile.Makefile (or just !Makefile if you're using Makatic plus my
  31. customised scripts).  You'll need ObjAsm, a C compiler (I was lazy), OSLib,
  32. and CMHG (so Acorn C/C++ is a necessity, unfortunately).
  33.  
  34.  
  35. Compatibility
  36. -------------
  37. MaskThrowback works with Zap, although I haven't tried it with SrcEdit or
  38. StrongEd.  It is possible that empty throwback windows might get left open
  39. with obscure editors, since the module doesn't trap the messages that begin
  40. throwback sessions.
  41.  
  42.  
  43. Author and copyright
  44. --------------------
  45. MaskThrowback was written by me, Mark Seaborn.  You can contact me via
  46. e-mail at <mseaborn@argonet.co.uk>, or if that fails in the future, at
  47. <mseaborn@bigfoot.com>.  You should be able to find this program at
  48. <http://www.argonet.co.uk/users/mseaborn/comp/programs.html>.
  49.  
  50. You may do what you like with this program, provided that if you distribute
  51. it, either I am credited as the author or this ReadMe file is included.  If
  52. you alter the software, make it clear what alterations you have made.
  53.  
  54. If you have any improvements or suggestions, please contact me!
  55.  
  56.  
  57. Version history
  58. ---------------
  59. <1.00  (written in 1996)
  60.           These only had primitive string-matching routines.
  61.  
  62. 1.00      A new string-matching routine was written to allow for wildcards.
  63.           I was lazy and wrote it in C.
  64.  
  65. 1.10  (fixed in late 1996, but only released by 31st Mat 1998)
  66.           Fixed a silly, embarrassing bug -- I didn't fill in r4 for the
  67.           Filter_RegisterPostFiler SWI (RTFPRM in future!).
  68.