TDE personal information management applications
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

index.docbook 8.1KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280
  1. <?xml version="1.0" ?>
  2. <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
  3. "dtd/kdex.dtd" [
  4. <!ENTITY kappname "&kpilot;">
  5. <!ENTITY kpilotver "4.4.6">
  6. <!ENTITY package "tdepim">
  7. <!ENTITY USB "<acronym>USB</acronym>">
  8. <!ENTITY PalmOS '<trademark class="registered">Palm OS</trademark>'>
  9. <!ENTITY PalmOne '<trademark class="registered">PalmOne</trademark>'>
  10. <!ENTITY Sony '<trademark class="registered">Sony</trademark>'>
  11. <!ENTITY Clie "<productname><trademark>Clie</trademark></productname>">
  12. <!ENTITY FreeBSD '<trademark class="registered">FreeBSD</trademark>'>
  13. <!ENTITY AvantGo '<trademark class="registered">AvantGo</trademark>'>
  14. <!ENTITY handheld "handheld">
  15. <!ENTITY configuring-kpilot SYSTEM "configuration.docbook">
  16. <!ENTITY using-kpilot SYSTEM "usage.docbook">
  17. <!ENTITY synchronization SYSTEM "sync.docbook">
  18. <!ENTITY kpilot-faq SYSTEM "faq.docbook">
  19. <!ENTITY % English "INCLUDE" ><!-- Change language ONLY here -->
  20. <!ENTITY % addindex "IGNORE">
  21. ]>
  22. <!--
  23. From LW: http://www.palm.com/about/trademark.html According to this,
  24. we have have overspecified some of the tradmarks... feel free to
  25. adjust if you think this is the case.
  26. -->
  27. <book lang="&language;">
  28. <bookinfo>
  29. <title>&kpilot; User's Guide</title>
  30. <authorgroup>
  31. <author>
  32. <firstname>Carlos</firstname>
  33. <othername>Leonhard</othername>
  34. <surname>Woelz</surname>
  35. <affiliation>
  36. <address><email>carloswoelz@imap-mail.com</email></address>
  37. </affiliation>
  38. </author>
  39. <author>
  40. <firstname>Adriaan</firstname>
  41. <othername>de</othername>
  42. <surname>Groot</surname>
  43. <affiliation>
  44. <address><email>groot@kde.org</email></address>
  45. </affiliation>
  46. </author>
  47. <author>
  48. <firstname>Dan</firstname>
  49. <surname>Pilone</surname>
  50. </author>
  51. <!-- TRANS:ROLES_OF_TRANSLATORS -->
  52. </authorgroup>
  53. <copyright>
  54. <year>1999</year>
  55. <year>2000</year>
  56. <year>2001</year>
  57. <year>2002</year>
  58. <year>2003</year>
  59. <year>2004</year>
  60. <holder>Adriaan de Groot</holder>
  61. </copyright>
  62. <copyright>
  63. <year>2004</year>
  64. <year>2005</year>
  65. <holder>Carlos Woelz</holder>
  66. </copyright>
  67. <legalnotice>&FDLNotice;</legalnotice>
  68. <date>2004-06-27</date>
  69. <releaseinfo>&kpilotver;</releaseinfo>
  70. <abstract>
  71. <para>
  72. &kpilot; &kpilotver; is the &kde; version of the Desktop &HotSync; software for
  73. &PalmOne; handhelds, the &ThreeCom; &PalmPilot; and other &PalmOS; devices.
  74. </para>
  75. </abstract>
  76. <keywordset>
  77. <keyword>KDE</keyword>
  78. <keyword>KPilot</keyword>
  79. <keyword>tdepim</keyword>
  80. <keyword>palm pilot</keyword>
  81. <keyword>synchronization</keyword>
  82. </keywordset>
  83. </bookinfo>
  84. <chapter id="introduction">
  85. <title>Introduction</title>
  86. <para>
  87. &kpilot; &kpilotver; is an application that synchronizes your &PalmPilot; or
  88. similar device (like the &Handspring; &Visor;, the &Sony; &Clie; or other
  89. &PalmOS; devices) with your &kde; desktop, much like the Palm Desktop &HotSync;
  90. software does for &Windows;. &kpilot; can back-up, restore, and &HotSync; your
  91. &PalmPilot;. It can synchronize the built-in applications with their &kde;
  92. counterparts. It also features additional conduits for third-party software.
  93. </para>
  94. <para>
  95. There is a web page for &kpilot;: the <ulink
  96. url="http://www.kpilot.org/">Official &kpilot; Home Page</ulink>. The <ulink
  97. url="http://pim.kde.org/">KDE-PIM website</ulink> also offers useful information
  98. on the subject of <acronym>PIM</acronym> in general. &kpilot; shares the
  99. tdepim-users mailing list, <email>tdepim-users@kde.org</email>. See <ulink
  100. url="http://www.kde.org/mailinglists"> the mailing lists page</ulink> for more
  101. information on subscribing and unsubscribing from the list.
  102. </para>
  103. <!--
  104. <para>
  105. A word about version numbers: &kpilot; 4.5.x is current and still unstable as of
  106. August 2005. It does not work with KDE versions lower than 3.2.
  107. </para>
  108. -->
  109. <sect1 id="trademarks">
  110. <title>Trademarks</title>
  111. <para>
  112. &kpilot; describes synchronization operations
  113. with &PalmOS; devices, and it uses the word &HotSync;
  114. to name those synchronization operations,
  115. while recognizing that &HotSync; is a trademark of
  116. Palm, Inc. Holders of other trademarks, such as
  117. &Handspring; &Visor;, &Sony; &Clie;, and
  118. the Palm, Inc. trademarks &PalmPilot; and
  119. <productname><trademark>Zire</trademark></productname>
  120. are recognized as well.
  121. </para>
  122. </sect1>
  123. </chapter>
  124. <chapter id="overview">
  125. <title>Overview of &kpilot;</title>
  126. <para>
  127. &kpilot; consists of two parts: the &kpilot; daemon, which sits
  128. in the system tray and handles the actual communication with
  129. the &handheld;, and the normal &kpilot; program, which lets
  130. you configure the daemon and view the databases on your
  131. &handheld;. In normal operation, you will not need to use &kpilot;
  132. itself very much, since the daemon handles communication unobtrusively
  133. and synchronizes your data to &kde; applications like &korganizer;
  134. and &knotes;. &kpilot; is integrated into &kontact; as well.
  135. </para>
  136. <para>
  137. It is vital to configure &kpilot; before use. At the very least,
  138. you need to tell it which hardware device to use to communicate with
  139. your &handheld;.
  140. Configuration settings are described at length in
  141. the <link linkend="configure">section on configuring &kpilot;</link>.
  142. For the impatient, the <link linkend="configwizard">configuration wizard</link>
  143. can set up most things for you.
  144. </para>
  145. <para>
  146. Once &kpilot; is configured, you should make a <link
  147. linkend="backup">backup</link> of your &handheld; first. That is to be on the
  148. safe side. Once that is done, you can just leave the &kpilot; daemon running in
  149. the system tray, and all you need to do is press the &HotSync; button, and
  150. changes in the &handheld; data and the &kde; applications will be <link
  151. linkend="synchronization">synchronized</link>, so that the information matches
  152. again on both the &handheld; and the desktop.
  153. </para>
  154. <para>
  155. If you want to <link linkend="page-viewers">examine</link> the
  156. data stored on your &handheld;, the built in <link
  157. linkend="page-viewers">viewers</link> can be used. This allows you to view
  158. memos, addresses, &etc;. There is a generic hexadecimal database viewer for
  159. advanced use.
  160. </para>
  161. <para>
  162. Finally, &kpilot; can be used to <link linkend="installer-app">install</link>
  163. new programs and databases on your &handheld;.
  164. </para>
  165. <!--
  166. FIXME: Old Warnings
  167. <caution>
  168. <title>Changes in &kpilotver;</title>
  169. <para>
  170. The expressiveness of the <guilabel>No Backup</guilabel> configuration
  171. item, which prevents specific databases from being backed up (for space, speed,
  172. or stability reasons), has been extended.
  173. In particular, the old format listed only
  174. creator values, while the new format can list wildcard database names
  175. as well as creator values.
  176. The value set in the configuration dialog will be automatically adjusted to
  177. the new format.
  178. </para>
  179. <para>
  180. In &kpilot; &kpilotver;, the way conduits are programmed changed,
  181. and you will need to use newly compiled conduits. If there are
  182. old conduits on your system, &kpilot; will prompt you to remove them.
  183. </para>
  184. <para>
  185. Please take the time to review all of the configuration settings.
  186. </para>
  187. </caution>
  188. -->
  189. </chapter>
  190. &configuring-kpilot;
  191. &using-kpilot;
  192. &synchronization;
  193. &kpilot-faq;
  194. <chapter id="credits">
  195. <title>Credits and License</title>
  196. <para>
  197. &kpilot;
  198. Program copyright 1998-2000 by &Dan.Pilone;
  199. &Dan.Pilone.mail;
  200. </para>
  201. <para>
  202. Contributors:
  203. <itemizedlist>
  204. <listitem><para>Adriaan de Groot <email>groot@kde.org</email></para>
  205. </listitem>
  206. <listitem><para>&Preston.Brown; <email>pbrown@redhat.com</email></para>
  207. </listitem>
  208. <listitem><para>VCal and Todo Conduits by: Herwin Jan Steehouwer,
  209. Kenneth Albanowski, &Michael.Kropfberger;
  210. </para></listitem>
  211. <listitem><para>Popmail Conduit overhaul: Marko Gr&ouml;nroos
  212. </para></listitem>
  213. <listitem><para>&kaddressbook; Conduit: Greg Stern
  214. </para></listitem>
  215. <listitem><para>Patches by:
  216. J&ouml;rn Ahrens,
  217. Robert Ambrose,
  218. J&ouml;rg Habenicht,
  219. Philipp Hullmann,
  220. Dag Nygren,
  221. Scott Presnell,
  222. Heiko Purnhagen,
  223. Chuck Robey
  224. and
  225. Jay Summet
  226. </para></listitem>
  227. </itemizedlist>
  228. </para>
  229. <para>
  230. Documentation copyright 2000,2001 Adriaan de Groot <email>groot@kde.org</email>.
  231. Documentation copyright 2004,2005 Carlos Leonhard Woelz
  232. <email>carloswoelz@imap-mail.com</email>
  233. </para>
  234. <!-- TRANS:CREDITS_FOR_TRANSLATORS -->
  235. &underFDL;
  236. &underGPL;
  237. </chapter>
  238. &documentation.index;
  239. </book>
  240. <!--
  241. Local Variables:
  242. sgml-minimize-attributes: nil
  243. sgml-general-insert-case: lower
  244. End:
  245. -->