summaryrefslogtreecommitdiffstats
path: root/doc/kmousetool/index.docbook
blob: dce288fe226ae1d67ba2e510b9d1840539331844 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kmousetool '<application>KMouseTool</application>'>
  <!ENTITY kappname "&kmousetool;">
  <!ENTITY package "kdeaccessibility">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE"><!-- change language only here -->
]>

<book lang="&language;">

<bookinfo>
<title>The &kmousetool; Handbook</title>

<authorgroup>
<author>
<firstname>Jeff</firstname>

<surname>Roush</surname>
<affiliation>
<address><email>jeff@kmousetool.com</email></address>
</affiliation>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>


<copyright>
<year>2002</year>
<holder>Jeff Roush</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>2006-05-20</date>
<releaseinfo>1.12</releaseinfo>

<abstract>
<para>
&kmousetool; clicks the mouse whenever the mouse cursor pauses briefly.  It
was designed to help those with repetitive strain injuries, for whom
pressing buttons hurts. 
</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>kdeutils</keyword>
<keyword>KMouseTool</keyword>
<keyword>ergonomic</keyword>
<keyword>tendonitis</keyword>
<keyword>carpal tunnel syndrome</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<para>
&kmousetool; clicks the mouse whenever the mouse cursor pauses briefly.  It was designed to help those
with repetitive strain injuries, for whom pressing buttons hurts.
It can also drag the mouse, although this takes a bit more practice.
</para>

<para>
&kmousetool; can eliminate the pain caused by clicking the mouse, and helps many
people to use the computer without pain.  Unfortunately, some pain can also
be caused by simply moving the mouse around the table.  If you are experiencing
computer-related pain and haven't yet seen a doctor, please do so.
</para>
<para>
Just to make it absolutely clear: while &kmousetool; can help reduce the pain
caused by <emphasis>clicking</emphasis> the mouse, it cannot help any pain
caused by <emphasis>moving</emphasis> the mouse.  And, like all ergonomic tools,
your mileage may vary.
</para>

</chapter>


<chapter id="using-kmousetool">
<title>Using &kmousetool;</title>
<para>
Using &kmousetool; is simple: &kmousetool; watches as you move the mouse, and
when you pause briefly, it clicks.
</para>

<para>
&kmousetool;'s Smart Drag mode allows you to drag the mouse.
</para>

<para>
When Smart Drag is enabled, &kmousetool; pauses after it clicks down; if you
move the mouse, it waits until you stop moving before it clicks up. This
way, you can both click and drag the mouse. Smart Drag takes a bit more
practice, but becomes natural once you get used to it.
</para>

</chapter>


<chapter id="commands">
<title>Command Reference</title>

<sect1 id="kmousetool-mainwindow">
<title>The Main &kmousetool; window</title>

    <para>&kmousetool;'s
    options are accessed mostly via the mouse.</para>


    <variablelist>
      <varlistentry>
        <term><guibutton>Start</guibutton>
        </term>
        <listitem>
          <para>Starts (or stops) &kmousetool;.</para>
        </listitem>
      </varlistentry>
<varlistentry>
<term><guilabel>Minimum movement:</guilabel></term>
<listitem>
<para>The minimum movement in pixels before &kmousetool; will attempt
to click the mouse.</para>
</listitem>
</varlistentry>

      <varlistentry>
        <term><guilabel>Dwell time (1/10 sec):</guilabel>
        </term>
        <listitem>
          <para>The time the mouse has to pause before &kmousetool; clicks.
	  Try increasing this time if
	  it is hard getting used to &kmousetool; </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><guilabel>Smart drag</guilabel>
        </term>
        <listitem>
          <para>Enables or disables Smart Drag.  Disabled use is
          easier, so this is the default.</para><para>If you enable
          <guilabel>Smart drag</guilabel> the <guilabel>Drag time
          (1/10 sec):</guilabel> field becomes available.  This is the
          time &kmousetool; waits, after it clicks down, before it
          clicks back up if you don't move the mouse. </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><guilabel>Enable strokes</guilabel>
        </term>
        <listitem>
          <para>&kmousetool; now supports strokes.  When you enable
