home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d1xx / d163 / machii.lha / MachII / MachII.doc < prev    next >
Text File  |  1988-11-22  |  32KB  |  746 lines

  1.  
  2. MachII    - Mouse Accelerator with Hotkeys (and other stuff).
  3.       Version 2.4c    09-23-88.
  4.  
  5.  
  6.        This program may be freely distributed but may not be used in any
  7.        commercial product without prior written permission.
  8.        Source available. Shareware donations ACCEPTED.
  9.  
  10.  
  11.        For those who hate doc files, just type "run MachII" and then
  12.        "Cancel" the "Can't Open Configuration File!". Now activate the
  13.        clock window with your mouse and press the right button. The
  14.        requester displayed has all of your options and hotkeys. Change
  15.        them to what you like and save it. AND TRY THIS; hit Alternate-
  16.        Escape then Amiga-F1 then type (for example) "diskcopy df0: to df1:"
  17.        then hit Alternate-Escape again. Now press Amiga-F1. Also look at
  18.        F1 in the requester. Read on if you're still interested.
  19.  
  20.  
  21.     FEATURES
  22.  
  23.       Hotkeys      30 macros activated with the Function keys or the
  24.               Amiga or Ctl-Amiga-Function keys or by typing the
  25.               first few letters of the macro. Macros may be
  26.               automatically recorded and may include mouse
  27.               buttons.
  28.       Auto Execute      Automatically execute macros at startup or at a
  29.               specific preset time.
  30.       Help Screen      Display a chart with the current macro definitions.
  31.       Accelerator      Speeds up mouse movements. Adjustable.
  32.       PopCli      Execute a NewCLI or any other command.
  33.       Screen Blanker  Blank or dim the screen after an adjustable
  34.               period of time.
  35.       Mouse Off      Turn off the mouse after a specified number of
  36.               seconds with no mouse activity.
  37.       SunMouse      Activate a window by moving the mouse into it.
  38.       ClickToFront      Move a window to the front by single or double
  39.               clicking in any part of it.
  40.       Cycle       Move a window (or screen) to the back with the
  41.               left then right mouse button combination.
  42.       Screen Shuffler Use Left_Amiga-M to push ANY screen to the back.
  43.       Clock       Optional title bar clock with memory display, date
  44.               and low memory warning.
  45.       Alarm       Set an alarm.
  46.       Beeper      Beep every 15 minutes. Adjustable.
  47.       Meter       Maintain online costs. Adjustable rates.
  48.       Qualifier Accum Accumulate qualifiers to be added to a key or to
  49.               mouse activity such as Workbench's extended
  50.               selection.
  51.  
  52.       All features may be turned off. Unused hotkeys are passed through
  53.       and may be defined on the fly. Configuration file is saved to disk.
  54.       See the SPECIAL KEYS section near the end for a description of all
  55.       definable keys.
  56.  
  57.  
  58.  
  59.     UPDATES:
  60.       2.4c a.  A primitive method for recording mouse button clicks is now
  61.            included.
  62.        b.  \annnn may be used to automatically execute macros upon
  63.            startup if nnnn = 0 or at the time nnnn (24 hour format).
  64.        c.  The clock now has a "Memory Only" display option.
  65.        d.  The date is displayed whenever the clock window is active (if
  66.            you are in the clock + memory mode).
  67.        e.  The word "Time" has been removed. (By popular demand)
  68.        f.  The clock window will now have a border on 1 plane screens.
  69.        g.  \Pnn may be used to pause nn seconds. Used mainly to delay
  70.            between mouse clicks but can also be used to allow user input.
  71.        h.  \G may be used to beep.
  72.        i.  \Q may be used to remove MachII.
  73.        j.  \h or \hnnn may be used to pop up a help screen with macro
  74.            definitions. The optional nnn specifies the screen height.
  75.        k.  When using Amiga-N or Amiga-M, the window under the pointer
  76.            will become the active window (if SunMouse is active).
  77.        l.  The screen blanker has been changed to dim the front screen.
  78.            The brightness level is adjustable. A value of 0 will blank
  79.            the screen in the same way as before.
  80.        m.  A mouse off feature as been added. Adjustable delay.
  81.        n.  A subtle bug in event timestamps that caused sporadic lockups
  82.            is fixed. (Finally!)
  83.        o.  Macros invoking other macros now function in a true recursive
  84.            manner.
  85.        p.  A \ may be used to terminate a \fstring or \Xstring.
  86.        q.  ESCape will abort an executing macro.
  87.        r.  Task priority is lowered to 4 (below con:) during macro output
  88.        s.  Moving icons with no clock now works.
  89.  
  90.       2.4b     Internal upgrade.
  91.       2.4a     Internal upgrade.
  92.  
  93.       2.3  a.  The clock can be placed on other screens and it can pop to
  94.            the top screen. Use the gadget WBscreen/Screen Depth/Clock
  95.            To Top to select.
  96.        b.  Another new gadget allows you to toggle "Cycle" on and off.
  97.            "Cycle" allows the cycling of windows and screens with the
  98.            left-right mouse buttons.
  99.        c.  You can use the Function keys alone for a total of 30 hotkeys.
  100.        d.  You can use \Y in macros to write the date. Use \y for the
  101.            short date form.
  102.        e.  Accelerator events now have a time stamp so it works properly
  103.            with programs like Shanghai.
  104.        f.  The clock has a title ("MachII") so other programs can find it
  105.        g.  You can use a clock left edge larger than 350 (494 for clock
  106.            only).
  107.  
  108.       2.2  a.  There are NO commandline arguments. All options are selected
  109.            and changed in the requester.
  110.        b.  The time and memory display alternates with the date. The
  111.            number of seconds that the time is displayed is adjustable
  112.            with the `Date Delay' gadget. With clock only, the date and
  113.            time are displayed together in the format "mm-dd-yy hh:mm:ss".
  114.        c.  If free memory falls below 50k, the time and memory display is
  115.            shown in red (pen 3). This value is adjustable.
  116.        d.  You can execute commands in macros by using \X. Using
  117.            "\XNewCli >nil: <nil:" in a macro is the same as using the
  118.            Amiga-Esc Popcli feature.
  119.        e.  The extra keys of the 500 and 2000 are supported.
  120.        f.  Using ClickToFront on an already up front window does not
  121.            try to do a WindowToFront.
  122.        g.  You cannot create an icon and run this from the Workbench, you
  123.            should put it in your startup-sequence.
  124.        h.  Pressing the right mouse button will reset the qualifier
  125.            accumulator.
  126.  
  127.       2.1  a.  All options are saved in the config file.
  128.        b.  You can now load a config file with a hotkey macro by using
  129.            "\fname".
  130.        c.  Use "\b" in a macro for instant screen blanking.
  131.        d.  Use single or double click for ClickToFront.
  132.  
  133.       2.0  a.  This is a major rewrite of Mach 1.6. Although it can still
  134.            do everything that the old one could (and more), the method
  135.            of setting your variables and hotkey macros has changed. It
  136.            is about 8k larger (about 20k) but if this is to big, you can
  137.            always use the old Mach. The nicest thing about this version
  138.            is the ability to define a hotkey macro on the fly and if
  139.            needed, edit it in a string gadget. There are now 20 hotkeys,
  140.            the Amiga-Function keys and the Ctl-Amiga-Function keys.
  141.  
  142.     OVERVIEW:
  143.  
  144.      MachII is a utility program that provides many optional features
  145.        for both CLI and WorkBench users (although it cannot be started from
  146.        an icon). Your own configuration may be saved to disk. Each function
  147.        key may be used as a hotkey and hotkeys may be defined on the fly.
  148.        They may also include mouse button clicks.
  149.      Other features include a SunMouse that automatically activates the
  150.        window that the pointer is over, ClickToFront which allows you to
  151.        bring a window to the front by single or double clicking in any part
  152.        of it and many clock features. It is very easily configurable to your
  153.        own desires. If you don't like a feature, just turn it off. Pop up
  154.        the configuration requester by either activating the clock and
  155.        pressing the right button or by typing Control-Amiga-Escape. A
  156.        configuration file is not neccessary but without one you will get the
  157.        defaults. You will also get a "Can't Find Configuration File"
  158.        requester. After you have setup your macros and other options, you
  159.        can save this to the file s:mach.config.
  160.  
  161.     USAGE:
  162.  
  163.        Run MachII
  164.  
  165.        After it is running, you may either activate the clock with the
  166.        mouse and press the right button or press Control-Amiga-ESC.
  167.        This will pop up a requester jammed full of gadgets. All options
  168.        and hotkeys may be modified here.
  169.  
  170.     The gadgets are:
  171.  
  172.      1st ROW
  173.      1st:  Toggle between Amiga, Control-Amiga and None hotkeys.
  174.      2nd:  Clear all hotkey definitions.
  175.      3rd:  Abort a macro definition.
  176.      4th:  Change the maximum macro size.
  177.      2nd ROW
  178.      1st:  Select each hotkey with the 'Fn' gadgets.
  179.      3rd ROW
  180.      1st:  Selected hotkey macro definition.
  181.      4th ROW
  182.      1st:  Amiga-ESC execute string.
  183.      5th ROW
  184.      1st:  Activate/deactivate SunMouse.
  185.      2nd:  Select 0, 1 or 2 clicks for Click To Front.
  186.      3rd:  Select Cycle on or off.
  187.      4th:  Activate/deactivate the Amiga-M Screen Shuffler.
  188.      6th ROW
  189.      1st:  Activate/deactivate the Qualifier Accumulator.
  190.      2nd:  Toggle the Clock.
  191.      3rd:  Toggle Online Meter.
  192.      4th:  Reset Online Meter.
  193.      7th ROW
  194.      1st:  Select Clock Front or Clock Depth gadget.
  195.      2nd:  Select WBScreen, Screen Depth, or Clock To Top.
  196.      3rd:  Select Clock Only, Mem Only or Clock+Mem.
  197.      8th ROW
  198.      1st:  Set the Clock's left edge.
  199.      2nd:  Set the Clock's top edge.
  200.      3rd:  Set the seconds to alternate time and date. 0=time only.
  201.      4th:  Select online rate. ($00.00 - $99.99)
  202.      9th ROW
  203.      1st:  Select blanking interval (0-99 minutes).
  204.      2nd:  Dimness level. 0 = Black, 15 = no change.
  205.      3rd:  Mouse off delay (0-99 seconds).
  206.      4th:  Select beep interval (0-999 minutes).
  207.      5th:  Set the alarm time. 24 hour format.
  208.      6th:  Change the acceleration rate (0-9).
  209.      10th ROW
  210.      1st:  Step through the 4 special functions.
  211.      2nd:  Select a key for the special function.
  212.      3rd:  Set the memory level to receive low memory warning.
  213.      11th ROW
  214.      1st:  Select the Alternate qualifier for a special function.
  215.      2nd:  Select the Control qualifier for a special function.
  216.      3rd:  Select the Shift qualifier for a special function.
  217.      4th:  Select the Amiga and C= qualifiers for a special function.
  218.      12th ROW
  219.      1st:  Configuration file name.
  220.      13th ROW
  221.      1st:  Done.
  222.      2nd:  Load configuration file.
  223.      3rd:  Save configuration file.
  224.      4th:  Remove MachII.
  225.  
  226.  
  227.     HOTKEYS:
  228.  
  229.        There are 30 hotkeys; 10 Function keys, 10 Amiga-Function keys and
  230.        10 Ctl-Amiga-Function keys. "Hotkey" referred to here will mean any
  231.        one of these. Macro will mean the definition given to a hotkey. In
  232.        the requester you can select each Function key with the 'Fn' gadgets
  233.        and select the Ctl-Amiga/Amiga/None gadget. The macros may be edited
  234.        in the string gadget. The default maximum macro size is 255 charac-
  235.        ters but this may be changed in the size gadget. You cannot change
  236.        the size while you are creating a new macro and the new macro size
  237.        will not take effect until you select "Done". This controls the size
  238.        of dynamic buffers which are allocated only during macro definition
  239.        or when the requester is up. The actual macros take up only as much
  240.        space as they need.
  241.  
  242.        Macros are invoked either by hitting the hotkey or by hitting Shift-
  243.        Alternate-Escape and then type some of the first letters of the
  244.        macro and then return. The first macro found that matches will be
  245.        executed. If none is found there will be a beep. See the Special
  246.        Keys section for changing the keys used.
  247.  
  248.     Defining Macros:
  249.  
  250.        To define a macro, type Alternate-ESCape, then a hotkey and the type
  251.        your macro. During these steps, you will be prompted by messages in
  252.        the clock and by beeps. You may use any keys including qualifiers,
  253.        arrow keys, numeric keypad keys and mouse buttons. When finished,
  254.        hit Alternate-ESCape again. You may now use your macro by hitting
  255.        the selected hotkey or by hitting Shift-Alternate-ESCape, enough
  256.        characters to uniquely match the macro followed by return. You may
  257.        also edit the macro in a string gadget by hitting Control-Amiga-
  258.        ESCape or by activating the clock window and pressing the right
  259.        mouse button. All of these special keys can be changed to your own
  260.        preferences. You may also enter your macro directly in the string
  261.        gadget.
  262.  
  263.        Sample recording and playback session: (Special keys are shown in <>)
  264.  
  265.        <Alt-ESC><Amiga-F1>Diskcopy df0: to df1:<Alt-ESC>
  266.  
  267.        'Diskcopy df0: to df1:' is now bound to the Amiga-F1 combination.
  268.        To play this back, you can type either:
  269.  
  270.        <Amiga-F1>
  271.  
  272.        Or
  273.  
  274.        <Shift-Alt-ESC>dis<Return>
  275.  
  276.        The second method searches until it finds a macro whose first letters
  277.        match 'dis' and then plays the rest back. This is useful if you don't
  278.        remember the function key but do remember what it begins with. If you
  279.        also had a macro that began with 'disp' and it was before 'diskc...',
  280.        and you typed only 'dis' the first one matching 'dis' would be played
  281.        back. In this case you would need to type 'disk'.
  282.  
  283.        You may start a learning period, do a series of complex editing
  284.        commands and then replay all of it. Or edit it and save for later
  285.        use. This is especially useful when using word processors that don't
  286.        have macro abilities built in.
  287.  
  288.     Help Screen:
  289.  
  290.        A help screen with the macro definitions partially displayed in a
  291.        chart can be popped up by using \h in a macro. Executing that macro
  292.        again will close the screen. \hnnn may be used to also specify the
  293.        height of the screen. You could use a height of 200, push the clock
  294.        to that screen and open the requester and have both available at all
  295.        times. 52 is the minimum height. The screen opens an interlaced screen
  296.        if the front screen is interlaced.
  297.  
  298.     Recording mouse clicks:
  299.  
  300.        Mouse clicks may be recorded or entered in the gadget. When a click
  301.        is detected, MachII puts in the mouse's position, which button and
  302.        whether it is pressed or released. For example: "\Mx155\My075\Mld"
  303.        when played back, the mouse will be moved to x = 155, y = 75 and a
  304.        left button down will be sent. A \P will be inserted for every
  305.        second delay between clicks. This will allow for menus to drop or
  306.        requesters and windows to open. You may delete them from your macro
  307.        when not needed. Do not depend on the SunMouse to activate a window
  308.        on playback. The mouse will be moved to the same position as when
  309.        recorded which may not be over the desired gadget or icon. A
  310.        qualifier such as Shift (\S) will be placed before the first \M and
  311.        will have effect over the mouse positioning and the first click.
  312.        e.g. \S\Mx330\My122\Mld.
  313.  
  314.     Escaped keys:  (all case sensitive)
  315.  
  316.        The escape character "\" may be used for the following:
  317.  
  318.        \N  Newline (return).
  319.        \T  TAB.
  320.        \E  ESCape.
  321.        \D  DELete.
  322.        \B  BACKSPACE.
  323.        \\  Backslash.
  324.        \H  HELP.
  325.        \u  Up arrow.
  326.        \d  Down arrow.
  327.        \l  Left arrow.
  328.        \r  Right arrow.
  329.        \0  Numeric pad 0.
  330.         .
  331.         .
  332.        \9  Numeric pad 9.
  333.        \.  Numeric pad ".".
  334.        \-  Numeric pad "-".
  335.        \e  Numeric pad ENTER.
  336.        \(  Numeric pad "(".  (Amigas 500 and 2000 only)
  337.        \)  Numeric pad ")".  (Amigas 500 and 2000 only)
  338.        \*  Numeric pad "*".  (Amigas 500 and 2000 only)
  339.        \+  Numeric pad "+".  (Amigas 500 and 2000 only)
  340.        \/  Numeric pad "/".  (Amigas 500 and 2000 only)
  341.        \F1 Function key 1.
  342.         .
  343.         .
  344.        \F0 Function key 10.
  345.  
  346.  
  347.        \Y  Write the current date in the long form.
  348.        \y  Write the current date in the short form.
  349.        \b  Instant screen blanking.
  350.        \f  Load config file using name following f.
  351.        \X  Execute the string following X.
  352.        \Pnn Pause nn seconds.
  353.        \Q  Quit. Remove MachII.
  354.        \G  Beep.
  355.        \a  Automatically execute the macro following "\a" upon startup.
  356.            More than one macro may have the \a and all will be executed.
  357.            First executed are the Amiga Function keys 1-10, then the Ctl-
  358.            Amiga Function keys 1-10, then the Function keys 1-10 with
  359.            no qualifiers.
  360.            The \a may be followed by a time in 24 hour format. The macro
  361.            will be executed at that time. e.g. "\a1045\G" At 10:45, beep.
  362.        \h  Display or close a help screen with macro definitions. Use
  363.            \hnnn to specify the screen height. Minimum height = 52.
  364.  
  365.          These last ten are unique in that they cannot be recorded
  366.          live but must be entered in the string gadget. (The \P is
  367.          however also recorded during mouse clicks).
  368.          \ffilename and \Xstring must be terminated with a "\" if not
  369.          at the end of the macro. e.g. "\XNewCLI\Dir\N" or
  370.          "\XComm\\F1\F2". Note the 2 \s after "Comm". One terminates the
  371.          "\XComm" string and one introduces a function key.
  372.          Following a \ffilename with more commands may cause problems
  373.          when the new config file is loaded unless it has an identical
  374.          macro in the same location.
  375.  
  376.        \M  Mouse info follows this.
  377.          \Mxnnn  Send Mouse x coordinates.
  378.          \Mynnn  Send Mouse y coordinates.
  379.          \Mld     Send left button down.
  380.          \Mlu     Send left button up.
  381.          \Mrd     Send right button down.
  382.          \Mru     Send right button up.
  383.  
  384.      Qualifiers modify the character or mouse activity immediately
  385.      following these:
  386.  
  387.        \C  Control.
  388.        \S  Shift (either one).
  389.        \A  Alternate (either one).
  390.        \L  Left-Amiga.
  391.        \R  Right-Amiga.
  392.  
  393.        An example:
  394.  
  395.      \Cc\u\A\S\l
  396.  
  397.      This plays back the key combinations:
  398.      'Control-c' 'up arrow' and 'alternate shift left arrow'
  399.  
  400.     Auto Execution:
  401.  
  402.        \annnn is the auto execution command. If nnnn = 0 or is omitted,
  403.        the macro will be automatically executed when MachII is started
  404.  
  405.        An example:
  406.        "\a\XNewCli <Nil: >Nil:" will open a new CLI window automatically.
  407.  
  408.        If nnnn equals a time of 0001 to 2359, the macro will be executed at
  409.        that time.
  410.  
  411.        Another example:
  412.        "\a930\XNewcli CON:220/50/200/50/Alarm\Call Joe\G\P3\CXEndCLI >nil:\N"
  413.        At 9:30 this will open a newcli in the center of the screen, print
  414.        the text "Call Joe", beep, pause 3 seconds, delete (control-x) the
  415.        text and end the CLI window. Note the "\" terminating the newcli
  416.        string.
  417.  
  418.        The first hotkeys executed are the Amiga Function keys 1-10, then
  419.        the Ctl-Amiga Function keys 1-10, then the Function keys 1-10 with
  420.        no qualifiers. \a macros may also be executed manually. The clock
  421.        need not be displayed for this feature to work.
  422.  
  423.     Miscellaneous:
  424.  
  425.        Function keys not assigned to a hotkey string are passed through.
  426.        Escaped letters are case sensitive.
  427.        Note above that function key numbers are single digits. This means
  428.        that 0 is F10, 1 is F1, 9 is F9.
  429.  
  430.        Macros may not be used for input during a \Pause.
  431.  
  432.        A macro may be aborted during execution with the ESCape key.
  433.  
  434.        Use \A for any Alternate key sequences rather than entering the
  435.        actual Alternate-key in the string gadget.
  436.  
  437.        If a hotkey is embedded in a macro and the macro for that hotkey
  438.        is null, the key is passed through. Otherwise the macro is executed.
  439.        Got that?
  440.  
  441.     ACCELERATOR:
  442.  
  443.        The accelerator speeds up mouse movements. Its speed is set 0 - 9.
  444.        0 = no acceleration.
  445.  
  446.     NEWCLI:
  447.  
  448.        The Amiga and ESCape combination will create a NewCLI. You need to
  449.        have NewCLI and Run in the c: directory. The NewCLI will have the
  450.        same size stack as MachII. You can change this command in the
  451.        execute string gadget. A full window example is "NewCLI
  452.        CON:0/0/640/200/MyCLI". You can also use the \X feature in a macro
  453.        to execute a string.
  454.  
  455.     SCREEN BLANKER:
  456.  
  457.        After 5 minutes of no mouse or keyboard activity, the screen will
  458.        dim. You can change the time and brightness defaults in the "Blanking"
  459.        gadget. The first number is the time delay in minutes and the second
  460.        number is the brightness. 0-15 with 0 black and 15 no dimming. The
  461.        numbers 0-6 are the only really useful values. 0 blanks the screen
  462.        by opening a new screen in front. The other values dim only the front
  463.        screen.
  464.        You can use \b in a macro for instant blanking.
  465.        0 delay disables blanking.
  466.  
  467.     MOUSE OFF:
  468.  
  469.        After 10 seconds of no mouse activity, the mouse pointer will dis-
  470.        appear. This is adjustable with the third number of the "Blanking"
  471.        gadget. CAUTON: be sure that your pointer is visible when saving
  472.        Preferences. It is best to turn off the Mouse Off feature by setting
  473.        its value to 0 before running Preferences. Mouse Off may affect the
  474.        Preferences settings changed by other programs. When the mouse comes
  475.        back on, ALL Preferences settings are set to what they were when the
  476.        mouse went off.
  477.  
  478.     SUN MOUSE:
  479.  
  480.        The window that the pointer is over becomes the active window after
  481.        the first mouse movement. To be able to drag icons, the SunMouse is
  482.        disabled while the left button is held down. The window under the
  483.        pointer will also become active when Amiga-N or Amiga-M is used.
  484.        Turn on or off with the "SunMouse" gadget.
  485.  
  486.     CLICK To FRONT:
  487.  
  488.        You can single or double click in any part of a window and bring it
  489.        to the front.
  490.        Select 0, 1, or 2 clicks with the "Click" gadget.
  491.  
  492.     CYCLE:
  493.  
  494.        You can push the window that is under the mouse to the back by
  495.        holding the left button down and clicking the right button (the
  496.        opposite of extended menu selection). If there are no windows or
  497.        just one window, the screen will be pushed to the back.
  498.        Turn on or off with the "Cycle" gadget.
  499.  
  500.  
  501.     SCREEN SHUFFLER:
  502.  
  503.        Left_Amiga-M will push the front screen to the back instead of
  504.        pushing workbench to the back. Left_Amiga-N will still bring the
  505.        workbench to the front. This is useful if you have more than two
  506.        screens on at once, especially if they don't have screen depth
  507.        gadgets. The window under the pointer will become the active
  508.        window if SunMouse is active.
  509.        Turn on or off with the "Amiga-M" gadget.
  510.  
  511.     QUALIFIER ACCUMULATOR:
  512.  
  513.        Many disabled people find it difficult if not impossible to type key
  514.        combinations such as Control-Shift-F1. MachII has the ability to
  515.        remember qualifiers that are pressed and add them to the first
  516.        non-qualifier key pressed. So you could for example, type Control,
  517.        Alternate, and then F1. The Control and Alternate would be added to
  518.        the F1 just as if they were pressed at the same time. This is not
  519.        intended for someone who doesn't need it as it sometimes may cause
  520.        unexpected results. For example, if you type Control and then change
  521.        your mind, the Control will still be added to the next key pressed.
  522.        Pressing Caps Lock or the right mouse button will reset the
  523.        qualifier accumulator.
  524.        This may also be used with Workbench's extended selection. Hit the
  525.        Shift key, then click on your icons. Hit any non-qualifier key or
  526.        the right mouse button to clear the Shift.
  527.        Turn on or off with the "Qual Accum" gadget.
  528.  
  529.     CLOCK:
  530.  
  531.        There is a title bar clock that displays available memory and the
  532.        time. The clock is updated every second and brings itself to the
  533.        front (if covered up) every 4 seconds except when the left button is
  534.        held down. Sometimes this covers up information in the title bar so
  535.        if you don't like this use the "Clock Front"/"Clock Depth" gadget.
  536.        This disables the auto upfront and adds an (almost) invisible depth
  537.        gadget. The date can alternate with the time and memory display. The
  538.        length of time that the time is displayed is adjustable with the
  539.        "Date Delay" gadget. Select 0 to display the time only. The date
  540.        is also displayed when the clock window is active.
  541.  
  542.     Clock and Memory Only:
  543.  
  544.        You can select "Clock Only" and get the clock and date displayed
  545.        together in the format "mm-dd-yy hh:mm:ss" or select "Mem Only" and
  546.        get the memory display without the clock.
  547.  
  548.     Low Memory Warning:
  549.  
  550.        The time and memory are displayed in red (pen 3) if your total free
  551.        memory falls below 50k. You can change this value in the "Low Mem"
  552.        gadget.
  553.  
  554.     Positioning the clock:
  555.  
  556.        You can change the clock's left and top edge in the requester
  557.        gadgets "Clock LE" and "Clock TE". These are the current left edge
  558.        and top edge for the clock. There are 3 methods for setting these.
  559.  
  560.        1. You can position the clock then pop up the requester and save the
  561.       new position.
  562.        2. Enter -1 and 'return'. The gadgets will then be updated.
  563.        3. Enter the desired values in the gadgets.
  564.  
  565.        The width for the clock alone is 146 pixels. Memory only display is
  566.        170 pixels. The clock with memory display is 250 pixels wide.
  567.  
  568.      The Clock and other screens:
  569.  
  570.        There is a gadget above the "ClockTE" gadget that will let you make
  571.        three choices.
  572.        1. WBScreen - The clock will remain on the workbench screen.
  573.        2. Screen Depth - This adds an invisible depth gadget to the left edge
  574.       of the clock. With it you can place the clock on other screens.
  575.        3. Clock To Top - The clock will automatically pop to the top screen
  576.       when this is selected.
  577.        Options 2 and 3 replace the CloseScreen vector to allow MachII to
  578.        close its windows. Selecting option 1 or removing MachII will put
  579.        back the original vector. If another program also replaced the
  580.        vector, you will be given the opportunity to terminate that program
  581.        before the original vector is replaced. If you get a requester with
  582.        the message "CloseScreen Vectors Were Changed!", either terminate
  583.        the program that changed the vectors and click Retry or just click
  584.        Cancel. You cannot change these options while on another screen.
  585.        If WBScreen is selected, the vectors are NOT changed.
  586.  
  587.        Turn the clock on or off with the "Clock" gadget.
  588.  
  589.     ALARM:
  590.  
  591.        You may set 1 alarm time in 24 hour format. When it goes off, it
  592.        will beep longer than the interval beeper and the screen will
  593.        flash. Set to greater than 2400 for no alarm. Note that with the
  594.        auto execute feature (\annnn) you may create all sorts of fancy
  595.        alarms.
  596.  
  597.     BEEPER:
  598.  
  599.        There is a beeper (to keep you awake) which defaults to a 15
  600.        minute interval. Change this in the Beeping gadget.
  601.        \G may be used in a macro to beep; prompt for user input for
  602.        example.
  603.  
  604.     METER:
  605.  
  606.        MachII has an online cost meter. Use the "Meter" gadget to toggle
  607.        between the meter and the clock. Use the "Reset" gadget to reset the
  608.        meter. The rate that it uses may be set in the "Rate" gadget.
  609.        The meter runs continuously whether visible or not. The default rate
  610.        is $4.75.
  611.  
  612.     SPECIAL KEYS:
  613.  
  614.        There are 4 special functions selectable from 33 (or 38 for the 500
  615.        and 2000) special keys and 5 qualifiers. They all have default
  616.        values but these may be changed in the requester.
  617.  
  618.        Start/Stop - This starts or stops a macro definition or learning
  619.             period. Type the key combination, then type the hotkey
  620.             that you want this macro to be bound to, then type your
  621.             macro. When finished, type the key combination again.
  622.             This ends the learning period. You may now execute the
  623.             macro by typing the hotkey. You may also view or edit
  624.             the macro in the string gadget in the requester.
  625.             Default key = Alternate-ESCape.
  626.  
  627.        Execute -    This executes the NewCli command. You may change the
  628.             executed command in the requester.
  629.             Default key = Amiga-ESCape.
  630.  
  631.        Requester -  This pops up the requester just like the pointer over
  632.             the clock and the right button does.
  633.             Default key = Control-Amiga-ESCape.
  634.  
  635.        Matcher -    This is used to find and execute a macro. To match,
  636.             type the key combination, then type enough letters
  637.             to match the desired macro, then type 'return'. The
  638.             rest of the macro will be executed.
  639.             Default key = Shift-Alternate-ESCape.
  640.  
  641.        Note that selecting 'C= / Amiga' allows you to use either the Left
  642.        Amiga (C=) key or the Right Amiga key. Clicking on the left half of
  643.        the Special Key gadget steps down through the keys, clicking on the
  644.        right half steps up. The special keys are: Tab, Escape, F1-F10, Del,
  645.        BackSpace, Return, Help, all arrow keys and all numeric keypad keys.
  646.        The 500 and 2000 have 5 keys that the 1000 doesn't, the numeric pad
  647.        keys "(", ")", "*", "+", "/".
  648.  
  649.  
  650.     UNINSTALL:
  651.  
  652.        Use the Remove gadget to uninstall MachII or \Q in a macro.
  653.  
  654.  
  655.  
  656.     MISCELLANEOUS:
  657.  
  658.        When a string gadget (or any gadget anywhere) is active, the
  659.        SunMouse will not work.
  660.  
  661.        When WordPerfect has a requester up, it tries to keep the requester's
  662.        window active. If MachII has the SunMouse option on, every mouse
  663.        move will activate a window and then WP will activate its requester's
  664.        window. The only thing to do is turn off the SunMouse or hold down
  665.        the left button.
  666.  
  667.        This program will NOT work from Workbench. Put it in your
  668.        startup-sequence. Use RunBack or ARun to allow the CLI window
  669.        to close.
  670.  
  671.        MachII may fail to run for any number of reasons (e.g. no free
  672.        signals, insufficient memory). You will be informed of this if it is
  673.        started with the Run command. If started from RunBack (public domain
  674.        program that will allow the CLI window to close and available on
  675.        Fred Fish disk # 65) and MachII fails, you won't get any messages.
  676.        The ARP command ARun may also be used.
  677.  
  678.        The NewCLI brought up by Amiga-ESC will have a stack the same size
  679.        as MachII. Many programs that you may run from this CLI need a
  680.        larger stack so either run MachII with a larger stack or, after you
  681.        get a NewCLI, use the stack command to set your stack to a larger
  682.        value. If programs mysteriously crash when run from the NewCLI, it
  683.        may be caused by the stack size.
  684.  
  685.        If the macro size is set too small and you try to load a config file
  686.        with longer macros, the macro size gadget will be updated to the
  687.        largest macro . If you set the size too small and then select "Done"
  688.        then activate the requester again, the macro size will be set to the
  689.        size needed for the largest macro.
  690.  
  691.        Let me know if you find any incompatibilities with other programs.
  692.  
  693.  
  694.  
  695.        Copyright 1988 by Brian Moats
  696.              Polyglot Software
  697.              10431 Ardyce Court
  698.              Boise, Idaho 83704
  699.              (208) 375-3741
  700.  
  701.              PeopleLink - BrianM
  702.              CI$        - 76167,2334
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.   Other programs for the Amiga 500/1000/2000 from Polyglot Software:
  711.  
  712.  
  713.   M18Cheater - Lets you cheat in Mean 18 by causing your opponent to
  714.            slice. Public domain.
  715. ----------------------------------------------------------------------------
  716.   FunBut - Lets you use the F1 key instead of the left mouse button.
  717.        It's useful when playing games like Defender of the Crown
  718.        because it sends repeat mouse clicks.  Public Domain.
  719. ----------------------------------------------------------------------------
  720.   4 IN ONE - Four easy to play games on one disk.
  721.  
  722.          SlotCars           For 1 or 2 players, arcade type driving and
  723.                    shooting game. Seven screens, great graphics.
  724.  
  725.          CircuitMania      For 1 or 2 players, surround your opponent
  726.                    in a maze of wires.
  727.  
  728.          ShufflePuzzle     Like the sliding number puzzles that you used
  729.                    to play as a kid but this uses beautiful color
  730.                    pictures.
  731.  
  732.          Follow That Tune  Follow the bouncing boy as he jumps from
  733.                    pedestal to pedestal playing musical notes.
  734.  
  735.          These games are integrated into an easy to use package.
  736.          Enjoyable for all ages. All use digitized sound.  $29.95
  737. ----------------------------------------------------------------------------
  738.  
  739.   Dominoes - 3d graphics, speech, tutorial. More entertaining and
  740.          challenging than Shanghai.  $24.95
  741. ----------------------------------------------------------------------------
  742.  
  743.   The Crossword Creator - Make or solve crossword puzzles. 40,000+ word
  744.               pattern matching dictionary, med-res or interlace,
  745.               IFF compatible and many more features. $49.95
  746.