home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / utility / rainbow / makefast.txt < prev    next >
Encoding:
Text File  |  1990-01-12  |  5.2 KB  |  109 lines
  1. MAKEFAST.PRG by Ken Badertscher
  2. Copyright 1989, Atari Corp.
  3.  
  4. NEW TOS FEATURE!
  5. ================
  6. One of the new features of Rainbow TOS is the ability to set a program
  7. for "fastload."  This is accomplished by setting a bit in the program
  8. file which tells TOS that the program can be loaded without having all
  9. of memory cleared for it.  Setting programs for fastload is most useful
  10. on machines like Mega 4's with a lot of memory.  Clearing 4 megabytes of
  11. memory can take a significant amount of time - a program set for
  12. "fastload" can start up to a second faster.  That may not sound like
  13. much, but when you're running a program which runs other programs (in, for
  14. example, a programming environment) saving a second on each program load
  15. can add up.  And it makes your ST feel much faster when everything is
  16. loaded seemingly instantaneously.
  17.  
  18. Wot's a fastloadbit?
  19. ====================
  20. Now, we could have told everyone which bit was the fastload bit and
  21. watched everyone whip out their handy sector editors and flip that bit
  22. in each of their programs - but we're not that sadistic.  MAKEFAST is a
  23. program which will set the fastload bit on any program.  It is one in a
  24. series of what I like to call "AlertWare," that is, a program which
  25. does everything via the simplest AES call that exists: form_alert(). 
  26. It is sort of a pain to wade through all those alert boxes, but it's
  27. quick and dirty to program, and it gets the job done.  You do have an
  28. alternative with my AlertWare, though - I try to make things run from
  29. command lines as well as from the desktop.
  30.  
  31.  
  32. From the desktop...
  33. ===================
  34. When you run MAKEFAST from the desktop, it presents you with
  35. (surprise!) an alert box.  The first one asks you if you want to
  36. Continue or Quit.  If you bravely select Continue, you are then
  37. presented with an alert which asks you which function you want to
  38. perform:  MakeFast (set a program's fastload bit), MakeSlow (clear a
  39. program's fastload bit), or Check (see if a program is set for
  40. fastload).  Make a selection, and use the file selector which appears
  41. to select the program to check.  Don't worry if you make a mistake and
  42. select a Spectrum picture instead of a program - MakeFast won't do
  43. anything with files that aren't executable.  It will let you know if
  44. you selected a file which was not an executable program.  Also, if you
  45. try to MakeFast a program which is already set for fastload (or
  46. MakeSlow one which is not set for fastload), MakeFast will leave the
  47. program alone and tell you that there was no change.  After the function
  48. is complete, you're back to the "Continue/Quit" alert box.
  49.  
  50. On a command line
  51. =================
  52. When installed as a TOS Takes Parameters application, or run from a
  53. command line shell, MAKEFAST can be used to manipulate more than one
  54. file at a time.  From a command line shell, type:
  55.  
  56. makefast -h
  57.  
  58. to get a message describing the usage.  Long after you've lost this
  59. doc file, you'll still be able to use makefast -h to remind you how to
  60. run makefast.
  61.  
  62. Note that if you are using makefast as a TTP application, you don't have
  63. to type "makefast" at the beginning of the command line - the desktop
  64. fills in that part of the command for you.
  65.  
  66. To set the fastload bit in file1, file2, and file3, use the command:
  67.  
  68. makefast file1 file2 file3
  69.  
  70. To clear the fastload bit in filea and fileb, use the -Slow option:
  71.  
  72. makefast -s filea fileb
  73.  
  74. To check the fastload bit in all files in a directory, use the -Check option:
  75.  
  76. makefast -c *.*
  77.  
  78. If any of the files are not executable, MAKEFAST will inform you of that fact.
  79. Note that filename wildcards will NOT be expanded if you are running makefast
  80. from the Desktop TTP dialog.  If you are using the TTP dialog, you must
  81. type out all the filenames to check.
  82.  
  83. Why MakeSlow?
  84. =============
  85. Fastloading works because almost all programs don't require that all of
  86. memory be set to zeros when they start up.  What Rainbow TOS does when
  87. it sees a file with the fastload bit set is it only clears as much
  88. memory as the program needs cleared.  The rest of memory is left alone. 
  89. The operative word here, though, is "almost."  Some programs insist on
  90. having all of memory cleared for them, among them is Microsoft Write. 
  91. Don't try to MakeFast Microsoft Write, because it won't work correctly. 
  92. Also, using MakeFast on desk accessories yields mixed results.  BE VERY
  93. CAREFUL when using MakeFast to speed up desk accessory loading.  If you
  94. run into a problem, you can always use MakeSlow to clear the offending
  95. program's fastload bit.
  96.  
  97.  
  98. !IMPORTANT!IMPORTANT!IMPORTANT!IMPORTANT!IMPORTANT!IMPORTANT!IMPORTANT!
  99. !IMPORTANT>                                                 <IMPORTANT!
  100. !IMPORTANT> If you use MakeFast to set the fastload bit on  <IMPORTANT!
  101. !IMPORTANT> any program, DO NOT EXPECT THE PROGRAM TO LOAD  <IMPORTANT!
  102. !IMPORTANT> ANY FASTER IF YOU DO NOT HAVE A RELEASE VERSION <IMPORTANT!
  103. !IMPORTANT> OF RAINBOW TOS.  Other versions of TOS do NOT   <IMPORTANT!
  104. !IMPORTANT> know about the fastload bit, so setting the bit <IMPORTANT!
  105. !IMPORTANT> will have NO EFFECT.                            <IMPORTANT!
  106. !IMPORTANT>                                                 <IMPORTANT!
  107. !IMPORTANT!IMPORTANT!IMPORTANT!IMPORTANT!IMPORTANT!IMPORTANT!IMPORTANT!
  108.  
  109.