home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 103.lha / Mach.doc < prev    next >
Encoding:
Text File  |  1980-07-10  |  13.0 KB  |  330 lines
  1.  
  2. Mach -  Mouse Accelerator with Hotkey.           Version 1.6  02-01-88.
  3. MachClk - Mach + Title Bar Clock and Beeper.     Version 1.2  02-01-88.
  4.  
  5.  
  6.     NOTES: 1. Mach is identical to MachClk minus the clock. Features that
  7.               apply only to MachClk are so noted.
  8.  
  9.            2. References in this document to "Qualifier" means either the
  10.               left or right Alternate or Amiga keys depending on whether
  11.               or not you use "-a" on the command line.
  12.  
  13.            3. When used on the command line, function keys are single digits.
  14.               1 is F1, 2 is F2, 9 is F9, and 0 is F10.
  15.  
  16.            4. Main difference from 1.5 is the change of -d to -q which now
  17.               accumulates qualifiers to be added to the next key.
  18.               Unused hotkeys are passed on.
  19.               Also, it should not lock up when holding an icon.
  20.  
  21.     USAGE:
  22.  
  23.        Run Mach [nscmqaeb] hotkeystring hotkeystring...hotkeystring
  24.                             or
  25.        Run Mach [nscmqaeb] +1hotkeystring +2hotkeystring...+nhotkeystring
  26.  
  27.                             or
  28.  
  29.        Run MachClk [nscmqaebktp] hotkeystring hotkeystring...hotkeystring
  30.                             or
  31.        Run MachClk [nscmqaebktp] +1hotkeystring +2hotkeystring...+nhotkeystring
  32.  
  33.  
  34.      Options: All are optional. Any order. They may be concatenated but
  35.                 an option with an argument should be the last one.
  36.                 e.g. Mach -scb10   (sun mouse, clicktofront and blanker)
  37.  
  38.      -n     Acceleration factor where n >= 0 && n <=9.
  39.      -s     Removes sunmouse.
  40.      -c     Removes click to front.
  41.      -m     Removes the trapping of left-amiga-m. (allows normal use)
  42.      -q     Adds qualifier accumulator feature.
  43.      -a     Use the Amiga keys as qualifiers.
  44.      -estr  Use str as execute string. Default is "NewCLI >nil: <nil:".
  45.      -bnn   Time delay before blanking screen. 0-99 minutes. 0 = no blank.
  46.      -knnn  Put Clock left edge at nnn. (MachClk only)
  47.      -tnn   Beep every nn minutes. Default 15. (MachClk only)
  48.      -pnnnn Set online rate. nnnn = pennies per hour. Default = 475.
  49.  
  50.  
  51.     Hotkeys:
  52.  
  53.        The hotkeys are the keys F1 to F10 qualified with the left or
  54.        right alternate keys. If you prefer to use left or right Amiga, put
  55.        -a on the command line. This makes it more compatible with WordPerfect
  56.        and other programs that make use of alternate-function keys.
  57.        The escape character "\" may be used to introduce newline or a function
  58.        key or to add qualifiers.
  59.          \n  newline
  60.          \c  control
  61.          \a  alternate
  62.          \A  Amiga
  63.          \s  shift
  64.          \f  function key where f is 1-0 = F1-F10
  65.  
  66.          c, a, A, s modifiy the next letter. They can be combined.
  67.          c, s, and n may be upper case.
  68.          Examples:
  69.               \C\a\3  is Control-Alternate-F3.
  70.               \A\0    sends Amiga-F10.
  71.  
  72.          Hotkeys may call other hotkeys.
  73.  
  74.        The hotkeys are defined in the command line following the optional
  75.        options. Definitions with embedded spaces should use "".
  76.        They may be positional, that is, the first definition is matched
  77.        with F1 and the second with F2. Or, you may specify a function key
  78.        with +n. n = 1 - 0 with 0 equaling 10 and no spaces following the
  79.        key number. e.g. Run Mach "+5diskcopy df0: to df1:\n"
  80.        See more examples below.
  81.        You may redefine hotkeys by running Mach again with new definitions.
  82.        e.g. Mach +3dir\n "+0run df1:wp\n"
  83.        Function keys not assigned to a hotkey string are passed through.
  84.  
  85.     Accelerator:
  86.  
  87.        The accelerator speeds up mouse movements. It accepts as an argument
  88.        a number, 0-9, which sets its speed.
  89.        -1 is the default, -0 = no acceleration. (I use -4).
  90.  
  91.     NewCLI:
  92.  
  93.        The qualifier and ESCape combination will create a NewCLI รก la PopCLI
  94.        from The Software Distillary. You need to have NewCLI and Run in the c:
  95.        directory. The NewCLI will have the same size stack as Mach. You can
  96.        change the command that is executed with -estring. A full window can
  97.        be used with "-eNewCLI CON:0/0/640/200/MyCLI".
  98.  
  99.     Screen Blanker:
  100.  
  101.        After 5 minutes of no mouse or keyboard activity, the screen will
  102.        go blank. You can change this default with -bnn where nn = 0 - 99
  103.        minutes. 0 disables blanking.
  104.        Instant blanking: Control-Qualifier-F2.
  105.  
  106.     Sun Mouse:
  107.  
  108.        The window that the pointer is over becomes the active window
  109.        after the first mouse movement. To be able to drag icons, the
  110.        sun mouse is disabled while the left button is held down.
  111.        If you don't want the sun mouse, use -s on the command line.
  112.        On/off toggle: Control-Qualifier-F3.
  113.  
  114.     Click To Front:
  115.  
  116.        You can click in any part of a window and bring it to the front.
  117.        If you don't want this, use -c on the command line.
  118.        On/off toggle: Control-Qualifier-F4.
  119.  
  120.     Screen Shuffler:
  121.  
  122.        Left-Amiga-M will push the front screen to the back instead of
  123.        pushing workbench to the back.
  124.        Left-Amiga-N will still bring the workbench to the front.
  125.        This is useful if you have more than two screens on at once,
  126.        especially if they don't have screen depth gadgets.
  127.        If you don't want this feature, use -m on your command line.
  128.        On/off toggle: Control-Qualifier-F5.
  129.  
  130.     Clock:
  131.  
  132.        MachClk has a title bar clock that displays available memory and the
  133.        time. You can change its left edge position with -knnn. For no clock
  134.        use -k0 or -k. The clock is updated every second and brings itself
  135.        to the front (if covered up) every 4 seconds except when the left
  136.        button is held down. The current toggles are shown in the left corner.
  137.        They are s: sun mouse, c: click to front, m: Amiga-M screen shuffler,
  138.        d: double control, a: Alternate/Amiga qualifiers.
  139.        On/off toggle: Control-Qualifier-F8.
  140.  
  141.     Beeper:
  142.  
  143.        MachClk (when the clock is activated) has a beeper (to keep you awake)
  144.        which defaults to a 15 minute interval. Change this with -tnn.
  145.        nn = 0 to 60 minutes.
  146.  
  147.     Meter:
  148.  
  149.        MachClk has an online cost meter. Use Control-Qualifier-F9 to toggle
  150.        between the meter and the clock. Use Control-Qualifier-F10 to reset
  151.        the meter. The rate that it uses may be set with "-pnnnn". nnnn is in
  152.        pennies per hour. The meter runs continuously whether visible or not.
  153.        The default rate is $4.75.
  154.        On/off toggle: Control-Qualifier-F9.
  155.  
  156.     Uninstall:
  157.  
  158.        Use the combination Control-Qualifier-F1 to uninstall Mach or MachClk.
  159.  
  160.     Toggles:
  161.  
  162.        These key combinations can be used to toggle specific features.
  163.  
  164.         Ctl-Qualifier-
  165.           F3  Sun mouse.
  166.           F4  Click to front.
  167.           F5  Screen shuffle.
  168.           F6  Qualifier Accumulator.
  169.           F7  Alternate/Amiga qualifiers.
  170.           F8  Clock. (MachClk only)
  171.           F9  Meter. (MachClk only)
  172.           F10 Reset meter. (MachClk only)
  173.  
  174.         F3-F7 are displayed in the clock as [scmqa].
  175.  
  176.     Instant blanker:
  177.  
  178.           Ctl-Qualifier-F2  Causes the screen to go blank immediately.
  179.  
  180.  
  181.  
  182.     EXAMPLES:
  183.  
  184.        Run Mach -2 -m -s df0: df1: "dir\n" "copy " "" "run sys:system/rollodex"
  185.          This maps
  186.              Alternate-F1 to  df0:
  187.              Alternate-F2 to  df1:
  188.              Alternate-F3 to  dir + return
  189.              Alternate-F4 to  copy
  190.              Alternate-F5 to  nothing
  191.              Alternate-F6 to  run sys:system/rollodex
  192.  
  193.          The options set the acceleration factor to 2, allows the normal use
  194.          of Left-Amiga-M, and disables the sun mouse feature.
  195.  
  196.  
  197.        Run MachClk -0cab12 "run df1:wp\n" +5df0: \s\c\1 \c\A\0 dir\n\A\1
  198.          This maps
  199.            Amiga-F1 to  run df1:wp + return
  200.            Amiga-F5 to  df0:
  201.            Amiga-F6 to  Shift-Control-F1
  202.            Amiga-F7 to  Control-Amiga-F10
  203.            Amiga-F8 to  dir + return + Amiga-F1
  204.  
  205.          This example shows how to concatenate options (-0cab12).
  206.          The options set the acceleration factor to 0, the function key
  207.          qualifiers to the Amiga keys, disables the click to front feature,
  208.          and sets the waiting before blanking to 12 minutes.
  209.          The clock is placed in its default position and the beeper interval
  210.          is the default 15 minutes.
  211.  
  212.  
  213.        Run MachClk -k200 -t30 -4 -a "diskcopy df0: to df1:\n"
  214.          This maps
  215.            Amiga-F1 to  diskcopy df0: to df1: + return
  216.  
  217.          The options use 200 for the clock's left edge, sets the beeper
  218.          interval to 30 minutes, the acceleration factor to 4, and the
  219.          qualifiers to the Amiga keys.
  220.  
  221.        Run MachClk -p525
  222.          This set the online rate to $5.25.
  223.  
  224.  
  225.     REDEFINING:
  226.  
  227.        Mach may be run again to redefine hotkeys or set the blanking
  228.        time delay or the beep interval or to change the toggles.
  229.        For example, after Mach is running, typing "Mach -6 +5df0:"
  230.        will change the acceleration factor to 6 and redefine F5 to "df0:".
  231.        Only the clock position may not be changed this way.
  232.  
  233.        Mach -b10 -p650 +3CCC +2BBB +5EEE FFF
  234.          This redefines
  235.            Qualifier-F2 to  BBB
  236.            Qualifier-F3 to  CCC
  237.            Qualifier-F5 to  EEE
  238.            Qualifier-F6 to  FFF
  239.  
  240.          resets the blanking delay to 10 minutes, and set the online
  241.          rate to $6.50.
  242.  
  243.  
  244.        Mach -eWack
  245.          This changes the Qualifier-ESCape command from NewCLI to Wack.
  246.          Remember, the executed command will have the same size stack
  247.          as Mach.
  248.  
  249.  
  250.     MISCELLANEOUS:
  251.  
  252.        Note that anything after a semicolon is treated as a comment.
  253.        If you are typing this in from the CLI, when you reach the end of
  254.        the line, don't hit return and you can continue mapping up to 255
  255.        characters (including run mach [options]). If you are using an editor
  256.        or word processor, use one that can handle long lines. You can use
  257.        Ed but you need to use the command SR or EX. You can then put this
  258.        in your startup-sequence.
  259.  
  260.        I have found that the hotkeys do not function properly with the
  261.        program Sili(Con:). But they do work ok with ConMan.
  262.        There seems to be some slight problems with SunMouse and the
  263.        shareware disk utility DiskMan.
  264.        Let me know if you find other incompatibilities.
  265.  
  266.        Mach may fail to run for any number of reasons (e.g. no free signals,
  267.        insufficient memory). You will be informed of this if it is started
  268.        with the Run command. If started from RunBack or RunBackGround
  269.        (public domain program that will allow the CLI window to close and
  270.        available on Fred Fish disk # 65) Mach won't run and you won't get
  271.        any messages. If you want to use RunBack, it is best to test your
  272.        script first with Run.
  273.  
  274.        The NewCLI brought up by Qualifier-ESC will have a stack the same
  275.        size as Mach. Many programs that you may run from this CLI need a
  276.        larger stack so either run Mach with a larger stack or, after you
  277.        get a NewCLI, use the stack command to set your stack to a larger
  278.        value. If programs mysteriously crash when run from the NewCLI, it
  279.        may be caused by the stack size.
  280.  
  281.     Hidden Qualifier Feature:
  282.  
  283.        Many disabled people find it difficult if not impossible to
  284.        type key combinations such as Control-Shift-F1. If you put
  285.        -q on the command line, Mach will remember qualifiers that
  286.        are pressed and add them to the first non-qualifier key pressed.
  287.        So you could for example, type Control, Alternate, and then F1.
  288.        The Control and Alternate would be added to the F1 just as if
  289.        they were pressed at the same time. This is not for someone who
  290.        doesn't need it as it sometimes may cause unexpected results like
  291.        if you type Control and then change your mind, the Control will
  292.        still be added to the next key pressed. Pressing Caps Lock will
  293.        reset the qualifier accumulator.
  294.        Note that because most people will not want this, it defaults to
  295.        off unlike all the other features.
  296.        On/off toggle: Control-Qualifier-F6.
  297.  
  298.  
  299.  
  300.        Copyright 1988 by Brian Moats
  301.                          Polyglot Software
  302.                          10431 Ardyce Court
  303.                          Boise, Idaho 83704
  304.  
  305.                          PeopleLink - BrianM
  306.                          CI$        - 76167,2334
  307.  
  308.        This program may be freely distributed but may not be used in any
  309.        commercial product without prior written permission.
  310.        Source available. Donations accepted.
  311.  
  312.  
  313.  
  314.  
  315.   Other programs from Polyglot Software:
  316.  
  317.   M18Cheater - Lets you cheat in Mean 18 by causing your opponent to
  318.                slice. Public domain.
  319.  
  320.   FunBut - Lets you use the F1 key instead of the left mouse button.
  321.            It's useful when playing games like Defender of the Crown
  322.            because it sends repeat mouse clicks.  Public Domain.
  323.  
  324.   Dominoes - 3d graphics, instructions, tutorial. More entertaining and
  325.              challenging than Shanghai.  $24.95
  326.  
  327.   The Crossword Creator - Make or solve crossword puzzles. 40,000+ word
  328.                           pattern matching dictionary, med-res or interlace,
  329.                           IFF compatible and many more features. $49.95
  330.