home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / w / wimpmon / !WimpMon / !Help next >
Text File  |  1994-11-27  |  5KB  |  121 lines
  1.                     **********************************
  2.                     *                                *
  3.                     *  !WimpMon - © Tom Hughes 1994  *
  4.                     *                                *
  5.                     **********************************
  6.  
  7. This software is COPYRIGHT, but has been released as FREEWARE. Please see
  8. the end of this file for conditions of use and distribution.
  9.  
  10. About the Software
  11. ******************
  12.  
  13. !WimpMon allows a programmer to spy on applications to find out what events
  14. they are receiving from the WIMP. In particular, it gives details of the
  15. messages being passed between applications which can be very useful when your
  16. program doesn't seem to be doing what you expect :-)
  17.  
  18. I wrote the original version of !WimpMon whilst trying to find a particularly
  19. obscure bug in some of my code which turned out to be a bug in Pinboard and
  20. not my code...
  21.  
  22. Using the Software
  23. ******************
  24.  
  25. Please note that this program requires RISC OS 3 to run, as it uses post
  26. filters to monitor the events.
  27.  
  28. The program loads to the iconbar, and a click on the icon produces a single
  29. window which is used to display details of the events being monitored. The
  30. main menu allows you to select which events will be included in the
  31. monitoring, and which tasks will be monitored.
  32.  
  33. The menu of tasks is automagically updated when a task starts up or closes
  34. down, and ticking the 'Catch New' option on the menu causes new tasks to be
  35. monitored automagically when they start. This option is useful if you wish to
  36. trap events being sent to transient tasks such as filer action windows which
  37. only exist for short periods of time.
  38.  
  39. Closing the log window will cause the output of updates to be suspended until
  40. it is reopened, at which point, all changes which have taken place whilst it
  41. was closed will be applied. Quiting the application will cause all monitoring
  42. to stop cleanly.
  43.  
  44. Technical Details
  45. *****************
  46.  
  47. The program works by using a module which installs filters on tasks when
  48. requested to do so via a SWI call. The information it traps in this way is
  49. then sent into a pipe in a textual form. Please note that the SWI chunk being
  50. used at the moment is in the user area until I get a proper allocation from
  51. Acorn.
  52.  
  53. The desktop front end is written in C, using DeskLib, and this reads the
  54. piped data and displays details about the events in a text window. A pollword
  55. is used by the module to inform the task when it writes information into the
  56. pipe.
  57.  
  58. Planned Future Extensions
  59. *************************
  60.  
  61. None. If anybody thinks of anything, please let me know.
  62.  
  63. Bugs, Misfeatures and Idoiosyncracies
  64. *************************************
  65.  
  66. If a new task starts or an old one dies whilst you have the task menu open,
  67. the menu will not be updated until you close it and reopen it. I havn't
  68. changed this, as I don't think it can actually occur. If it can, let me know
  69. how...
  70.  
  71. Thanks and Credits
  72. ******************
  73.  
  74. Thanks to everyone who's given me tips, advice, help etc, also to all the
  75. Acorn owners I've met in the last two and a half years, and especially those
  76. I've met since getting my Arc last year. Also to everybody whose programs
  77. I've looked at for ideas on coding for the Wimp.
  78.  
  79. A special thank you to my beta testers, and in particular to Martin Ebourne
  80. for his help. The beta testers were:
  81.  
  82.         Andrew Hersee
  83.         Simon Burrows
  84.         Martin Ebourne
  85.         Mike Henry
  86.  
  87. Thanks to Phil Colmer for suggesting come changes after seeing version 1.00 -
  88. I think I included most of his suggestions in the next version.
  89.  
  90. Also thanks to Jason Williams for developing DeskLib which is so much nicer
  91. than Risc_OSLib - it couldn't get much worse could it :-)
  92.  
  93. Thanks again everyone - And may the Acorn world flourish evermore!
  94.  
  95. Copyright Notice - Read and OBEY!!
  96. **********************************
  97.  
  98. This application is copyright Tom Hughes. It is *not* Public Domain, but it
  99. *is* Freeware. This means that you may use it yourself, and may distribute
  100. it to others provided that you pass it on *as is*, with all the files with
  101. which it came. You may not distribute it any way which leads to you or
  102. anyone else making profit from it. This means that you can only charge
  103. enough to cover the costs of media and postage involved in distribution, and
  104. you may not use it as an incentive to buy something else. If in doubt,
  105. contact the author at the address below.
  106.  
  107. The author's permission *must* be obtained before this application is
  108. included on any Magazine disc, and it would be appreciated if PD libraries
  109. could inform the author when they are distributing this application.
  110.  
  111. Bug reports, donations, complaints, thanks, free software etc to the author
  112. please at the following address:
  113.  
  114. Tom Hughes 
  115. 5 Lampits
  116. Hoddesdon
  117. Hertfordshire
  118. EN11 8EH
  119.  
  120. tom@compton.demon.co.uk
  121.