home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsc / codeangel / !CodeAngel / !Help < prev    next >
Encoding:
Text File  |  1995-11-25  |  8.5 KB  |  146 lines
  1. +------------------------------------------------------------------------------+
  2. |                            !CodeAngel version 1.04                           |
  3. |                         © DizzyWizard Software 1995.                         |
  4. |                         By James Larcombe, 25-11-95.                         |
  5. +------------------------------------------------------------------------------+
  6.  
  7. Introduction
  8. ~~~~~~~~~~~~
  9. !CodeAngel v1.04 is an early version of an on-going project of mine, which
  10. is to provide a general purpose programmer's toolkit called up using a mouseclick on the side of the screen.
  11.  
  12. In fact, !CodeAngel was originally coded when I found I needed such features
  13. when doing some development work on another program one evening. It's now been
  14. lying around for a while, and I decided to tidy it up a little and release it.
  15. I've now started to add some of the featured promised in earlier versions.
  16.  
  17. I have some very good ideas for !CodeAngel, and I intend to develop this utility further in the near future.
  18.  
  19.  
  20. How do I use !CodeAngel?
  21. ~~~~~~~~~~~~~~~~~~~~~~~~
  22. Using !CodeAngel is extremely easy. Simply run the application in the normal way. This leaves your desktop in pretty much the same state that it was originally, and you may be forgiven for thinking that !CodeAngel hasn't initialised properly. But it has! *8-D
  23.  
  24. At any time, click with SELECT at the very left hand side of the screen. After doing this the !CodeAngel toolbox will popup in the top right hand corner of the screen. The icons in this window display information about what's beneath the pointer, and the pointer's x/y position on the screen. Should you not wish the x/y icons to update, you can deselect the 'Do x/y' option button. This is handy for slower machines. The 'Choices...' button will open a further dialogue box allowing you to configure CodeAngel in a number of ways.
  25.  
  26. Here's the information for the choices window...
  27.  
  28. * 'Startup banner' - this option toggles display of the startup banner 
  29. * 'Display task names' - this determines whether task names or task handles
  30.   will be displayed
  31. * 'Display handles in hex' - pretty obvious! Affects both window handles and
  32.   task handles (when 'Display task names' is switched off)
  33. * 'Update whilst over CodeAngel window' - if this is selected then the icons in
  34.   the main toolbox will be updated whilst the pointer is over the toolbox.
  35. * 'Only one copy of CodeAngel at once' - if this option is selected then
  36.   CodeAngel won't load if it's already running
  37. * 'Provide border for mouseclicks' - if this is switched on then a click within
  38.   a certain distance (specified by the writable field) of the left hand side of
  39.   the screen will activate CodeAngel. Otherwise the click has to be exactly at
  40.   the very left of the screen.
  41. * 'Size of border:' - This writable field allows you to choose the number of OS
  42.   units away from the left hand side of the screen the that the border is
  43.   operational in. At present I haven't included any range checking on this but
  44.   values larger than about 20 OS units being to get silly.
  45.  
  46. Oh yeah, also, you can quit CodeAngel by clicking on the toolbox's close gadget with *adjust*. Also you can obviously use the standard taskmanager window.
  47.  
  48.  
  49. Future plans
  50. ~~~~~~~~~~~~
  51. Although I've added a few features now, I still don't consider the application finished, so here are some ideas I have for the future.
  52.  
  53. * make the border size grey out if the border isn't switched on
  54. * tidy code
  55. * interactive help
  56. * a better icon! *8-D
  57. * decimal/hex/octal/binary converter, so you don't have to load !SciCalc...
  58. * ascii converter (type in an ascii code, and watch the character displayed!)
  59. * calculator? (probably not, !Calc is in rom...)
  60. * more information, such as icon + window data, caret data etc etc.
  61. * possibly wimp messaging facilities...
  62. * anything else that I could do with whilst developing other software!
  63.  
  64. That's not a particularly impressive list, so *PLEASE* contact us if you have
  65. any further ideas!
  66.  
  67. I also wouldn't mind keeping the app. fairly small... *9-D
  68.  
  69.  
  70. History
  71. ~~~~~~~
  72.  
  73. 1.00 (21-11-95) - First release version.
  74.                   Few features, no task names.
  75. 1.01 (21-11-95) - Ben noticed some probs with v1 1/2 hour after release... *9-D
  76.                   Corrected silly mistake in docs (ta Ben!).
  77.                   Altered window so icon updates don't flicker (ta Ben!).
  78.                   Corrected x/y updating-whilst-over-toolbox bug.
  79. 1.02 (22-11-95) - Cleaned up code relating to 'update x/y' icon, works now!
  80.                   This also sped up redraws slightly...
  81. 1.03 (25-11-95) - Corrected mistakes in documentation.
  82.                   Displayed task names instead of handles (optional).
  83.                   Added mouseclicks border (optional).
  84.                   Made window/task handles display in hex (optional).
  85.                   Allowed user to choose CodeAngel-window-updating or not.
  86.                   Added choices window, allowing user to configure new features.
  87.                   Corrected a silly icon handle updating bug.
  88. 1.04 (25-11-95) - Added 'Only one copy of CodeAngel at once' option.
  89.                   Added startup banner.
  90.  
  91.  
  92. Credits
  93. ~~~~~~~
  94. Thanks must go to Ben Ingram (also of DWS) for writing Converse (an excellent 8-way chat door for Arc/Arm/NFBBS - a DizzyWizard Software / Prodigy Systems coproduction!). When putting this app together (hurridly) I nicked a few bits from the Converse code... not much though! Also, Ben pointed out a few problems with the first version.
  95.  
  96. Also I'd like to thank Ben Harris for writing Handles (similar to this version of CodeAngel...), 'teaching' me about Risc OS and inspiring me to begin programming the Arc.
  97.  
  98.  
  99. Legal
  100. ~~~~~
  101. This utility is FREEWARE. That means that you can distribute it freely, as long as no more than nominal media costs are charged. In other words, most PD libraries should be OK apart from Skyfall PD, who we would ask to refrain from distributing this and any of our other software. You can upload it to BBSes provided nothing is changed and this file remains with the application. AT ALL TIMES, no matter who distributes it, the copyright remain with © DizzyWizard Software 1995. OK? Oh, and also, we take no responsibility for any loss of data or other damage incurred whilst this software is in use. It shouldn't happen, but if it does, don't blame us!
  102.  
  103.  
  104. DizzyWizard Software
  105. ~~~~~~~~~~~~~~~~~~~~
  106. DizzyWizard Software is a group of programmers, artists and musicians who enjoy creating software for Acorn's 32-bit machines. Although primarily a PD group, we also have some commercial software in development, and would be happy to consider any programming work anyone may have on offer.
  107.  
  108. To contact DizzyWizard Software for general enquiries, software support or to obtain our latest catalogue (a must!) please email:
  109.  
  110. dizzywiz@digibank.demon.co.uk
  111.  
  112. Or... "Dizzy Wizard Software" at the Digital Databank BBS, 2:257/501.0.
  113.  
  114. We also have a software support area on Digital Databank BBS (as well as Werewolf BBS and several others, coming soon...). Also, individual members of DWS can be contacted here (we are made up of 6 members).
  115.  
  116.    +-------------+----------------------------------------------------------+
  117.    |BBS..........|Digital Databank BBS                                      |
  118.    |Sysop........|John A Stonier (Internet: jstonier@digibank.demon.co.uk)  |
  119.    |Location.....|Welwyn Garden City, Hertfordshire, UK.                    |
  120.    |FidoNet......|2:257/501.0                                               |
  121.    |Internet.....|@digibank.demon.co.uk                                     |
  122.    |Line 1.......|(0707) 329306 / 300-28.8k / MNP 1-5(v42/42bis) / 23 Hrs   |
  123.    |Lines 2/3/4..|(0707) 323531 / 300-14.4k / MNP 1-5(v42/42bis) / 24 Hrs   |
  124.    |Data Format..|8 bits, No parity 1 Stop bit                              |
  125.    +-------------+----------------------------------------------------------+
  126.    |                 (Acorn Information at your Fingertips)                 |
  127.    +------------------------------------------------------------------------+
  128.  
  129. Individual contact addresses can be obtained by emailing us at the address shown above or by logging on to the Digital Databank.
  130.  
  131. If you really have to contact me personally by post, or wish to send general postal enquiries to the whole group (ie money/offers of work... *9-D) please write to...
  132.  
  133. James Larcombe,
  134. DizzyWizard Software,
  135. 20 Southland Park Road,
  136. Wembury,
  137. Nr. Plymouth,
  138. Devon,
  139. PL9 0HF.
  140.  
  141. However, email contact is preferable.
  142.  
  143. Watch out for more DizzyWizard Software productions in the near future... consult our catalogue for more information.
  144.  
  145.  
  146. DizzyWizard Software hope you enjoy using !CodeAngel, v1.04.