home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / m / modctrl / !ModCtrl / !Help next >
Text File  |  1995-05-09  |  7KB  |  121 lines

  1.  
  2. ##   ##              ##  #####    ##             ###
  3. ### ###              ## ##   ##   ##              ##
  4. #######  #####   ###### ##       #####  ## ###    ##
  5. ## # ## ##   ## ##   ## ##        ##    ###  ##   ##
  6. ## # ## ##   ## ##   ## ##        ##    ##        ##
  7. ##   ## ##   ## ##   ## ##   ##   ##    ##        ##
  8. ##   ##  #####   ######  #####     #### ##      #####
  9.  
  10. Help for ModCtrl v1.00, © Simon Hatliff 1994.
  11.  
  12. Introduction
  13. ¨¨¨¨¨¨¨¨¨¨¨¨
  14. ModCtrl is a small utility providing information about and control over modules, which can normally only be done from the command line. Features include:
  15.  
  16. • Lists all ROM and RAM modules installed in your computer
  17. • Shows the status of ROM modules by using different colours
  18. • Kill or re-initialise any ROM or RAM module
  19. • Unplug any ROM module
  20. • Display information about any installed module, and it’s SWIs or keywords
  21. • Display information about a module on disc without installing it
  22.  
  23. ModCtrl supports interactive help.
  24.  
  25. Loading ModCtrl
  26. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  27. Load ModCtrl in the usual way, by double clicking on the !ModCtrl icon in the directory display. After a short delay the ModCtrl icon will appear to the right of the icon bar.
  28.  
  29. Clicking on the ModCtrl icon on the icon will have the following effects:
  30.   with SELECT - open the RAM modules window
  31.   with MENU   - open the icon bar menu
  32.   with ADJUST - open the ROM modules window
  33.  
  34. The icon bar menu gives you access to the program information box, allows you to open the RAM or ROM modules window, or allows you to quit the ModCtrl program.
  35.  
  36. The RAM modules window
  37. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  38. This window shows a scrolling list of installed RAM modules, and a number of action buttons.
  39.  
  40. Clicking on the Close button will close the RAM modules window. A close icon (☓) has also been provided on the title bar so that you may iconise this window easily.
  41.  
  42. Clicking on the Re-scan button will re-scan and display the list of installed RAM modules. This could be useful if you have loaded in more modules since loading ModCtrl. Re-scanning is performed automatically if you kill any modules using ModCtrl, so there is no need to re-scan after every operation.
  43.  
  44. Clicking on Kill, Re-init or Get info will kill, re-initialise or display more information on any selected RAM modules in the list. Choose your selection (see below) then choose the action.
  45.  
  46. To select a single module, click SELECT on it’s name in the scrolling list.
  47. Clicking SELECT over an already selected name will de-select everything.
  48. To select additional modules, click ADJUST on their names in the scrolling list.
  49. Clicking ADJUST over an already selected name will de-select it.
  50.  
  51. The ROM modules window
  52. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  53. This looks very similar and performs in almost exactly the same way as the RAM modules window, except for the following differences:
  54.  
  55. • The scrolling list shown is of ROM modules, and actions are performed on these.
  56. • An extra action button, Unplug, can be used to unplug all selected ROM modules.
  57. • After an action has been performed, both the ROM and RAM modules are re-scanned and displayed (RAM modules are only displayed if the RAM modules window is already open). This is done because sometimes altering a ROM module will also alter a RAM module.
  58. • In the list of modules, some are displayed in different colours to show their status. The colours mean:
  59.   RED        - Running at the time of the scan
  60.   BLACK      - Active
  61.   DARK GREY  - Dormant
  62.   LIGHT GREY - Unplugged
  63.  
  64. Getting info
  65. ¨¨¨¨¨¨¨¨¨¨¨¨
  66. When you choose the Get info option, a new window will be opened for every selected module which shows information on the module. Expanding the window using the toggle icon will reveal more technical information on the module header.
  67.  
  68. If the module provides any SWIs or * commands/keywords then you can get lists of these by clicking on the submenu icons to the right of the bottom part of the window. These icons will be greyed out if no SWIs or keywords are available. If you choose an SWI name from the SWI menu, then ModCtrl will try to get StrongHelp¹ to open a help page for it, providing StrongHelp¹ is loaded, and has help for the SWI. If you choose a keyword name from the Keyword menu, any help on that keyword will be displayed in a task window.
  69.  
  70. As well as choosing the Get info option for any installed modules, you can drag one or more modules from a directory display (or even another task) to the ModCtrl icon or any ModCtrl windows and an information window will be opened for it/them without installing the module. Lists of SWIs and keywords will NOT be available for modules dragged from a directory display in this way.
  71.  
  72. ¹ StrongHelp is the hypertext help program supplied with the StrongED text editor, which is now once again shareware. This is an excellent editor and I would recommend it to anyone.
  73.  
  74. RMAManager
  75. ¨¨¨¨¨¨¨¨¨¨
  76. Another piece of software I can recommend to you is RMAManager by Topix. What RMAManager does is return free memory pages in the RMA, in other words it stops RMA fragmentation. If you send me a disc and SSAE or email me I’ll send you a copy or you can get it from the Datafile on disc UT140.
  77.  
  78. Risc OS 2
  79. ¨¨¨¨¨¨¨¨¨
  80. ModCtrl was written on and for Risc OS 3.1 but it does work on Risc OS 2. The only differences are:
  81.  
  82. • Doesn’t display the submenu icon.
  83. • Doesn’t display any help for keywords in a task window unless a task window server has been set up.
  84. • Some of the characters (¨ and ’ and •) in this help file look stupid.
  85.  
  86. These things could be fixed for Risc OS 2 but quite honestly I can’t be bothered as I don’t know anyone who still uses Risc OS 2, and if you do you should upgrade and stop spouting crap about it not being a good investment. Soon programmers will start to give no support for RO2 at all, as they simply won’t be able to test the software on RO2.
  87.  
  88. Conditions
  89. ¨¨¨¨¨¨¨¨¨¨
  90. This application may be distributed freely so long as no profit is made from it in any way, and that it is not tampered with in any way, ie ALL FILES ARE LEFT INTACT AND UNTOUCHED, and no extra files are added.
  91.  
  92. The copyright remains mine at all times.
  93.  
  94. Contacts
  95. ¨¨¨¨¨¨¨¨
  96. How to contact me:
  97.  
  98. email: S.Hatliff@ed.ac.uk
  99.  
  100. snail: Simon Hatliff
  101.        4 Elmlands Grove
  102.        Stockton Lane
  103.        York
  104.        YO3 OEE
  105.  
  106. phone: +44 (0)131 668 4695 during term time
  107.        +44 (0)1904 425702 during holidays
  108.  
  109. wwweb: http://www.ed.ac.uk/~simh/
  110.  
  111. Credits
  112. ¨¨¨¨¨¨¨
  113. Thanks to the authors of the following modules :
  114.  
  115.         WimpExtension   2.18 © Jon Ribbens of DoggySoft, 1993
  116.  
  117. The desktop task was designed and programmed by myself.
  118.  
  119. © Simon Hatliff 1994
  120.  
  121. This help file, as all code, was written and edited in StrongED.