home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / t / taskensure / !Help next >
Text File  |  1996-01-14  |  6KB  |  127 lines
  1. +---------------------------------------------------------------------------+
  2. |                         TaskEnsure, version 1.00                          |
  3. |                       © DizzyWizard Software 1996.                        |
  4. |                       By William Gibbons, 14-01-96                        |
  5. +---------------------------------------------------------------------------+
  6.  
  7. Introduction
  8. ~~~~~~~~~~~~
  9. TaskEnsure is a small transient utility similar in function to the built-in
  10. *RmEnsure command. Instead of checking for the presence of a modle however
  11. TaskEnsure checks for the presence of a WIMP task (hence the name!). This is
  12. extremely useful for command scripts etc., and in !Run files of applications.
  13.  
  14. How to use TaskEnsure
  15. ~~~~~~~~~~~~~~~~~~~~~
  16. TaskEnsure is supplied in the form of a transient utility. This can be called
  17. from the command line in the following way:
  18.  
  19. *TaskEnsure ["]<taskname>["] [<*command>]
  20.  
  21. We recommend you place TaskEnsure inside your library directory if you wish
  22. to use it from the command line on a regular basis, as this saves typing in
  23. the full pathname of the utility everytime you wish to use it. If you do not
  24. have a library directory and are unsure of their use, please consult the
  25. Risc OS 3 User Guide that came with your computer.
  26.  
  27. The utility checks for the task <taskname> as supplied when it is run. If
  28. this task is not present, and a star command has also been specified in the
  29. command string, that command will be executed. If a star command has not been
  30. specified and the task is not present then a short on-screen message will be
  31. printed reflecting this fact.
  32.  
  33. The optional quote marks can be used to delimit the taskname. This is so that
  34. TaskEnsure can be used with tasks that contain spaces in their names.
  35. Although not the norm, such tasks are not uncommon and can still be detected
  36. using TaskEnsure in this way.
  37.  
  38. Example - to ensure that !Paint is loaded, you could use:
  39.  
  40. *TaskEnsure Paint Filer_Run Resources:$.Apps.!Paint
  41.  
  42. Or you could use:
  43.  
  44. *TaskEnsure "Paint" Filer_Run Resources:$.Apps.!Paint
  45.  
  46.  
  47. Credits
  48. ~~~~~~~
  49. Thanks to James Larcombe who is writing this documentation. *8-D
  50.  
  51.  
  52. History
  53. ~~~~~~~
  54. 1.00 (14-01-96) - First release version
  55.  
  56.  
  57. Legal
  58. ~~~~~
  59. This utility is FREEWARE. That means that you can distribute it freely, as
  60. long as no more than nominal media costs are charged. In other words, most
  61. PD libraries should be OK apart from Skyfall PD, who we would ask to refrain
  62. from distributing this and any of our other software. You can upload it to
  63. BBSes provided nothing is changed and *this file remains with the
  64. application*! AT ALL TIMES, no matter who distributes it, the copyright
  65. remain with © DizzyWizard Software 1995. OK? Oh, and also, we take no
  66. responsibility for any loss of data or other damage incurred whilst this
  67. software is in use. It shouldn't happen, but if it does, don't blame us!
  68.  
  69. This utility can also be distributed with 3rd party applications, as long as
  70. we are explicitly credited with it's copyright in the helpfile. In such cases
  71. this document need not be distributed with the utility. If you are going to
  72. distribute this utility with a commercial application, please contact
  73. DizzyWizard Software first. NOTE however that this is the ONLY time the
  74. utility may be distributed without this helpfile!
  75.  
  76. DizzyWizard Software
  77. ~~~~~~~~~~~~~~~~~~~~
  78. DizzyWizard Software is a group of programmers, artists and musicians who
  79. enjoy creating software for Acorn's 32-bit machines. Although primarily a PD
  80. group, we also have some commercial software in development, and would be
  81. happy to consider any programming work anyone may have on offer.
  82.  
  83. To contact DizzyWizard Software for general enquiries, software support or
  84. to obtain our latest catalogue (a must!) please contact us using one of the
  85. following methods:
  86.  
  87. Contacting DizzyWizard Software
  88. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  89.  
  90. Internet: dizzywiz@digibank.demon.co.uk
  91.  Fidonet: "Dizzy Wizard Software" at 2:257/501.0
  92.      BBS: User #1462 ("Dizzy Wizard Software") on the Digital Databank BBS
  93.      Fax: (01752) 253388
  94.      WWW: http://www.warwick.ac.uk/~esvwh/dws/index  - UNDER CONSTRUCTION!
  95.  
  96.  
  97. We also have software support areas on several bulletin boards, including
  98. the Digital Databank BBS.
  99.  
  100.   +-------------+---------------------------------------------------------+
  101.   |BBS..........|Digital Databank BBS                                     |
  102.   |Sysop........|John A Stonier (Internet: jstonier@digibank.demon.co.uk) |
  103.   |Location.....|Welwyn Garden City, Hertfordshire, UK.                   |
  104.   |FidoNet......|2:257/501.0                                              |
  105.   |Internet.....|@digibank.demon.co.uk                                    |
  106.   |Line 1.......|(0707) 329306 / 300-28.8k / MNP 1-5(v42/42bis) / 23 Hrs  |
  107.   |Lines 2/3/4..|(0707) 323531 / 300-14.4k / MNP 1-5(v42/42bis) / 24 Hrs  |
  108.   |Data Format..|8 bits, No parity 1 Stop bit                             |
  109.   +-------------+---------------------------------------------------------+
  110.   |                 (Acorn Information at your Fingertips)                |
  111.   +-----------------------------------------------------------------------+
  112.  
  113. Individual contact addresses can be obtained by emailing us at the address
  114. shown above or by logging on to the Digital Databank.
  115.  
  116. I can be contacted individually by post at the following address:
  117.  
  118. William Gibbons,
  119. 52 Hurst Park Avenue,
  120. Cambridge,
  121. CB4 2AE.
  122.  
  123. Watch out for more DizzyWizard Software productions in the near future...
  124. consult our catalogue for more information.
  125.  
  126.  
  127. DizzyWizard Software hope you enjoy using TaskEnsure, v1.00.