Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdetoys@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

3 files changed, 229 insertions, 0 deletions

diff --git a/doc/kodo/Makefile.am b/doc/kodo/Makefile.am
new file mode 100644
index 0000000..085981d
--- /dev/null
+++ b/doc/kodo/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
diff --git a/doc/kodo/guide.png b/doc/kodo/guide.png
new file mode 100644
index 0000000..18b820e
--- /dev/null
+++ b/doc/kodo/guide.png
diff --git a/doc/kodo/index.docbook b/doc/kodo/index.docbook
new file mode 100644
index 0000000..20cd0be
--- /dev/null
+++ b/doc/kodo/index.docbook
@@ -0,0 +1,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 "kdetoys">
+ <!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
+-->