<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kpilot;">
  <!ENTITY kpilotver "4.4.3">
  <!ENTITY package "kdepim">
  <!ENTITY USB "<acronym>USB</acronym>">
  <!ENTITY PalmOne '<trademark class="registered">PalmOne</trademark>'>
  <!ENTITY Sony '<trademark class="registered">Sony</trademark>'>
  <!ENTITY Clie "<productname><trademark>Clie</trademark></productname>">
  <!ENTITY FreeBSD '<trademark class="registered">FreeBSD</trademark>'>
  <!ENTITY AvantGo '<trademark class="registered">AvantGo</trademark>'>
  <!ENTITY handheld "&PalmPilot;">
  <!ENTITY configuring-kpilot SYSTEM "configuration.docbook">
  <!ENTITY using-kpilot SYSTEM "usage.docbook">
  <!ENTITY synchronization SYSTEM "sync.docbook">
  <!ENTITY kpilot-faq SYSTEM "faq.docbook">
  <!ENTITY % English "INCLUDE" > <!-- Change language ONLY here -->
  <!ENTITY % addindex "IGNORE">
]>


<!--
    From [cw]: This document is nearly finished. I will submit it to the
    doc-english list before stating that it is ready for translation, but
    you can start to translate if you wish.

      TRANSLATORS YOU CAN START WORKING NOW!
-->
<!--
    From LW: http://www.palm.com/about/trademark.html According to this,
	we have have overspecified some of the tradmarks... feel free to
	adjust if you think this is the case.
-->

<book lang="&language;">

<bookinfo>
<title>&kpilot; User's Guide</title>

<authorgroup>
<author>
	<firstname>Carlos</firstname>
	<othername>Leonhard</othername>
	<surname>Woelz</surname>
	<affiliation>
		<address><email>carloswoelz@imap-mail.com</email></address>
	</affiliation>
</author>
<author>
	<firstname>Adriaan</firstname>
	<othername>de</othername>
	<surname>Groot</surname>
	<affiliation>
		<address><email>groot@kde.org</email></address>
	</affiliation>
</author>
<author>
	<firstname>Dan</firstname>
	<surname>Pilone</surname>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<copyright>
<year>1999</year>
<year>2000</year>
<year>2001</year>
<year>2002</year>
<year>2003</year>
<year>2004</year>
<holder>Adriaan de Groot</holder>
</copyright>

<copyright>
<year>2004</year>
<holder>Carlos Woelz</holder>
</copyright>


<legalnotice>&FDLNotice;</legalnotice>

<date>2004-06-27</date>
<releaseinfo>&kpilotver;</releaseinfo>

<abstract>
<para>
&kpilot; &kpilotver;
is the &kde; version of the Desktop &HotSync; software for
&PalmOne; handhelds, the &ThreeCom; &PalmPilot; and similar products.
</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>KPilot</keyword>
<keyword>kdepim</keyword>
<keyword>palm pilot</keyword>
<keyword>synchronization</keyword>
</keywordset>

</bookinfo>

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

<para>
&kpilot; &kpilotver;
is an application that
synchronizes your &PalmPilot; or similar
device (like the &Handspring; &Visor; or the
&Sony; &Clie;)
with your &kde; desktop,
much like the Palm Desktop &HotSync; software does
for &Windows;.
&kpilot; can back-up, restore, and &HotSync;
your &PalmPilot;.
It can synchronize the built-in applications
with their &kde; counterparts.
It also features additional conduits for
third-party software.
</para>

<para>
There is a web page for &kpilot;: the
<ulink url="http://www.kpilot.org/">
Official &kpilot; Home Page
</ulink>.
The
<ulink url="http://pim.kde.org/">
KDE-PIM website
</ulink>
also offers useful information on the subject of
<acronym>PIM</acronym>
in general.
&kpilot; shares the
kdepim-users mailing list,
<email>kdepim-users@kde.org</email>.
See
<ulink url="http://www.kde.org/mailinglists">
the mailing lists page</ulink>
for more information on subscribing and unsubscribing from the list.
</para>

<para>
A word about version numbers:
&kpilot; 4.4.x is current and still unstable as of June 2004.
It does not work with KDE versions lower that 3.2.
</para>