strokes, a slow move to the right and back, followed by a pause, will
generate a <mousebutton>right</mousebutton> click.  A slow move left
and back will generate a double click.  (Strokes are specified in
<filename>$<envar>KDEHOME</envar>/share/config/kmousetool_strokes.txt</filename>.
This file is generated by &kmousetool; the first time it is run, but
can be modified afterwards.)
	  </para>
        </listitem>
      </varlistentry>      
       <varlistentry>
        <term><guilabel>Audible click</guilabel>
        </term>
        <listitem>
          <para>
	 Plays a sound when &kmousetool; clicks down.  This helps, especially
         with Smart Drag.
	  </para>
	  <para>
	 If the sound seems delayed, you can have &kde; speed it up.
	 To do this open the &kcontrolcenter;, click on
	 <guimenuitem>Sound &amp; Multimedia</guimenuitem>, then on <guimenuitem>Sound
	 System</guimenuitem>, and then select the <guilabel>Sound
	 I/O</guilabel> tab.  At the bottom
	 of the tab, there is an <guilabel>Audio buffer size (response
	 time)</guilabel> adjustment; 
	 slide this towards the lower number to speed up the audio
	 response time.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><guilabel>Start with KDE</guilabel>
        </term>
        <listitem>
          <para>When this is enabled, &kmousetool; will start each
	  time &kde; starts. At the moment, this only works under
	  &kde;.  Under GNOME or other Window Managers, see the
	  documentation for the Window Manager itself to see how to
	  start a program automatically when you start the windowing
	  system.</para> 
        </listitem>
      </varlistentry>
<varlistentry>
<term><guibutton>Defaults</guibutton></term>
<listitem>
<para>Reset all settings to their defaults.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Reset</guibutton></term>
<listitem>
<para>Reset all settings to their state when you opened the dialog,
or, if you have already saved a setting with the
<guibutton>Apply</guibutton> button, reset all settings to the state
when you last pressed <guibutton>Apply</guibutton></para>
</listitem>
</varlistentry>
     <varlistentry>
        <term><guibutton>Apply</guibutton>
        </term>
        <listitem>
          <para>After changing any settings, you must click this button.</para>
        </listitem>
      </varlistentry>
<varlistentry>
<term><guibutton>Help</guibutton></term>
<listitem>
<para>Opens the User manual (this document).</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Close</guibutton></term>
<listitem>
<para>Close the dialog without saving any settings.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Quit</guibutton></term>
<listitem>
<para>Quit &kmousetool;</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>
</chapter>

<chapter id="Tips">
<title>Tips</title>

<para>
These tips can help shorten &kmousetool;'s learning curve a bit.

<itemizedlist>
<listitem><para>You can modify the time delays &kmousetool; waits, for both clicking and for dragging.</para>
</listitem>
<listitem><para>It's best to practice clicking with &kmousetool; using its defaults first.
You may especially want to leave Smart Drag disabled at first.
Then, once you are comfortable clicking, move on to practicing Smart Drag.</para>
</listitem>
<listitem><para>When using Smart Drag, it may help to enable the Audible Click</para>
</listitem>
<listitem><para>When using the Audible Click, you may need to speed up &kde;'s audio response.</para>
</listitem>
</itemizedlist>
</para>

</chapter>

<chapter id="faq">
<title>Questions and Answers</title>

&reporting.bugs;
&updating.documentation;

