home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / utilities / starttask / !StartTask / !Help < prev    next >
Encoding:
Text File  |  1990-11-24  |  9.8 KB  |  265 lines
  1. >!StartTask.!Help
  2.  
  3.                                  StartTask
  4.                                  =========
  5.  
  6.                         Multiple Application Loader
  7.  
  8.                  Package Version 0.82, Document Version 0.23
  9.  
  10.                   (C) Martyn S. Lovell 11th October 1989
  11.  
  12. Contents
  13. ========
  14.  
  15. 1. Introduction
  16.  
  17. 2. Using StartTask 
  18.  
  19.   2.1 Before using StartTask
  20.   2.2 Making task lists
  21.   2.3 Executing task lists
  22.   2.4 Menu Options
  23.  
  24. 3. Program Information
  25.  
  26.   3.1 Version history
  27.   3.2 Thanks
  28.   3.3 Planned changes
  29.   3.4 Notes for users  
  30.   3.5 Shareware information (Please read this)
  31.  
  32.  
  33. 1. Introduction
  34. ===============
  35.  
  36.    StartTask allows the user to start up groups of applications and execute
  37. commands withing the RISC OS desktop. It was designed to provide the same
  38. facility as the -file option of the *Desktop command at any time rather than
  39. just as you enter the desktop. It is also possible to set up files that load
  40. a group of applications when double-clicked and immediately quit StartTask,
  41. making its operation 'invisible' to the user.
  42.  
  43.    This document describes version 0.82 of StartTask, a beta-test copy.
  44. Please report bugs as soon as possible. A full release will come quite soon.
  45. Even if you don't find any bugs I'd be very interested in your comments on
  46. sections 3.3 and 3.4. You can contact using any of the means described in
  47. 3.5.
  48.  
  49. 2. Using StartTask
  50. ==================
  51.  
  52. 2.1 Before using StartTask
  53. --------------------------
  54.  
  55.   You should have a disc with the StartTask icon on it. Double click on the
  56. icon. Click menu on the StartTask icon which is on the right of the icon
  57. bar. Move the pointer out to the right of the option 'Configure' and onto
  58. the sub-option 'Reset'. Click select. Then select 'Quit' from the StartTask
  59. menu. You have now reset StartTask to its initial state.
  60.  
  61. 2.2 Making task lists
  62. ---------------------
  63.  
  64.   A task list is a file containing any commands that can be executed at the
  65. * prompt, including any valid application startup command. You can create a
  66. task list with the !Edit application or with any application that can save
  67. plain text (or ASCII) files.
  68.  
  69.   It's also possible to create a task list that has its own icon. This sort
  70. of list can be executed simply by double clicking on it. To make one, simply
  71. make a text file version and then issue the command.
  72.  
  73.   *SetType <filename> TaskList                     
  74.  
  75.   You should ensure that the StartTask application has been visible in a
  76. window before issuing this command.
  77.  
  78. 2.3 Executing task lists
  79. ------------------------
  80.  
  81.   To execute a task list simply drag its icon the the StartTask icon. You
  82. can initially drag files of type Text, Command or Obey, but you can change
  83. this (see later).
  84.  
  85.   If the task list has its own icon it can be run simply by double clicking
  86. on it. 
  87.  
  88.   It is possible to make a tasklist cause StartTask to quit when the list is
  89. exhausted. Simply add the line |StartTask_Quit (exactly that line, with the
  90. same capitalisation) somewhere in the file. This feature allows you to start
  91. sets of applications at one go and then get rid of StartTask, making its
  92. action invisible. An example might be:
  93.   !Edit
  94.   !Draw
  95.   !DTP
  96.   |StartTask_Quit
  97. to load a set of applications suitable for desktop publishing.
  98.  
  99.   Errors will not stop a task list. If you want to stop a task list
  100. prematurely, press both ALT keys at the same time. (This process will not
  101. work when an error dialog box is visible. In this case you should click OK
  102. and then immediately press both ALT keys at the same time.)
  103.  
  104. 2.4 Menu options
  105. ----------------
  106.  
  107. 2.4.1 StartTask menu
  108.  
  109.   About ...
  110.     Click Select or Adjust to bring up a program information dialog box.
  111.   About ... -> brings up a program information dialog box.
  112.   Configure -> brings up the configure menu
  113.   Quit
  114.     Finish StartTask.
  115.  
  116. 2.4.2 Configure menu
  117.  
  118.   Filetype -> brings up the filetype dialog. You can enter a numeric value
  119. for the TaskList type. After a Reset this is set to 711. Note that if you
  120. have already made some TaskList files you will have to *SetType them again.
  121. The new type takes effect immediately.
  122.   Accept type -> brings up the Accept type menu.
  123.   Reset
  124.     Click Select or Adjust to reset the program configurations to their
  125. initial values. Filetype is set to 711 and the Accept types options are set
  126. to Text, Obey and Command.
  127.  
  128. 2.4.3 Accept type menu
  129.  
  130.   Any type
  131.     When this option is ticked then you can drag any type of file to the
  132. StartTask icon. When unticked the types able to be dragged depend on the
  133. other options. You can change the tick status by clicking Select or Adjust.
  134.   Command
  135.     When this option is ticked command files can be dragged to the StartTask
  136. icon.
  137.   Obey
  138.     When this option is ticked obey files can be dragged to the StartTask
  139. icon.
  140.   Text
  141.     When this option is ticked text files can be dragged to the StartTask
  142. icon.
  143.  
  144. 3. Program Information ======================
  145.  
  146. 3.1 Version history -------------------
  147.  
  148. Version 0.80 20th September 1989
  149.   A pre-release beta test version. Version 0.81 21st September 1989
  150.   Fixed close of about box. Version 0.82 11th October 1989
  151.   Modified icons (thanks, Kevin)
  152.   A few tidyups in the code
  153.    
  154. 3.2 Thanks
  155. ----------
  156.  
  157. I'd like to thank Kevin Turner for making my icon for this look nicer and
  158. for all his support and advice during its development.
  159.  
  160. 3.3 Planned changes
  161. -------------------
  162.  
  163. The following changes are 'in the pipeline':
  164.  
  165.   Automatic centring of About... dialog (waiting for RISC OS PRM)
  166.   New icon?
  167.   Redo type handling?
  168.   Create new tasklist (save dialog)
  169.   It occurred to me that it might be useful to be able to add a line
  170. |StartTask_Wait to a task list. This would bring up a dialog box with
  171. Continue, Stop and Quit buttons in it. This would allow TaskLists to take
  172. some user interaction in the middle. Would anyone find this useful?
  173.   SubLists? |StartTask_Call <fsp> would execute a tasklist then return to
  174. the current one. Would you use this?
  175.   Loops (|StartTask_Do <N>, |StartTask_Next)
  176.   Repeats (|StartTask_Repeat _Until <OS_Variables condition>)
  177.   While...
  178.   |StartTask_Chain <fsp>
  179.   There's a lot I *could* do to make StartTask more versatile - none of the
  180. above would be very hard. Would you like them done? Let me know...
  181.  
  182. 3.4 Notes for users
  183. -------------------
  184.  
  185.   Since this is still in 'beta-test', I'm very interested in user comments.
  186. Things of interest to me are, in particular:
  187.   Can it work in a Slot of less than 32k? I only have a 440 (ahhh ;) ) and
  188. can't test less than 32k.
  189.   Do you think the configure options are useful? What would you add or
  190. remove?
  191.   Any ideas for a better icon?
  192.   Do you like the error handling? What would you prefer? Thanks, in advance.
  193.  
  194. 3.5 Sharware information
  195. ------------------------
  196.  
  197. *** Users of other shareware written by me please note - the text below may
  198. *** look the same as others but it is not. Take a few moments to look through
  199. *** it for differences, please. 
  200.  
  201. *** This has been substantially modified for this RISC OS application.
  202.  
  203. This package contains:
  204. StartTask 0.82 (21st September 1989): RISC OS application
  205.  
  206.    The software contained in this package is Shareware. The word 'Shareware'
  207. means many things to many people, so I'll explain what I mean. In fact, some
  208. people would call this 'freeware' or 'public domain software' but it hardly
  209. matters what you call it - your obligations are set out below.
  210.    The program is free. You may make any number of copies and give them away
  211. to anyone (subject to the condition that you give them ALL the files in the
  212. package). You may not sell this software, or use it otherwise for personal
  213. gain without my permission. If you wish to post it on your Bulletin Board or
  214. include it in your Shareware library then that, too, is fine.
  215.    If you want to add any part of the code or data to one of your programs
  216. for your own use, then that's fine too. If you want to add it to something
  217. you plan to sell, or otherwise release as copyright material (whether for
  218. gain or not) then you'll need my permission - I retain copyright on this
  219. program.
  220.    If you like this program and find it useful then I would appreciate a
  221. small donation of, say, 5 or 10 pounds (since this is the result of quite a
  222. lot of work). This donation is a voluntary contribution.
  223.    If you send a donation and say which version of the package you have then
  224. I will send you an update if there is one. This disc will also contain
  225. up-to-date copies of as much of my shareware as will fit, plus any other
  226. stuff I can fit. There may be no update, since this program is nearing
  227. completion. Thus I don't guarantee that, if you send me money, I'll send you
  228. a new version of the program. You will, however, get a disc with things on
  229. it. If you'd prefer to wait until there is a disc with a new version on it
  230. then please say so. In this case you'll get a thankyou note.
  231.    This program has been tested with RISC OS 2.00.  It is not suitable for
  232. Arthur 1.2.
  233.    This software carries no warranty, either express or implied. I've tested
  234. it and, to the best of my knowledge, there are no bugs. If you come across a
  235. bug then I'd be delighted if you got in touch with me. I can't guarantee to
  236. fix it but I'll probably have a good try. My address is:
  237.         Martyn Lovell
  238.         16, Fairwater Park,
  239.         Barnwood,
  240.         Gloucester.
  241.         GL4 7HF 
  242. No telephone calls please. 
  243. However, I can be contacted as:
  244. Cix:       MartynL 
  245. Janet:     ZCEEB02@UK.AC.UCL.EUCLID 
  246. Interspan: Contact via Janet at above address 
  247. Eureka II: Martyn Lovell (112) 
  248. Note that, during university terms, I read all this EMail sites regularly 
  249. but in the holiday periods I may read them less regularly. 
  250. For bug reports please send the following information:
  251.         Machine Type
  252.         OS Version
  253.         Software Version
  254.         Modules Installed
  255.         Modules Unplugged
  256.         Podules Installed
  257.         Drives Installed
  258.         RAM Available
  259.         Monitor Type
  260.         Other applications installed
  261.         Type of file in use
  262.         Is the bug repeatable?  
  263.  
  264. and everything else that seems relevant.
  265.