This is a quick documentation file on MoonMouse.

Please see the source code for the re-distribution terms for MoonMouse.

MoonMouse is a succesor to Sunmouse written by Scott Evernden.

MoonMouse executes and leaves behind in memory a 172 byte "wedge", much like
DeciGEL. Unlike DeciGEL though this "wedge" is inserted into the input.device
input stream ahead of intuition. It's purpose is to watch the mouse for
movement and the keyboard for incoming keys presses. If the mouse moves the
wedge records this fact. The next time a character comes along the wedge checks
to see if the current screen is the workbench screen. If it is and the key is
not a "system" key, a key that was pressed with either the Left-Alt key or the
Left-Amiga key held down, then the wedge inserts a sequence into the input
stream. This sequence consists of a Left Mouse Button Down followed by a
Left Mouse Button Up. The effect of this is to make intuition think that you
pressed the left mouse button after moving the mouse. Which in turn selects
whatever the mouse is pointing at as the current input source.

All this is SUPPOSED to simulate the way the mouse/keyboard works on a high
priced workstation. Unfortunately, or fortunately (grin), it doesn't quite get
it right. For example, if you move the mouse and point it at a screen gadget
and then type a non-system key on the keyboard two things will happen. First,
that gadget will get a "press" and then your key will be entered. If that gadget
was to indicate "OK to format hard disk" but you didn't want to do that... Well
I've just warned ya... But this shouldn't be too big a deal since you had to
MOVE the mouse to point at this gadget in the first place. If the gadget pops
up under the mouse but you don't actually move the mouse the gadget will not
get a press. (But if the cat jumps on the table with your computer as the
gadget pops up, shakes the mouse, and THEN you press a key... Scream at the cat
not me OK? grin)

All in all this piece of software can take some getting used to.

To install the MoonMouse, from the CLI issue MoonMouse. MoonMouse WILL NOT
run from the workbench. MoonMouse is designed to be inserted into your
s:Startup-Sequence file.

One final note, BE CAREFUL!!! Due to the side effect mentioned above you will
need to be a little more careful about where the mouse is pointing after you
move it. Remember, the pseudo mouse button press ONLY occurs AFTER you move
the mouse and THEN type a character.

Scott Turner