summaryrefslogtreecommitdiffstats
path: root/doc/kodo/index.docbook
blob: cbfed19f4de35a90cc14afabf6b79eecfb6fa36e (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
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
 <!ENTITY kappname "&kodometer;">
 <!ENTITY package "tdetoys">
 <!ENTITY % addindex "IGNORE">
 <!ENTITY % English "INCLUDE">
]>

<book lang="&language;">
<bookinfo>
<title>The &kodometer; Handbook</title>
<authorgroup>
<author>
&Armen.Nakashian; &Armen.Nakashian.mail;
</author>

<!-- TRANS:ROLES_OF_TRANSLATORS -->

</authorgroup>

<copyright>
<year>1999</year><year>2001</year>
<holder>&Armen.Nakashian;</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>2003-09-17</date>
<releaseinfo>3.2</releaseinfo>

<abstract>
<para>&kodometer; is a little gadget to measure your desktop mileage</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>KOdometer</keyword>
<keyword>odometer</keyword>
<keyword>mouse</keyword>
<keyword>mileage</keyword>
</keywordset>
</bookinfo>

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

<sect1 id="whats-kodo">
<title>What is &kodometer;?</title>

<para>
&kodometer; <emphasis>measures your desktop mileage</emphasis>.  It tracks the
movement of your mouse pointer across your desktop, and renders it in
inches/feet/miles!  It can do cm/meters/km too.  The most exciting
feature is the tripometer, and its utter uselessness.</para>

<note>
<para>The next version will be USEFUL!</para>
</note>

</sect1>

</chapter>

<chapter id="onscreen-operation">
<title>On screen operation</title>

<screenshot>
<screeninfo>A labeled screen-shot of &kodometer; in action</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="guide.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>A labeled screen-shot of &kodometer; in action</phrase></textobject>
<caption><para>A screen shot. Note the fashionable lack of a
titlebar.</para></caption>
</mediaobject>
</screenshot>

<para>
The <guilabel>Odometer</guilabel> is the total distance traveled by the
mouse since the last odometer reset.  The
<guilabel>Tripometer</guilabel> is the distance traveled by the mouse
since it last stopped moving.
</para>

<sect1 id="menu-options">
<title>Menu Options</title>

<para>
If you've gotten this far, you probably already know that there is a
&RMB; mouse button context menu on &kodometer;, which contains a number of
choices.
</para>

<variablelist>
<varlistentry>
<term><guimenuitem>Enable</guimenuitem></term>
<listitem>
<para>
Toggle mileage tracking.  This is good if you want to cheat on your
mileage.  <emphasis>Note: This is illegal in most countries</emphasis>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Metric Display</guimenuitem></term>
<listitem>
<para>
Because &kodometer; was written by an American, it obnoxiously assumes you
want to use Inches/Feet/Miles for measurement.  If you come from some
more modern country in Europe, to use metric measurements, turn on this
option.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Auto Reset Trip</guimenuitem></term>
<listitem>
<para>
This option will cause &kodometer; to set the Tripometer back to zero every
time it starts up. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Reset Trip</guimenuitem></term>
<listitem>
<para>
Set the tripometer to zero.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Reset Odometer</guimenuitem></term>
<listitem>
<para>
Set the odometer back to zero. <emphasis>You might get in trouble for
this!</emphasis></para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>About Mousepedometa</guimenuitem></term>
<listitem>
<para>
Pops up a little dialog box with information on who to blame for the
program.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Help</guimenuitem></term>
<listitem>
<para>
This menu entry opens up the &kodometer; help - this very document. 
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Quit</guimenuitem></term>
<listitem>
<para>
Quit &kodometer;
</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

</chapter>

<chapter id="how-it-works">
<title>How It Works</title>

<para>&X-Window; displays are usually configured with a screen-size
variable.  That is, how big your screen is in real-world measurements,
not pixels.  &kodometer; grabs this value and uses it come up with a
&dpi; (dots per inch) value for your display, and thus
can relate the number of pixels you've traversed to the number of inches
the pointer appears to have moved on the screen.</para>

<para>But lets be real!  Its horribly <emphasis>inaccurate!</emphasis>
&kodometer; makes no pretense of being even remotely accurate.  In fact,
someone has measured the movement of their mouse across the screen with
a ruler, and found that the distance algorithm is almost 25&percnt; off!
The original author's response to this complaint was <quote>who
cares?</quote>.</para>
</chapter>

<chapter id="license-and-credits">
<title>Credits and Licenses</title>

<para>&kodometer; Copyright &copy; 1998-2001, &Armen.Nakashian;.</para>

<para>Documentation copyright 1998 &Armen.Nakashian;, with small updates
and markup cleanup for &kde; 2.2, &Lauri.Watts; &Lauri.Watts.mail;
</para>

&underFDL;
&underGPL;

</chapter>

&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:

// vim:ts=0:sw=2:tw=78:noet
-->