home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / acc / general / rmsbt121 / rmsbt121.txt < prev   
Text File  |  1990-12-31  |  17KB  |  326 lines
  1.                         RMS Boot v1.2 Docs
  2.  
  3.      RMS_BOOT.ACC is a read-only control panel (ROCP), plus an 
  4. auto-prompting time-date entry facility.  Its origin dates back to 
  5. my TD2X.ACC, and the current version is the result of feedback 
  6. from users who wanted additional features.  It is shareware; 
  7. please see the notice at the end of these docs.
  8.  
  9.                    The rationale behind an ROCP
  10.  
  11.      TOS does not automatically set various parameters when you 
  12. power-up or reset your ST.  In addition, the 520ST and the 1040ST 
  13. do not include a battery-powered clock.
  14.      The solution which Atari provides is CONTROL.ACC, working in 
  15. conjunction with a DESKTOP.INF file.  It initializes parameters at 
  16. power-up and reset, and when selected from the Desk menu, it 
  17. allows you to view/set the system clock.  You can also change 
  18. parameters loaded in from DESKTOP.INF.
  19.      CONTROL.ACC has several shortcomings.  It uses over 20K of 
  20. RAM, and it does not automatically prompt you to enter the time 
  21. and the date.  Moreover, most of the time you only use it as an 
  22. ROCP; you seldom change the parameters.
  23.  
  24.                     Why set the system clock?
  25.  
  26.      When a file is saved to disk by the ST, it has a time-date 
  27. stamp attached to it.  At power-up, the default is 12:00 AM on the 
  28. date of creation of the TOS version in your ST.  Having the actual 
  29. time and date appear on a file can be a convenience.  Furthermore, 
  30. hard drive back-up programs may allow you the option to back up 
  31. only from a certain date forward.  If your files don't have the 
  32. correct time-date stamp, they will not be backed up.
  33.  
  34.                         Using RMS_BOOT.ACC
  35.  
  36.      When you power-up or reset your ST, you will be greeted with 
  37. a dialog box.  At the top is the title and the version number of 
  38. the accessory, with a copyright notice below it.  Immediately 
  39. below that is a display of the free RAM available.  If you are now 
  40. using a special accessory just to display the free RAM, then you 
  41. can discard it.  This will free up an accessory slot; it will also 
  42. save you several KB of RAM.
  43.      Next is the time-date box.  Entering the time and the date 
  44. follows standard GEM procedures.  The up-arrow and the down-arrow 
  45. keys will toggle you between the time field and the date field.  
  46. The left-arrow and the right-arrow keys will move you one 
  47. character in the indicated direction.  The [Delete] key will erase 
  48. the character under the cursor, and move the characters to the 
  49. right of the cursor one space to the left.  The [Backspace] key 
  50. will move the cursor one space to the left, delete the character 
  51. under its new position, and move the characters to the right of 
  52. the cursor one space to the left.  The [Esc] key will erase all 
  53. the characters in the field and place the cursor at the start of 
  54. the field.
  55.      Time entry is in AM-PM format.  (The colon and the "M" are 
  56. defaults; do not enter them.)  Date entry is in USA-standard 
  57. mm/dd/yy format.  (The slash bars are defaults; you do not need to 
  58. enter them.)  Leading zeros are required.  Due to a bug in TOS, I 
  59. have limited the year entry to 85 through 99.
  60.  
  61.                       "The Better MouseTrap"
  62.  
  63.      When mousing-around on the desktop or inside an application, 
  64. we've all encountered the frustration of accidentally moving the 
  65. mouse into the menu bar.  An unwanted menu drops down, and we have 
  66. to move the mouse outside the menu and click on the left button to 
  67. get it to disappear.
  68.      Back in the Fall 1986 issue of "START", Daniel L. Moore and 
  69. David Small introduced a solution.  "MouseTrap", a program which 
  70. ran in the AUTO folder, made it necessary for the user to depress 
  71. the right mouse button in order to enter the menu bar.
  72.      The program had several shortcomings which I have corrected 
  73. with "The Better MouseTrap".  Below the time-date is a box which 
  74. allows you to install or to remove the mousetrap at will.  It does 
  75. not use any absolute low-RAM addresses, so it is compatible with 
  76. all versions of TOS.  It also does not interfere with an 
  77. application's setting of a new mouse interrupt routine.
  78.      When the mousetrap is enabled, press and hold down the right 
  79. mouse button when you enter the menu bar.  Then release the right 
  80. mouse button; otherwise, when you traverse the menu headings, the 
  81. menus will not drop down.
  82.  
  83.                        Marching bravely forward
  84.  
  85.      The button marked "ENTER" terminates the dialog box.  Just 
  86. click the left mouse button in it, or press the [Return] or the 
  87. [Enter] key.
  88.      RMS_BOOT.ACC now checks for an illegal entry in the time and 
  89. the date fields.  (Yes, it even checks for 02/29/XX in non leap-
  90. years.)  An illegal entry will cause the dialog box to be 
  91. displayed again so that you can correct your mistake.
  92.      This is where things get interesting.  An alert box asks if 
  93. you want to change all the parameters, the color palette only, or 
  94. none at all.  The default is "Cancel"; just click in it, or press 
  95. [Return] or [Enter].
  96.      If you choose "All", another alert box appears to warn you 
  97. that you may lose your work session or crash your ST if you are 
  98. using your printer or your modem.  If you choose "Cancel", then 
  99. you will return to the original alert box.
  100.      If you choose "Continue", then you will see the familiar GEM 
  101. file selector.  The default path is the root directory of the 
  102. drive from which RMS_BOOT.ACC was loaded.  (This is just one of 
  103. several reasons that RMS_BOOT.ACC should be in the root directory 
  104. of your boot drive.  See notes on MultiDesk, below.)  The default 
  105. filename is "DESKTOP.INF".  Clicking on "Cancel" gives you one 
  106. final chance to bail out; you will return to the original alert 
  107. box.
  108.      Using standard GEM procedures, select the file that you want.  
  109. If you choose a file which is not in DESKTOP.INF format, then you 
  110. will be notified by an alert box, and you will be returned to the 
  111. file selector.
  112.      Once you select a legitimate DESKTOP.INF-format file, 
  113. RMS_BOOT will read it from disk and set all parameters according 
  114. to the values in the file.
  115.  
  116.                         An off-color story
  117.  
  118.      If you choose "Colors" from the original alert box, or if you 
  119. have already set new parameters, then you will see another alert 
  120. box.  As before, "Cancel" is the default.
  121.      "From disk" takes you to the file selector.  As always, 
  122. selecting "Cancel" gives you another chance to bail out; you will 
  123. be returned to the original alert box.
  124.      The same error-checking as above will be applied to the file 
  125. that you selected.  Once you select a legitimate file, RMS_BOOT 
  126. will load it; however, only the color palette will be set.
  127.      The "Default" selection will set the color palette to Atari's 
  128. palette provided in the DESKTOP.INF file which came with my ST.  
  129. It is not the same as that in the disassembly in ABACUS' 
  130. "Internals".
  131.      Any changes that you make to the parameters and/or to the 
  132. color palette are automatically copied to the system desktop 
  133. buffer.  The next time that you save the desktop, they will be 
  134. saved in the DESKTOP.INF file to the root directory of your boot 
  135. drive.
  136.      At this point, RMS_BOOT returns control of your ST to you.  
  137. It can be re-invoked at any time from the desktop or from within 
  138. any GEM application which allows accessories.
  139.  
  140.                          The ROCP itself
  141.  
  142.      RMS_BOOT.ACC sets the following parameters:
  143. 1)  The baud rate and the flow control for the serial (aka modem 
  144. aka RS-232) port,
  145. 2)  The various parameters for the parallel (aka printer aka 
  146. Centronics) port,
  147. 3)  The color palette,
  148. 4)  The keyboard attack rate (the delay between a keypress and the 
  149. start of keyboard repeat),
  150. 5)  The keyboard repeat rate,
  151. 6)  The mouse double-click rate,
  152. 7)  Keyclick on/off, and
  153. 8)  Bell on/off.
  154.  
  155.                        Comments and caveats
  156.  
  157.      RMS_BOOT.ACC is compatible with all versions of TOS 1.0 (ST 
  158. TOS), TOS 1.2 (Mega TOS), and TOS 1.4 (Rainbow TOS), whether in 
  159. ROM or loaded from disk.  (With one exception -- the May 1985 
  160. version of TOS 1.0 on disk.)  It is not intended for use with TOS 
  161. 1.6 (STe TOS); it does not support the extended color palette of 
  162. the STe.
  163.      TOS 1.4 introduced a new file selector.  In addition to many 
  164. bug fixes, it now sports 16 drive buttons.  It is no longer 
  165. necessary to use the keyboard to enter a new drive number in the 
  166. "Directory" line.
  167.      Furthermore, there is an additional call to invoke the file 
  168. selector.  A programmer may choose to have his own text replace 
  169. the "FILE SELECTOR" which normally appears at the top of the box.
  170.      RMS_BOOT.ACC takes advantage of this new call.  If you click 
  171. on "All" in the "Load new parameters:" alert box, then you will be 
  172. prompted with "Load parameters from disk:".  Likewise, "Load color 
  173. palette from disk:" will prompt you when you click on "From disk" 
  174. in the "Load new color palette:" alert box.
  175.      If you have TOS 1.0 or 1.2, then the standard file selector 
  176. will appear, with "ITEM SELECTOR" at the top.  RMS_BOOT.ACC checks 
  177. the TOS version to ensure compatibility.  I have also tested it 
  178. with several custom file selector programs; no conflicts have 
  179. arisen.
  180.      In fact, I've taken it a step farther.  Charles F. Johnson's 
  181. excellent shareware file selector, "Little Green Selector", allows 
  182. programmers to pass strings to it.  These strings replace the 
  183. normal:
  184. ----------------
  185. | Little Green |
  186. |   Selector   |
  187. ----------------
  188. in the upper right-hand corner of his selector.  So if you use 
  189. Charles' program with TOS 1.0 or TOS 1.2, then RMS_BOOT.ACC will 
  190. prompt you with:
  191. ----------------
  192. |   Load new   |
  193. | parameters:  |
  194. ----------------
  195. or:
  196. ----------------
  197. |   Load new   |
  198. |   palette:   |
  199. ----------------
  200. at the appropriate times.  And with TOS 1.4, the same prompts 
  201. which appear in the standard file selector will be displayed in 
  202. the Little Green Selector.
  203.       When RMS_BOOT.ACC executes, it steals the system mouse 
  204. handler vector for use with its mousetrap.  It plays by all the 
  205. rules of good programming practice.  Installing and removing the 
  206. mousetrap involves a special technique of self-modifying code; 
  207. this makes it compatible with virtually any GEM program.
  208.      You can repeatedly invoke RMS_BOOT.ACC from the Desk menu of 
  209. any well-behaved GEM application, install or remove the mousetrap, 
  210. or change all parameters or the color palette only, without any 
  211. problems.
  212.      Unfortunately, my favorite spreadsheet, "Analyze! v2.03", is 
  213. not a well-behaved program.  If you invoke RMS_BOOT.ACC from 
  214. Analyze!'s Desk menu, then it will lock up, and you will have to 
  215. reset your ST (and lose any work that you've already done).
  216.      You should not run RMS Boot from within CodeHead Software's 
  217. "MultiDesk".  If you configure MULTDESK.ACC to automatically load 
  218. and execute RMS_BOOT.ACC, then the two programs will behave 
  219. predictably together.
  220.      However, if you subsequently unload RMS_BOOT.ACC, then you no 
  221. longer have access to it.  In addition, after unloading it, 
  222. loading in another accessory -- or even reloading RMS_BOOT.ACC -- 
  223. will overwrite the mousetrap code, and your ST will lock up or 
  224. crash.
  225.      Likewise, if you run RMS_BOOT.ACC from MULTDESK.PRG, then 
  226. when you terminate MultiDesk and load another application, the 
  227. same thing will happen.
  228.      In other words, RMS Boot and MultiDesk are not inherently 
  229. incompatible with one another.  They can be simultaneously 
  230. coresident in RAM, without any negative interaction whatsoever.  
  231. It is the use of MultiDesk's powerful ability to load and unload 
  232. accessories which leads to the conflict between the two programs.
  233.      The bottom line is this:  As its name implies, RMS_BOOT.ACC 
  234. is meant to execute every time that you boot -- that is, power-up 
  235. or reset -- your ST.  It is also meant to remain resident in RAM, 
  236. so that you can invoke it at any time from the Desk menu of a GEM 
  237. application -- including, of course, the desktop.  So to get the 
  238. most from it, please copy it to the root directory of your boot 
  239. drive -- where it belongs.
  240.      Good sense dictates that there are times that the mousetrap 
  241. should be removed before running some TOS programs.  Using GFA 
  242. BASIC's menu system, for example, would be a royal pain if the 
  243. mousetrap were installed.
  244.      By the way, time-date entry always sets the seconds to zero.  
  245. Repeatedly resetting your ST or selecting RMS_BOOT.ACC from the 
  246. Desk menu will gradually cause your ST's clock to lose minutes 
  247. unless you re-enter the time.
  248.  
  249.                           RMS Boot v1.21
  250.                           Upgrade notes
  251.  
  252.      For RMS Boot v1.21, I optimized a couple of sections of code 
  253. to save a few bytes of memory and to speed execution by several 
  254. microseconds.  No big deal; by themselves, these changes don't 
  255. justify release of a new version.  The real reason for the upgrade 
  256. is to distribute this addendum to the original docs.
  257.      Some programs use the right mouse button for their own 
  258. purposes.  "Hotwire", for instance, responds to a quick single-
  259. click of the right button to kick it into action and display its 
  260. menu.  And "Flash" uses a right button press to toggle between its 
  261. TOS terminal screen and its GEM program screen.
  262.      At first thought, it would seem obvious that RMS Boot's 
  263. moustrap, when installed, would be incompatible with such 
  264. programs.  This is not the case, however; you just have to "fool" 
  265. them into ignoring the right mouse button.
  266.      Codehead's John Eidsvoog was kind enough to clue me in to how 
  267. Hotwire is invoked.  If you press the right mouse button, and then 
  268. you release it within about 1/3 of a second, Hotwire takes over.  
  269. If you hold the button down longer than that, though, Hotwire 
  270. ignores it.
  271.      To enter the menu bar when both Hotwire and my mousetrap are 
  272. installed, press the right button, move the mouse arrow into the 
  273. menu bar, and hold the button down for about half a second.  (It 
  274. sounds like more effort than it really is.  In actual practice, 
  275. for most users this mouse action would take that long anyway.)
  276.      Flash presents a different challenge: it responds when you 
  277. first press the right mouse button.  If you want to use the GEM 
  278. screen's menus, then you have to "sneak" the mouse into the menu 
  279. bar before Flash gets a chance to respond to the right button..
  280.      The trick is to move the arrow up to the bottom of the menu 
  281. bar directly below a menu title.  While continuing to move your 
  282. mouse, press the right button.  The mouse will enter the menu bar, 
  283. and a menu will immediately drop down.  You can then release the 
  284. button and move the mouse arrow to eny menu title that you want.  
  285. GEM's menuing system will work normally, and as long as a menu is 
  286. displayed, Flash will ignore the right mouse button.
  287.      This solution for Flash works equally well for Hotwire, too  
  288. -- just be sure to hold the right button down for about half a 
  289. second.  In fact, after a few times, this mouse motion becomes 
  290. automatic.  I quickly got into the habit of entering the menu bar 
  291. this way all the time.  This is the reason that I didn't notice 
  292. the problems until they were pointed out to me.
  293.      Thanks to Norm Weinress for bringing these anomalies to my 
  294. attention.
  295.  
  296.                             Conclusion
  297.  
  298.      RMS Boot was written in 100% assembly language.  It occupies 
  299. only 4K of disk space and less than 5K of RAM.  It uses an 
  300. imbedded, hard-coded resource; there is no separate .RSC file.  
  301. (This thanks to a terrific program by John Eidsvoog, which he may 
  302. some day decide to release.)
  303.      RMS Boot is copyright 1991 by Maloney and Red Menace! 
  304. Software.  It may be distributed freely, provided that this text 
  305. file accompanies it.  It may not be sold for profit, nor may it be 
  306. included with a commercial software package without the express 
  307. written permission of the author.
  308.      As I stated at the beginning, RMS Boot is shareware.  For 
  309. those unfamiliar with the concept, shareware is "try-before-you-
  310. buy" software.  Unlike commercial software, if you test shareware 
  311. and find it not to your liking, then you haven't wasted your 
  312. money.
  313.      On the other hand, if you want to continue to use it, then 
  314. you are expected to pay for it.  The cost is usually nominal; it 
  315. does not begin to reward the programmer for his efforts.
  316.      If RMS Boot meets with your approval, then please send a 
  317. check for $15.00 (in U.S. funds), payable to "Maloney" to:
  318.  
  319.                          Maloney
  320.                          6245 Kester #40
  321.                          Van Nuys, CA  91411
  322.                          U.S.A.
  323.  
  324.      Thank you for your support!
  325.  
  326.