home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilsd / dismounter / !Help next >
Text File  |  1995-03-07  |  4KB  |  116 lines
  1. Instructions for Dismounter by Andrew Sellors (v0.05 Release 2)
  2.  
  3. *****************************************************************************
  4. * NOTE:                                                                     *
  5. * Dismounter is FreeWare.                                                   *
  6. * This means that you may freely copy and distribute it, provided that it   *
  7. * is complete with all original files, and that you do not sell it.         *
  8. * PD libraries may charge a nominal fee for the cost of duplication,        *
  9. * postage etc.                                                              *
  10. * In no circumstances shall the author be liable for any damage, loss of    *
  11. * profits, time or data or any indirect or consequential loss rising out of *
  12. * the use of this software or inability to use this software.               *
  13. *****************************************************************************
  14.  
  15. Contents:
  16. ---------
  17.  
  18. Aims
  19. Compatibility
  20. Operation
  21. Technical Details
  22. Contacting the author
  23.  
  24. ********************************************************************************
  25.  
  26. Aims:
  27. -----
  28.  
  29. The module "Dismounter" allows ADFS floppies to be dismounted by clicking with
  30. the Adjust button over the drive icon on the iconbar.
  31.  
  32. ********************************************************************************
  33.  
  34. Compatibility:
  35. --------------
  36.  
  37. This program is for RISC OS 3 only.
  38. It has been tested on both RISC OS 3.10 and RISC OS 3.50 and should work with
  39. RISC OS 3.00 although I cannot guarantee it as it hasn't been tested with this
  40. version of the OS.
  41.  
  42. ********************************************************************************
  43.  
  44. Operation:
  45. ----------
  46.  
  47. Simply double click on the module or *Filer_Run it when the Desktop is running.
  48.  
  49. NOTE: The desktop must be running when program is loaded as it needs to find out
  50.       taskhandle of the ADFSFiler to work.
  51.       
  52. If you want to load in when the computer is turned on the put the *Filer_Run
  53. command in your !Boot file, but this must be a "Desktop" file and not an "Obey"
  54. file as the desktop must be running when the program is loaded.
  55. Eg.
  56.  
  57.   Filer_Run <Boot$Dir>.Modules.Dismounter
  58.  
  59. Where <Boot$Dir> points to a directory containing a Modules dir. with
  60. Dismounter in it.
  61. Note: This line works on RISC OS 3.1, thanks to all who emailed me with
  62.       their problems.
  63.       
  64. If you have a Risc PC then you can copy it into !Boot.Choices.Boot.Tasks. and
  65. it will be loaded when the computer boots. 
  66.  
  67. ********************************************************************************
  68.  
  69. Technical Details:
  70. ------------------
  71.  
  72. The source for the module is included in the BASIC file "Source". It can be
  73. assembled by double clicking on the "Assemble" file.
  74.  
  75. The module works by scanning all the names of all the tasks when started and
  76. finding the taskhandle of the one named "ADFSFiler". (an error is generated
  77. and the module quits if it is not found).
  78.  
  79. This taskhandle is then used to install a post Wimp_Poll filter on the
  80. ADFSFiler.
  81.  
  82. The filter checks the return code from Wimp_Poll and if it is a mouse click
  83. then it checks to see if it was with the Adjust button. If it was then the text
  84. in the icon is checked to see if it is a floppy drive and which drive it is so
  85. that it can be dismounted.
  86.  
  87.  
  88. This program was originally going to be a wimp task so that it could catch the
  89. ADFSFiler when it starts up and dies but I never got that far and I abandoned
  90. it. 
  91. After transferring several large Replay files via DOS discs (which needed to be
  92. dismounted after each one because they were all called "Untitled"), I realised
  93. that even in this state, the program is very useful so that is why I am 
  94. releasing it now.
  95.  
  96. ********************************************************************************
  97.  
  98. Contacting the author
  99. --------------------
  100.  
  101. I, Andrew Sellors, can be contacted either at
  102.    57 Boundaries Road
  103.    Feltham
  104.    Middlesex
  105.    TW13 5DR
  106.  
  107. Or via Internet email at
  108.    k946949@king.ac.uk
  109.  
  110. Any feedback from users (bugs reports, requests for new features, praise,
  111. money etc.) is gladly received. 
  112.  
  113.  
  114.  
  115.  
  116.