Xref: utzoo comp.binaries.amiga:201 comp.sources.amiga:172
Path: utzoo!attcan!uunet!husc6!purdue!i.cc.purdue.edu!j.cc.purdue.edu!ain
From: ain@j.cc.purdue.edu (Patrick White)
Newsgroups: comp.binaries.amiga,comp.sources.amiga
Subject: Mach (docs)
Keywords: mouse, accelerator, docs.
Message-ID: <7099@j.cc.purdue.edu>
Date: 19 May 88 13:00:17 GMT
Organization: PUCC Land, USA
Lines: 396
Approved: ain@j.cc.purdue.edu	(Patrick White)

Submitted by:	rodger@hpmrtca  (Rodger Anderson)
Summary:	A mouse accelerator and more.
Poster Boy:	Patrick White	(ain@j.cc.purdue.edu)
Archive Name:	sources/amiga/volume4/mach.doc.sh.Z binaries/amiga/volume5/mach.doc.sh.Z
Tested but uncompiled.
 
NOTES:
   Rob or Brent tested this but didn't give me any notes about it, so I
assume that it works just fine.
   I converted it from an arc to shars so I could separate docs, sources, and
binaries.
.
 
 
-- Pat White   (co-moderator comp.sources/binaries.amiga)
ARPA/UUCP: j.cc.purdue.edu!ain  BITNET: PATWHITE@PURCCVM  PHONE: (317) 743-8421
U.S.  Mail:  320 Brown St. apt. 406,    West Lafayette, IN 47906
 
========================================
 
>The author is Brian Moats of Polyglot software.  I am merely posting
>Mach to usenet, with Brian's permission.  Brian doesn't have usenet
>access, although he is on PeopleLink and Compuserve (see doc file).
>I will forward anything I get.  My uucp address is below.
>
>Hotkeys:
>	Defines the function keys (with qualifier) to be any string.
>Mouse Accelerator:
>	Like the Gizmos one.
>NewCLI:
>	Like PopCLI.
>Screen Blanker:
>	Like PopCLI.
>Sun Mouse:
>	Window under mouse always active.
>Click To Front:
>	Should be obvious.
>Screen Shuffler:
>	Cycles through each screen, instead of just Workbench.
>Clock:
>	Machclk version has title bar clock.
>Meter:
>	Mackclk has resettable $/hr meter for online time.
>
>Each feature can be enabled or disabled as needed, either at startup or while
>running.  Qualifier can be left-amiga or left-alt.


#	This is a shell archive.
#	Remove everything above and including the cut line.
#	Then run the rest of the file through sh.
#----cut here-----cut here-----cut here-----cut here----#
#!/bin/sh
# shar:	Shell Archiver
#	Run the following text with /bin/sh to create:
#	Mach.doc
# This archive created: Tue May 17 09:26:35 1988
# By:	Patrick White (PUCC Land, USA)
echo shar: extracting Mach.doc '(13285 characters)'
cat << \SHAR_EOF > Mach.doc

