home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / utility / elfboot / elfboot.doc < prev    next >
Encoding:
Text File  |  1991-06-04  |  67.6 KB  |  1,253 lines

  1.      
  2.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  3.  
  4.      
  5.      I. INTRODUCTION
  6.  
  7.  
  8.           Thanks for trying ELF-BOOT!, a powerful new startup utility for
  9.      the ATARI ST, from Elfin Magic Software. While there are many startup
  10.      utilities for the ST which go in your auto folder, this is the only one
  11.      that provides a familiar GEM-like interface, complete with mouse 
  12.      pointer, dialog boxes, one click functions, and even a file select 
  13.      window! If you decide not to install ELF-BOOT, because you think your 
  14.      current startup utility is probably just as good, you're really missing
  15.      out! Try it...  I guarantee you'll like it! Finally, I must mention 
  16.      that the user interface is so instinctive, that you may be tempted to
  17.      lay the docs aside. READ THESE DOCS! Otherwise, you'll never get 
  18.      optimum use out of the system.
  19.  
  20.  
  21.                    ***** Important Note on DEMO version! *****
  22.  
  23.           If the your main program file is called "ELFBOOTD.PRG", this is a
  24.      demonstration copy of the program, but don't worry...  It contains
  25.      every single feature that the "registered" version contains.  However,
  26.      a commercial message about shareware has been added to the code.  Which
  27.      brings us to an important point. This program IS a shareware offering.
  28.      In actual use you will find it to be a very complete and thoroughly
  29.      planned application, with features you would expect to find in a
  30.      commercial offering. If you agree and find ELF-BOOT to be a valuable
  31.      asset to your system, you'll want to register your ownership by sending
  32.      $15 to:
  33.  
  34.                       Randy Constan c/o Elfin Magic Software
  35.                         23 Brook Plane, E. Islip, NY 11730
  36.  
  37.  
  38.      In return, You'll receive a copy of the registered version in the mail,
  39.      along with printed documentation (if you request), full support for any
  40.      problems you encounter, and access to updates and revisions at a
  41.      substantial discount. In fact, it is possible that by the time you
  42.      register, more features will have been added! The demo version contains
  43.      a 40 second commercial message, which will appear only 1 out of 4 times
  44.      the program is used.  It is a simple reminder that a lot of time and
  45.      effort went into this product, and shareware authors gotta eat too!
  46.  
  47.  
  48.                            ******** DISCLAIMER ********
  49.  
  50.      Although I (and several 'beta' testers) have beaten the program to
  51.      death forcing every conceivable error, I must hereby state that I nor
  52.      the Elfin Magic company assume any responsibility for lost time or data
  53.      resulting from the use or misuse of ELF-BOOT. The user assumes
  54.      responsibility for backing up his system to prevent such disasters. I
  55.      can only affirm that to the best of my knowledge, the program will
  56.      perform as stated in the docs, and at the time of distribution
  57.      contained no 'viruses' of any kind.
  58.  
  59.  
  60.                THANKS IN ADVANCE FOR SUPPORTING SHAREWARE AUTHORS!
  61.  
  62.  
  63.      
  64.                                      Page 1
  65.  
  66.      
  67.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  68.  
  69.           
  70.      FILES:
  71.  
  72.           Before proceeding, be sure you have all the following files in
  73.      your ELFBOOT package:
  74.  
  75.           ELFBOOT.PRG    Main program (or ELFBOOTD.PRG for demo version) .
  76.           ELFHELP.PRG    Utility to assist in preparing special batch files.
  77.           STARTGEM.PR    A public domain program run utility.
  78.           RAMDISK.PRG    ATARI's public domain reset proof ramdisk.
  79.           RDSET.TTP      A freeware utility from Elfin Magic to set the
  80.                          default drive and size of the ramdisk.
  81.           DESKTOP.L      Some default desktop.inf files for each resolution
  82.           DESKTOP.M
  83.           DESKTOP.H
  84.           ELFBOOT.DOC    The file you're reading.
  85.           README.DOC     May contain last minute changes. Check it out!
  86.  
  87.      ELF-BOOT: What it does...
  88.  
  89.      ELF-BOOT normally resides in the AUTO folder of your hard disk. It can
  90.      also be re-run from the desktop at any time. For maximum utility, it
  91.      also requires that the file "STARTGEM.PR" (notice the  missing "G") be
  92.      placed in the AUTO folder, after ELF-BOOT has been added. When it runs,
  93.      ELF-BOOT will allow you to:
  94.  
  95.           1) Load, and modify up to 50 desktop.inf files. Desktop colors,
  96.              printer configuration, keyboard repeat, delay, bell silence and
  97.              key click can all be controlled, as well the option to confirm
  98.              copies & deletes, and turn disk write verify on or off.
  99.  
  100.           2) Automatically select a default desktop file based on the
  101.              current monitor (color or mono), so that your system can boot
  102.              up properly with no manual intervention.
  103.  
  104.           3) Install an option called 'AUTOCOLOR' which keeps your selected
  105.              desktop colors in place when the system completes it's startup.
  106.              This feature also prevents other applications from changing
  107.              your colors, unless you want them to.
  108.  
  109.           4) Completely eliminate the need for the ATARI control panel desk
  110.              accessory, freeing up 2 valuable 'slots' for other accessories.
  111.  
  112.           5) Enable or disable programs in your AUTO folder.
  113.  
  114.           6) Easily change the order in which programs in your AUTO folder
  115.              will run.
  116.  
  117.           7) Activate any one of up to 50 ASSIGN.SYS files for use with
  118.              GDOS, or prevent any from becoming active.
  119.  
  120.           8) Enable and disable Desk accessories.
  121.  
  122.           9) Automatically transfer any number of files from up to 50 user
  123.              defined lists, from any drive (and path) to an active ramdisk.
  124.  
  125.          10) Cause your ST to run any of 50 preset programs without having
  126.              to double click them from the desktop. As of the time of this 
  127.              writing though, THIS OPTION IS UN-USABLE WITH TOS 1.4. 
  128.              Hopefully, this will soon change.
  129.  
  130.                                      page 2
  131.      
  132.  
  133.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  134.  
  135.      
  136.          11) Create and or activate up to 50 macro files, which can perform
  137.              all the above functions, in one mouse click!
  138.  
  139.          12) View and/or modify the system time and date, for those without
  140.              a real time clock.
  141.  
  142.           Best of all, even though the program runs in an AUTO folder, It
  143.      provides an active mouse, dialog and alert boxes, multiple fonts,
  144.      button click functions, and even displays a file select window with
  145.      scrolling arrows! No, I have not discovered some hidden feature in the
  146.      ATARI to make this possible. Rather, I wrote my own 'mini-GEM' in 100%
  147.      assembly code.  Because of the familiar environment, you'll find that
  148.      in most cases, just guessing what to do will give you the expected
  149.      result. But again.... read _ALL_ the documentation!
  150.  
  151.  
  152.                **********************************************
  153.  
  154.      II. PREPARATION:
  155.  
  156.  
  157.      1) DESKTOP.INF FILES
  158.  
  159.           ELF-BOOT can be used with or without desktop.inf files. But unless
  160.      you're a rare breed that likes ATARI's default lo res. desktop, these
  161.      files are important. The first thing you should do is prepare at least
  162.      one "default" desktop file for each of the 3 normal ATARI resolutions.
  163.      Since many users don't have both color and mono monitors, a sample
  164.      DESKTOP file for each res. is provided on the ELF-BOOT disk, so you can
  165.       accomplish this step even if you have only one monitor.
  166.  
  167.           If you have a color monitor, prepare your own desktop.inf file in
  168.      medium resolution, with the desired colors, window/icon placement, and
  169.      installed applications you desire. If you do not currently use a
  170.      ramdisk, setup an icon for one now.  To do this, just select any disk
  171.      icon, and select "INSTALL DISK" from the desktop menu.  Then, specify
  172.      an unused drive identifier from D: thru  P: at the prompt.  Finally,
  173.      place the new icon in a convenient location on the desktop.
  174.  
  175.           Set up your colors using ATARI's CONTROL.ACC for now.  See your
  176.      ATARI manual for details.  When you've saved the file using the 'SAVE
  177.      DESKTOP' option, rename the file "DESKTOP.M".  Then, close all your
  178.      windows and switch to LO res with the set preferences option from the
  179.      desktop.  When you're satisfied with your LO res setup, again save the
  180.      file, and RENAME it to DESKTOP.L.  If you have a monochrome monitor,
  181.      follow the same procedure, this time renaming the file "DESKTOP.H".
  182.      Finally, switch to the resolution you use most often, set up your
  183.      screen, and do one final DESKTOP save, without renaming the file.  If
  184.      you have only/Çê@6ã⇨ÿÇ`⇧0sπ⇧αôα`Γ③Γb⇩#Ç`pβ⓪ôΓ ⇧3α`Γ③Γ Çb⇧③αÇ③π⇨Ç2|3≤≤≤≤α⇨Ç⇩③αÇ⇧!⇩b0sΓ! ③α`Γ③µ⇦f0◆$⇦sΓ Çb⇧③ββ  éb⇩p<<3≤≤≤≤≤≤≤≤≤αΓ3µ⇦f0◆$⇦sβcü a③α⇧≡sαÇsα`⇧③Γ ⇧3πôΓ Çb③π⇨Ç`b⇩sµf⇧⇦d⇧≡$ä&0<3≤≤≤≤Σé3αÇsΓ Ç"a③α"⓪sαÇsαÇ`sπÇ#Ç`Ç"③αÇsα`③α⇨Ç⇩③β⇧"③αÇr⇧③usable for the
  185.      current monitor type. If not, it will look for the default "DESKTOP.M"
  186.      or "DESKTOP.H" depending on the monitor you're using. Providing the
  187.      program finds a usable desktop file, it will allow the user a chance to
  188.      exit the program immediately, and will automatically copy the file to a
  189.      new DESKTOP.INF file if necessary, when the program exits.
  190.  
  191.  
  192.                                      page 3
  193.  
  194.           
  195.           ELF-BOOT!  by Randy Constan,   Elfin Magic Software/נננבîBFBBFpp≡pנננננ≡pננננננננננéOÇ⇩OÄ⇧äOî⇦ê⇧êOÇ◆נüÇOIJבנÇ⇦êOבüÇ⇧Ä⇧נijGאOëê⇦⇧Ç◆נêé⇧ê⇦AנêÇ⇦≡pנננננÄ⇧üנé⇦נÄ◆çüé ⇧éä@נÆ⇧ז⇦Oå⇩⇧êOâÄëéOüÇOâÄêOüâê@22¨Œ´7Õ⓪0Õ82ã¨⓪;œ´4╱à⓪⓪⓪⓪⓪:42É897Õ2¨⓪;œÃ27†¨É7Õ2Ã⓪0Ã2⓪1ÃÀ7¨9É9Ø´⓪4Ã⓪0õõè20Ã1ØÉ;œ´4⓪:42É;è5É<ôåà⓪⓪⓪⓪⓪4Ã:2Ã2⓪:7É27ù⓪ øãœÃ⓪:47´øœ⑥⓪37¨⓪0É10¨2É6œÃ4À´Àû⓪<ôÉ9œ7´À2⓪40†2É0´╱à⓪⓪⓪⓪⓪62㨴⓪⑧É34À2É7Ã⓪40Ã2⓪34À2É37¨⓪2ãõœ⓪92¨ÃÀ:´4ÃÃ⓪<ôÉ:¨Øû⓪0Ã2⓪4´③¨É0É3ÃÃØ╱à⓪⓪⓪⓪⓪4Ø2ãÉ:7É:¨ØÉ:42É2¶:2Ã22¨⓪7ø⓪:42É34À2Ã0ÀØÉ:7É4Ã24õã´2É:42É92¨ÃÀ:´4ÃÃ⓪4´╱à⓪⓪⓪⓪⓪4¨É4Ã:2Ã22Ø⓪37¨⑦⓪!2¶ÃÃ2⓪:44¨t. In fact, it is possible that by the time you
  196.      register, more features will have been added! The demo version contains
  197.      a 40 second commercial message, which will appear only 1 out of 4 times
  198.      the program is used.  It is a simple reminder that a lot of time and
  199.      effort went into this product, and shareware authors gotta eat too!
  200.  
  201.  
  202.                            ******** DISCLAIMER ********
  203.  
  204.      Although I (and several 'beta' testers) have beaten the program to
  205.      death forcing every conceivable error, I must hereby state that I nor
  206.      the Elfin Magic company assume any responsibility for lost time or data
  207.      resulting from the use or misuse of ELF-BOOT. The user assumes
  208.      responsibility for backing up his system to prevent such disasters. I
  209.      can only affirm that to the best of my knowledge, the program will
  210.      perform as stated in the docs, and at the time of distribution
  211.      contained no 'viruses' of any kind.
  212.  
  213.  
  214.                THANKS IN ADVANCE FOR SUPPORTING SHAREWARE AUTHORS!
  215.  
  216.  
  217.      
  218.                                      Page 1
  219.  
  220.      
  221.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  222.  
  223.           
  224.      FILES:
  225.  
  226.           Before proceeding, be sure you have all the following files in
  227.      your ELFBOOT package:
  228.  
  229.           ELFBOOT.PRG    Main program (or ELFBOOTD.PRG for demo version) .
  230.           ELFHELP.PRG    Utility to assist in preparing special batch files.
  231.           STARTGEM.PR    A public domain program run utility.
  232.           RAMDISK.PRG    ATARI's public domain reset proof ramdisk.
  233.           RDSET.TTP      A freeware utility from Elfin Magic to set the
  234.                          default drive and size of the ramdisk.
  235.           DESKTOP.L      Some default desktop.inf files for each resolution
  236.           DESKTOP.M
  237.           DESKTOP.H
  238.           ELFBOOT.DOC    The file you're reading.
  239.           README.DOC     May contain last minute changes. Check it out!
  240.  
  241.      ELF-BOOT: What it does...
  242.  
  243.      ELF-BOOT normally resides in the AUTO folder of your hard disk. It can
  244.      also be re-run from the desktop at any time. For maximum utility, it
  245.      also requires that the file "STARTGEM.PR" (notice the  missing "G") be
  246.      placed in the AUTO folder, after ELF-BOOT has been added. When it runs,
  247.      ELF-BOOT will allow you to:
  248.  
  249.           1) Load, and modify up to 50 desktop.inf files. Desktop colors,
  250.              printer configuration, keyboard repeat, delay, bell silence and
  251.              key click can all be controlled, as well the option to confirm
  252.              copies & deletes, and turn disk write verify on or off.
  253.  
  254.           2) Automatically select a default desktop file based on the
  255.              current monitor (color or mono), so that your system can boot
  256.              up properly with no manual intervention.
  257.  
  258.           3) Install an option called 'AUTOCOLOR' which keeps your selected
  259.              desktop colors in place when the system completes it's startup.
  260.              This feature also prevents other applications from changing
  261.              your colors, unless you want them to.
  262.  
  263.           4) Completely eliminate the need for the ATARI control panel desk
  264.              accessory, freeing up 2 valuable 'slots' for other accessories.
  265.  
  266.           5) Enable or disable programs in your AUTO folder.
  267.  
  268.           6) Easily change the order in which programs in your AUTO folder
  269.              will run.
  270.  
  271.           7) Activate any one of up to 50 ASSIGN.SYS files for use with
  272.              GDOS, or prevent any from becoming active.
  273.  
  274.           8) Enable and disable Desk accessories.
  275.  
  276.           9) Automatically transfer any number of files from up to 50 user
  277.              defined lists, from any drive (and path) to an active ramdisk.
  278.  
  279.          10) Cause your ST to run any of 50 preset programs without having
  280.              to double click them from the desktop. As of the time of this 
  281.              writing though, THIS OPTION IS UN-USABLE WITH TOS 1.4. 
  282.              Hopefully, this will soon change.
  283.  
  284.                                      page 2
  285.      
  286.  
  287.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  288.  
  289.      
  290.          11) Create and or activate up to 50 macro files, which can perform
  291.              all the above functions, in one mouse click!
  292.  
  293.          12) View and/or modify the system time and date, for those without
  294.              a real time clock.
  295.  
  296.           Best of all, even though the program runs in an AUTO folder, It
  297.      provides an active mouse, dialog and alert boxes, multiple fonts,
  298.      button click functions, and even displays a file select window with
  299.      scrolling arrows! No, I have not discovered some hidden feature in the
  300.      ATARI to make this possible. Rather, I wrote my own 'mini-GEM' in 100%
  301.      assembly code.  Because of the familiar environment, you'll find that
  302.      in most cases, just guessing what to do will give you the expected
  303.      result. But again.... read _ALL_ the documentation!
  304.  
  305.  
  306.                **********************************************
  307.  
  308.      II. PREPARATION:
  309.  
  310.  
  311.      1) DESKTOP.INF FILES
  312.  
  313.           ELF-BOOT can be used with or without desktop.inf files. But unless
  314.      you're a rare breed that likes ATARI's default lo res. desktop, these
  315.      files are important. The first thing you should do is prepare at least
  316.      one "default" desktop file for each of the 3 normal ATARI resolutions.
  317.      Since many users don't have both color and mono monitors, a sample
  318.      DESKTOP file for each res. is provided on the ELF-BOOT disk, so you can
  319.       accomplish this step even if you have only one monitor.
  320.  
  321.           If you have a color monitor, prepare your own desktop.inf file in
  322.      medium resolution, with the desired colors, window/icon placement, and
  323.      installed applications you desire. If you do not currently use a
  324.      ramdisk, setup an icon for one now.  To do this, just select any disk
  325.      icon, and select "INSTALL DISK" from the desktop menu.  Then, specify
  326.      an unused drive identifier from D: thru  P: at the prompt.n (very!) quickly transfer a group of files to a
  327.      ramdisk! This is very handy if you have an ongoing project in which you
  328.      normally spend time moving the same files into your ramdisk every time
  329.      you boot.  However, in order for ELF-BOOT to accomplish this, the
  330.      RAMDISK program must have been previously run. This is why I recommend
  331.      keeping ATARI's reset proof RAMDISK in your AUTO folder. It is easily
  332.      sized or even disabled at boot time with a single keystroke.  However,
  333.      If you use a DESK.ACC type ramdisk, you can still make great use of
  334.      this feature, since ELF-BOOT can be re-run from the desktop at any
  335.      time.
  336.  
  337.           For now, just Create a folder in your root directory, and call it
  338.      "TRANSFER".  Later, we'll see how the supplied support program
  339.      "ELFHELP.PRG" may be used to quickly create up to 50 'batch' files for
  340.      use with this feature.
  341.  
  342.  
  343.      6. STARTGEM
  344.  
  345.           If you're using any version of TOS but 1.4, create a folder in
  346.      your root directory called STARTGEM. The public domain program
  347.      STARTGEM.PRG (renamed .PR in your ELFBOOT package) is capable of
  348.      automatically running any program on bootup, just by placing the
  349.      programs' full path and filename in a text file called STARTGEM.INF.
  350.      In the STARTGEM folder you just created, you can store up to 50 such
  351.      text files, with names of your choosing. ELFBOOT will automatically
  352.      take care of copying the one you select, and enabling/disabling 
  353.      STARTGEM.PRG as needed. (This is why it's current filename ends in
  354.      ".PR" instead of ".PRG"). Later, we'll see how the supplied ELFHELP.PRG
  355.      can assist you in accurately creating these text files, without errors
  356.      or hassle.
  357.  
  358.      7. MACROS!
  359.  
  360.           Create one more folder in your root directory called "ELFMACRO".
  361.      No need to fill it with anything, ELFBOOT handles all the processing
  362.      here. Later, we'll see how almost everything ELFBOOT does for you can
  363.      be saved in a macro file, for a totally customized setup every time you
  364.      use your ST!
  365.  
  366.  
  367.      III. PROGRAM USE:
  368.  
  369.           OK... now comes the fun part! For the first time, run ELF-BOOT
  370.      from the desktop, even though it's in the auto folder. This way, if
  371.      there's  anything wrong with the program file, or if there's any
  372.      incompatibility with some other program that's resident in memory
  373.      (TSRs), you'll find out with a harmless crash to the desktop.
  374.  
  375.           When you run the program, the startup screen will appear, followed
  376.      by an alert box. If the DESKTOP.INF file was present (or alternately,
  377.      if either DESKTOP.H or DESKTOP.M  is all that's available), the dialog
  378.      box will offer 3 choices. You have 10 seconds to choose, or option 2
  379.      (EXIT with AUTOCOLOR) will be selected by default. For now, click the
  380.      mouse on choice 3: USE ELF-BOOT!. If no DESKTOP file was found, you
  381.      will see a different dialog box reminding you to select one before
  382.      exiting. In this case, click on EXIT (upper right corner of screen),
  383.  
  384.                                      page 6
  385.  
  386.      
  387.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  388.  
  389.      followed by clicking on EXIT WITHOUT AUTOCOLOR in the next dialog box.
  390.      Then, retrace your steps and see where you went wrong. Remember, in the
  391.      demo version, 1 out of 4 exits will display, a 40 second commercial.
  392.  
  393.           When you select the 'USE' option, you'll see the entire ELF-BOOT
  394.      work screen.  To the left, there are displays for the Time, Date,
  395.      printer configuration, keyboard configuration, Disk parameters (Confirm
  396.      copies, deletes, and disk verify), buttons for keyboard click and bell,
  397.      and in the lower left, color control. The parameters displayed are all
  398.      taken from the 'current' desktop file (or from the system itself if no
  399.      desktop file exists). Here is a brief synopsis of how these work:
  400.  
  401.      Printer: Just like the ATARI control panel. Set each parameter by
  402.               clicking the appropriate box. These parameters may be changed
  403.               at any time, whether the program is run from an AUTO folder at
  404.               boot time, or later from the desktop.
  405.  
  406.      Disk:    For the confirm deletes/copies buttons to be toggled, a
  407.               desktop file must exist. But even so, these parameters can
  408.               only be changed in the system when the program is run from the
  409.               AUTO folder at boot time. Write verify for disk operations
  410.               however can be turned off or on at any time. But note that
  411.               this item will always default to active (verify on) since I
  412.               believe it shouldn't be disabled without user intervention.
  413.  
  414.      Time/Date: These displays update automatically every 2 seconds.  To
  415.                 change the time or date, just click on the appropriate box
  416.                 and type your new entry. The program parses date and time
  417.                 strings fairly intelligently, and all the following are
  418.                 legal entries:
  419.  
  420.                 Time: 03:22:10 AM, 3:23, 3:24P, 03:23 PM
  421.                 DATE: 05/01/91, 5/01/91, 5/1/91
  422.  
  423.      Press escape if desired to clear the string and start again, just as in
  424.      a normal GEM dialog box. Other than that, the backspace is your only
  425.      active editing key. Hit RETURN, ENTER, or click the mouse to complete
  426.      your entry. The new date or time will be installed in the system and
  427.      displayed. If the program can't make sense out of your entry, the
  428.      original time or date will re-appear.
  429.  
  430.      Keyboard: The keyboard click and delay rate may be varied to within the
  431.                same limits that the ATARI CONTROL.ACC allows. Simply click
  432.                on the up or down arrows for the desired parameter. Feel free
  433.                to press any key and hold it to check the results of your
  434.                change. To the right, the keyclick and console bell sound may
  435.                be enabled or disabled. Keep them both enabled for now
  436.                (highlighted), since they are used to aid the unfamiliar
  437.                user of ELF-BOOT. For example, anytime you click the mouse in
  438.                an inactive area, or when certain errors occur that the 
  439.                program wants to draw attention to, the console bell will
  440.                ring in addition to any status messages present.
  441.  
  442.      Color:    This is a big feature if your using a color monitor! Click on
  443.                any color box from 0 to F (representing 1 - 16 in GEM order),
  444.                and you'll see the color change, both in the screen display,
  445.                and in the color box to the right. Note that even though the
  446.                program is running in medium res. (on a color monitor), all
  447.                16 colors can be  viewed in this special color box!. This
  448.                will allow you to alter all the colors of a LO res
  449.      
  450.                                      page 7
  451.      
  452.      
  453.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  454.  
  455.                
  456.                desktop.inf file without even being in lo res! To alter any
  457.                color, select the color number (0-F), then click the left or
  458.                right arrows in the RED, GREEN, or BLUE box. The numerical
  459.                color value, as well as the color itself will show up in the
  460.                color box. If you're in monochrome, colors 0 and 1 will only
  461.                allow two settings (BLACK on WHITE, or WHITE on Black). The
  462.                other colors may be edited normally.
  463.  
  464.      A very important feature of the color control is this: You can select
  465.      any resolution desktop file (we'll see how to do this later), and the
  466.      program will make visual sense out of the colors! That is, from a color
  467.      monitor, You can load in a HI or LO res desktop, and edit the colors
  468.      perfectly, While the screen display accurately shows what the colors
  469.      will look like in the resolution of the chosen desktop. You'll have to
  470.      experiment with this later to see what I mean. Also, should you
  471.      accidently edit the colors in such a way that the screen becomes
  472.      difficult to read, clicking the color box itself will temporarily
  473.      install a preset color palette. This will not effect the color box or
  474.      the color data itself. Any additional editing, or clicking the color
  475.      box again will toggle the actual desk colors back to the screen. The
  476.      more you need to use this, the more you'll like it!
  477.  
  478.  
  479.      Status Box:
  480.  
  481.           In the status box on the lower right, the default message shows
  482.           the current free ram, as well as the type of desktop file
  483.           currently in memory. Actually, the 'Free RAM' message indicates
  484.           the amount of memory that ELFBOOT has available for copying files,
  485.           etc, rather than the total ram available. For most disk
  486.           operations, this status box will also display information showing
  487.           the various stages of the selected process, or will provide
  488.           instructions as to your next logical action. If during a disk
  489.           operation, you hear the console bell and all activity seems to
  490.           stop, check the status box to see how to proceed.
  491.  
  492.      FILE OPERATIONS:
  493.  
  494.           In the center of the screen there are 8 boxes with associated file
  495.      select operations. Each is designed to accomplish it's goal in as few
  496.      mouse clicks as possible. All items make use of the file select window
  497.      to the right, in one way or another. When a file function box is
  498.      clicked, the associated directory will be displayed in the window. If
  499.      more than 12 items are in the directory, the right sidebar will become
  500.      shaded, as an indicator. In this case, you can use the UP and DOWN
  501.      arrows at the  upper right and lower left of the window, to scroll the
  502.      display. If no items are present, the status box will reflect this, and
  503.      the menu box you selected will clear. Also, regarding the UP and DOWN
  504.      arrows, holding the mouse button down will allow continuous scrolling.
  505.      When the window can be scrolled no further, the console bell will ring.
  506.      The status box will also reflect the number of items found. To select a
  507.      file from a directory, just click on it (double click has no meaning in
  508.      ELF-BOOT).  The Top window bar will also display the name of the
  509.      selected directory!
  510.  
  511.           Note that ELFBOOT will automatically choose the 'MACRO SELECT' box
  512.      and display the 'ELFMACRO' directory, IF there are macros present.
  513.      Since no macros have been created yet, the system will instead default
  514.      to the 'SELECT DESKTOP.INF' option. This should be the case now, and a
  515.  
  516.                                      page 8
  517.           
  518.  
  519.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  520.  
  521.      
  522.      directory of your desktop files should already be present in the
  523.      window. We'll skip this option for now though, and explore all the
  524.      menu boxes from top to bottom.
  525.  
  526.  
  527.      1. Auto Program Enable:
  528.  
  529.           Clicking this item causes all entries in your AUTO folder with
  530.      either a .PR or .PRG extende⇦נüÇOîêOä⇨ÇijנüÇOäêÄ✓OבêÄ üêBOÄOijçä≡pנננננêé⇧êAנÇÇ⇦⇧נî⇧é OÇנé⇧ijנüÇOëé⇦ üêOÄOijçäÿOêé⇧êAנÄ✓⇩נÇÇ⇦⇧נî⇧é OÇנé⇧ij≡pנננננÆ⇧ז⇦OüâÄ⇧נä⇩◆üêNOÿ ⇨נüé✓OéOî⇧é OÇנÄOêé⇧êAנüâêOä⇧Ä⇧Ç⇦OîÇ⇨נÇ⇩⇧ü≡pנננננä⇨ÇOüâêOäê⇦⇧üIJנÄëנüâêOëé⇦ê ⇧Ç⇦éOÇ⇩⇧üנîêOäê✓äê⇦⇨ê    ijנÆî⇩    êüÄ⇧üéAנéÕ;@4❎·⇩²⇨⇦⑤ךòזüíàךö®╱⇧>②②    >82◆>╱!> ⇩82╱ '>③>&✓⓪82╱ '>⓪╱8╱①>#IJב????>⓪╱x②╱``A⇩②⇨>`Fcr@@◆>✓╱◆>╱8!>08②!>#>╱8◆>8╱8╱✓08╱╱    >8①IJב????>⇩ 0 ⓪⓪8e are displays for the Time, Date,
  531.      printer configuration, keyboard configuration, Disk parameters (Confirm
  532.      copies, deletes, and disk verify), buttons for keyboard click and bell,
  533.      and in the lower left, color control. The parameters displayed are all
  534.      taken from the 'current' desktop file (or from the system itself if no
  535.      desktop file exists). Here is a brief synopsis of how these work:
  536.  
  537.      Printer: Just like the ATARI control panel. Set each parameter by
  538.               clicking the appropriate box. These parameters may be changed
  539.               at any time, whether the program is run from an AUTO folder at
  540.               boot time, or later from the desktop.
  541.  
  542.      Disk:    For the confirm deletes/copies buttons to be toggled, a
  543.               desktop file must exist. But even so, these parameters can
  544.               only be changed in the system when the program is run from the
  545.               AUTO folder at boot time. Write verify for disk operations
  546.               however can be turned off or on at any time. But note that
  547.               this item will always default to active (verify on) since I
  548.               believe it shouldn't be disabled without user intervention.
  549.  
  550.      Time/Date: These displays update automatically every 2 seconds.  To
  551.                 change the time or date, just click on the appropriate box
  552.                 and type your new entry. The program parses date and time
  553.                 strings fairly intelligently, and all the following are
  554.                 legal entries:
  555.  
  556.                 Time: 03:22:10 AM, 3:23, 3:24P, 03:23 PM
  557.                 DATE: 05/01/91, 5/01/91, 5/1/91
  558.  
  559.      Press escape if desired to clear the string and start again, just as in
  560.      a normal GEM dialog box. Other than that, the backspace is your only
  561.      active editing key. Hit RETURN, ENTER, or click the mouse to complete
  562.      your entry. The new date or time will be installed in the system and
  563.      displayed. If the program can't make sense out of your entry, the
  564.      original time or date will re-appear.
  565.  
  566.      Keyboard: The keyboard click and delay rate may be varied to within the
  567.                same limits that the ATARI CONTROL.ACC allows. Simply click
  568.                on the up or down arrows for the desired parameter. Feel free
  569.                to press any key and hold it to check the results of your
  570.                change. To the right, the keyclick and console bell sound may
  571.                be enabled or disabled. Keep them both enabled for now
  572.                (highlighted), since they are used to aid the unfamiliar
  573.                user of ELF-BOOT. For example, anytime you click the mouse in
  574.                an inactive area, or when certain errors occur that the 
  575.                program wants to draw attention to, the console bell will
  576.                ring in addition to any status messages present.
  577.  
  578.      Color:    This is a big feature if your using a color monitor! Click on
  579.                any color box from 0 to F (representing 1 - 16 in GEM order),
  580.                and you'll see the color change, both in the screen display,
  581.                and in the color box to the right. Note that even though the
  582.                program is running in medium res. (on a color monitor), all
  583.                16 colors can be  viewed in this special color box!. This
  584.                will allow you to alter all the colors of a LO res
  585.      
  586.                                      page 7
  587.      
  588.      
  589.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  590.  
  591.                
  592.                desktop.inf file without even being in lo res! To alter any
  593.                color, select the color number (0-F), then click the left or
  594.                right arrows in the RED, GREEN, or BLUE box. The numerical
  595.                color value, as well as the color itself will show up in the
  596.                color box. If you're in monochrome, colors 0 and 1 will only
  597.                allow two settings (BLACK on WHITE, or WHITE on Black). The
  598.                other colors may be edited normally.
  599.  
  600.      A very important feature of the color control is this: You can select
  601.      any resolution desktop file (we'll see how to do this later), and the
  602.      program will make visual sense out of the colors! That is, from a color
  603.      monitor, You can load in a HI or LO res desktop, and edit the colors
  604.      perfectly, While the screen display accurately shows what the colors
  605.      will look like in the resolution of the chosen desktop. You'll have to
  606.      experiment with this later to see what I, and displayed in the PRINTER, DISK, KEYBOARD, and COLOR
  607.      displays.  Any modifications you make to these boxes will instantly
  608.      change the file data, as well as the ST itself. Again, these changes
  609.      are not really permanent, since ELF-BOOT normally saves this file as
  610.      DESKTOP.INF (a filename that is constantly overwritten). But the
  611.      changes CAN be saved permanently, as we'll see next.
  612.  
  613.      4.1 DESKTOP.INF file save.
  614.  
  615.           It isn't included in the 8 menu functions we're discussing, since
  616.      it's a "SAVE" rather then a "SELECT" or "LOAD" function. However, it
  617.      does seem logical to discuss it here. Skip down to the bottom of the
  618.      screen, and you'll see a SAVE DESKTOP select button. Assuming a desktop
  619.      file is installed in the program (either automatically on startup, or
  620.      manually with the previous menu function), you can control whether, and
  621.      HOW it is saved by clicking here. Assuming the file is in memory,
  622.      you'll be able select:
  623.  
  624.           1- SAVE NOW
  625.           2- SAVE WHEN PROGRAM EXITS
  626.           3- CANCEL (DON'T SAVE AT ALL)
  627.  
  628.      These options are self explanatory, except that option 2 (save when
  629.      program exits) will force it to be saved as DESKTOP.INF (the default
  630.      condition). The current filename is also displayed. Option 3 prevents
  631.      saving on exit, in case you're just browsing through your desktop
  632.      files.
  633.      
  634.                                      page 10
  635.      
  636.      
  637.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  638.  
  639.      
  640.      If you choose option 1 to SAVE now however, you'll be given 3
  641.      additional choices:
  642.  
  643.           1- SAVE with current filename
  644.           2- Save as 'DESKTOP.INF'
  645.           3- Enter a new filename.
  646.  
  647.  
  648.           The current filename is of course also displayed. Picking option 1
  649.      or 2 will save the file immediately. Saving with the current filename
  650.      means that any change you made to the system parameters is permanently
  651.      saved. Again, this illustrates how ELF-BOOT eliminates the need for the
  652.      ATARI CONTROL accessory. Saving as DESKTOP.INF instead just causes the
  653.      normally automatic save on exit to occur now instead of later, and
  654.      the original file is not altered. If option 3 is selected, another
  655.      dialog box will appear, allowing you to enter a new file name. Don't
  656.      enter any drive specifiers or path names here! Just a (max 12 char.)
  657.      filename.  The save will always go to the root directory.  Entering a
  658.      blank line will abort the operation in case you change your mind. The
  659.      same text editing rules for time/date entry also apply here. Just
  660.      remember that the name you choose must start with "DESK..." if you want
  661.      it to be selectable from ELF-BOOT.
  662.  
  663.  
  664.      5. Desk Accessory enable:
  665.  
  666.           This works just like AUTO program enable/disable! Click here, and
  667.      all root directory files ending with .AC or .ACC will be displayed.
  668.      Clicking on one will either enable or disable it, and an appropriate
  669.      status message will be posted. The same rules of the FILE SORT box
  670.      discussed earlier also apply here. Also, remember that only the first 6
  671.      accessories will load into the system, and some files like CONTROL.ACC
  672.      (which you'll probably never use again) and SNAPSHOT.ACC take up 2
  673.      accessory slots! You must keep track of this yourself.
  674.  
  675.  
  676.      6. Ramdisk Transfer:
  677.  
  678.           Clicking here will display any text files you'll prepare later
  679.      with the ELFHELP.PRG program. You don't have these set up yet, but
  680.      here's how it will work when you do. Selecting one of the 'transfer'
  681.      files will cause the program to copy all the files specified within
  682.      that file to the active RAMDISK. It's kind of a 'batch' copy command!
  683.      Of course, thorough checking is done to make sure the ramdisk/ä◆ê ⇩✓é✓    ≡pנננננîéOé⇦נêé⇧êOê⇨üêëê⇦נé⇦OÄ ⇧éêAנÄëנÇ✓✓◆נüäÄ OÇ✓נÄ⇧נüê⇦⇧נijOÇ⇧âê⇦≡pנננננçäÇ üê⇦OüâÄ⇧נî✓⇧ëנÄ⇦é⇦✓Aנä ⇨נÄ⇦OÄOêé⇧êOîê⇩êOüÇOîé✓OêÇ⇦נüâêppנננננäÄ    é⇦@נÇ⇧î⇨נüâêOä⇧Ä⇧Ç⇦ng the appropriate box. These parameters may be changed
  684.               at any time, whether the program is run from an AUTO folder at
  685.               boot time, or later from the desktop.
  686.  
  687.      Disk:    For the confirm deletes/copies buttons to be toggled, a
  688.               desktop file must exist. But even so, these parameters can
  689.               only be changed in the system when the program is run from the
  690.               AUTO folder at boot time. Write verify for disk operations
  691.               however can be turned off or on at any time. But note that
  692.               this item will always default to active (verify on) since I
  693.               believe it shouldn't be disabled without user intervention.
  694.  
  695.      Time/Date: These displays update automatically every 2 seconds.  To
  696.                 change the time or date, just click on the appropriate box
  697.                 and type your new entry. The program parses date and time
  698.                 strings fairly intelligently, and all the following are
  699.                 legal entries:
  700.  
  701.                 Time: 03:22:10 AM, 3:23, 3:24P, 03:23 PM
  702.                 DATE: 05/01/91, 5/01/91, 5/1/91
  703.  
  704.      Press escape if desired to clear the string and start again, just as in
  705.      a normal GEM dialog box. Other than that, the backspace is your only
  706.      active editing key. Hit RETURN, ENTER, or click the mouse to complete
  707.      your entry. The new date or time will be installed in the system and
  708.      displayed. If the program can't make sense out of your entry, the
  709.      original time or date will re-appear.
  710.  
  711.      Keyboard: The keyboard click and delay rate may be varied to within the
  712.                same limits that the ATARI CONTROL.ACC allows. Simply click
  713.                on the up or down arrows for the desired parameter. Feel free
  714.                to press any key and hold it to check the results of your
  715.                change. To the right, the keyclick and console bell sound may
  716.                be enabled or disabled. Keep them both enabled for now
  717.                (highlighted), since they are used to aid the unfamiliar
  718.                user of ELF-BOOT. For example, anytime you click the mouse in
  719.                an inactive area, or when certain errors occur that the 
  720.                program wants to draw attention to, the console bell will
  721.                ring in addition to any status messages present.
  722.  
  723.      Color:    This is a big feature if your using a color monitor! Click on
  724.                any color box from 0 to F (representing 1 - 16 in GEM order),
  725.                and you'll see the color change, both in the screen display,
  726.                and in the color box to the right. Note that even though the
  727.                program is running in medium res. (on a color monitor), all
  728.                16 colors can be  viewed in this special color box!. This
  729.                will allow you to alter all the colors of a LO res
  730.      
  731.                                      page 7
  732.      
  733.      
  734.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  735.  
  736.                
  737.                desktop.inf file without even being in lo res! To alter any
  738.                color, select the color number (0-F), then click the left or
  739.                right arrows in the RED, GREEN, or BLUE box. The numerical
  740.                color value, as well as the color itself will show up in the
  741.                color box. If you're in monochrome, colors 0 and 1 will only
  742.                allow two settings (BLACK on WHITE, or WHITE on Black). The
  743.                other colors may be edited normally.
  744.  
  745.      A very important feature of the color control is this: You can select
  746.      any resolution desktop file (we'll see how to do this later), and the
  747.      program will make visual sense out of the colors! That is, from a color
  748.      monitor, You can load in a HI or LO res desktop, and edit the colors
  749.      perfectly, While the screen display accurately shows what the colors
  750.      will look like in the resolution of the chosen desktop. You'll have to
  751.      experiment with this later to see what I
  752.      When you click on a macro file, It's like watching ELF-BOOT run itself
  753.      at high speed.  All the menu items will select themselves, and set up
  754.      their options according to your macro specification!  However, all non-
  755.      fatal error checking is bypassed.
  756.      
  757.                                      page 12
  758.      
  759.      
  760.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  761.  
  762.      
  763.      Instead, a MACRO ERROR STATISTICS box (example below) will be displayed
  764.      after the macro is processed.
  765.  
  766.  
  767.                PROCESS NAME       FILE REQUESTS     FILES COMPLETE
  768.                ---------------------------------------------------
  769.                   AUTO PRGS:           8                  8
  770.                 ASSIGN FILE:           1                  1
  771.                 DESKTOP.INF:          --- PROCESS FAILURE ---
  772.                 ACCESSORIES:           6                  6
  773.                    TRANSFER:           4                  3 *
  774.                    STARTGEM:           0                  0
  775.  
  776.  
  777.           In this example, 8 AUTO programs specified in the users' macro
  778.      have been activated and are now ".PRG". All others have been
  779.      deactivated. An ASSIGN file has been specified and copied as well. The
  780.      DESKTOP.INF function failed however. Perhaps the file specified in this
  781.      macro was intended for a mono monitor, while the user is currently in
  782.      color mode. Six requested desk ACCESSORIES have also been enabled,
  783.      while all others have been disabled. The TRANSFER function was able to
  784.      copy only 3 out of the 4 files specified by the user, so this
  785.      discrepancy is flagged by a '*' character. No program has been
  786.      specified to run under STARTGEM, and so "0"s are displayed.
  787.  
  788.           In the event such errors occur, any exit condition specified by
  789.      the user is cancelled, and the next mouse click will return the USER to
  790.      ELF-BOOT. If you so desire, you can try to manually retry the failed
  791.      operation. In normal (or "manual") mode, the error messages are much
  792.      more extensive, and will provide full details on the nature of the
  793.      problem. If no errors occurred, and the user specified an exit
  794.      condition when the macro was created, ELF-BOOT will post a final
  795.      'good-bye' message, and exit.
  796.  
  797.      9.1 MACRO RECORD.
  798.  
  799.           While TRANSFER and STARTGEM files must be prepared outside the
  800.      ELF-BOOT environment with the ELFHELP.PRG, this is not the case with
  801.      macros. All you have to do is set up your system the way you want it
  802.      for a given application, and click the RECORD button. Again, the system
  803.      will scan all the menu items, this time recording all your selections.
  804.      For each, the status window reflects the users choices, but these
  805.      messages normally are too fast to actually read. ELF-BOOT will then
  806.      prompt you to select an exit condition for the macro. Basically, You'll
  807.      either exit the program when the macro is used, or simply return to the
  808.      ELF-BOOT environment. The normal exit condition is EXIT WITH AUTOCOLOR,
  809.      as this option replaces the color functions of the ATARI CONTROL panel.
  810.      Note again that this choice does NOT cause the exit to occur now.
  811.      Rather, it specifies what will occur when the macro is actually used.
  812.      After this selection, a directory of macro files is displayed, and ELF-
  813.      BOOT will prompt you for a filename. Pressing return with no entry
  814.      aborts the process, while an actual filename entry will cause a save.
  815.  
  816.           On problem that can arise when creating several macros in
  817.      succession, is that you must remember to specifically select every menu
  818.      item that you want changed. For example, if you create a macro that
  819.      (among other things) runs a program, and then proceed to create another
  820.      macro that should NOT run a program, you must remember to select the
  821.      RUN PROGRAM box, even though you don't intend to select anything.
  822.      
  823.                                      page 13
  824.      
  825.      
  826.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  827.  
  828.      
  829.      In other words, selecting the box automatically clears the 'macro
  830.      memory' of the last selection. This is also true of ramdisk TRANSFERs,
  831.      ASSIGN file selections, and DESKTOP file choices. So, when preparing 
  832.      multiple macros, make sure to select ALL menu items, including the ones
  833.      for which you don't pick a file.
  834.  
  835.           Another problem that arises when recording multiple macros is that
  836.      the system is unaware that you really don't want any actions to occur,
  837.      and that you're only preparing to do a macro save. So, to suspend all
  838.      file saving while setting up for a macro, click the FILE PROTECT box at
  839.      the bottom of the screen so that is highlighted. From here on, all
  840.      ASSIGN, PROGRAM RUN, TRANSFER, and automatic DESKTOP saves are
  841.      suspended, until the file protect box is turned off. With FILE PROTECT
  842.      on, file selection causes the associated file (or multiple files in the
  843.      case of TRANSFERs) to be loaded, so that basic error checking can
  844.      occur. However, instead of proceeding to copy the file(s) as usual, the
  845.      message "Selection Noted, No action Taken" will appear in the status
  846.      window. Selecting the FILE PROTECT option before making any macros will
  847.      also help to eliminate some of the  "OVERWRITE (YES/NO) and "DELETE
  848.      (YES/NO)" messages, that can be very distracting. Incidentally, the
  849.      FILE PROTECT box has NO effect when actually EXECUTING (selecting) a
  850.      macro.
  851.  
  852.  
  853.      I.V. MISCELLANEOUS functions:
  854.  
  855.      About Program.
  856.  
  857.           If you click the box in the upper right hand corner of the screen
  858.           a short commercial message for ELF-BOOT will appear.  Click the
  859.           mouse anywhere to escape this message. Note that the Demo and
  860.           Registered copies of the program contain different information. If
  861.           you have a registered copy of ELF-BOOT, be sure to check this out!
  862.  
  863.  
  864.      V. EXIT OPTIONS:
  865.  
  866.       1. Exit on Startup
  867.  
  868.           As we saw earlier, when ELF-BOOT starts up, you have the choice of
  869.           exiting immediately, or using the program. The default is to exit
  870.           with AUTOCOLOR enabled, and this option will occur after 10
  871.           seconds if the user does not intervene. We'll discuss AUTOCOLOR
  872.           more in a moment. For now, the important thing to realize is that
  873.           exiting at this point will allow you to enter the ST environment
  874.           with the/ä✓Oîëé⇧éäOüâÄ⇧נê⇨é⇦⇧       and you'll see the color change, both in the screen display,
  875.                and in the color box to the right. Note that even though the
  876.                program is running in medium res. (on a color monitor), all
  877.                16 colors can be  viewed in this special color box!. This
  878.                will allow you to alter all the colors of a LO res
  879.      
  880.                                      page 7
  881.      
  882.      
  883.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  884.  
  885.                
  886.                desktop.inf file without even being in lo res! To alter any
  887.                color, select the color number (0-F), then click the left or
  888.                right arrows in the RED, GREEN, or BLUE box. The numerical
  889.                color value, as well as the color itself will show up in the
  890.                color box. If you're in monochrome, colors 0 and 1 will only
  891.                allow two settings (BLACK on WHITE, or WHITE on Black). The
  892.                other colors may be edited normally.
  893.  
  894.      A very important feature of the color control is this: You can select
  895.      any resolution desktop file (we'll see how to do this later), and the
  896.      program will make visual sense out of the colors! That is, from a color
  897.      monitor, You can load in a HI or LO res desktop, and edit the colors
  898.      perfectly, While the screen display accurately shows what the colors
  899.      will look like in the resolution of the chosen desktop. You'll have to
  900.      experiment with this later to see what Ion 1 when the program is run from an AUTO
  901.           folder during bootup, Your Desktop colors will never be installed
  902.           (Unless you re-enable the ATARI CONTROL.ACC).
  903.  
  904.  
  905.           option 3:  coldstart
  906.  
  907.           We'll come back to option 2 in a second. Exit option 3 will
  908.           cause a re-boot. This is an full coldstart, and is much more
  909.           thorough than pressing your RESET button. Some possible uses are:
  910.  
  911.                1. When you've re-sequenced your AUTO folder programs, and
  912.                   now want to reboot with the new configuration.
  913.  
  914.                2. When you want to disable the ATARI ramdisk completely,
  915.                   with a '0' key-press.
  916.  
  917.                3. When a program (any program) causes a severe system crash,
  918.                   and the desktop is behaving strangely. Earlier versions of
  919.                   PINHEAD sometimes caused this to occur. A coldstart is the
  920.                   next best thing to powering down for 10 seconds, and can
  921.                   solve many problems that the RESET button alone can't
  922.                   cure.
  923.  
  924.      NOTE: While we're on the subject of RESET, note that exiting from
  925.      ELFBOOT with the RESET button is not recommended. In order to do the
  926.      simulation of a GEM mouse and event manager, many system changes are
  927.       made which will never be restored properly if RESET is pressed.
  928.  
  929.  
  930.           option 2.  Autocolor Exit:
  931.  
  932.           So what the heck is AUTOCOLOR anyway? Autocolor is a very powerful
  933.           feature of ELF-BOOT that goes beyond the ATARI control panel in
  934.           keeping your selected colors in place. Autocolor is a small piece
  935.           of program code (less than 1 k) that stays in memory after the
  936.           program ends. It can be installed only once, but enabled and 
  937.           disabled at will. Normally it is installed when the program is run
  938.           from the AUTO folder (but this does not have to be the case).
  939.           When ELF-BOOT starts up, as long as a usable DESKTOP file is found,
  940.           the program will exit WITH autocolor installed (or enabled) after
  941.           10 seconds on user inactivity.
  942.      
  943.                                      page 15
  944.  
  945.           
  946.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  947.  
  948.      
  949.      AUTOCOLOR... How it works:
  950.  
  951.           When autocolor is initiated, the program will exit with the
  952.      selected desktop colors still active. It steals the primary vertical
  953.      blank vector from the system, and monitors the video hardware and
  954.      screen 60 times a second waiting for the desktop to appear. At this
  955.      point, it installs itself properly in the system vertical blank queue,
  956.      intercepts the mouse data from the keyboard, and restores the primary
  957.      vertical blank vector to it's original state.
  958.  
  959.      What it does:
  960.  
  961.           ALRIGHT...ENOUGH TECH TALK! With AUTOCOLOR installed, you'll see
  962.      your selected colors appear when the desktop appears. From there on,
  963.      ANY program that attempts to change the screen colors will fail to do
  964.      so!  This is especially useful when you use a lot of programs that seem
  965.      to insist that the programmers choice of colors is superior to the ones
  966.      the user selected.
  967.  
  968.      Enabling/disabling Autocolor:
  969.  
  970.           Well that's all fine and well, but what happens when you run a
  971.      program that needs to control the colors. A drawing program like DEGAS
  972.      ELITE would be crippled without such control. In fact, Some parts of
  973.      DEGAS ELITE will fight the AUTOCOLOR program so hard, that sometimes,
  974.      after much screen-flickering battle, the program may actually crash!
  975.      So, we need a way to easily enable or disable AUTOCOLOR, to really make
  976.      it useful.
  977.  
  978.           I thought a lot about this, and decided that the old approach of
  979.      pressing ALT - SHIFT- CTRL plus a key has been over used. My chances of
  980.      coming up with a new combination that no one else has used are pretty
  981.      bleak, and you'd probably forget the key combination anyway. So, here's
  982.      what I did. If you want to disable AUTOCOLOR, press the RIGHT mouse
  983.      button, and move the mouse to the left, _QUICKLY_, while still holding
  984.      the button down! Just a quick left 'swish'. Slowly won't do it!  Once
  985.      you do that, The current colors will still remain, but any program that
  986.      wants to change them will be able to (including the old ATARI control
  987.      panel if you want!). To re-enable AUTOCOLOR, press the RIGHT mouse
  988.      button again, and this time move quickly to the RIGHT.  The desk colors
  989.      will come back immediately. This sounds awkward, but believe me, it
  990.      becomes quite instinctive.  You'll find that most of the time you
  991.      discover the need to enable or disable AUTOCOLOR, your hand will
  992.      already be on the mouse! In addition, You'll be hard pressed to find a
  993.      program that really does anything destructive in response to quick
  994.      mouse movements with the right button pushed. And, programs that do use
  995.      the right button, never require any movements fast enough to trigger
  996.      AUTOCOLOR. By the way, remembering the on-off direction is easy; just
  997.      think: "RIGHT ON!!"
  998.  
  999.           Whenever you re-run ELF-BOOT, it first checks the system to see if
  1000.      autocolor has been installed. If so, it disables it (but doesn't remove
  1001.      it!). If you then exit the program and choose AUTOCOLOR exit, it senses
  1002.      that AUTOCOLOR is already resident, and simply re-enables it, rather
  1003.      than waste memory installing it again. This is why you will normally
  1004.      ALWAYS exit WITH autocolor. The one exception may be monochrome only
  1005.      users, since most mono programs accept the default 'black text over
  1006.      white background' format. Also, if while re-running ELF-BOOT you decide
  1007.      to change the screen colors (either manually, or by loading a new
  1008.      
  1009.                                      page 16
  1010.           
  1011.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  1012.  
  1013.      desktop file), the new palette will be installed into AUTOCOLOR
  1014.      automatically when you exit.  This is in fact the only way to change
  1015.      the AUTOCOLOR palette. Incidentally, AUTOCOLOR is smart enough to keep
  1016.      your colors consistent and logical, even if you/î⇨Äê✓@92¨ÃÀ:´4ÃÃ9É397Àåà⓪⓪⓪⓪⓪:42ùגג⇩ij⇨ατij⇩gijij◆⇦τIJgijIJג'ij⇩@D'גג⇩ij⇨τגAג'88x8x8gττττijI gכ✓כ`H✓τא⇨בז⇩@τijח✓חח ⇩'τβτµF@IJ⇦⇩&gβ88x8x8gττττπ gττאLא α@ijב°8x8gτττττττττijij'א⇦τij⇨τijIJג'ננ⇩I'אG⇦IJ⇩'ijij'ו'גIJ⇦DD⇩D@τגג⇦Gijτא⇧D'וץê⑨Ü]ÖCBê✓✓✓✓②Q♪✓⑧ץ⇧αôα`Γ③β&a╱p `a≤Γ Çb③πÇ"sα`Γ③β'ä╱dü⇦⓪!β&③Γ Çb③α       and you'll see the color change, both in the screen display,
  1017.                and in the color box to the right. Note that even though the
  1018.                program is running in medium res. (on a color monitor), all
  1019.                16 colors can be  viewed in this special color box!. This
  1020.                will allow you to alter all the colors of a LO res
  1021.      
  1022.                                      page 7
  1023.      
  1024.      
  1025.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  1026.  
  1027.                
  1028.                desktop.inf file without even being in lo res! To alter any
  1029.                color, select the color number (0-F), then click the left or
  1030.                right arrows in the RED, GREEN, or BLUE box. The numerical
  1031.                color value, as well as the color itself will show up in the
  1032.                color box. If you're in monochrome, colors 0 and 1 will only
  1033.                allow two settings (BLACK on WHITE, or WHITE on Black). The
  1034.                other colors may be edited normally.
  1035.  
  1036.      A very important feature of the color control is this: You can select
  1037.      any resolution desktop file (we'll see how to do this later), and the
  1038.      program will make visual sense out of the colors! That is, from a color
  1039.      monitor, You can load in a HI or LO res desktop, and edit the colors
  1040.      perfectly, While the screen display accurately shows what the colors
  1041.      will look like in the resolution of the chosen desktop. You'll have to
  1042.      experiment with this later to see what Iders with mouse clicks, it is quite difficult
  1043.      sometimes to remember the full path of a program.  For example, my
  1044.      terminal program " FLASH" requires a path sting like this to make a
  1045.      GEMSTART file:
  1046.  
  1047.                     D:\TELECOM\FLASH\FLASH.PRG
  1048.  
  1049.           I couldn't expect the user to remember strings like this from
  1050.      within ELF-BOOT, and adding code to make the file select window into a
  1051.      full replica of the GEM file selector box was in my opinion, too much
  1052.      effort for too little gain. The solution was to provide a separate
  1053.      program which could be run from the desktop, and so provide the user
  1054.      with a real GEM file selector box, or allow him to use whatever file
  1055.      selector replacement he is used to. the ELFHELP.PRG does just that.
  1056.  
  1057.           Preparing STARTGEM files.
  1058.  
  1059.           ELFHELP.PRG is run from the desktop, and should normally reside in
  1060.      the root directory of your boot disk. It will first ask you whether you
  1061.      want to create a STARTGEM file, TRANSFER file, or EXIT the program.  If
  1062.      you choose STARTGEM, a familiar file selector box will appear. Use it
  1063.      to find the program you want ELF-BOOT to be able to run from it's 
  1064.      
  1065.      
  1066.                                      page 17
  1067.  
  1068.           
  1069.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  1070.  
  1071.      
  1072.      'RUN PROGRAM' option. Click on the desired file, followed by the OK
  1073.      button. (Clicking the CANCEL button will return you to the start of the
  1074.      program). Note that the program file you choose may be imbedded in any
  1075.      combination of drive partitions and folders you choose. At this point,
  1076.      ELFHELP will store the selected path/file name in a text file in the
  1077.      STARTGEM folder.  the name of the file will be the filename you
  1078.      selected, with a ".RUN" extender. If you try to run ELFHELP from
  1079.      anything other than your boot drive, it will not be able to find the
  1080.      STARTGEM folder you prepared earlier. In that case, the file will be
  1081.      saved to the current directory. In either case, when the save is
  1082.      complete, the program will return to the initial dialog box and prompt
  1083.      you for what to do next. When preparing STARTGEM files, be careful not
  1084.      to mistakenly select a non program file. Programs on the ST all have
  1085.      an extender of ".TOS", "TTP", ".APP", or ".PRG". Note also that the
  1086.      text files produced do not have to be named the way ELFHELP names them.
  1087.      You can rename them to anything you want, so long as they stay in the
  1088.      STARTGEM folder.
  1089.  
  1090.  
  1091.           Preparing TRANSFER files.
  1092.  
  1093.           Selecting TRANSFER at the start of the ELFHELP program will again
  1094.      allow file picks via the GEM item selector box. Use this option to
  1095.      create LISTS of files that ELFBOOT will use in it's RAMDISK TRANSFER
  1096.      function. It works like this:
  1097.      
  1098.        1) Use the file selector to pick files you want to be transfered.
  1099.  
  1100.        2) After each file pick, you'll be asked if you want to add more.
  1101.  
  1102.        3) Selecting CANCEL from the item selector will simply return you to
  1103.           the above message, and will list the files picked so far.
  1104.  
  1105.        4) When you're done selecting files, you'll be prompted for a
  1106.           filename to save under, using the same file selector box. If the
  1107.           program can't find the TRANSFER folder, the file will be saved in 
  1108.           the root directory.
  1109.  
  1110.        5) With TRANSFER files, remember that the extender must match your 
  1111.           RAMDISK specifier (Ex:   MYTRANS.G  = transfer to drive 'G:').
  1112.  
  1113.  
  1114.  
  1115.      VII. ADVANCED USER NOTES:
  1116.  
  1117.           These are just some tips I've discovered, that make using ELFBOOT
  1118.      a little more logical. First, as mentioned earlier, try to get into the
  1119.      habit of using generic filenames for programs, accessories, and any
  1120.      other files that ELFBOOT must handle. This is especially true if you
  1121.      use macros and transfer files a great deal. When new versions of a
  1122.      program get installed into your system, keeping the name consistent
  1123.      will avert the need for rebuilding MACRO, TRANSFER, and STARTGEM files.
  1124.  
  1125.           It is also important to note that as text files, MACRO, STARTGEM,
  1126.      and TRANSFER files can all be hand edited with a text editor, or
  1127.      word processor capable of saving in straight ASCII format. While the
  1128.      contents of the latter two files is probably obvious by now, the macro
  1129.      files need a little more attention. 
  1130.      
  1131.  
  1132.                                           page 18
  1133.  
  1134.      
  1135.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  1136.  
  1137.      
  1138.      Here is a typical macro text file:
  1139.  
  1140.                #auto:
  1141.                PINHEAD.PRG
  1142.                RAMDISK.PRG
  1143.                SUPCLKRD.PRG
  1144.                FOLDER200.PRG
  1145.                ELFBOOT.PRG
  1146.                #assign:
  1147.                #desktop:
  1148.                DESKWP.M
  1149.                #accessories:
  1150.                CALC.ACC
  1151.                MEMFILE.ACC
  1152.                PRINTDIR.ACC
  1153.                CALENDER.ACC
  1154.                #transfer:
  1155.                #startgem:
  1156.                WWRITER.RUN
  1157.                #exit:
  1158.                2
  1159.  
  1160.           Pretty straightforward really. For each macro category, an entry
  1161.      must exist even when no file is specified, as is the case with the
  1162.      "#assign:" directive above. If files are specified for the "#transfer:"
  1163.      or "#startgem:" directives, the files must be the text files prepared 
  1164.      by ELFHELP. In other words, if you try to hand edit one of these, don't
  1165.      specify FLASH.PRG (example) for a startgem file. Rather, specify the 
  1166.      name of a filename, in your STARTGEM folder, that contains the full 
  1167.      path to the FLASH program, in ASCII form. If all this sound confusing, 
  1168.      then don't worry about it. The information is just here to aid the 
  1169.      advanced user. Directly editing macro files may yeild some time savings 
  1170.      over building a new file from ELFBOOT. A good example is when a complex 
  1171.      macro needs only its' DESKTOP file changed, to accomodate a mono or 
  1172.      color monitor. The final digit in the file specifies the exit condition
  1173.      for the macro. 0 means return to program when done, and '1' and '2' 
  1174.      refer to exiting WITHOUT or WITH autocolor, respectively.
  1175.  
  1176.       
  1177.           As you become familiar with the system, you'll ultimately think of
  1178.      many ways in which the program could be made even more powerful.
  1179.      Several ideas have come to my mind already. (Not bad for a version 1
  1180.      though ehh?).  Please feel free to send comments and suggestions either
  1181.      by mail, via COMPUSERVE (EMAIL only to 73637,317), GEnie (ATARI 
  1182.      roundtable, or GE Mail address: R.CONSTAN)AÇ⇦נüôÿOÉÿ⇦⇧IJנÇ⇨é ⇨נé⇦OüâêO≡pנננננÇ✓êé ⇩⇧נ££äOÇ✓נüâêOæÇêOÆ⇦⇧Äëנß⇧Ä⇦éOÇ⇦✓⇦נÿ⇦Ç◆ijנüâê⇩9⓪7:Àõ2¨⓪4¨É╱à⓪⓪⓪⓪⓪əÿ¢⑥Ö⑨Ü⑥ÜÜ⑨ù⓪&2´⓪6ØÉ9´0´2É47†Ø†2¨⓪:40´⓪;œ0´⓪$ôÀÉ6è´⓪4Ã:2¨2¨´2Ø⓪4Ã⓪╱à⓪⓪⓪⓪⓪4¨É2Ã40Ã1ØÀØÃ:9É:7É6ãŒØÉ:42É897ø¨0ÀÉ6è2É:¨Øø:À⑥⓪90´42¨⓪:42Ã⓪5:¨´⓪╱à⓪⓪⓪⓪⓪67Ã3ب⓪É⓪④$ôÀ6⓪72†2¨⓪6ãŒØÉ4´⓪860¶É6´¨œõÉ7¨⓪290†É84õ´:¨2¨É37¨⓪2¶0ÀÕ62öù╱à⓪⓪⓪⓪⓪ À9Ãû⓪$ôØ⓪64ŒØÉ:7É5Ã7†É7ø⓪0Ã<É0Ã2⓪0À6⓪4Ã1ÃÀÕatibilities with other 
  1183.      programs you discover. Unfortunately, I did not find out until the very
  1184.      last minute that STARTGEM does not work with TOS 1.4. I will try to
  1185.      find a way around this as soon as possible, and again/äê✓⇩⇦⇧ê⇦ê    נÇ⇦✓⇦äO≡pנננננÇ⇩⇧üנêéëנÇ⇧נÇéOëé⇦ê ⇧נÇ⇩⇧éêAנÇ⇨êêê⇦נÇêOÿ①ÿijÉ⓪⇧נÇê⇦ä⇩äOÇ⇦≡pנננננéêÇ⇦Ç⇧éנîê ✓⇦OÄÄ⇩⇧Ä üê@נäOêéÄ⇧üéAנÇêOüÄ⇦⇧נüé✓@נÆ✓נéOüé✓O≡pנננננüâêOçäÇ✓⇦ÄAנçüê⇦✓Oäê✓⇩⇦⇧ê⇦ijנßëIJנé✓נéH⇦êOçÄ⇦üנÇ✓נÄOÇ⇦✓⇦נê⇦Ç◆IJנ≡pנננננüÄ✓OחijOÇ✓êנüâêOäê✓⇩⇦⇧äÄ⇧émally.
  1186.  
  1187.      A very important feature of the color control is this: You can select
  1188.      any resolution desktop file (we'll see how to do this later), and the
  1189.      program will make visual sense out of the colors! That is, from a color
  1190.      monitor, You can load in a HI or LO res desktop, and edit the colors
  1191.      perfectly, While the screen display accurately shows what the colors
  1192.      will look like in the resolution of the chosen desktop. You'll have to
  1193.      experiment with this later to see what I
  1194.      fee for these modules, I can say that they will be very reasonable 
  1195.      provided that proper credit is given in the docs of the resulting 
  1196.      products. Here are some of the more interesting source codes available:
  1197.      
  1198.      AUXMOUSE.S   This module creates a completely stand alone mouse cursor, 
  1199.      that exactly duplicates the GEM mouse function. It installs cleanly in 
  1200.      the VBI, and may be removed at any time. It may be passed a list of 
  1201.      rectangles, and will return the Rectangle number and button data in 
  1202.      response to a mouse click. The rectangle list may be changed at any 
  1203.      time, to allow for secondary graphic inputs, such as simulated alert 
  1204.      boxes. Because of it's independence, it can run equally from an 
  1205.      AUTO.PRG, or under GEM. It also provides for the possibility of changing 
  1206.      the cursor form, with standard mouse data, mouse mask, and hotspot data. 
  1207.      All 3 standard resolutions are supported.
  1208.      
  1209.      FONT6X6   This is a standalone utility for printing 6x6 system fonts, 
  1210.      but only ascii codes from 1 to 127 are included. You pass it position 
  1211.      and color data, and a pointer to a standard (zero terminated) string. 
  1212.      Options are included to control both foreground and background color, as 
  1213.      well as X-RAY or BLOCKED mode. Again, this runs with or without GEM 
  1214.      surfaces, in all 3 resolutions.
  1215.      
  1216.      DRAWFILL.S This is actually a high performance graphic package which was 
  1217.      originally intended for an ST version of SUPER 3D PLOTTER (something 
  1218.      only 8 bitters would remember). Anyway, It can draw lines, draw filled 
  1219.      or unfilled boxes (with borders), and fill convex polygons with any 
  1220.      number of sides. Line clipping is also built in, allowing the user to 
  1221.      specify points anywhere in a + or - 32K range. The fill commands allow 
  1222.      16 dithered patterns in monochrome and med res., as well as the standard 
  1223.      16 colors of lo rez. As a line engine, it exceeds 1000 lines/second in 
  1224.      random line draw tests.
  1225.      
  1226.      ALERT.S   Actually, this code is somewhat imbedded in the ELF-BOOT code, 
  1227.      but I can extract it if someone is interested. It allows all the alert 
  1228.      box actions in ELF-BOOT, and could easily be modified to allow a default 
  1229.      RETURN keypress button. It's much less cumbersome than the GEM alert 
  1230.      box, and allows much more variation in size, text size, and text color. 
  1231.      Of course, the 6x6 font code is needed if the alert boxes are to contain 
  1232.      the small system font.
  1233.      
  1234.           I would also like to hear from other developers, so that we can 
  1235.      work together to insure that ELF-BOOT gets along well with, and maybe 
  1236.      even enhances other applications. There are many startup utilities out 
  1237.      there. ELF-BOOT, though it's macros, may for the first time allow the 
  1238.      user to select any startup program or desktop replacement, at boot time! 
  1239.      For example, the ramdisk transfer can be used to copy files not only to 
  1240.      a ramdisk, but to any active drive. By carefully combining this utility 
  1241.      with the other setup function, a macro could be created to setup for 
  1242.      NEO-DESK(TM), HOTWIRE(TM), or a host of other packages. The program is 
  1243.      very open ended, and I am open to changes to make ELF-BOOT support other 
  1244.      products.
  1245.      
  1246.           Finally, I wish to thank Steven Stubbs and John Aalto of the Long 
  1247.      Island ATARI user group. You have these relentless beta testers to thank 
  1248.      for beating the program bug free, and gently forcing me to add many 
  1249.      important features to ELF-BOOT. Enjoy the program!
  1250.  
  1251.                                      page 20
  1252.  
  1253.