MachII  - Mouse Accelerator with Hotkeys (and other stuff).
          Version 2.3  06-27-88.


       This program may be freely distributed but may not be used in any
       commercial product without prior written permission.
       Source available. Shareware donations ACCEPTED.


       For those who hate doc files, just type "run MachII" and then
       "Cancel" the "Can't Open Configuration File!". Now activate the
       clock window with your mouse and press the right button. The
       requester displayed has all of your options and hotkeys. Change
       them to what you like and save it. AND TRY THIS; hit Alternate-
       Escape then Amiga-F1 then type (for example) "diskcopy df0: to df1:"
       then hit Alternate-Escape again. Now press Amiga-F1. Also look at
       F1 in the requester. Read on if you're still interested.

    VERSION 2.1 USERS NOTE!

       The configuration file for version 2.2 and 2.3 is incompatible with
       2.1. A program named Convert included in this archive will convert
       it for you and preserve most (if not all) of your options. Version
       2.2 and 2.3 are compatible and need no conversion.


    FEATURES

          Hotkeys         30 macros activated with the Function keys or the
                          Amiga or Ctl-Amiga-Function keys or by typing the
                          first few letters of the macro. They may be
                          automatically recorded.
          Accelerator     Speeds up mouse movements. Adjustable.
          PopCli          Execute a NewCLI or any other command.
          Screen Blanker  Blank the screen after an adjustable
                          period of time.
          SunMouse        Activate a window by moving the mouse into it.
          ClickToFront    Move a window to the front by single or double
                          clicking in any part of it.
          Cycle           Move a window (or screen) to the back with the
                          left then right mouse button combination.
          Screen Shuffler Use Left_Amiga-M to push ANY screen to the back.
          Clock           Title bar clock with memory display, date and
                          low memory warning.
          Alarm           Set an alarm.
          Beeper          Beep every 15 minutes. Adjustable.
          Meter           Maintain online costs. Adjustable rates.
          Qualifier Accum Accumulate qualifiers to be added to a key or to
                          mouse activity such as Workbench's extended
                          selection.

          All features may be turned off. Unused hotkeys are passed through
          and may be defined on the fly. Configuration file is saved to disk.



    UPDATES:
      2.3 a.  The clock can be placed on other screens and it can pop to
              the top screen. Use the gadget WBscreen/Screen Depth/Clock
              To Top to select.
          b.  Another new gadget allows you to toggle "Cycle" on and off.
              "Cycle" allows the cycling of windows and screens with the
              left-right mouse buttons.
          c.  You can use the Function keys alone for a total of 30 hotkeys.
          d.  You can use \Y in macros to write the date. Use \y for the
              short date form.
          e.  Accelerator events now have a time stamp so it works properly
              with programs like Shanghai.
          f.  The clock has a title ("MachII") so other programs can find it.
          g.  You can use a clock left edge larger than 350 (494 for clock
              only).
      2.2 a.  There are NO commandline arguments. All options are selected
              and changed in the requester.
          b.  The time and memory display alternates with the date. The
              number of seconds that the time is displayed is adjustable
              with the `Date Delay' gadget. With clock only, the date and
              time are displayed together in the format "mm-dd-yy hh:mm:ss".
          c.  If free memory falls below 50k, the time and memory display is
              shown in red (pen 3). This value is adjustable.
          d.  You can execute commands in macros by using \X. Using "\XNewCli
              >nil: <nil:" in a macro is the same as using the Amiga-Esc
              Popcli feature.
          e.  The extra keys of the 500 and 2000 are supported.
          f.  Using ClickToFront on an already up front window does not
              try to do a WindowToFront.
          g.  You cannot create an icon and run this from the Workbench, you
              should put it in your startup-sequence.
          h.  Pressing the right mouse button will reset the qualifier
              accumulator.

      2.1 a.  All options are saved in the config file.
          b.  You can now load a config file with a hotkey macro by using
              "\fname".
          c.  Use "\b" in a macro for instant screen blanking.
          d.  Use single or double click for ClickToFront.

      2.0 a.  This is a major rewrite of Mach 1.6. Although it can still
              do everything that the old one could (and more), the method
              of setting your variables and hotkey macros has changed. It
              is about 8k larger (about 20k) but if this is to big, you can
              always use the old Mach. The nicest thing about this version
              is the ability to define a hotkey macro on the fly and if
              needed, edit it in a string gadget. There are now 20 hotkeys,
              the Amiga-Function keys and the Ctl-Amiga-Function keys.

    BUG FIXES:
              The accelerator now handles qualifiers correctly so that it
              works properly with ProWrite and will add qualifiers to
              mouse messages. If using the qualifier accumulator, you don't
              need to hold down the Amiga key when using programs like
              SnipIt or the shift key when using Workbench's extended
              selection. Clicking to front on an already up front window
              does not do a window to front.


    OVERVIEW:

      MachII is a utility program that provides many optional features
      for both CLI and WorkBench users (although it cannot be started from
      an icon). Your own configuration may be saved to disk. Each function
      key may be used as a hotkey and hotkeys may be defined on the fly.
      Other features include a SunMouse that automatically activates the
      window that the pointer is over, ClickToFront which allows you to
      bring a window to the front by single or double clicking in any part
      of it and many clock features. It is very easily configurable to your
      own desires. If you don't like a feature, just turn it off. Pop up
      the configuration requester by either activating the clock and
      pressing the right button or by typing Control-Amiga-Escape. A
      configuration file is not neccessary but without one you will get the
      defaults. You will also get a "Can't Find Configuration File"
      requester. After you have setup your macros and other options, you
      can save this to the file s:mach.config.

    USAGE:

       Run MachII

   After it is running, you may either activate the clock with the mouse
   and press the right button or press Control-Left_Amiga-ESC. This will
   pop up a requester jammed full of gadgets. All options and hotkeys
   may be modified here.

     The gadgets are:

     1st ROW
         1st:  Toggle between Amiga and Control-Amiga hotkeys.
         2nd:  Clear all hotkey definitions.
         3rd:  Abort a macro definition.
         4th:  Change the maximum macro size.
     2nd ROW
         1st:  Select each hotkey with the 'Fn' gadgets.
     3rd ROW
         1st:  Hotkey macro definitions.
     4th ROW
         1st:  Left_Amiga-ESC execute string.
     5th ROW
         1st:  Activate/deactivate SunMouse.
         2nd:  Select 0, 1 or 2 clicks for Click To Front.
         3rd:  Select Cycle on or off.
         4th:  Activate/deactivate the Amiga-M Screen Shuffler.
     6th ROW
         1st:  Activate/deactivate the Qualifier Accumulator.
         2nd:  Toggle the Clock.
         3rd:  Toggle Online Meter.
         4th:  Reset Online Meter.
     7th ROW
         1st:  Select Clock Front or Clock Depth gadget.
         2nd:  Select WBScreen, Screen Depth, or Clock To Top.
         3rd:  Select Clock Only or Clock + Mem.
     8th ROW
         1st:  Select the Clock's left edge.
         2nd:  Select the Clock's top edge.
         3rd:  Select the number of seconds for the time to display.
         4th:  Select online rate. ($00.00 - $99.99)
     9th ROW
         1st:  Select blanking interval. (0-99 minutes)
         2nd:  Select beep interval. (0-999 minutes)
         3rd:  Set the alarm time. 24 hour format.
         4th:  Change the acceleration rate. (0-9)
     10th ROW
         1st:  Step through the 4 special functions.
         2nd:  Select a key for the special function.
         3rd:  Set the memory level to receive low memory warning.
     11th ROW
         1st:  Select the Alternate qualifier for the special function.
         2nd:  Select the Control qualifier for the special function.
         3rd:  Select the Shift qualifier for the special function.
         4th:  Select the Amiga and C= qualifiers for the special function.
     12th ROW
         1st:  Configuration file name.
     13th ROW
         1st:  Done.
         2nd:  Load configuration file.
         3rd:  Save configuration file.
         4th:  Remove MachII.


     Hotkeys:

       There are 30 hotkeys. 10 Function keys, 10 Amiga-Function keys and
       10 Ctl-Amiga-Function keys. "Hotkey" referred to here will mean any
       one of these. In the requester you can select each Function key with
       the 'Fn' gadgets and select the Ctl-Amiga/Amiga/None gadget. The
       macros may be edited in the string gadget. The default maximum macro
       size is 255 characters but this may be changed in the size gadget.
       You cannot change the size while you are creating a new macro and
       the new macro size will not take effect until you select "Done".
       This controls the size of dynamic buffers which are allocated only
       during macro definition or when the requester is up. The actual
       macros take up only as much space as they need.

       Macros are invoked either by hitting the hotkey or by hitting Shift-
       Alternate-Escape and then type some of the first letters of the
       macro and then return. The first macro found that matches will be
       executed. If none is found there will be a beep. See the Special
       Keys section for changing the keys used.

       To define a macro, type Alternate-Escape, then a hotkey and the type
       your macro. During these steps, you will be prompted by messages in
       the clock and by beeps. You may use any keys including qualifiers,
       arrow keys and numeric keypad keys. When finished, hit Alternate-
       Escape again. You may now use your macro by hitting the selected
       hotkey or by hitting Shift-Alternate-Escape, enough characters to
       uniquely match the macro followed by return. You may also edit the
       macro in a string gadget by hitting Control-Amiga-Escape or by
       activating the clock window and pressing the right mouse button. All
       of these special keys can be changed to your own preferences.
       You may also enter your macro directly in the string gadget. Use
       \A for any Alternate key sequences rather than entering the actual
       Alternate-key.

       Sample recording and playback session: (Special keys are shown in <>)

       <Alt-Esc><Amiga-F1>Diskcopy df0: to df1:<Alt-Esc>

       'Diskcopy df0: to df1:' is now bound to the Amiga-F1 combination.
       To play this back, you can type either:

       <Amiga-F1>

       Or

       <Shift-Alt-Esc>dis<Return>

       The second method searches until it finds a macro whose first letters
       match 'dis' and then plays the rest back. This is useful if you don't
       remember the function key but do remember what it begins with. If you
       also had a macro that began with 'disp' and it was before 'diskc...',
       and you typed only 'dis' the first one matching 'dis' would be played
       back. In this case you would need to type 'disk'.

       You may start a learning period, do a series of complex editing
       commands and then replay all of it. Or edit it and save for later
       use. This is especially useful when using word processors that don't
       have macro abilities built in.

       The escape character "\" may be used for the following:

           \N  Newline (return).
           \T  Tab.
           \E  Escape.
           \D  Del.
           \B  Backspace.
           \H  Help.
           \u  Up arrow.
           \d  Down arrow.
           \l  Left arrow.
           \r  Right arrow.
           \0  Numeric pad 0.
            .
            .
           \9  Numeric pad 9.
           \.  Numeric pad ".".
           \-  Numeric pad "-".
           \e  Numeric pad ENTER.
           \(  Numeric pad "(".  (Amigas 500 and 2000 only)
           \)  Numeric pad ")".  (Amigas 500 and 2000 only)
           \*  Numeric pad "*".  (Amigas 500 and 2000 only)
           \+  Numeric pad "+".  (Amigas 500 and 2000 only)
           \/  Numeric pad "/".  (Amigas 500 and 2000 only)
           \F1 Function key 1.
            .
            .
           \F0 Function key 10.

           \Y  Write the current date in the long form.
           \y  Write the current date in the short form.
           \b  Instant screen blanking.
           \f  Load config file using name following f.
           \X  Execute the string following X.

               These last five are special in that they cannot be recorded
               live but must be entered in the string gadget.
               \ffilename and \Xstring must be at the end of the macro.

         Qualifiers modify the character immediately following these:

           \C  Control.
           \S  Shift.
           \A  Alternate.
           \L  Left-Amiga.
           \R  Right-Amiga.

       An example:

         \Cc\u\A\S\l

         This plays back the key combinations:
         'Control-C' 'up arrow' and 'alternate shift left arrow'

       Function keys not assigned to a hotkey string are passed through.
       Escaped letters are case sensitive.
       Note above that function key numbers are single digits. This means
       that 0 is F10, 1 is F1, 9 is F9.


    Accelerator:

       The accelerator speeds up mouse movements. Its speed is set 0 - 9.
       0 = no acceleration.

    NewCLI:

       The Left-Amiga and ESCape combination will create a NewCLI.
       You need to have NewCLI and Run in the c: directory. The NewCLI
       will have the same size stack as MachII. You can change the command
       in the execute string gadget.
       A full window example is "NewCLI CON:0/0/640/200/MyCLI".
       You can also use the \X feature in a macro to execute a string.

    Screen Blanker:

       After 5 minutes of no mouse or keyboard activity, the screen will
       go blank. You can change this default in the Blanking gadget.
       You can use \b in a macro for instant blanking.
       0 disables blanking.

    Sun Mouse:

       The window that the pointer is over becomes the active window
       after the first mouse movement. To be able to drag icons, the
       SunMouse is disabled while the left button is held down.
       Turn on or off with the "SunMouse" gadget.

    Click To Front:

       You can single or double click in any part of a window and bring it
       to the front.
       Select 0, 1, or 2 clicks with the "Click" gadget.

    Cycle:

       You can push the window that is under the mouse to the back by
       holding the left button down and clicking the right button (the
       opposite of extended menu selection). If there are no windows or
       just one window, the screen will be pushed to the back.
       Turn on or off with the "Cycle" gadget.


    Screen Shuffler:

       Left_Amiga-M will push the front screen to the back instead of
       pushing workbench to the back. Left_Amiga-N will still bring the
       workbench to the front. This is useful if you have more than two
       screens on at once, especially if they don't have screen depth
       gadgets.
       Turn on or off with the "Amiga-M" gadget.

    Qualifier Accumulator:

       Many disabled people find it difficult if not impossible to type key
       combinations such as Control-Shift-F1. MachII has the ability to
       remember qualifiers that are pressed and add them to the first
       non-qualifier key pressed. So you could for example, type Control,
       Alternate, and then F1. The Control and Alternate would be added to
       the F1 just as if they were pressed at the same time. This is not
       intended for someone who doesn't need it as it sometimes may cause
       unexpected results. For example, if you type Control and then change
       your mind, the Control will still be added to the next key pressed.
       Pressing Caps Lock or the right mouse button will reset the
       qualifier accumulator.
       This may also be used with Workbench's extended selection. Hit the
       Shift key, then click on your icons. Hit any non-qualifier key or
       the right mouse button to clear the Shift.
       Turn on or off with the "Qual Accum" gadget.

    Clock:

       There is a title bar clock that displays available memory and the
       time. The clock is updated every second and brings itself to the
       front (if covered up) every 4 seconds except when the left button is
       held down. Sometimes this covers up information in the title bar so
       if you don't like this use the "Clock Front"/"Clock Depth" gadget.
       This disables the auto upfront and adds an (almost) invisible depth
       gadget. The date alternates with the time and memory display. The
       length of time that the time is displayed is adjustable with the
       "Date Delay" gadget. The time and memory are displayed in red (pen
       3) if your total free memory falls below 50k. You can change this
       value in the "Low Mem" gadget. You can use the "Clock Only"/
       "Clock+Mem" gadget and get the clock and date displayed together in
       the format "mm-dd-yy hh:mm:ss".

       Positioning the clock:

       You can change the clock's left and top edge in the requester
       gadgets "Clock LE" and "Clock TE". These are the current left edge
       and top edge for the clock. There are 3 methods for setting these.

       1. You can position the clock then pop up the requester and save the
          new position.
       2. Enter -1 and 'return'. The gadgets will then be updated.
       3. Enter the desired values in the gadgets.

       The width for the clock alone is 146 pixels. The clock with memory
       display is 290 pixels wide.

       The Clock and other screens:

       There is a gadget above the "ClockTE" gadget that will let you make
       three choices.
       1. WBScreen - The clock will remain on the workbench screen.
       2. Screen Depth - This adds an invisible depth gadget to the clock.
          With it you can place the clock on other screens.
       3. Clock To Top - The clock will automatically pop to the top screen
          when this is selected.
       Options 2 and 3 replace the CloseScreen vector to allow MachII to
       close its windows. Selecting option 1 or removing MachII will put
       back the original vector. If another program also replaced the
       vector, you will be given the opportunity to terminate that program
       before the original vector is replaced. If you get a requester with
       the message "CloseScreen Vectors Were Changed!", either terminate
       the program that changed the vectors and click Retry or just click
       Cancel.
       You cannot change these options while on another screen.

       Turn the clock on or off with the "Clock" gadget.

    Alarm:

       You may set 1 alarm time in 24 hour format. When it goes off, it
       will beep longer than the interval beeper and the screen will
       flash. Set to greater than 2400 for no alarm.

    Beeper:

       There is a beeper (to keep you awake) which defaults to a 15
       minute interval. Change this in the Beeping gadget.

    Meter:

       MachII has an online cost meter. Use the "Meter" gadget to toggle
       between the meter and the clock. Use the "Reset" gadget to reset the
       meter. The rate that it uses may be set in the "Rate" gadget.
       The meter runs continuously whether visible or not. The default rate
       is $4.75.

    Special Keys:

       There are 4 special functions selectable from 33 (or 38 for the 500
       and 2000) special keys and 5 qualifiers. They all have default
       values but these may be changed in the requester.

       Start/Stop - This starts or stops a macro definition or learning
                    period. Type the key combination, then type the hotkey
                    that you want this macro to be bound to, then type your
                    macro. When finished, type the key combination again.
                    This ends the learning period. You may now execute the
                    macro by typing the hotkey. You may also view or edit
                    the macro in the string gadget in the requester.
                    Default key = Alternate-Escape.

       Execute -    This executes the NewCli command. You may change the
                    executed command in the requester.
                    Default key = Amiga-Escape.

       Requester -  This pops up the requester just like the pointer over
                    the clock and the right button does.
                    Default key = Control-Amiga-Escape.

       Matcher -    This is used to find and execute a macro. To match,
                    type the key combination, then type enough letters
                    that match the desired macro, then type 'return'. The
                    rest of the macro will be executed.
                    Default key = Shift-Alternate-Escape.

       Note that selecting 'C= / Amiga' allows you to use either the Left
       Amiga (C=) key or the Right Amiga key. Clicking on the left half of
       the Special Key gadget steps down through the keys, clicking on the
       right half steps up. The special keys are: Tab, Escape, F1-F10, Del,
       BackSpace, Return, Help, all arrow keys and all numeric keypad keys.
       The 500 and 2000 have 5 keys that the 1000 doesn't, the numeric pad
       keys "(", ")", "*", "+", "/".


    Uninstall:

       Use the Remove gadget to uninstall MachII.



    MISCELLANEOUS:

       When a string gadget (or any gadget anywhere) is active, the
       SunMouse will not work.

       When WordPerfect has a requester up, it tries to keep the requester's
       window active. If MachII has the SunMouse option on, every mouse
       move will activate a window and then WP will activate its requester's
       window. The only thing to do is turn off the SunMouse or hold down
       the left button.

       This program will NOT work from Workbench. Put it in your
       startup-sequence. Use RunBack or ARun to allow the CLI window
       to close.

       Let me know if you find any incompatibilities.

       MachII may fail to run for any number of reasons (e.g. no free
       signals, insufficient memory). You will be informed of this if it is
       started with the Run command. If started from RunBack or
       RunBackGround (public domain program that will allow the CLI window
       to close and available on Fred Fish disk # 65) and MachII fails,
       you won't get any messages. The ARP command ARun may also be used.

       The NewCLI brought up by Left_Amiga-ESC will have a stack the same
       size as MachII. Many programs that you may run from this CLI need a
       larger stack so either run MachII with a larger stack or, after you
       get a NewCLI, use the stack command to set your stack to a larger
       value. If programs mysteriously crash when run from the NewCLI, it
       may be caused by the stack size.

       If the macro size is set too small and you try to load a config file
       with longer macros, you will get a "Not A Mach Configuration File!"
       message. If you set the size too small and then select "Done" then
       activate the requester again, the macro size will be set to the
       size needed for the largest macro.








       Copyright 1988 by Brian Moats
                         Polyglot Software
                         10431 Ardyce Court
                         Boise, Idaho 83704
                         (208) 375-3741

                         PeopleLink - BrianM
                         CI$        - 76167,2334







  Other programs for the Amiga 500/1000/2000 from Polyglot Software:


  M18Cheater - Lets you cheat in Mean 18 by causing your opponent to
               slice. Public domain.
----------------------------------------------------------------------------
  FunBut - Lets you use the F1 key instead of the left mouse button.
           It's useful when playing games like Defender of the Crown
           because it sends repeat mouse clicks.  Public Domain.
----------------------------------------------------------------------------
  4 IN ONE - Four easy to play games on one disk.

             SlotCars          For 1 or 2 players, arcade type driving and
                               shooting game. Seven screens, great graphics.

             CircuitMania      For 1 or 2 players, surround your opponent
                               in a maze of wires.

             ShufflePuzzle     Like the sliding number puzzles that you used
                               to play as a kid but this uses beautiful color
                               pictures.

             Follow That Tune  Follow the bouncing boy as he jumps from
                               pedestal to pedestal playing musical notes.

             These games are integrated into an easy to use package.
             Enjoyable for all ages. All use digitized sound.  $29.95
----------------------------------------------------------------------------

  Dominoes - 3d graphics, speech, tutorial. More entertaining and
             challenging than Shanghai.  $24.95
----------------------------------------------------------------------------

  The Crossword Creator - Make or solve crossword puzzles. 40,000+ word
                          pattern matching dictionary, med-res or interlace,
                          IFF compatible and many more features. $49.95