home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 137.lha / MachII.doc < prev    next >
Encoding:
Text File  |  1986-11-20  |  17.4 KB  |  447 lines
  1.  
  2. MachII  - Mouse Accelerator with Hotkeys.   Version 2.0  04-23-88.
  3.  
  4.  
  5.        This program may be freely distributed but may not be used in any
  6.        commercial product without prior written permission.
  7.        Source available. Shareware donations accepted.
  8.  
  9.  
  10.        For those who hate doc files, just type "run MachII" and then
  11.        "Cancel" the "Can't Open Configuration File!". Now activate the
  12.        clock window with your mouse and press the right button. The
  13.        requester displayed has all of your options and hotkeys. Change
  14.        them to what you like and save it. AND TRY THIS; hit Alternate-
  15.        Escape then Amiga-F1 then type (for example) "diskcopy df0: to df1:"
  16.        then hit Alternate-Escape again. Now press Amiga-F1. Also look at
  17.        F1 in the requester. Read on if you're still interested.
  18.  
  19.  
  20.  
  21.     FEATURES
  22.  
  23.           Hotkeys         20 macros activated with the Amiga- or Ctl-Amiga-
  24.                           Function keys or by typing the first few letters
  25.                           of the macro.
  26.           Accelerator     Speeds up mouse movements. Adjustable.
  27.           PopCli          Execute a NewCLI or any other command.
  28.           Screen Blanker  Blank the screen after an adjustable period of
  29.                           time.
  30.           SunMouse        Activate a window by moving the mouse into it.
  31.           ClickToFront    Move a window to the front by clicking in any
  32.                           part of it.
  33.           Screen Shuffler Use Left_Amiga-M to push ANY screen to the back.
  34.           Clock           Title bar clock with memory watcher.
  35.           Alarm           Set an alarm.
  36.           Beeper          Beep every 15 minutes. Adjustable.
  37.           Meter           Maintain online costs. Adjustable rates.
  38.           Qualifier Accum Accumulate qualifiers to be added to a key.
  39.  
  40.           All features may be turned off. Unused hotkeys are passed through
  41.           and may be defined on the fly. Configuration saved to disk.
  42.  
  43.  
  44.  
  45.  
  46.     NOTES:
  47.  
  48.            1. All special keys and qualifiers except Amiga and Ctl-Amiga
  49.               Function keys may be changed on the command line.
  50.               The defaults are the Escape key qualified with:
  51.  
  52.               Alternate        Begin/End a macro definition.
  53.               Shift-Alternate  Begin accepting macro name.
  54.               Control-Amiga    Popup requester.
  55.               Amiga            Execute command string.
  56.  
  57.            2. When used in hotkey macros, function key numbers are
  58.               single digits. This means that 0 is F10, 1 is F1, 9 is F9.
  59.  
  60.  
  61.  
  62.  
  63.     UPDATES:
  64.         2.0   This is a major rewrite of Mach 1.6. Although it can still
  65.               do everything that the old one could (and more), the method
  66.               of setting your variables and hotkey macros has changed. It
  67.               is about 8k larger (about 20k) but if this is to big, you can
  68.               always use the old Mach. The nicest thing about this version
  69.               is the ability to define a hotkey macro on the fly and if
  70.               needed, edit it in a string gadget. There are now 20 hotkeys,
  71.               the Amiga-Function keys and the Ctl-Amiga-Function keys.
  72.  
  73.               Bug fix: The accelerator works properly with ProWrite.
  74.               May also help when using PageSetter.
  75.  
  76.  
  77.     OVERVIEW:
  78.  
  79.       MachII is a utility program that provides many optional features
  80.       for both CLI and WorkBench users. Your own configuration may be saved
  81.       to disk. Each function key may be used as a hotkey and hotkeys may
  82.       be defined on the fly. To do this, simply hit Alternate-Escape, an
  83.       Amiga-Function or Ctl-Amiga-Function key and then type your macro.
  84.       You will be prompted for these by messages in the clock and by beeps.
  85.       You may use any keys including qualifiers, arrow keys and numeric
  86.       keypad keys. When finished, hit Alternate-Escape again. You may now
  87.       use your macro by hitting the Amiga-Function or Ctl-Amiga-Function key
  88.       or by hitting Shift-Alternate-Escape, enough characters to uniquely
  89.       match the macro followed by return. You may also edit the macro in a
  90.       string gadget by hitting Control-Amiga-Escape or by activating the
  91.       clock window and pressing the right mouse button.
  92.  
  93.       A configuration file is not neccessary but without one you will get
  94.       the defaults. You will also get a "Can't Find Configuration File"
  95.       requester. After you have setup your macros and other variables,
  96.       save this to the file s:mach.config.
  97.  
  98.  
  99.  
  100.     USAGE:
  101.  
  102.        Run MachII [?ltfwmprn]
  103.  
  104.          Most people will not need any arguments. These are provided for
  105.          those who find a key combination that conflicts with another
  106.          program or who want the clock in a different location or want a
  107.          different config file.
  108.  
  109.          Arguments: All optional. Any order.
  110.  
  111.            ?         Display help.
  112.            -lnnn     Clock left edge. Default = 296.
  113.            -tnnn     Clock top edge. Default = 0.
  114.            -fname    Load configuration file "name". Default = s:Mach.config.
  115.            -w        Disable auto clock to front.
  116.            -mCALRSk  Change the macro begin/end key combination to the
  117.                      string following -m. -mAE is the default Alternate-ESC.
  118.            -pCALRSk  Change the PopCli/Command string key combination to the
  119.                      string following -p. -pLE is the default Left_Amiga-ESC.
  120.            -rCALRSk  Change the requester key combination to the string
  121.                      following -r. -rCLE is the default Control-Left_Amiga-
  122.                      ESC.
  123.            -nCALRSk  Change the macro invoking key combination to the string
  124.                      following -n. -nSAE is the default Shift-Alternate-ESC.
  125.                        C = Control.
  126.                        A = Alternate.
  127.                        L = Left-Amiga.
  128.                        R = Right-Amiga.
  129.                        S = Shift.
  130.                        k = Desired key
  131.                            T = Tab.
  132.                            E = ESC.
  133.                            D = Del
  134.                            B = Backspace.
  135.                            H = Help.
  136.                            F = F1. (F1 only!)
  137.                            0-9 = Numeric pad 0-9.
  138.                            - = Numeric pad -.
  139.                            . = Numeric pad ..
  140.                            e = Numeric pad Enter.
  141.  
  142.  
  143.      Usage eg. Run MachII -l270 -fs/wp
  144.  
  145.    After it is running, you may either activate the clock with the mouse
  146.    and press the right button or press Control-Left_Amiga-ESC. This will
  147.    pop up a requester jammed full of gadgets. All options and hotkeys
  148.    may be modified here.
  149.  
  150.      The gadgets are:
  151.  
  152.      1st ROW
  153.          left:   Toggle between Amiga and Control-Amiga hotkeys.
  154.          center: Clear all hotkey definitions.
  155.          center: Abort a macro definition.
  156.          right:  Change the maximum macro size.
  157.      2nd ROW
  158.                  Select each hotkey.
  159.      3rd ROW
  160.                  Hotkey definitions.
  161.      4th ROW
  162.                  Left_Amiga-ESC execute string.
  163.      5th ROW
  164.          left:   Activate/deactivate SunMouse.
  165.          center: Activate/deactivate ClickToFront.
  166.          right:  Activate/deactivate Screen Shuffler.
  167.      6th ROW
  168.          left:   Activate/deactivate Qualifier Accumulator.
  169.          center: Toggle clock.
  170.          center: Toggle online meter.
  171.          right:  Reset online meter.
  172.      7th ROW
  173.          left:   Select blanking interval. (0-99 minutes)
  174.          center: Select beep interval. (0-999 minutes)
  175.          center: Set the alarm time. 24 hour format.
  176.          center: Select online rate. ($00.00 - $99.99)
  177.          right:  Change the acceleration rate. (0-9)
  178.      8th ROW
  179.                  Configuration file name.
  180.      9th ROW
  181.          left:   Done.
  182.          center: Load configuration file.
  183.          center: Save configuration file.
  184.          right:  Remove MachII.
  185.  
  186.  
  187.      Hotkeys:
  188.  
  189.        There are 20 hotkeys. 10 are the Amiga-Function keys and 10 are the
  190.        Ctl-Amiga-Function keys. In the requester you can select each hotkey
  191.        with the Fn gadgets and toggle the Ctl-Amiga/Amiga gadget.
  192.        The hotkey macros may be edited in the string gadget. The default
  193.        maximum macro size is 255 characters but this may be changed in the
  194.        size gadget. You cannot change the size while you are creating a new
  195.        macro and the new macro size will not take effect until you select
  196.        "Done". This controls the size of dynamic buffers which are allocated
  197.        only during macro definition or when the requester is up. The actual
  198.        macros take up only as much space as they need.
  199.        Macros are invoked either by hitting the Amiga- or Ctl-Amiga-Function
  200.        key or by hitting Shift-Alternate-Escape and then type some of the
  201.        first letters of the macro and then return. The first macro found
  202.        that matchs will be executed. If none is found there will be a beep.
  203.        See the overview for defining hotkey macros.
  204.  
  205.        The escape character "\" may be used for the following:
  206.  
  207.            \N  Newline.
  208.            \T  Tab.
  209.            \E  Escape.
  210.            \D  Del.
  211.            \B  Baskspace.
  212.            \H  Help.
  213.            \u  Up arrow.
  214.            \d  Down arrow.
  215.            \l  Left arrow.
  216.            \r  Right arrow.
  217.            \0  Number pad 0.
  218.             .
  219.             .
  220.            \9  Numeric pad 9.
  221.            \.  Numeric pad ".".
  222.            \-  Numeric pad "-".
  223.            \e  Numeric pad ENTER.
  224.            \F1 Function key 1.
  225.             .
  226.             .
  227.            \F0 Function key 10.
  228.  
  229.          Qualifiers modify the character immediately following these:
  230.  
  231.            \C  Control.
  232.            \S  Shift.
  233.            \A  Alternate.
  234.            \L  Left-Amiga.
  235.            \R  Right-Amiga.
  236.  
  237.        Function keys not assigned to a hotkey string are passed through.
  238.  
  239.     Accelerator:
  240.  
  241.        The accelerator speeds up mouse movements.
  242.        Its speed is set 0 - 9.
  243.        0 = no acceleration. (I use 4).
  244.  
  245.     NewCLI:
  246.  
  247.        The Left-Amiga and ESCape combination will create a NewCLI.
  248.        You need to have NewCLI and Run in the c: directory. The NewCLI
  249.        will have the same size stack as MachII. You can change the command
  250.        in the execute string gadget.
  251.        A full window example is "NewCLI CON:0/0/640/200/MyCLI".
  252.  
  253.     Screen Blanker:
  254.  
  255.        After 5 minutes of no mouse or keyboard activity, the screen will
  256.        go blank. You can change this default in the Blanking gadget.
  257.        0 disables blanking.
  258.  
  259.     Sun Mouse:
  260.  
  261.        The window that the pointer is over becomes the active window
  262.        after the first mouse movement. To be able to drag icons, the
  263.        Sun Mouse is disabled while the left button is held down.
  264.        Turn on or off with the SunMouse gadget.
  265.  
  266.     Click To Front:
  267.  
  268.        You can click in any part of a window and bring it to the front.
  269.        Turn on or off with the ClickToFront gadget.
  270.  
  271.  
  272.     Screen Shuffler:
  273.  
  274.        Left_Amiga-M will push the front screen to the back instead of
  275.        pushing workbench to the back. Left_Amiga-N will still bring the
  276.        workbench to the front. This is useful if you have more than two
  277.        screens on at once, especially if they don't have screen depth
  278.        gadgets.
  279.        Turn on or off with the Amiga-M gadget.
  280.  
  281.     Clock:
  282.  
  283.        MachII has a title bar clock that displays available memory and the
  284.        time. You can change its left edge position with -lnnn and the top
  285.        edge with -tnnn. The clock is updated every second and brings itself
  286.        to the front (if covered up) every 4 seconds except when the left
  287.        button is held down. Sometimes this covers up information in the
  288.        title bar so if you don't like this use the option -w. This disables
  289.        the auto upfront and adds an (almost) invisible depth gadget.
  290.        Activate the clock with the mouse and press the right button to
  291.        pop up the requester.
  292.        Turn on or off with the Clock gadget.
  293.  
  294.     Alarm:
  295.  
  296.        You may set 1 alarm time in 24 hour format. When it goes off, it
  297.        will beep longer than the interval beeper and the screen will
  298.        flash.
  299.  
  300.     Beeper:
  301.  
  302.        MachII has a beeper (to keep you awake) which defaults to a 15
  303.        minute interval. Change this in the Beeping gadget.
  304.  
  305.     Meter:
  306.  
  307.        MachII has an online cost meter. Use the Meter gadget to toggle
  308.        between the meter and the clock. Use the Reset gadget to reset
  309.        the meter. The rate that it uses may be set in the Online Rate
  310.        gadget. The meter runs continuously whether visible or not.
  311.        The default rate is $4.75.
  312.  
  313.     Uninstall:
  314.  
  315.        Use the Remove gadget to uninstall MachII.
  316.  
  317.  
  318.  
  319.  
  320.     EXAMPLES:
  321.  
  322.        Run MachII -l328 -t190 -mCSE -fs:maconfig
  323.          This puts the clock at a left edge of 328 and a top edge of 190,
  324.          uses Control-Shift-Escape to begin/end hotkey macros and loads
  325.          your configuration from the file s:maconfig.
  326.  
  327.        Run MachII -pLT
  328.          This sets the PopCli key combination to Left_Amiga-Tab.
  329.  
  330.        Run MachII -ne -fs/wpcfig
  331.          This sets the macro invocation key to the keypad "Enter" key and
  332.          loads a configuration file in the s directory named wpcfig
  333.  
  334.        Run MachII -mS. -rAH
  335.          This sets the requester popup key combination to "Alternate-Help"
  336.          and the macro invocation to "Shift-NumericPad ." .
  337.  
  338.        Run MachII -rLRH
  339.          This sets the requester popup key combination to the "Left_Amiga-
  340.          Right_Amiga-Help".
  341.  
  342.        Watch out that you don't have keys in conflict. The results of two
  343.        functions that are assigned to a single key combination is unknown
  344.        and is bound to cause headaches.
  345.  
  346.  
  347.  
  348.     MISCELLANEOUS:
  349.  
  350.        I have found that the hotkeys do not function properly with the
  351.        program Sili(Con:). When a string gadget (or any gadget anywhere)
  352.        is active, the SunMouse does not work.
  353.        Let me know if you find any incompatibilities.
  354.  
  355.        MachII may fail to run for any number of reasons (e.g. no free
  356.        signals, insufficient memory). You will be informed of this if it is
  357.        started with the Run command. If started from RunBack or
  358.        RunBackGround (public domain program that will allow the CLI window
  359.        to close and available on Fred Fish disk # 65) MachII won't run and
  360.        you won't get any messages.
  361.  
  362.        The NewCLI brought up by Left_Amiga-ESC will have a stack the same
  363.        size as MachII. Many programs that you may run from this CLI need a
  364.        larger stack so either run MachII with a larger stack or, after you
  365.        get a NewCLI, use the stack command to set your stack to a larger
  366.        value. If programs mysteriously crash when run from the NewCLI, it
  367.        may be caused by the stack size.
  368.  
  369.        If the macro size is set too small and you try to load a config file
  370.        with longer macros, you will get a "Not A Mach Configuration File!"
  371.        message. If you set the size too small and then select "Done" then
  372.        activate the requester again, the macro size will be set to the
  373.        size needed for the largest macro.
  374.  
  375.  
  376.  
  377.  
  378.     SPECIAL FEATURE:
  379.  
  380.        Many disabled people find it difficult if not impossible to
  381.        type key combinations such as Control-Shift-F1. MachII has
  382.        the ability to remember qualifiers that are pressed and add
  383.        them to the first non-qualifier key pressed. So you could for
  384.        example, type Control, Alternate, and then F1. The Control
  385.        and Alternate would be added to the F1 just as if they were
  386.        pressed at the same time. This is not for someone who doesn't
  387.        need it as it sometimes may cause unexpected results. If you
  388.        type Control and then change your mind, the Control will still
  389.        be added to the next key pressed. Pressing Caps Lock will
  390.        reset the qualifier accumulator.
  391.        Note that because most people will not want this, it defaults to
  392.        off unlike all the other features.
  393.        Turn on or off with the Qual Accum gadget.
  394.  
  395.  
  396.  
  397.  
  398.  
  399.        Copyright 1988 by Brian Moats
  400.                          Polyglot Software
  401.                          10431 Ardyce Court
  402.                          Boise, Idaho 83704
  403.  
  404.                          PeopleLink - BrianM
  405.                          CI$        - 76167,2334
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.   Other programs for the Amiga 500/1000/2000 from Polyglot Software:
  414.  
  415.  
  416.   M18Cheater - Lets you cheat in Mean 18 by causing your opponent to
  417.                slice. Public domain.
  418.  
  419.   FunBut - Lets you use the F1 key instead of the left mouse button.
  420.            It's useful when playing games like Defender of the Crown
  421.            because it sends repeat mouse clicks.  Public Domain.
  422.  
  423.   4 IN ONE - Four easy to play games on one disk.
  424.  
  425.              SlotCars          For 1 or 2 players, arcade type driving and
  426.                                shooting game. Seven screens, great graphics.
  427.  
  428.              CircuitMania      For 1 or 2 players, surround your opponent
  429.                                in a maze of wires.
  430.  
  431.              ShufflePuzzle     Like the sliding number puzzles that you used
  432.                                to play as a kid but this uses beautiful color
  433.                                pictures.
  434.  
  435.              Follow That Tune  Follow the bouncing boy as he jumps from
  436.                                pedestal to pedestal playing musical notes.
  437.  
  438.              These games are integrated into an easy to use package.
  439.              Enjoyable for all ages. All use digitized sound.  $29.95
  440.  
  441.   Dominoes - 3d graphics, speech, tutorial. More entertaining and
  442.              challenging than Shanghai.  $24.95
  443.  
  444.   The Crossword Creator - Make or solve crossword puzzles. 40,000+ word
  445.                           pattern matching dictionary, med-res or interlace,
  446.                           IFF compatible and many more features. $49.95
  447.