@ -0,0 +1,3 @@
|
||||
KDE_LANG = en
|
||||
KDE_DOCS = AUTO
|
||||
SUBDIRS = $(AUTODIRS)
|
@ -0,0 +1,12 @@
|
||||
#################################################
|
||||
#
|
||||
# (C) 2010-2011 Serghei Amelian
|
||||
# serghei (DOT) amelian (AT) gmail.com
|
||||
#
|
||||
# Improvements and feedback are welcome
|
||||
#
|
||||
# This file is released under GPL >= 2
|
||||
#
|
||||
#################################################
|
||||
|
||||
tde_create_handbook( DESTINATION kpilot )
|
@ -0,0 +1,2 @@
|
||||
KDE_DOCS = kpilot
|
||||
KDE_LANG = en
|
After Width: | Height: | Size: 45 KiB |
After Width: | Height: | Size: 10 KiB |
After Width: | Height: | Size: 17 KiB |
After Width: | Height: | Size: 19 KiB |
After Width: | Height: | Size: 13 KiB |
After Width: | Height: | Size: 17 KiB |
After Width: | Height: | Size: 18 KiB |
After Width: | Height: | Size: 42 KiB |
After Width: | Height: | Size: 66 KiB |
@ -0,0 +1,386 @@
|
||||
<chapter id="faq">
|
||||
<title>&FAQ;</title>
|
||||
|
||||
<sect1 id="faq-crash">
|
||||
<title>&kpilot; Startup Problems</title>
|
||||
|
||||
<qandaset>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>
|
||||
What do I put after <option>--debug</option>?
|
||||
</para>
|
||||
</question>
|
||||
<answer>
|
||||
<para>
|
||||
Nothing. Most versions of &kpilot; don't even have
|
||||
a <option>--debug</option> option, and will complain if you use it.
|
||||
For those versions that <emphasis>do</emphasis> have it,
|
||||
use a value between 1 and 4, which will control the
|
||||
amount of debugging printed (a little).
|
||||
Using a value of 1 will print a fairly complete call trace
|
||||
without the really-boring functions, while 4 will include every trivial
|
||||
function in all of &kpilot;.
|
||||
</para>
|
||||
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry id="faq-connection">
|
||||
<question>
|
||||
<para>
|
||||
&kpilot; says <errorname>Can't connect to pilot</errorname>
|
||||
</para>
|
||||
</question>
|
||||
<answer>
|
||||
<para>
|
||||
This can have various causes. Check that:
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
The pilot device (usually <filename
|
||||
class="devicefile">/dev/pilot</filename>) exists and points to the
|
||||
serial port the &PalmPilot; is actually connected to.
|
||||
</para>
|
||||
<para>
|
||||
To link the &PalmPilot; device to the correct serial port, you can
|
||||
either fill in
|
||||
<filename
|
||||
class="devicefile">/dev/ttyS<replaceable>n</replaceable></filename>
|
||||
in the <guilabel>Pilot Device</guilabel> field in the <link
|
||||
linkend="page-general">setup dialog</link> or (preferably) link
|
||||
<filename class="devicefile">/dev/pilot</filename> to
|
||||
<filename
|
||||
class="devicefile">/dev/ttyS<replaceable>n</replaceable></filename>
|
||||
with the following command (as <systemitem
|
||||
class="username">root</systemitem>):
|
||||
<userinput>
|
||||
<command>ln</command>
|
||||
<option>-s</option>
|
||||
<parameter>/dev/ttyS<replaceable>n</replaceable></parameter>
|
||||
<parameter>/dev/pilot</parameter></userinput>
|
||||
Here <filename
|
||||
class="devicefile">/dev/ttyS<replaceable>n</replaceable></filename>
|
||||
is the name
|
||||
of the serial port; replace <replaceable>n</replaceable>
|
||||
with the correct number (usually 0 or 1).
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Check that you have permission to read and write to the serial port.
|
||||
The permissions for the serial port should be such that you can write to
|
||||
it. This is most easily done by running the following (as root):
|
||||
<userinput>
|
||||
<command>chmod</command>
|
||||
<option>666</option>
|
||||
<parameter>/dev/ttyS<replaceable>n</replaceable></parameter>
|
||||
</userinput>
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Try starting the daemon by hand before starting &kpilot;.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
(For &Linux-Mandrake; 7 systems) Check the system security level:
|
||||
settings higher than 3 prevent some forms of inter-process
|
||||
communication which are necessary for &kpilot; to
|
||||
operate correctly.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
(<emphasis>&Linux-Mandrake; security information
|
||||
courtesy of Jay Summett</emphasis>)
|
||||
To set your
|
||||
<!-- TM? --><acronym>MSEC</acronym>
|
||||
<!-- TM? -->(Mandrake SECurity)
|
||||
settings to not block the
|
||||
&kpilot; socket (for connections to localhost) you can
|
||||
login as root and
|
||||
type
|
||||
<userinput>
|
||||
<command>/etc/security/msec/init.sh</command>
|
||||
<option>3</option>
|
||||
</userinput>
|
||||
Which will set your
|
||||
<!-- TM? --><acronym>MSEC</acronym>
|
||||
level to 3 (regular security).
|
||||
For more information about the various security levels, &etc;, see:
|
||||
<ulink url="http://www.linux-mandrake.com/userguide/en/reference/017.html#157">
|
||||
the
|
||||
<!-- TM? -->Mandrake
|
||||
reference guide</ulink>.
|
||||
</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
</qandaset>
|
||||
|
||||
</sect1>
|
||||
|
||||
<sect1 id="faq-database">
|
||||
<title>Database Questions</title>
|
||||
|
||||
<para>
|
||||
This section answers questions commonly asked about
|
||||
particular databases and how they
|
||||
interact with &kpilot;.
|
||||
</para>
|
||||
|
||||
<qandaset>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>
|
||||
Databases become corrupted after a sync,
|
||||
what should I do?
|
||||
</para>
|
||||
</question>
|
||||
<answer>
|
||||
<para>
|
||||
Certain databases (from third-party software manufacturers)
|
||||
appear not to follow the standard database layout.
|
||||
If you can find out what the creator id of the database is,
|
||||
you can add it to either the
|
||||
<guilabel>Backup Only:</guilabel> list or the
|
||||
<guilabel>Skip</guilabel> list in the
|
||||
<link linkend="page-backup">settings dialog</link>.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The following table shows which databases should be skipped
|
||||
or backed-up only:
|
||||
<table id="dbskip">
|
||||
<title>Databases needing Special Treatment</title>
|
||||
<tgroup cols="3">
|
||||
<thead>
|
||||
<row><entry>Database</entry><entry>Creator ID</entry><entry>Action</entry></row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Launcher (the &PalmPilot;'s main menu)</entry>
|
||||
<entry>lnch</entry>
|
||||
<entry>Backup Only:</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Arranger</entry>
|
||||
<entry>Arng</entry>
|
||||
<entry>Backup Only:</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>(unknown)</entry>
|
||||
<entry>PmDB</entry>
|
||||
<entry>Backup Only:</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>AvantGo</entry>
|
||||
<entry>avgo</entry>
|
||||
<entry>Skip (Mostly because there's no point in backing up the
|
||||
news articles that AvantGo gives you)</entry>
|
||||
</row>
|
||||
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>
|
||||
Is there a conduit for &Netscape; <application>Calendar</application>?
|
||||
</para>
|
||||
</question>
|
||||
<answer>
|
||||
<para>
|
||||
No, there isn't.
|
||||
Neither are there plans to include support or write a
|
||||
conduit for &Netscape; <application>Calendar</application>.
|
||||
</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
|
||||
</qandaset>
|
||||
|
||||
</sect1>
|
||||
|
||||
<sect1 id="faq-hotsync">
|
||||
<title>
|
||||
Special HotSync Questions
|
||||
</title>
|
||||
|
||||
<para>
|
||||
This section lists questions about HotSync methods that differ
|
||||
from the <quote>usual</quote> direct serial link method.
|
||||
</para>
|
||||
|
||||
<qandaset>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>
|
||||
How do I do an infrared (<acronym>IR</acronym>) HotSync?
|
||||
</para>
|
||||
</question>
|
||||
<answer>
|
||||
<para>
|
||||
First of all your &PalmPilot; has to actually support
|
||||
<acronym>IR</acronym> HotSyncs. This can be achieved through various
|
||||
means: &PalmOS; 3.3 and higher include support for it; there is an
|
||||
<acronym>IR</acronym> enhancements package for older &PalmOS; versions;
|
||||
<application>IrLink</application> from IsComplete apparently has the
|
||||
same capabilities. Check out the <ulink
|
||||
url="http://www.palmone.com/us/">PalmOne</ulink> web pages for more information.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Assuming your &PalmPilot; now has <acronym>PC</acronym> HotSync support
|
||||
and it is setup to do <acronym>IR</acronym> HotSyncs (in the HotSync
|
||||
preferences on the &PalmPilot;), we can turn our attention to the
|
||||
<acronym>PC</acronym> you will be synchronization with. It needs an
|
||||
<acronym>IR</acronym> port. For laptops, this is trivial, desktop
|
||||
<acronym>PCs</acronym> may require some extra hardware.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Your &Linux; kernel will need to support <acronym>IR</acronym> and the <acronym>IRCOMM</acronym> protocol.
|
||||
For stock
|
||||
&RedHat;
|
||||
systems, the following command should
|
||||
setup <acronym>IR</acronym> support (as <systemitem class="username">root</systemitem>):
|
||||
<screen width="40">
|
||||
<prompt># </prompt><userinput><command>modprobe</command> <option>ircomm</option></userinput>
|
||||
</screen>
|
||||
|
||||
Other distributions should follow the <filename>IR-HOWTO</filename>.
|
||||
Once <acronym>IR</acronym> support in the kernel has been activated,
|
||||
you need to make devices for the <acronym>IR</acronym> ports.
|
||||
The <filename>IR-HOWTO</filename> suggests (as <systemitem class="username">root</systemitem>):
|
||||
<screen width="40">
|
||||
<prompt># </prompt><userinput><command>mknod</command>
|
||||
<option>/dev/ircomm0</option> <parameter>60</parameter> <parameter>64</parameter> </userinput>
|
||||
<prompt># </prompt><userinput><command>chmod</command>
|
||||
<option>666</option> <parameter>/dev/ircomm0</parameter></userinput>
|
||||
</screen>
|
||||
Next we need to start some daemons for <acronym>IR</acronym> services:
|
||||
<screen width="40">
|
||||
<prompt># </prompt><userinput><command>irattach</command>
|
||||
<option>/dev/ttyS<replaceable>n</replaceable></option></userinput>
|
||||
<prompt># </prompt><userinput><command>irmanager</command>
|
||||
<option>-d</option> <parameter>0</parameter></userinput>
|
||||
</screen>
|
||||
Here <filename class="devicefile">/dev/ttyS<replaceable>n</replaceable></filename>
|
||||
is the serial port
|
||||
the <acronym>IR</acronym> port is using. <replaceable>n</replaceable> could be 0, 1, or some other
|
||||
number depending on your hardware setup.
|
||||
Follow the instructions in the <filename>IR-HOWTO</filename> for assistance
|
||||
(for desktop machines, it's usually a setting in the <acronym>BIOS</acronym>).
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Once you've gotten this far, just make <filename class="devicefile">/dev/pilot</filename>
|
||||
point to <filename class="devicefile">/dev/ircomm0</filename>
|
||||
and you're ready!
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The IR-HOWTO and other useful information on using IR may
|
||||
be found at
|
||||
<ulink url="http://mobilix.org/howtos.html">http://mobilix.org/howtos.html</ulink>
|
||||
and
|
||||
<ulink url="http://mobilix.org/software/irda/">http://mobilix.org/software/irda/</ulink>.
|
||||
</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Can I do a &HotSync; with my (<acronym>USB</acronym>)
|
||||
<!-- TM? -->&Handspring; &Visor;?
|
||||
</para>
|
||||
</question>
|
||||
<answer>
|
||||
<para>
|
||||
Yes, you can.
|
||||
I don't have definitive information, but postings on the
|
||||
&kpilot; mailing-list have stated that you can point <filename class="devicefile">/dev/pilot</filename>
|
||||
to the <acronym>USB</acronym> device and everything will work fine.
|
||||
</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question><para>Is there any support for remote HotSyncs?</para>
|
||||
</question>
|
||||
<answer>
|
||||
<para>
|
||||
No, not yet.
|
||||
Maybe later.
|
||||
</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
</qandaset>
|
||||
|
||||
</sect1>
|
||||
|
||||
|
||||
<sect1>
|
||||
<title>&kpilot;'s &DCOP; interface</title>
|
||||
|
||||
<qandaset>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>What does &kpilot; use &DCOP; for?</para>
|
||||
</question>
|
||||
<answer><para>
|
||||
The daemon and &kpilot; communicate using &DCOP;
|
||||
for several purposes: logging messages, changing the &HotSync;
|
||||
type, and exchanging configuration information.
|
||||
</para></answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry><question>
|
||||
<para>Which &DCOP; interfaces are there?</para></question>
|
||||
|
||||
<answer><para>
|
||||
The daemon has two important interfaces:
|
||||
<interface>LogIface</interface>
|
||||
and
|
||||
<interface>KPilotDaemonIface
|
||||
</interface>.
|
||||
The <interface>LogIface</interface>
|
||||
interface is used to record messages in the sync log
|
||||
on the &handheld;, and is rarely used.
|
||||
The <interface>KPilotDaemonIface</interface>
|
||||
is the more important &DCOP; interface,
|
||||
and is used to control the kind of &HotSync; that
|
||||
&kpilot; will do.
|
||||
</para></answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry><question><para>
|
||||
How can I tell the daemon to perform a specific kind of &HotSync;?</para></question>
|
||||
<answer><para>
|
||||
There are three &DCOP; functions that control what kind
|
||||
of &HotSync;
|
||||
the daemon will do next:
|
||||
<function></function>
|
||||
<function></function>
|
||||
</para></answer>
|
||||
</qandaentry>
|
||||
</qandaset>
|
||||
|
||||
</sect1>
|
||||
|
||||
</chapter>
|
After Width: | Height: | Size: 52 KiB |
@ -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 "tdepim">
|
||||
<!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>tdepim</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
|
||||
tdepim-users mailing list, <email>tdepim-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:
|
||||
-->
|
||||
|
After Width: | Height: | Size: 96 KiB |
After Width: | Height: | Size: 42 KiB |
After Width: | Height: | Size: 19 KiB |
After Width: | Height: | Size: 14 KiB |
After Width: | Height: | Size: 14 KiB |
After Width: | Height: | Size: 14 KiB |
After Width: | Height: | Size: 16 KiB |
After Width: | Height: | Size: 5.3 KiB |
After Width: | Height: | Size: 16 KiB |
After Width: | Height: | Size: 68 KiB |
After Width: | Height: | Size: 17 KiB |
After Width: | Height: | Size: 42 KiB |
@ -0,0 +1,450 @@
|
||||
<chapter id="synchronization">
|
||||
<title>Syncing your &handheld; with a PC</title>
|
||||
|
||||
<para>
|
||||
This chapter describes the synchronization process
|
||||
that &kpilot; uses, focusing on the &kpilot; daemon functionality.
|
||||
You may sync your &handheld; using the <link linkend="builtin">internal
|
||||
viewers</link> and / or <link linkend="conduits">conduits</link>, depending
|
||||
on your personal preferences. Conduits allow external applications to interface
|
||||
with the data on your &handheld;.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
It is a good idea to make a <link linkend="backup">backup</link>
|
||||
of your &handheld; regularly. Other than making backups, it should rarely be
|
||||
necessary to do anything other than drop your &handheld; on the cradle and press
|
||||
the &HotSync; button. The &kpilot; daemon icon in the system tray will flash
|
||||
indicating that a sync is under way.
|
||||
</para>
|
||||
|
||||
|
||||
<screenshot>
|
||||
<screeninfo>&kpilot; Daemon Pop-Up Menu</screeninfo>
|
||||
<mediaobject>
|
||||
<imageobject><imagedata fileref="daemon-menu.png" format="PNG"/></imageobject>
|
||||
<textobject><phrase>&kpilot; daemon popup menu</phrase></textobject>
|
||||
<caption><para>&kpilot; daemon popup menu</para></caption>
|
||||
</mediaobject>
|
||||
</screenshot>
|
||||
|
||||
|
||||
<para>
|
||||
To which type of sync &kpilot; will perform next, you can use the main
|
||||
application
|
||||
<link linkend="menu-file">
|
||||
<menuchoice>
|
||||
<guimenu>File</guimenu>
|
||||
</menuchoice>
|
||||
menu</link>,
|
||||
or right click the &kpilot; daemon icon located in the system tray,
|
||||
and select one of the menu items under the
|
||||
<menuchoice>
|
||||
<guisubmenu>Next Sync</guisubmenu>
|
||||
</menuchoice>
|
||||
sub menu.
|
||||
<tip><para>
|
||||
If you hover over the &kpilot; daemon icon, a tooltip will appear showing you
|
||||
what the type of sync &kpilot; will perform next.
|
||||
</para></tip>
|
||||
|
||||
</para>
|
||||
|
||||
|
||||
|
||||
<para>
|
||||
In short, the sync types are:
|
||||
</para>
|
||||
|
||||
<itemizedlist>
|
||||
|
||||
<listitem><para>
|
||||
<guilabel>HotSync (once)</guilabel>: this option offers
|
||||
a nice balance between speed and data safety.
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>
|
||||
<guilabel>FastSync (once)</guilabel>: only sync those
|
||||
databases that have conduits.
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>
|
||||
<guilabel>FullSync (once)</guilabel>: the safest option, but
|
||||
takes the longest time to complete.
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>
|
||||
<guilabel>Backup (once)</guilabel>: copy all the data from the &handheld; to the
|
||||
<acronym>PC</acronym>.
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>
|
||||
<guilabel>Restore from Backup (once)</guilabel>: copy the data from a previous backup from the PC to the
|
||||
&handheld;, erasing the data previously held there.
|
||||
|
||||
<warning><para>
|
||||
Use the restore functionality with care, as you can lose all the new
|
||||
data entered on the &handheld; since the last backup.
|
||||
</para></warning>
|
||||
</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>
|
||||
<guilabel>Copy Handheld to PC (once)</guilabel>: run all conduits and
|
||||
sync all databases, but instead of merging the information from both sources,
|
||||
just copy the handheld data to the PC.
|
||||
<warning><para>Use with care, as this option erases the changes
|
||||
you made in your PC since the last sync.</para></warning>
|
||||
</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>
|
||||
<guilabel>Copy PC to Handheld (once)</guilabel>: run all conduits and
|
||||
sync all databases, but instead of merging the information from both sources,
|
||||
just copy the PC data to the handheld.
|
||||
<warning><para>Use with care, as this option erases the changes
|
||||
you made in your handheld since the last sync.</para></warning>
|
||||
</para>
|
||||
</listitem>
|
||||
|
||||
</itemizedlist>
|
||||
|
||||
|
||||
<para>
|
||||
Alternatively, you can change the default syncing behavior of &kpilot; by
|
||||
choosing the most suitable option in the <link linkend="page-hotsync">&HotSync;
|
||||
configure dialog</link>.
|
||||
|
||||
<note><para>
|
||||
To configure the conduits or the sync process, you do not need to open the main
|
||||
&kpilot; application, as the
|
||||
<menuchoice>
|
||||
<guimenuitem>Configure KPilot...</guimenuitem>
|
||||
</menuchoice>
|
||||
menu item is available on the &kpilot; daemon popup menu as well.
|
||||
</para></note>
|
||||
|
||||
</para>
|
||||
|
||||
<sect1 id="backup">
|
||||
<title>Backing up your &handheld; data</title>
|
||||
|
||||
<para>
|
||||
On every backup, &kpilot; stores a copy of all your &handheld; data under the
|
||||
<filename class="directory">$TDEHOME/share/apps/kpilot/DBBackup/User Name/</filename>
|
||||
folder, allowing you to restore that copy later, if needed. The
|
||||
<filename class="directory">$TDEHOME</filename> environment variable
|
||||
(typically <filename class="directory">/home/Login Name/.trinity/</filename>)
|
||||
points to the folder that contains your configuration and data for the &kde;
|
||||
applications.</para>
|
||||
|
||||
<para>
|
||||
It is a good idea to backup your data often. To perform a backup, you can click
|
||||
the
|
||||
<menuchoice>
|
||||
<guisubmenu>Next Sync</guisubmenu>
|
||||
<guimenuitem>Backup</guimenuitem>
|
||||
</menuchoice>
|
||||
on the &kpilot; daemon icon popup menu or the
|
||||
<menuchoice>
|
||||
<guimenu>File</guimenu>
|
||||
<guimenuitem>Backup</guimenuitem>
|
||||
</menuchoice>
|
||||
menu item on the main &kpilot; application menu in order
|
||||
to make the next sync a backup. Then, just press the &HotSync; button.
|
||||
</para>
|
||||
|
||||
</sect1>
|
||||
|
||||
<sect1 id="restore">
|
||||
<title>Restoring Your &handheld; Data</title>
|
||||
|
||||
<para>
|
||||
The restore operation consist of transferring all the data previously saved on
|
||||
the <acronym>PC</acronym> to the &handheld;, effectively erasing all the new
|
||||
data held by the device by returning it to a previous state.
|
||||
<warning><para>
|
||||
Use the restore functionality with care, as you can lose all the new
|
||||
data entered on the &handheld; since the last backup.
|
||||
</para></warning>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The data saved on the last backup is located on the <filename class="directory">$TDEHOME/share/apps/kpilot/DBBackup/User Name/</filename>
|
||||
folder. The <filename class="directory">$TDEHOME</filename> environment variable
|
||||
(typically <filename class="directory">/home/Login Name/.trinity/</filename>)
|
||||
points to the folder that contains your configuration and data for the &kde;
|
||||
applications.</para>
|
||||
|
||||
<para>
|
||||
The most common use for the restore functionality is to recover from a hardware
|
||||
or software failure on the device.
|
||||
The restore function can be accessed from the
|
||||
main &kpilot; application, and from the &kpilot; daemon. be careful, as
|
||||
restoring the data is not a common operation. In order
|
||||
to restore the data at the next sync, click the
|
||||
<menuchoice>
|
||||
<guimenu>File</guimenu>
|
||||
<guimenuitem>Restore</guimenuitem>
|
||||
</menuchoice>
|
||||
menu item, then press the &HotSync; button.
|
||||
</para>
|
||||
|
||||
</sect1>
|
||||
|
||||
|
||||
<sect1 id="sync-s">
|
||||
<title>Selecting the Synchronization Type</title>
|
||||
|
||||
<para>
|
||||
There are three ways to sync your &handheld;, <guilabel>HotSync</guilabel>,
|
||||
<guilabel>FastSync</guilabel> or <guilabel>FullSync</guilabel>.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
When you press the &HotSync; button on your &handheld;, &kpilot;'s will run the
|
||||
default sync operation (usually a <guilabel>HotSync</guilabel>). You can select
|
||||
the default sync operation in the <link linkend="page-hotsync">&HotSync;
|
||||
configure dialog</link>. Alternatively, you can click one of the sync options on
|
||||
the main &kpilot; application
|
||||
<menuchoice>
|
||||
<guimenu>File</guimenu>
|
||||
</menuchoice>
|
||||
menu or on the &kpilot; daemon popup
|
||||
<menuchoice>
|
||||
<guisubmenu>Next Sync</guisubmenu>
|
||||
</menuchoice>
|
||||
submenu.
|
||||
|
||||
<important><para>
|
||||
Using the <link linkend="page-hotsync">&HotSync; configure dialog</link>
|
||||
is the only way to change the default sync operation.
|
||||
The main &kpilot; application
|
||||
<menuchoice>
|
||||
<guimenu>File</guimenu>
|
||||
</menuchoice>
|
||||
menu items or the &kpilot; daemon popup
|
||||
<menuchoice>
|
||||
<guisubmenu>Next Sync</guisubmenu>
|
||||
</menuchoice>
|
||||
submenu items change only the type of sync that will be performed <emphasis>next</emphasis>.
|
||||
</para></important>
|
||||
</para>
|
||||
|
||||
<screenshot>
|
||||
<screeninfo>&kpilot; Daemon Pop-Up Menu</screeninfo>
|
||||
<mediaobject>
|
||||
<imageobject><imagedata fileref="daemon-menu.png" format="PNG"/></imageobject>
|
||||
<textobject><phrase>&kpilot; daemon popup menu</phrase></textobject>
|
||||
<caption><para>&kpilot; daemon popup menu</para></caption>
|
||||
</mediaobject>
|
||||
</screenshot>
|
||||
|
||||
|
||||
<para>
|
||||
For more information on the sync types, please refer to the descriptions
|
||||
available in <xref linkend="page-hotsync" />.
|
||||
</para>
|
||||
|
||||
|
||||
</sect1>
|
||||
|
||||
<sect1 id="conduits">
|
||||
<title>Syncing your &handheld; Data Using Conduits</title>
|
||||
|
||||
<para>
|
||||
Conduits are programs that interface your &handheld; data with
|
||||
<acronym>PC</acronym> applications or sync your &handheld; data with files
|
||||
that can be used by <acronym>PC</acronym> applications.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Conduits can be set up by selecting
|
||||
<menuchoice>
|
||||
<guimenu>Settings</guimenu>
|
||||
<guimenuitem>Configure KPilot...</guimenuitem>
|
||||
</menuchoice>, or using the daemon pop up menu and clicking the
|
||||
<guimenuitem>Configure KPilot...</guimenuitem>
|
||||
menu item.
|
||||
</para>
|
||||
|
||||
<screenshot>
|
||||
<screeninfo>&kpilot; Daemon Pop-Up Menu</screeninfo>
|
||||
<mediaobject>
|
||||
<imageobject><imagedata fileref="daemon-menu.png" format="PNG"/></imageobject>
|
||||
<textobject><phrase>&kpilot; daemon popup menu</phrase></textobject>
|
||||
<caption><para>&kpilot; daemon popup menu</para></caption>
|
||||
</mediaobject>
|
||||
</screenshot>
|
||||
|
||||
<para>
|
||||
The <guilabel>Conduits</guilabel> tree in the configuration dialog
|
||||
collects all the installed conduits available.
|
||||
The conduits can be enabled and disabled
|
||||
by clicking on the check box to the left of the conduit's name.
|
||||
Conduits can have an extensive configuration of
|
||||
their own, and may be supplied by third parties.
|
||||
Most of the conduits require some initial configuration, so it is strongly
|
||||
recommended to check the
|
||||
<link linkend="config-conduits">section detailing the default conduits
|
||||
configuration</link> before using them.
|
||||
</para>
|
||||
|
||||
|
||||
<para>
|
||||
The default conduits are the following:
|
||||
</para>
|
||||
|
||||
|
||||
<variablelist>
|
||||
|
||||
<varlistentry>
|
||||
<term><guilabel>KNotes / Memos</guilabel></term>
|
||||
<listitem><para>
|
||||
Synchronizes the Memo Pad application with &knotes;.
|
||||
|
||||
<important><para>
|
||||
The conduit only synchronizes the Memo Pad data if &knotes; is running. If you
|
||||
want to enable this functionality, please remember to start &knotes; first, or
|
||||
check if it is already running (tip: look for the &knotes; icon in the system tray).
|
||||
</para></important>
|
||||
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
||||
<varlistentry>
|
||||
<term><guilabel>Notepad</guilabel></term>
|
||||
<listitem>
|
||||
<para>
|
||||
Exports the free hand notes of the &handheld;'s Notepad application as pictures
|
||||
to the PC.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
||||
<varlistentry>
|
||||
<term><guilabel>Time Synchronization</guilabel></term>
|
||||
<listitem><para>
|
||||
Sets the &handheld;'s time to that of the desktop machine.
|
||||
Useful for keeping the clock of the &handheld; accurate.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><guilabel>Calendar (KOrganizer)</guilabel></term>
|
||||
<listitem><para>
|
||||
Synchronizes the Datebook application with &korganizer; or with a iCalendar file of
|
||||
your choice.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><guilabel>Palm DOC</guilabel></term>
|
||||
<listitem><para>
|
||||
Automatically converts, installs and sync text files in the &PalmPilot;
|
||||
DOC format, so you can read the text files with most DOC-capable
|
||||
applications on the &handheld;. There are many free or open source Palm
|
||||
DOC readers, and some Palm DOC editors for your handheld.</para>
|
||||
<para>
|
||||
Any plain text file can be easily converted. For instance, you can download and
|
||||
convert the public domain books provided by the <ulink url="http://www.gutenberg.net">
|
||||
Gutenberg Project</ulink> and read them in your &handheld;.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><guilabel>Addressbook</guilabel></term>
|
||||
<listitem><para>
|
||||
Synchronizes the Address application with &kaddressbook; or with a vCard file of
|
||||
your choice.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><guilabel>System Information</guilabel></term>
|
||||
<listitem><para>
|
||||
Writes information about your &handheld;, (such as OS version,
|
||||
RAM available, and the list of databases) to a file. Useful mostly for
|
||||
debugging purposes.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><guilabel>ToDo's (KOrganizer)</guilabel></term>
|
||||
<listitem><para>
|
||||
Synchronizes the Todo list application with &korganizer; or with a iCalendar file of
|
||||
your choice.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><guilabel>MAL (AvantGo) Conduit</guilabel></term>
|
||||
<listitem><para>
|
||||
Synchronizes your &handheld; with the &AvantGo; server. The &AvantGo; server
|
||||
offers general content (news, guides, stock quotes, &etc;) in a format that is
|
||||
suitable for reading in a &handheld;. To use this conduit, you need to register, subscribe
|
||||
the channels you select and install the &AvantGo; software on your &handheld;.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
||||
<varlistentry>
|
||||
<term><guilabel>Mail</guilabel></term>
|
||||
<listitem><para>
|
||||
Sends mail written on the &handheld; through &kmail;.
|
||||
There is no provision for receiving mail, however.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><guilabel>Perl</guilabel></term>
|
||||
<term><guilabel>Python</guilabel></term>
|
||||
<term><guilabel>NULL</guilabel></term>
|
||||
<listitem><para>
|
||||
These conduits are intended as a programming demonstration,
|
||||
and serve no practical purpose during a &HotSync;.
|
||||
They are not normally listed, but you may see them on some systems.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
</variablelist>
|
||||
|
||||
<screenshot>
|
||||
<screeninfo>The Conduit Setup Dialog</screeninfo>
|
||||
<mediaobject>
|
||||
<imageobject><imagedata fileref="setup-conduit.png" format="PNG"/></imageobject>
|
||||
<textobject><phrase>The Conduit Setup Dialog</phrase></textobject>
|
||||
<caption><para>The Conduit Setup Dialog</para></caption>
|
||||
</mediaobject>
|
||||
</screenshot>
|
||||
|
||||
|
||||
</sect1>
|
||||
|
||||
<sect1 id="conflicts">
|
||||
<title>Resolving Conflicts</title>
|
||||
|
||||
<para>
|
||||
Data records can be changed both on the &handheld; and
|
||||
on the <acronym>PC</acronym>. If one record has incompatible changes
|
||||
in both the &handheld; and the <acronym>PC</acronym>, (such as
|
||||
changing a phone number in different ways on both sides),
|
||||
the conflicting change needs to be resolved so
|
||||
that both the &handheld; and the <acronym>PC</acronym> are in sync again.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
A popup dialog may appear, asking you how to resolve the
|
||||
conflict, or you may have a general rule to automatically handle these
|
||||
conflicts (depending on your <link linkend="page-hotsync">conflict resolution
|
||||
choice</link>). Note that you can define different resolution choices
|
||||
for different conduits in the <link linkend="config-conduits">conduits
|
||||
configuration dialog</link>.
|
||||
</para>
|
||||
|
||||
</sect1>
|
||||
</chapter>
|
After Width: | Height: | Size: 42 KiB |
After Width: | Height: | Size: 1.0 KiB |
After Width: | Height: | Size: 984 B |
@ -0,0 +1,648 @@
|
||||
<chapter id="using-kpilot">
|
||||
<title>Using &kpilot; Data Viewers and Main Window Interface</title>
|
||||
|
||||
<para>
|
||||
This chapter describes the usage of &kpilot;'s main window; as a viewer
|
||||
application for data on the &handheld;, and its menu structure.
|
||||
The main window of &kpilot; also contains
|
||||
the &HotSync;-log, which can be useful when
|
||||
debugging problems.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
&kpilot; starts up with a splash screen, and then switches to showing the
|
||||
&HotSync;-log, as shown <link linkend="main-app">here</link>.
|
||||
</para>
|
||||
|
||||
<sect1 id="main">
|
||||
<title>The Main Window</title>
|
||||
|
||||
<screenshot id="main-app">
|
||||
<screeninfo>&kpilot; Main Window</screeninfo>
|
||||
<mediaobject>
|
||||
<imageobject><imagedata fileref="main-app.png" format="PNG"/></imageobject>
|
||||
<textobject><phrase>The Main Window</phrase></textobject>
|
||||
<caption><para>The Main Window</para></caption>
|
||||
</mediaobject>
|
||||
</screenshot>
|
||||
|
||||
<para>
|
||||
The main window contains the application menu, which we will deal with here.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The <guimenu>file</guimenu> menu contains the synchronization menu items. Note
|
||||
that these items do not start the sync process, they only select what the new
|
||||
sync will be. To really start it, you must press the HotSync button on your
|
||||
&PalmPilot;'s cradle (or on the &handheld; itself, when there is no cradle).
|
||||
</para>
|
||||
<note>
|
||||
<para>
|
||||
It is not possible to cancel a sync operation once the request has been made.
|
||||
</para>
|
||||
</note>
|
||||
<para>
|
||||
For more information regarding the synchronization functionality, please check the
|
||||
<link linkend="synchronization">Synchronization Chapter</link> of this handbook,
|
||||
where you can find detailed descriptions of the synchronization methods
|
||||
and options offered by &kpilot;.
|
||||
</para>
|
||||
|
||||
<variablelist id="menu-file">
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
<menuchoice>
|
||||
<guimenu>File</guimenu>
|
||||
<guimenuitem>HotSync</guimenuitem>
|
||||
</menuchoice>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Make the next sync a &HotSync;. For more information, please check the
|
||||
<link linkend="sync-s"> Syncing your &handheld; data</link> section of this
|
||||
handbook.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
<menuchoice>
|
||||
<guimenu>File</guimenu>
|
||||
<guimenuitem>FastSync</guimenuitem>
|
||||
</menuchoice>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
(not available with all installations)
|
||||
Make the next sync a FastSync. For more information, please check the
|
||||
<link linkend="sync-s">Syncing your &handheld; data</link> section of this
|
||||
handbook.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
<menuchoice>
|
||||
<guimenu>File</guimenu>
|
||||
<guimenuitem>FullSync</guimenuitem>
|
||||
</menuchoice>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
(not available with all installations)
|
||||
Make the next sync a FullSync. For more information, please check the
|
||||
<link linkend="sync-s"> Syncing your &handheld; data</link> section of this
|
||||
handbook.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
<menuchoice>
|
||||
<guimenu>File</guimenu>
|
||||
<guimenuitem>Backup</guimenuitem>
|
||||
</menuchoice>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Make the next sync a full backup of your &PalmPilot; data. This action can take
|
||||
several minutes. For more information, please check the
|
||||
<link linkend="backup"> Backing up your &handheld; data</link> section of this
|
||||
handbook.
|
||||
</para>
|
||||
<tip>
|
||||
<para>
|
||||
The first thing you should do after starting &kpilot; for
|
||||
the first time is make a full backup.
|
||||
</para>
|
||||
</tip>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
<menuchoice>
|
||||
<guimenu>File</guimenu>
|
||||
<guimenuitem>Restore</guimenuitem>
|
||||
</menuchoice>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
This copies all the data from a previous backup on your
|
||||
<acronym>PC</acronym> to your &PalmPilot;,
|
||||
replacing whatever data was there.
|
||||
Use this if your &PalmPilot; suffers some from software or hardware failure
|
||||
(or is replaced by a new one). For more information, please check the
|
||||
<link linkend="restore"> Restoring your &handheld; data</link> section of this
|
||||
handbook.
|
||||
</para>
|
||||
<warning>
|
||||
<para>
|
||||
Doing a restore will erase all data on the &PalmPilot;
|
||||
before restoring the information from your
|
||||
<acronym>PC</acronym>!</para>
|
||||
</warning>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
<menuchoice>
|
||||
<guimenu>File</guimenu>
|
||||
<guimenuitem>Copy Handheld to PC</guimenuitem>
|
||||
</menuchoice>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
This runs all conduits and syncs all databases, but instead of merging the
|
||||
information from both sources, it will copy the handheld data to the PC.
|
||||
<emphasis>Use with care, as this option erases the changes
|
||||
you made in your PC since the last sync</emphasis>.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
<menuchoice>
|
||||
<guimenu>File</guimenu>
|
||||
<guimenuitem>Copy PC to Handheld</guimenuitem>
|
||||
</menuchoice>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
This runs all conduits and syncs all databases, but instead of merging the
|
||||
information from both sources, it will copy the PC data to the handheld.
|
||||
<emphasis>Use with care, as this option erases the changes
|
||||
you made in your handheld since the last sync</emphasis>.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
||||
<!--
|
||||
<varlistentry>
|
||||
<term>
|
||||
<menuchoice>
|
||||
<guimenu>File</guimenu>
|
||||
<guimenuitem>List Only</guimenuitem>
|
||||
</menuchoice>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
The next sync will only list the databases on your &handheld;, no exchange of
|
||||
data will be performed.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
-->
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
<menuchoice>
|
||||
<guimenu>File</guimenu>
|
||||
<guimenuitem>Quit</guimenuitem>
|
||||
</menuchoice>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Quits &kpilot;, closing the main window and stopping the
|
||||
daemon if that
|
||||
<link linkend="stopdaemononexit">configuration option</link>
|
||||
is enabled.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
|
||||
<para>
|
||||
The <guimenu>Settings</guimenu> menu allows you to configure &kpilot; main
|
||||
interface and fine-tune the synchronization process with the &handheld;.
|
||||
</para>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<menuchoice>
|
||||
<guimenu>Settings</guimenu>
|
||||
<guimenuitem>Show Statusbar</guimenuitem>
|
||||
</menuchoice>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Click this menu item to toggle &kpilot;'s status bar on and off, or in other
|
||||
words, to show it if hidden, or to hide it if shown.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
<menuchoice>
|
||||
<guimenu>Settings</guimenu>
|
||||
<guimenuitem>Show Toolbar</guimenuitem>
|
||||
</menuchoice>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Click this menu item to toggle &kpilot;'s toolbar on and off, or in other
|
||||
words, to show it if hidden, or to hide it if shown.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
<menuchoice>
|
||||
<guimenu>Settings</guimenu>
|
||||
<guimenuitem>Configure Shortcuts...</guimenuitem>
|
||||
</menuchoice>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Displays &kpilot;'s shortcut configuration dialog, allowing you change or create
|
||||
key bindings, which are associations between actions (for example, opening
|
||||
&kpilot;'s configuration dialog) and keys or key combinations (for instance,
|
||||
Ctrl + Shift + a).
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
<menuchoice>
|
||||
<guimenu>Settings</guimenu>
|
||||
<guimenuitem>Configure Toolbars...</guimenuitem>
|
||||
</menuchoice>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Displays &kpilot;'s toolbar configuration dialog. This dialog lists all actions
|
||||
available for use on the toolbar, and the actions currently displayed, allowing
|
||||
you to add or remove actions, and move the actions which already are on the
|
||||
toolbar.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
<menuchoice>
|
||||
<guimenu>Settings</guimenu>
|
||||
<guimenuitem>Configure KPilot...</guimenuitem>
|
||||
</menuchoice>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Displays &kpilot;'s configuration dialog, allowing you to match your hardware
|
||||
with the configuration, so that &kpilot; can talk with your &handheld;, to
|
||||
configure the way &kpilot; synchronizes your &PalmPilot; with your
|
||||
desktop applications (through conduits) and the way it shows the data from your &PalmPilot; in the
|
||||
<link linkend="builtin">built-in viewers</link>. The <link linkend="configure">
|
||||
Configuring &kpilot;</link> chapter of this handbook offers detailed information
|
||||
about these configuration options.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
<menuchoice>
|
||||
<guimenu>Settings</guimenu>
|
||||
<guimenuitem>Configuration Wizard...</guimenuitem>
|
||||
</menuchoice>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Displays &kpilot;'s configuration wizard dialog. The
|
||||
<link linkend="configwizard">configuration wizard</link> helps you to set up
|
||||
&kpilot; to communicate with the &PalmPilot; and to configure the conduits as
|
||||
a group. It's a great start for new users, and you can always fine-tune your
|
||||
preferences later, using the <link linkend="configure">configure
|
||||
dialog</link>.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
||||
</variablelist>
|
||||
|
||||
|
||||
</sect1>
|
||||
|
||||
<sect1 id="builtin">
|
||||
<title>
|
||||
Built-in Applications
|
||||
</title>
|
||||
|
||||
<para>
|
||||
To select one of the Built in applications, just click its icon on &kpilot;'s
|
||||
sidebar.
|
||||
</para>
|
||||
|
||||
<screenshot>
|
||||
<screeninfo>KPilot's Sidebar</screeninfo>
|
||||
<mediaobject>
|
||||
<imageobject><imagedata fileref="sidebar.png" format="PNG"/></imageobject>
|
||||
<textobject><phrase>KPilot's Sidebar</phrase></textobject>
|
||||
<caption><para>KPilot's Sidebar</para></caption>
|
||||
</mediaobject>
|
||||
</screenshot>
|
||||
|
||||
|
||||
<para>
|
||||
Selecting one of the built-in applications
|
||||
will cause that application to appear in &kpilot;'s main
|
||||
window.
|
||||
You may use the viewer applications to edit the information, by enabling
|
||||
this option in the <link linkend="page-viewers">database viewer's
|
||||
configuration dialog</link>. The ability to view and edit private records is
|
||||
configurable too.</para>
|
||||
|
||||
<para>
|
||||
Any changes you make to the &PalmPilot; databases with
|
||||
the built-in applications (such as deleting a memo)
|
||||
do not take effect on the &PalmPilot; until the next HotSync.
|
||||
</para>
|
||||
|
||||
<important><para>
|
||||
If the <guilabel>Make internal viewers editable</guilabel> option is
|
||||
not enabled, the changes in the viewers are not synchronized with your
|
||||
&handheld;, and will be lost. In recent versions of &kpilot; it is not possible
|
||||
enable this option, and therefore, to edit the databases with the viewers.
|
||||
</para></important>
|
||||
|
||||
<sect2 id="todo-app">
|
||||
|
||||
<title>The Todo Viewer</title>
|
||||
|
||||
<para>
|
||||
The todo application allows you to view the tasks from your &PalmPilot;,
|
||||
add new tasks and edit or delete existing ones. The changes you made
|
||||
are applied to the &handheld; the next time you &HotSync;.
|
||||
</para>
|
||||
|
||||
<screenshot>
|
||||
<screeninfo>Todo Viewer Application</screeninfo>
|
||||
<mediaobject>
|
||||
<imageobject><imagedata fileref="todo-app.png" format="PNG"/></imageobject>
|
||||
<textobject><phrase>The Todo Viewer Application</phrase></textobject>
|
||||
<caption><para>The Todo Viewer Application</para></caption>
|
||||
</mediaobject>
|
||||
</screenshot>
|
||||
|
||||
<para>
|
||||
The todo application has a drop down box
|
||||
for the memo categories defined in the &PalmPilot;.
|
||||
In the screenshot, category <quote>All</quote> is selected.
|
||||
Underneath the drop down box is a list of todo entries, with a check box
|
||||
indicating if they are completed or not. You can click the check box to toggle
|
||||
the todo item between completed and not completed status. Clicking on one of the
|
||||
todo items in the list will display its details in the text box labelled
|
||||
<guilabel>Todo info:</guilabel> to the right.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
If you have the <guilabel>Make internal viewers editable</guilabel> option
|
||||
enabled in the <link linkend="page-viewers">viewers configuration page</link> you
|
||||
can use the buttons <guibutton>Edit Record...</guibutton>,
|
||||
<guibutton>New Record...</guibutton> and <guibutton>Delete Record</guibutton>
|
||||
to edit the todo data from your &handheld;, and sync the data in the next
|
||||
&HotSync;.</para>
|
||||
|
||||
<!--
|
||||
<note><para>
|
||||
If you create new todo and decide that
|
||||
you do not want to have it on the &PalmPilot;
|
||||
you must perform a &HotSync; (copying the todo
|
||||
to the &PalmPilot;) and then delete the todo record
|
||||
from the &PalmPilot; or the viewer, and &HotSync; again. It is not possible to
|
||||
delete newly-added records from the built-in applications.
|
||||
</para></note>
|
||||
-->
|
||||
|
||||
<para>
|
||||
The <guibutton>Edit Record...</guibutton> button opens a dialog where you can
|
||||
edit the details of the currently selected todo item, including description,
|
||||
priority and end date. Click the <guibutton>New Record...</guibutton> button to
|
||||
open the same dialog, but instead of editing the current selected record, a new
|
||||
todo will be added to the list. And finally, click the
|
||||
<guibutton>Delete Record</guibutton> button to remove the selected todo record
|
||||
from the list.
|
||||
</para>
|
||||
|
||||
</sect2>
|
||||
|
||||
<sect2 id="address-app">
|
||||
<title>The Address Viewer</title>
|
||||
<para>
|
||||
The address viewer lets you view, create, delete and edit addresses
|
||||
from the &PalmPilot;, and synchronize changes back. The addresses can be
|
||||
sorted and viewed in the <guilabel>"Last, first"</guilabel> or <guilabel>"Company,
|
||||
last"</guilabel> format, depending on your
|
||||
<link linkend="page-viewers">viewers configuration.</link>
|
||||
</para>
|
||||
|
||||
<screenshot>
|
||||
<screeninfo>The Address Viewer Application</screeninfo>
|
||||
<mediaobject>
|
||||
<imageobject><imagedata fileref="address-app.png" format="PNG"/></imageobject>
|
||||
<textobject><phrase>The Address Viewer Application</phrase></textobject>
|
||||
<caption><para>The Address Viewer Application</para></caption>
|
||||
</mediaobject>
|
||||
</screenshot>
|
||||
|
||||
|
||||
<para>
|
||||
The address application resembles the todo application;
|
||||
the drop down box, buttons, list and text area function exactly
|
||||
the same, allowing you to select, view and edit an address
|
||||
as on the &PalmPilot;.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The <guibutton>Edit Record...</guibutton> dialog allows you to edit the
|
||||
<guilabel>Last Name</guilabel>, <guilabel>First Name</guilabel>,
|
||||
<guilabel>Company</guilabel>, &etc; fields, just as if you where using your
|
||||
&handheld;. Click the <guibutton>New Record...</guibutton> button to
|
||||
open the same dialog, but instead of editing the current selected record, a new
|
||||
address will be added to the list. Click the
|
||||
<guibutton>Delete Record</guibutton> button to remove the selected address
|
||||
from the list.
|
||||
|
||||
<!--
|
||||
<note><para>
|
||||
If you create new address and decide that
|
||||
you do not want to have it on the &PalmPilot;
|
||||
you must perform a &HotSync; (copying the address
|
||||
to the &PalmPilot;) and then delete the address record
|
||||
from the &PalmPilot; or the viewer, and &HotSync; again. It is not possible to
|
||||
delete newly-added records from the built-in applications.
|
||||
</para></note>
|
||||
-->
|
||||
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
|
||||
<sect2 id="memo-app">
|
||||
|
||||
<title>The Memo Viewer</title>
|
||||
|
||||
<para>
|
||||
The memo application allows you to view the memos on your &PalmPilot;,
|
||||
export them to text files, import new ones to be installed the next
|
||||
time you &HotSync;, or edit existing ones.
|
||||
</para>
|
||||
|
||||
<screenshot>
|
||||
<screeninfo>Memo Viewer Application</screeninfo>
|
||||
<mediaobject>
|
||||
<imageobject><imagedata fileref="memo-app.png" format="PNG"/></imageobject>
|
||||
<textobject><phrase>The Memo Viewer Application</phrase></textobject>
|
||||
<caption><para>The Memo Viewer Application</para></caption>
|
||||
</mediaobject>
|
||||
</screenshot>
|
||||
|
||||
<para>
|
||||
The memo application has a drop down box
|
||||
for the memo categories defined in the &PalmPilot;.
|
||||
Here category <quote>All</quote> is selected.
|
||||
Underneath the drop down box is a list of memo titles.
|
||||
These are the first lines of the memos, just like
|
||||
in the &PalmPilot; memo application.
|
||||
Clicking on one of the memo titles in the list
|
||||
box will display it in the text box labelled
|
||||
<guilabel>Memo Text:</guilabel> to the right.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
When a memo is selected, you can use the buttons
|
||||
<guibutton>Export Memo...</guibutton> and
|
||||
<guibutton>Delete Memo</guibutton>
|
||||
to export the selected memo to a file
|
||||
or to delete the selected memo.
|
||||
Exporting a memo requires
|
||||
you to give a filename; the memo
|
||||
is written to that file.
|
||||
Take care not to overwrite existing files with this action.
|
||||
Deleting a memo does not affect the &PalmPilot;
|
||||
until the next &HotSync;.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The
|
||||
<guibutton>Import Memo...</guibutton>
|
||||
button allows you to read a text file and
|
||||
add it — as a memo — to the &PalmPilot;.
|
||||
Importing a memo does not take effect until
|
||||
the next &HotSync;.
|
||||
|
||||
<!--
|
||||
<note><para>
|
||||
If you import a memo and decide that
|
||||
you do not want to have it on the &PalmPilot;
|
||||
you must perform a &HotSync; (copying the memo
|
||||
to the &PalmPilot;) and then delete the memo record
|
||||
from the &PalmPilot; or the viewer, and &HotSync; again. It is not possible to
|
||||
delete newly-added records from the built-in applications.
|
||||
</para></note>
|
||||
-->
|
||||
|
||||
</para>
|
||||
|
||||
|
||||
</sect2>
|
||||
|
||||
<sect2 id="db-app">
|
||||
<title>The Generic DB Viewer</title>
|
||||
|
||||
<para>
|
||||
In short, databases are all files stored in your &handheld;. A database
|
||||
can be either a record database, which stores dynamic information created by the
|
||||
user (for instance, the addresses or the todo information), or a resource
|
||||
database, which tend to be static (for instance the applications).
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The Generic DB Viewer is a tool to view and analyze databases stored on
|
||||
your handheld, especially record databases. It helps a lot creating new conduits
|
||||
and to debug existing ones.
|
||||
|
||||
<warning><para>
|
||||
While it is possible use the database viewer to edit, add and delete records, you
|
||||
should really know what you are doing, otherwise you may damage your data. Use
|
||||
the viewer applications or conduits to edit your &handheld; data instead, in a
|
||||
normal usage scenario.
|
||||
</para></warning>
|
||||
|
||||
</para>
|
||||
|
||||
|
||||
|
||||
<screenshot>
|
||||
<screeninfo>The Generic DB Viewer</screeninfo>
|
||||
<mediaobject>
|
||||
<imageobject><imagedata fileref="db-app.png" format="PNG"/></imageobject>
|
||||
<textobject><phrase>The Generic DB Viewer</phrase></textobject>
|
||||
<caption><para>The Generic DB Viewer</para></caption>
|
||||
</mediaobject>
|
||||
</screenshot>
|
||||
|
||||
</sect2>
|
||||
|
||||
|
||||
<sect2 id="installer-app">
|
||||
<title>The File Installer</title>
|
||||
<para>
|
||||
Just hit the
|
||||
<guibutton>Add File...</guibutton> button to add a file to the
|
||||
<guilabel>Files to Install:</guilabel> list. These files will
|
||||
be installed on your &PalmPilot; during the next &HotSync; if
|
||||
<guilabel>Sync Files</guilabel>
|
||||
is checked in the conduits section of the
|
||||
<link linkend="configure">configuration dialog</link>.
|
||||
If you choose not to
|
||||
install these files on the &PalmPilot;, just hit
|
||||
<guibutton>Clear List</guibutton>
|
||||
to remove any pending files.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
If you are using the &HotSync; Daemon you may drag and
|
||||
drop files or &URL;s
|
||||
onto the docked icon on the toolbar. The file installer application also
|
||||
supports dragging and dropping into the <guilabel>Files to Install:</guilabel>area.
|
||||
Provided <guilabel>Sync Files</guilabel> is checked in the
|
||||
<link linkend="page-general">settings dialog</link> they
|
||||
will be installed the next time you HotSync.
|
||||
</para>
|
||||
|
||||
<tip>
|
||||
<para>An internal copy of the
|
||||
file is kept, so you can even drag and drop &URL;s from
|
||||
&konqueror;!
|
||||
</para>
|
||||
</tip>
|
||||
|
||||
<screenshot>
|
||||
<screeninfo>The File Installer</screeninfo>
|
||||
<mediaobject>
|
||||
<imageobject><imagedata fileref="file-app.png" format="PNG"/></imageobject>
|
||||
<textobject><phrase>The File Installer</phrase></textobject>
|
||||
<caption><para>The File Installer</para></caption>
|
||||
</mediaobject>
|
||||
</screenshot>
|
||||
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
</chapter>
|
||||
|
After Width: | Height: | Size: 33 KiB |
After Width: | Height: | Size: 30 KiB |
After Width: | Height: | Size: 27 KiB |