diff options
Diffstat (limited to 'doc/kpilot/index.docbook')
| -rw-r--r-- | doc/kpilot/index.docbook | 280 |
1 files changed, 280 insertions, 0 deletions
diff --git a/doc/kpilot/index.docbook b/doc/kpilot/index.docbook new file mode 100644 index 000000000..e59ca9cd8 --- /dev/null +++ b/doc/kpilot/index.docbook @@ -0,0 +1,280 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd" [ +<!ENTITY kappname "&kpilot;"> +<!ENTITY kpilotver "4.4.6"> +<!ENTITY package "kdepim"> +<!ENTITY USB "<acronym>USB</acronym>"> +<!ENTITY PalmOS '<trademark class="registered">Palm OS</trademark>'> +<!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 "handheld"> +<!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 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> +<year>2005</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 other &PalmOS; devices. +</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;, the &Sony; &Clie; or other +&PalmOS; devices) 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.5.x is current and still unstable as of +August 2005. It does not work with KDE versions lower than 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> + +<!-- +FIXME: Old Warnings +<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; +&Dan.Pilone.mail; +</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önroos +</para></listitem> +<listitem><para>&kaddressbook; Conduit: Greg Stern +</para></listitem> +<listitem><para>Patches by: +Jörn Ahrens, +Robert Ambrose, +Jö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,2005 Carlos Leonhard Woelz +<email>carloswoelz@imap-mail.com</email> +</para> + +<!-- TRANS:CREDITS_FOR_TRANSLATORS --> +&underFDL; +&underGPL; +</chapter> + +&documentation.index; +</book> +<!-- +Local Variables: +sgml-minimize-attributes: nil +sgml-general-insert-case: lower +End: +--> + |