Mach -  Mouse Accelerator with Hotkey.           Version 1.6  02-01-88.
MachClk - Mach + Title Bar Clock and Beeper.     Version 1.2  02-01-88.


    NOTES: 1. Mach is identical to MachClk minus the clock. Features that
              apply only to MachClk are so noted.

           2. References in this document to "Qualifier" means either the
              left or right Alternate or Amiga keys depending on whether
              or not you use "-a" on the command line.

           3. When used on the command line, function keys are single digits.
              1 is F1, 2 is F2, 9 is F9, and 0 is F10.

           4. Main difference from 1.5 is the change of -d to -q which now
              accumulates qualifiers to be added to the next key.
              Unused hotkeys are passed on.
              Also, it should not lock up when holding an icon.

    USAGE:

       Run Mach [nscmqaeb] hotkeystring hotkeystring...hotkeystring
                            or
       Run Mach [nscmqaeb] +1hotkeystring +2hotkeystring...+nhotkeystring

                            or

       Run MachClk [nscmqaebktp] hotkeystring hotkeystring...hotkeystring
                            or
       Run MachClk [nscmqaebktp] +1hotkeystring +2hotkeystring...+nhotkeystring


     Options: All are optional. Any order. They may be concatenated but
                an option with an argument should be the last one.
                e.g. Mach -scb10   (sun mouse, clicktofront and blanker)

     -n     Acceleration factor where n >= 0 && n <=9.
     -s     Removes sunmouse.
     -c     Removes click to front.
     -m     Removes the trapping of left-amiga-m. (allows normal use)
     -q     Adds qualifier accumulator feature.
     -a     Use the Amiga keys as qualifiers.
     -estr  Use str as execute string. Default is "NewCLI >nil: <nil:".
     -bnn   Time delay before blanking screen. 0-99 minutes. 0 = no blank.
     -knnn  Put Clock left edge at nnn. (MachClk only)
     -tnn   Beep every nn minutes. Default 15. (MachClk only)
     -pnnnn Set online rate. nnnn = pennies per hour. Default = 475.


    Hotkeys:

       The hotkeys are the keys F1 to F10 qualified with the left or
       right alternate keys. If you prefer to use left or right Amiga, put
       -a on the command line. This makes it more compatible with WordPerfect
       and other programs that make use of alternate-function keys.
       The escape character "\" may be used to introduce newline or a function
       key or to add qualifiers.
         \n  newline
         \c  control
         \a  alternate
         \A  Amiga
         \s  shift
         \f  function key where f is 1-0 = F1-F10

         c, a, A, s modifiy the next letter. They can be combined.
         c, s, and n may be upper case.
         Examples:
              \C\a\3  is Control-Alternate-F3.
              \A\0    sends Amiga-F10.

         Hotkeys may call other hotkeys.

       The hotkeys are defined in the command line following the optional
       options. Definitions with embedded spaces should use "".
       They may be positional, that is, the first definition is matched
       with F1 and the second with F2. Or, you may specify a function key
       with +n. n = 1 - 0 with 0 equaling 10 and no spaces following the
       key number. e.g. Run Mach "+5diskcopy df0: to df1:\n"
       See more examples below.
       You may redefine hotkeys by running Mach again with new definitions.
       e.g. Mach +3dir\n "+0run df1:wp\n"
       Function keys not assigned to a hotkey string are passed through.

    Accelerator:

       The accelerator speeds up mouse movements. It accepts as an argument
       a number, 0-9, which sets its speed.
       -1 is the default, -0 = no acceleration. (I use -4).

    NewCLI:

       The qualifier and ESCape combination will create a NewCLI a la PopCLI
       from The Software Distillary. You need to have NewCLI and Run in the c:
       directory. The NewCLI will have the same size stack as Mach. You can
       change the command that is executed with -estring. A full window can
       be used with "-eNewCLI CON:0/0/640/200/MyCLI".

    Screen Blanker:

       After 5 minutes of no mouse or keyboard activity, the screen will
       go blank. You can change this default with -bnn where nn = 0 - 99
       minutes. 0 disables blanking.
       Instant blanking: Control-Qualifier-F2.

    Sun Mouse:

       The window that the pointer is over becomes the active window
       after the first mouse movement. To be able to drag icons, the
       sun mouse is disabled while the left button is held down.
       If you don't want the sun mouse, use -s on the command line.
       On/off toggle: Control-Qualifier-F3.

    Click To Front:

       You can click in any part of a window and bring it to the front.
       If you don't want this, use -c on the command line.
       On/off toggle: Control-Qualifier-F4.

    Screen Shuffler:

       Left-Amiga-M will push the front screen to the back instead of
       pushing workbench to the back.
       Left-Amiga-N will still bring the workbench to the front.
       This is useful if you have more than two screens on at once,
       especially if they don't have screen depth gadgets.
       If you don't want this feature, use -m on your command line.
       On/off toggle: Control-Qualifier-F5.

    Clock:

       MachClk has a title bar clock that displays available memory and the
       time. You can change its left edge position with -knnn. For no clock
       use -k0 or -k. The clock is updated every second and brings itself
       to the front (if covered up) every 4 seconds except when the left
       button is held down. The current toggles are shown in the left corner.
       They are s: sun mouse, c: click to front, m: Amiga-M screen shuffler,
       d: double control, a: Alternate/Amiga qualifiers.
       On/off toggle: Control-Qualifier-F8.

    Beeper:

       MachClk (when the clock is activated) has a beeper (to keep you awake)
       which defaults to a 15 minute interval. Change this with -tnn.
       nn = 0 to 60 minutes.

    Meter:

       MachClk has an online cost meter. Use Control-Qualifier-F9 to toggle
       between the meter and the clock. Use Control-Qualifier-F10 to reset
       the meter. The rate that it uses may be set with "-pnnnn". nnnn is in
       pennies per hour. The meter runs continuously whether visible or not.
       The default rate is $4.75.
       On/off toggle: Control-Qualifier-F9.

    Uninstall:

       Use the combination Control-Qualifier-F1 to uninstall Mach or MachClk.

    Toggles:

       These key combinations can be used to toggle specific features.

        Ctl-Qualifier-
          F3  Sun mouse.
          F4  Click to front.
          F5  Screen shuffle.
          F6  Qualifier Accumulator.
          F7  Alternate/Amiga qualifiers.
          F8  Clock. (MachClk only)
          F9  Meter. (MachClk only)
          F10 Reset meter. (MachClk only)

        F3-F7 are displayed in the clock as [scmqa].

    Instant blanker:

          Ctl-Qualifier-F2  Causes the screen to go blank immediately.



    EXAMPLES:

       Run Mach -2 -m -s df0: df1: "dir\n" "copy " "" "run sys:system/rollodex"
         This maps
             Alternate-F1 to  df0:
             Alternate-F2 to  df1:
             Alternate-F3 to  dir + return
             Alternate-F4 to  copy
             Alternate-F5 to  nothing
             Alternate-F6 to  run sys:system/rollodex

         The options set the acceleration factor to 2, allows the normal use
         of Left-Amiga-M, and disables the sun mouse feature.


       Run MachClk -0cab12 "run df1:wp\n" +5df0: \s\c\1 \c\A\0 dir\n\A\1
         This maps
           Amiga-F1 to  run df1:wp + return
           Amiga-F5 to  df0:
           Amiga-F6 to  Shift-Control-F1
           Amiga-F7 to  Control-Amiga-F10
           Amiga-F8 to  dir + return + Amiga-F1

         This example shows how to concatenate options (-0cab12).
         The options set the acceleration factor to 0, the function key
         qualifiers to the Amiga keys, disables the click to front feature,
         and sets the waiting before blanking to 12 minutes.
         The clock is placed in its default position and the beeper interval
         is the default 15 minutes.


       Run MachClk -k200 -t30 -4 -a "diskcopy df0: to df1:\n"
         This maps
           Amiga-F1 to  diskcopy df0: to df1: + return

         The options use 200 for the clock's left edge, sets the beeper
         interval to 30 minutes, the acceleration factor to 4, and the
         qualifiers to the Amiga keys.

       Run MachClk -p525
         This set the online rate to $5.25.


    REDEFINING:

       Mach may be run again to redefine hotkeys or set the blanking
       time delay or the beep interval or to change the toggles.
       For example, after Mach is running, typing "Mach -6 +5df0:"
       will change the acceleration factor to 6 and redefine F5 to "df0:".
       Only the clock position may not be changed this way.

       Mach -b10 -p650 +3CCC +2BBB +5EEE FFF
         This redefines
           Qualifier-F2 to  BBB
           Qualifier-F3 to  CCC
           Qualifier-F5 to  EEE
           Qualifier-F6 to  FFF

         resets the blanking delay to 10 minutes, and set the online
         rate to $6.50.


       Mach -eWack
         This changes the Qualifier-ESCape command from NewCLI to Wack.
         Remember, the executed command will have the same size stack
         as Mach.


    MISCELLANEOUS:

       Note that anything after a semicolon is treated as a comment.
       If you are typing this in from the CLI, when you reach the end of
       the line, don't hit return and you can continue mapping up to 255
       characters (including run mach [options]). If you are using an editor
       or word processor, use one that can handle long lines. You can use
       Ed but you need to use the command SR or EX. You can then put this
       in your startup-sequence.

       I have found that the hotkeys do not function properly with the
       program Sili(Con:). But they do work ok with ConMan.
       There seems to be some slight problems with SunMouse and the
       shareware disk utility DiskMan.
       Let me know if you find other incompatibilities.

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

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

    Hidden Qualifier Feature:

       Many disabled people find it difficult if not impossible to
       type key combinations such as Control-Shift-F1. If you put
       -q on the command line, Mach will remember qualifiers that
       are pressed and add them to the first non-qualifier key pressed.
       So you could for example, type Control, Alternate, and then F1.
       The Control and Alternate would be added to the F1 just as if
       they were pressed at the same time. This is not for someone who
       doesn't need it as it sometimes may cause unexpected results like
       if you type Control and then change your mind, the Control will
       still be added to the next key pressed. Pressing Caps Lock will
       reset the qualifier accumulator.
       Note that because most people will not want this, it defaults to
       off unlike all the other features.
       On/off toggle: Control-Qualifier-F6.



       Copyright 1988 by Brian Moats
                         Polyglot Software
                         10431 Ardyce Court
                         Boise, Idaho 83704

                         PeopleLink - BrianM
                         CI$        - 76167,2334

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




  Other programs from Polyglot Software:

  M18Cheater - Lets you cheat in Mean 18 by causing your opponent to
               slice. Public domain.

  FunBut - Lets you use the F1 key instead of the left mouse button.
           It's useful when playing games like Defender of the Crown
           because it sends repeat mouse clicks.  Public Domain.

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

  The Crossword Creator - Make or solve crossword puzzles. 40,000+ word
                          pattern matching dictionary, med-res or interlace,
                          IFF compatible and many more features. $49.95
SHAR_EOF
if test 13285 -ne "`wc -c Mach.doc`"
then
echo shar: error transmitting Mach.doc '(should have been 13285 characters)'
fi
#	End of shell archive
exit 0