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