summaryrefslogtreecommitdiffabout
Side-by-side diff
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--bin/kdepim/Zaurus-KDE_syncHowTo.txt45
1 files changed, 44 insertions, 1 deletions
diff --git a/bin/kdepim/Zaurus-KDE_syncHowTo.txt b/bin/kdepim/Zaurus-KDE_syncHowTo.txt
index 90c6237..5aad5da 100644
--- a/bin/kdepim/Zaurus-KDE_syncHowTo.txt
+++ b/bin/kdepim/Zaurus-KDE_syncHowTo.txt
@@ -23,16 +23,58 @@ NOTE: Almost the same procedure will make it possible to
sync KA/Pi+KO/Pi running on Windows with KDE via network.
The setup+sync procedure is:
+0) How the syncing works
1) Installing KA/Pi+KO/Pi on the Z
2) Installing desktop version of KA/Pi+KO/Pi on the desktop
3) Connection your Z to the desktop via network
(network connection can be set up via USB cable or (W)Lan
4) Configuring KA/Pi+KO/Pi on Z for Sync
5) Enable remote sync in KA/Pi+KO/Pi on the desktop
6) Sync
+*****************************************************
+0) How the syncing works
+*****************************************************
+
+After setting up everything, the following actions will
+be performed when syncing:
+User enables "remote pi-sync" on desktop.
+User chooses "sync with configured desktop profile" on the Z.
+Z sends sync request via network to configured IP/port/password.
+KO/Pi on desktop detects sync request and syncs with KDE (configurable!).
+A window pops up, that KO/Pi on desktop is in "remote syncing mode".
+If a conflict occurs when syncing KO/PI<->KDE on the desktop,
+automatically the newest entry is choosen.
+(To avoid the need of user interaction)
+KO/Pi on desktop sends synced file to Zaurus.
+KO/Pi on desktop is in "waiting mode" to get synced file back.
+Zaurus is syncing it's own calendar with the received file.
+Here can be some user interaction needed, i.e.
+if the sync profile is configured as
+"ask for every entry on conflict" and a conflict occurs.
+Zaurus sends back synced file to desktop.
+Syncing on Zaurus is complete now.
+KO/Pi on desktop gets back synced file.
+KO/Pi on desktop removes all entries in its own calendar and
+reloads the synced file.
+KO/Pi on desktop syncs with KDE.
+After syncing with KDE is finished, KO/Pi closes
+the "remote syncing mode" window and displays
+a "syncing complete" message in the headline.
+
+The actual syncing KO/Pi on desktop <-> KDE is
+performed by a small command line tool "kdecaldump",
+which writes/reads the complete KDE calendar resources to
+a file/from a file.
+KO/Pi tags changed entries such that an unchanged entry
+is not changed in KDE by kdecaldump. That is important for
+calendar entries in KDE, stored in a "disconnected IMAP" calendar resource.
+
+
+Same way is KA/Pi working.
+
*****************************************************
1) Installing KA/Pi+KO/Pi on the Z
*****************************************************
@@ -222,8 +264,9 @@ After configuring everything as above, you have to do
the following, if you want to sync your Zaurus with KDE:
(It syncs will all resources in KDE, that are not "readonly").
Start KO/Pi on the desktop.
+If Kontact or KOrganizer is running, save the calendar!
Connect the Z with the USB cable to your desktop.
(Or to the local network).
Choose on the Z the menu:
Syncronize - <your name for the desktop sync profile>
@@ -242,9 +285,9 @@ the message "xx items changed on local", where
xx is greater or equal to the number of todos.
That behaviour is caused by a bug in KDE.
(In KDE, everytime a subtodo is loaded,
it's "last modified" settings are set to the current time - ouch!)
-I hope that bug will be fixed soon.
+I hope I can fix this bug in KDE soon.