<sect1 id="trademarks">
<title>Trademarks</title>
<para>
&kpilot; describes synchronization operations
with &PalmOS; devices, and it uses the word &HotSync;
to name those synchronization operations,
while recognizing that &HotSync; is a trademark of
Palm, Inc. Holders of other trademarks, such as
&Handspring; &Visor;, &Sony; &Clie;, and
the Palm, Inc. trademarks &PalmPilot; and
<productname><trademark>Zire</trademark></productname>
are recognized as well.
</para>
</sect1>

</chapter>

<chapter id="overview">
<title>Overview of &kpilot;</title>

<para>
&kpilot; consists of two parts: the &kpilot; daemon, which sits
in the system tray and handles the actual communication with
the &handheld;, and the normal &kpilot; program, which lets
you configure the daemon and view the databases on your
&handheld;. In normal operation, you will not need to use &kpilot;
itself very much, since the daemon handles communication unobtrusively
and synchronizes your data to &kde; applications like &korganizer;
and &knotes;. &kpilot; is integrated into Kontact as well.
</para>

<para>
It is vital to configure &kpilot; before use. At the very least,
you need to tell it which hardware device to use to communicate with
your &handheld;.
Configuration settings are described at length in
the <link linkend="configure">section on configuring &kpilot;</link>.
For the impatient, the <link linkend="configwizard">configuration wizard</link>
can set up most things for you.
</para>

<para>
Once &kpilot; is configured, you should make a <link linkend="backup">backup</link>
of your &handheld; first. That is to be on the safe side. Once that is done, you
can just leave the &kpilot; daemon running in the system tray, and all you need to
do is press the &HotSync; button, and changes in the &handheld; data and the &kde;
applications will be <link linkend="synchronization">synchronized</link>,
so that the information matches again on
both the &handheld; and the desktop.
</para>

<para>
If you want to <link linkend="page-viewers">examine</link> the
data stored on your &handheld;, the built in
<link linkend="page-viewers">viewers</link> can be used.
This allows you to view memos, addresses, &etc;.
There is a generic hexadecimal database viewer for
advanced use.
</para>

<para>
Finally, &kpilot; can be used to <link linkend="installer-app">install</link> new programs and databases
on your &handheld;.
</para>

<caution>
<title>Changes in &kpilotver;</title>
<para>
The expressiveness of the <guilabel>No Backup</guilabel> configuration
item, which prevents specific databases from being backed up (for space, speed,
or stability reasons), has been extended.
In particular, the old format listed only
creator values, while the new format can list wildcard database names
as well as creator values.
The value set in the configuration dialog will be automatically adjusted to
the new format.
</para>
<para>
In &kpilot; &kpilotver;, the way conduits are programmed changed,
and you will need to use newly compiled conduits. If there are
old conduits on your system, &kpilot; will prompt you to remove them.
</para>
<para>
Please take the time to review all of the configuration settings.
</para>
</caution>

</chapter>


&configuring-kpilot;
&using-kpilot;
&synchronization;
&kpilot-faq;


<chapter id="credits">

<title>Credits and License</title>

<para>
&kpilot;
Program copyright 1998-2000 by Dan Pilone
<email>pilone@slac.com</email>
</para>
<para>
Contributors:
<itemizedlist>
<listitem><para>Adriaan de Groot <email>groot@kde.org</email></para>
</listitem>
<listitem><para>Preston Brown <email>pbrown@redhat.com</email></para>
</listitem>
<listitem><para>VCal and Todo Conduits by: Herwin Jan Steehouwer,
Kenneth Albanowski, Michael Kropfberger
</para></listitem>
<listitem><para>Popmail Conduit overhaul: Marko Gr&ouml;nroos
</para></listitem>
<listitem><para>&kaddressbook; Conduit: Greg Stern
</para></listitem>
<listitem><para>Patches by:
J&ouml;rn Ahrens,
Robert Ambrose,
J&ouml;rg Habenicht,
Philipp Hullmann,
Dag Nygren,
Scott Presnell,
Heiko Purnhagen,
Chuck Robey
and
Jay Summet
</para></listitem>
</itemizedlist>
</para>

<para>
Documentation copyright 2000,2001 Adriaan de Groot <email>groot@kde.org</email>.
Documentation copyright 2004 Carlos Leonhard Woelz <email>carloswoelz@imap-mail.com</email>
</para>

&underFDL;
&underGPL;
</chapter>

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

