home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / utilities / multiobey_1 / !MultiObey / !Help < prev    next >
Text File  |  1994-09-19  |  8KB  |  166 lines
  1. Multitasking Obey version 1.10
  2. © Sam Kington 10th August 1994
  3. This program is freeware, *not* public domain – i.e., I retain copyright (see
  4. “Boring legal message”)
  5.  
  6. What this program does
  7. **********************
  8.  
  9.    This program, as it’s name suggests, allows you to multitask Obey files,
  10. allowing the Desktop time to catch up between each line. It is best suited to
  11. medium or long files that spend quite a lot of time on each line – such as
  12. Boot files, or Obey files that do a lot of file copying. However, it will slow
  13. down considerably long files, with lines that execute very rapidly – setting
  14. variables, for instance – and isn’t worth it for short files. On no account
  15. should you use it on files that set the WimpSlot (such as !Run files), and
  16. therefore it will refuse to run a !Run or !Boot file.
  17.  
  18.    When given a file to run, it steps through it line by line; when it finds a
  19. “useful” line (i.e. one that is neither blank or a comment), it starts that
  20. command as a new Wimp Task (using Wimp_StartTask), and updates the progress
  21. window to hold the text of the line just executed, an appropriate icon, and
  22. updates the slider to give some idea of the amount of the file still to come.
  23.  
  24.    The advantage of MultiObey over Obey files or Desktop files is that it gives
  25. you a (hopefully) useful idea of where you are in the file and what is
  26. happening; as it fully multitasks, it allows tasks that have been started up
  27. by the file to put their icons on the icon bar, update the screen, etc. etc.,
  28. so you can see something is happening. This is especially useful for Boot
  29. sequences, as mentioned earlier.
  30.  
  31. Using Multi Obey
  32. ****************
  33.  
  34.    There are two different ways to make MultiObey run a file. The first is to
  35. set an Obey file to type MultObey (type &212 - NB:this is not a registered
  36. filetype). Running, double-clicking or Filer_Running the file will pass it to
  37. MultiObey. The second is to run the command MultiObey <file>, if you want to
  38. force MultiObey to run a file of a different type.
  39.  
  40.    Warning: although it is possible to set MultiObey to run all Obey files, by
  41. running the command Set Alias$@RunType_FEB MultiObey %*0 (replace the % by %%
  42. if this is in an Obey file), there are very good reasons why you would not
  43. want to do this: not only are all Obey files not appropriate for the
  44. multitasking treatment (see above), but some Obey files do not take kindly to
  45. being multi-tasked, and complain, or hang the machine. I don’t know whose
  46. fault this is (it’s probably mine), but you have been warned.
  47.  
  48.    In other words, although MultiObey is primarily designed to be a
  49. multitasking Boot, you may have fatal errors which hang the machine from time
  50. to time. Sometimes they go away if you restart the machine, sometimes they go
  51. away if you change the order of the commands in the file. Most programs aren’t
  52. expecting to be run from a multitasking boot file, and while you should hardly
  53. ever have any problems, you have been warned: this is a complex process that
  54. can sometimes go wrong. Exactly how complex it is can be measured by pausing
  55. the process, watch the disc continue to whirr, and then notice the
  56. applications that had already been started, only now be initialised:
  57. MultiObey has moved on to other things, but the processes it has started up
  58. haven’t finished yet.
  59.  
  60. Advanced features
  61. *****************
  62.  
  63.    Apart from sitting back and enjoying the view, there are four buttons you
  64. can click on for more control over the process:
  65.    • Abort        : Stops everything, closes the window.
  66.    • Skip         : Skips this line, moves to the next one. Only useful if
  67.                     Pause is  on (see below).
  68.    • Step through : When selected, allows you to step through the file line by
  69.                     line, rather than them all being executed one after the
  70.                     other.
  71.    • Pause        : Pauses execution of the file; the button then changes to
  72.                     “Continue”. Clicking on “Continue” continues execution of
  73.                     the file.
  74.    Whatever the situation, the main part of the window will show the next
  75. line to be executed. When Paused, therefore, clicking Skip will skip the
  76. currently shown line and show the next one; clicking Continue will start
  77. execution again at the new line. If Step through is selected, the file will
  78. automatically be Paused after each line; press Skip to move to the next line
  79. or Continue to execute it.
  80.  
  81.    NB: The slider at the top is not necessarily a good indicator of how much
  82. longer the file will take, as it has no idea how long each line will take.
  83. What it actually measures is the position in the file of the current line,
  84. which will be approximately the same as the time taken/remaining if each line
  85. takes approximately the same time. If, however, different lines take very
  86. different times to execute, the bar will move erratically, in jumps.
  87.  
  88. Miscellanea
  89. ***********
  90.  
  91.    You can run several copies of MultiObey at the same time, in which case
  92. the earlier copies are suspended until the latest has finished. The windows
  93. are offset from each other so you can see how many are running at once.
  94.  
  95.    By default, MultiObey will display the name of the file it is processing in
  96. the title bar of its window, centred. However, if the filename gets too long,
  97. it will right-justify it so you can see the leaf-name (presumably you know
  98. the bit at the left). Cunning, cunning...
  99.  
  100. Boring legal message
  101. ********************
  102.  
  103.    This application is freeware, that is, it can be distributed freely as
  104. long as only reasonable charges are made for media and distribution. I retain
  105. copyright on all program code and documentation.
  106.  
  107.    This software is supplied “as is”: I make no warranty, expressed or
  108. implied, of the merchantability of this software or its fitness for any
  109. particular purpose. In no circumstances shall I be liable for any damage,
  110. loss of profits, or any indirect or consequential loss arising out of the use
  111. of this software or inability to use this software, even if I have been
  112. advised of the possibility of such loss.
  113.  
  114.    In other words, if your computer crashes, blows up, you lose all your work
  115. etc. all because of MultiObey (unlikely I know), don’t blame me.
  116.  
  117. About all these strange foreign characters in this file
  118. *******************************************************
  119.  
  120.    OK, so if you’re reading this on a PC or a Mac or another strange machine
  121. like that, you may be wondering what all these strange ae things are. Well,
  122. they’re quotes (sorry, there was another one), dashes, ligatures, etc.
  123. Honest. But not on all machines...
  124.    Basically, character sets are only standard up to character 127, which is
  125. basically alphanumerics and a few standard punctuation marks. Foreign
  126. characters, typographical oddities like quotes and ligatures, and other more
  127. obscure symbols are “non-standard”, and each computer often has its own idea
  128. of where they should go in the character set. So don’t worry: even if it’s
  129. hard to read on your current machine, it won’t be on an Acorn machine. It may
  130. look slightly strange if you’re using the System font, however.
  131.    But why am I using these strange characters in the first place? Well,
  132. they’re in the character set and they look nice in an outine font, and I’ve
  133. written a program called Smart Quotes (sorry for the plug) that substitutes
  134. these sort of characters automatically, and I’ve got it turned on at the
  135. moment...
  136.  
  137. How to contact me
  138. *****************
  139.  
  140. All bug-reports, suggestions, comments or indeed any feedback at all will be
  141. welcomed. Here’s how to get to me:
  142.  
  143. E-mail     : 9262861k@arts.gla.ac.uk, 926286ki@udcf.gla.ac.uk during term-time
  144.              These should be OK until June 1996
  145.              At Christmas, Easter and during the summer, you can get me at
  146.              wombat@altern.com, wombat@email.teaser.com or sam@altern.com, in order
  147.              of preference (that is, if mail bounces off one of these or I don’t
  148.              answer within a week send to the next one).
  149.  
  150. Snail-mail : My term-time address, at least until June 1995, is:
  151.              Sam Kington
  152.              Flat 2/1
  153.              44 Hotspur Street
  154.              Glasgow G20 8NL
  155.              SCOTLAND
  156.              
  157.              Again, a backup is the home address – anything that goes here will get
  158.              to me eventually.
  159.              Sam Kington
  160.              Merlhiot
  161.              24420 Savignac les Eglises
  162.              FRANCE
  163.  
  164. Term-time is October to June, with bits off at Christmas (3 weeks) and
  165. Easter (4 weeks).
  166.