<qandaset id="faqlist">
<qandaentry>
<question>
<para>Help!  &kmousetool; keeps dropping spurious clicks all over the screen!</para>
</question>
<answer>
<para>
When you are using &kmousetool;, you do have to learn new mousing habits.
</para>
<para>
First, 
keep in mind where it's safe to click &mdash; clicking on gray parts of windows or non-link
areas of web browsers won't hurt anything, so you can safely rest the mouse over those areas 
until you need it.
</para>
<para>
Second, you need to know where you're going to click before you move
the mouse. Most of the time, when we know we're going to use the mouse, most of
us grab the mouse and start moving it around randomly until we figure out where
we want to click. With &kmousetool;, you need to know where you're going to click
before you move the mouse in the first place. It is also a good idea to keep
your hands off the mouse when you're not using it.
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>My mouse sticks when I move it. Can I still use &kmousetool;?</para>
</question>
<answer>
<para>Yes. If your mouse sticks, it means you need to clean your mouse.
This is usually easy to do; the trick is that you have to clean not just the
mouse's ball, but the rollers that the ball rolls against inside the mouse.</para>
<para>First, you have to remove the ball.  The method for doing this varies from
mouse to mouse, but it's usually pretty clear how to do this if you look at
the bottom of the mouse.</para>
<para>Once you've removed the ball, you should be able to see the rollers on the
sides of the hole that contained the ball.  The dirt and grime on them can be
easily scraped off with a flat blade or with a fingernail.  </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>&kmousetool; clicks down and never clicks up. What's happening?</para>
</question>
<answer>
<para>In some rare situations, the system suspends &kmousetool; when a drag
starts; if you are using Smart Drag, this means thar &kmousetool; can never finish the drag by
clicking up.</para>
<para>
This happens when you use &kmousetool; under a non &kde; window manager and then
use it to move a window.  
</para>
<para>The solution is to simply click manually; this resets &kmousetool;, and you can then
continue to work normally again.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>
&kmousetool; moves the cursor when I am trying to type.</para>
</question>
<answer>
<para>Problem: When you're typing text, &kmousetool; keeps
dropping clicks and moving the cursor away from where you want to type.</para>
<para>Solution: Use the mouse to place the cursor where you want it, but when you're ready
to type, park the mouse on a neutral area on the screen. Then, if you
bump the mouse, or if it moves a few pixels, any random clicks that it sends
won't matter. Safe places to park the mouse include the gray areas
around toolbars and menus, and on the title bars of windows.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>I'm trying to use Smart Drag, but I cannot get the hang of using it to edit text.</para>
</question>
<answer>
<para>
Smart Drag is an advanced feature of &kmousetool;, and takes some getting used to. It is very
possible to use it to select text, to cut and paste, and use it in almost any situation
where you would normally want to drag the mouse. But you probably won't be able to do this
at first. Here are some suggestions:
</para>
<itemizedlist>
<listitem><para>Don't use Smart Drag while you are first learning to use &kmousetool;. Instead,
to select text, click at one end of the text, and hold down
the shift key while you click at the other end of the text.
</para></listitem>
<listitem><para>Use the Audible Click.  This will play a <quote>click</quote> sound when &kmousetool; clicks
down, and this will tell you when the Smart Drag delay is beginning.  With practice, you
can use Smart Drag without the Audible Click, but it does take a fair amount of practice.
</para></listitem>
<listitem><para>Know where you're going to click the mouse before you begin moving it.
</para></listitem>
</itemizedlist>

</answer>
</qandaentry>

</qandaset>
</chapter>

<chapter id="credits">

<title>Credits and License</title>

<para>
&kmousetool;
</para>
<para>
Program copyright 2002 Jeff Roush <email>jeff@mousetool.com</email>
and 2003 Gunnar Schmi Dt <email>gunnar@schmi-dt.de</email>
</para>
<para>
Contributors:
<itemizedlist>
<listitem><para>Jeff Roush <email>jeff@mousetool.com</email></para></listitem>
<listitem><para>Gunnar Schmi Dt<email>gunnar@schmi-dt.de</email></para></listitem>
<listitem><para>Olaf Schmidt <email>ojschmidt@kde.org</email></para></listitem>
</itemizedlist>
</para>

<para>
Documentation copyright 2002 Jeff Roush<email>jeff@mousetool.com</email>
</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
&underFDL;
&underGPL;        	 <!-- GPL License -->

</chapter>

<appendix id="installation">
<title>Installation</title>

<sect1 id="getting-kmousetool">
<title>How to obtain &kmousetool;</title>

&install.intro.documentation;

</sect1>

<sect1 id="requirements">
<title>Requirements</title>

<para>
In order to successfully use &kappname;, you need the XTest extension
compiled as part of your &X-Window;. This should already be installed
on your system; very few systems won't have it.
</para>
<para>
In order to use the Audible Click feature, you will have to have a
sound card and speakers, and you will have to have configured the
sound card correctly.
</para>
</sect1>

<sect1 id="compilation">
<title>Compilation and Installation</title>

&install.compile.documentation;

</sect1>

</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->