Warning, /accessibility/kmousetool/README is written in an unsupported language. File is not indexed.

0001 MouseTool is a program that clicks the mouse for you.
0003 I designed it to help relieve the pain that clicking mouse buttons can cause.
0005 For more information, see www.mousetool.com
0008 How To Use MouseTool 
0010 1 It's simple: MouseTool watches as you move the mouse. When you stop, it clicks.
0012 2 Practice with this.  When you are comfortable with it, move on to Smart Drag.
0014 3 When Smart Drag is enabled, MouseTool pauses after it clicks down.  If you
0015   move the mouse, it waits until you stop moving before it clicks up.
0016   This takes more practice, but if I can learn to do it without thinking, so can you.
0018 4 KMouseTool 1.1 supports strokes.  When you enable strokes, a slow move to the
0019   right and back, followed by a pause, will generate a right-click.  A slow move
0020   left and back will generate a double click.  (Strokes are specified in
0021   ~/.kde3/share/config/kmousetool_strokes.txt.  This file is generated by KMouseTool
0022   the first time it is run, but can be modified afterwards.)
0024 MouseTool Options:
0026 * Checkboxes:
0027   Smart Drag         -- enables or disables Smart Drag.  Disabled is easier, so this is default.
0028   Audible Click      -- plays a sound when MouseTool clicks down.  This helps, especially
0029                         with Smart Drag, but as of version 0.8, the latency is too high.
0030                         By the time you hear the click, you're doing something else.
0031                         This will be fixed in the next version.
0032   Start with desktop session
0033                      -- When this is enabled, MouseTool will start each time the desktop session
0034                         starts.
0035   Enable Strokes     -- When this is enabled, you can generate right- or double-clicks 
0036                         using mouse strokes.
0038 * Times
0039   Dwell Time         -- The time you have to pause before MouseTool clicks.
0040   Drag Time          -- (When Smart Drag is enabled) the time MouseTool waits, after it clicks
0041                         down, before it clicks back up if you don't move the mouse.
0042   Apply Times Button -- After changing either time, you must click this button.
0044 * Start Button       -- Starts MouseTool.  (Well, duh.)
0045                         When it says "stop", clicking it will stop MouseTool.  (Duh, again.)
0047 * command line       -- MouseTool has no command line options.
0048                         It does remembers its state when it is restarted, though.
0050 * Hotkeys            -- None yet (as of version 1.1).  They are very useful, though, and may be added.
0053 Credit:
0055 The idea for MouseTool came to me when I was thinking about head-tracking
0056 systems that allow you to move a cursor using your head orientation, and then
0057 send clicks when you pause.  As far as I know, I was the first person to use
0058 this technique with an ordinary mouse, but it is quite possible that I am wrong
0059 about that.  There are now other programs available for Windows and Macs that
0060 do this; I know that some were developed after MouseTool, but it is likely
0061 others came before.
0063 If you know of another Linux- or Unix-based program that does this, please let
0064 me know (at jeff@mousetool.com)
0066 The clever idea for Smart Drag was suggested by Joe Betts.  Thanks, Joe!
0068 Other ideas in MouseTool for Windows that I hope to port to KDE were either
0069 suggested by MouseTool users or came out of email discussions with users.
0073 Bugs and issues:
0074 Emacs   - Smart Drag and Emacs menus don't mix well; the menus don't stay visible
0075           long enough to use.  XEmacs seems to work fine.  Gvim also works well.
0077 Taskbar - When you drag the taskbar using Smart Drag in KDE 2.x, kmousetool won't release
0078           the drag.  This can be scary if you're not expecting it, but simply clicking 
0079           the mouse button manually fixes the problem.  KDE 3.x does not have this problem.
0081           This seems to be an issue with the internals of KDE or QT code, and similar
0082           things happen in Windows.  I haven't looked into it much under KDE, but on
0083           Windows it happens when mousetool's timer stops while Windows waits for an
0084           upclick, and the upclick never happens because the timer is stopped; 
0085           I'm sure the same thing is happening under KDE.