home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / program / a / assembly / StartUp / ReadMe next >
Encoding:
Text File  |  1992-01-26  |  3.7 KB  |  97 lines
  1.  StartUp 0.04
  2.  ------------
  3.  
  4.  Quite a useful little utility this, even if I do say so myself. A friend of
  5. mine wanted to be able to open a Cfs filer window on boot up, but doing a
  6. Filer_OpenDir in his Boot file after a Run !Cfs didn't work, the filer
  7. hadn't been started up yet.
  8.  
  9. [Actually entirely false, thinking about it it wouldn't matter if the filer
  10. hadn't started up and I managed to open a CFSread filer window in my boot
  11. file, one may never know what he was doing]
  12.  
  13.  He wanted to execute * commands IN the desktop automatically, so I wrote
  14. this, which I use myself for my !Boot file, so the desktop is active while
  15. everything sets itself up, especially Pinboard !
  16.  
  17.  StartUp itself is a task, but is much more suited to the Library rather
  18. than a Apps directory, once there you can have in your boot file something
  19. like:
  20.  
  21. Desktop *StartUp -+adfs::Hippo.!BootTasks -cache -cmdtime 4
  22.  
  23.  The - is to mark a parameter, a parameter without a name is taken as the
  24. command or file of commands (a file of commands is marked with a +, else it
  25. is taken as a single command).
  26.  
  27.  If the command contains spaces or only contains letters (in which case the
  28. GetArgs routine things it is a seperate parameter) then surround it in
  29. quotes.
  30.  
  31.  Other parameters are:
  32.  
  33.  -pause sets the time delay between commands in cs. The pause is taken
  34. first, so the command (or first of commands for a file) is only started
  35. after the delay.
  36.  
  37.  -perpoll specifies what the minimum number of commands to perform per poll
  38. is. For a single command, the command is repeated that number of times,
  39. regardless of the -repeat parameter.
  40.  
  41.  -repeat means to repeat the command or file of commands indefinately and
  42. not to quit the task when it gets to the end.
  43.  
  44.  -cmdtime specifies the minimum time the commands (this is only applicable
  45. to command files) will be called for. If -perpoll is specfied aswell, then
  46. the perpoll value is taken first and then the time limit is checked. (ie.
  47. the commands are executed until the perpoll minimum and then the time limit
  48. is checked and then it returns to Wimp_Poll if the time limit is up).
  49.  
  50.  -oscli specifies that the command(s) should be sent to OS_CLI, normally the
  51. command(s) are passed to Wimp_StartTask so they are treated as separate
  52. tasks themselves. Note if they are passed to OS_CLI they are executed in the
  53. StartUp task space.
  54.  
  55.  -cache specifies that if a command file is used that is loaded into memory
  56. and acted upon there, else the file is opened as a file and bytes read as
  57. normal.
  58.  
  59.  
  60.  Once the command (or the file of commands) has come to an end, the StartUp
  61. task quits itself, unless the -repeat parameter is specified.
  62.  
  63.  You can call StartUp itself from a previous StartUp task, thus spurning off
  64. another set of commands.
  65.  
  66.  As an example, the line above starts off my task loading, and setting up
  67. various things, and somewhere in that file while installing tasks it starts
  68. off another StartUp task to install Pinboard, with a slight delay so I can
  69. use the desktop normally while it works its way through all the icons.
  70.  
  71. ..............
  72. ..............
  73. Run adfs::Hippo.$.Apps.!Menon
  74. Run resources:$.Apps.!Alarm Alarms
  75. Run adfs::Hippo.$.DDE.!Make
  76. Run adfs::Hippo.$.DDE.!SrcEdit
  77.  
  78. startup -+adfs::Hippo.Pinboard -pause 10 -cache -oscli
  79.  
  80. Set Reader$Replies adfs::Hippo.Dload
  81. Set Edit$Options f0 b7 l1 m2 h12 w12  a80
  82. ..............
  83. ..............
  84.  
  85.  
  86.  Ideally you wouldn't want everything to startup under this mechanism, as it
  87. can take a while longer, so you would have the above file running normally,
  88. but the Pinboard starting up with StartUp.
  89.  
  90.  
  91. (c)1992 G.W.Babb
  92.  
  93. Normal copyright stuff applies, you can distribute where you want aslong as
  94. it isn't for profit. You must distribute as-is, though the source is
  95. included for your enjoyment, which you may expand upon and distribute as you
  96. please.
  97.