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
@@ -1,82 +1,124 @@
 
 Sync HowTo Zaurus <-> KDE
 
 NOTE:
 CURRENTLY ONLY SYNCING OF CALENDAR DATA IS SUPPORTED!
 
 This is a
 Sync HowTo Zaurus <-> K-Desktop Environment(KDE)
 using the KDE-Pim/Pi applications 
 KAddressbook/Pi (KA/Pi) and KOrganizer/Pi (KO/Pi)
 on the Zaurus (Z).
 
 You can now easily sync your Z with the 
 PIM data of the KDE.
 (addressbook and calendar data).
 You need to install the desktop versions 
 of KA/Pi+KO/Pi on the desktop.
 You need KDE version 3.3.0 or higher on your desktop.
 You need KA/Pi+KO/Pi version 1.9.11 or higher on the desktop
 and on the Z.
 
 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
 *****************************************************
 
 Download latest version of KA/Pi+KO/Pi from
 http://sourceforge.net/projects/kdepimpi/
 Project KDE/Pim.
 Direct link is:
 http://sourceforge.net/project/showfiles.php?group_id=104103&package_id=112604
 Click on the version number to read the release notes/change log.
 Choose there the right precompiled package for your Z:
 For Sharp ROM
 -File: kdepim_1.x.xx_for_SharpROM.ipk.zip
 For Open Zaurus ROM:
 -File: kdepim_1.x.xx_for_OZ-gcc3xx.ipk.zip
 If unsure, choose:
 -File: kdepim_1.x.xx_for_SharpROM.ipk.zip
 
 Unzip the file and install the packages as usual on your Z.
 In order to intstall KA/Pi+KO/Pi on your Z,
 you need to install the following files:
 kmicrokdelibs_1.x.xx_arm.ipk  
 kaddressbook_1.x.xx_arm.ipk
 korganizer_1.x.xx_arm.ipk
 
 *****************************************************
 2) Installing desktop version of KA/Pi+KO/Pi on the desktop
 *****************************************************
 
 Precompiled packages are available for SuSE 9.1.
 Choose on the above download location:
 File: KDE-Pim-Pi-1.9.10-SuSE9.1.i586.rpm
 Download file and install it on console with
 su
 rpm -ihv KDE-Pim-Pi-1.9.10-SuSE9.1.i586.rpm
 
 NOTE for users of SuSE 9.1:
 You need KDE version 3.3.0 or higher on your desktop.
 Plese make an online update in SuSE (YAST), then update
 your KDE to version 3.3.0 or higher.
 You can find links to updated precompiled versions of KDE 
 for SuSE 9.1 on the SusE web site, 
 a direct link is for example:
 ftp://ftp.gwdg.de/pub/linux/suse/ftp.suse.com/suse/i386/supplementary/KDE/update_for_9.1
 HOWTO UPDATE KDE:
 Download there the packages in "base".
 And the needed package for your language in "internationalization".
@@ -178,74 +220,75 @@ You do not have to change the
 Click "OK" button to save your settings.
 
 Now you have configured KA/Pi+KO/Pi sync on the Z,
 no need to configure anything in KA/Pi.
 
 
 *****************************************************
 5) Enable remote sync in KA/Pi+KO/Pi on the desktop
 *****************************************************
 
 Start KO/Pi on the desktop.
 Do a "test" sync with KDE, choose menu:
 Synchronize - KDE_Desktop
 After syncing, you should have the same data in KDE
 and in KO/Pi.
 NOTE:
 The KO/Pi version 1.9.10 had the bug, that on the first
 sync with KDE, all data in KDE was deleted.
 DO NOT USE VERSION 1.9.10!
 
 The bevaviour on the first sync is
 (in versions >= 1.9.11)
 that no data is deleted, the data in KO/Pi and in 
 KDE is merged into one calendar.
 
 When the first sync was ok, please choose menu:
 Synchronize - Enable Pi-sync
 Fill in the values for port ("9197" in our examle) 
 and for the password ( "xyz" in our example)
 that you did configure on the Z for that computer.
 Enable "Automatically start at application start"
 and "Automatically sync with KDE-Desktop when receiving sync request"
 by checking the two boxes.
 Close KO/Pi.
 
 Configure / test KA/Pi on the desktop in the same way.
 Fill in the right value for the port (9198 in our examle)
 in KA/Pi! 
 
 *****************************************************
 6) Sync
 *****************************************************
 
 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>
 ( that was "BUG" in our example ).
 That's all.
 
 Do the same with KA/Pi.
 
 NOTE:
 If an appointment/addressee is created on the Z, it is added to the
 standard resource in KDE.
 
 If you have todos with subtodos in your calendar, you will get on
 every sync (after you restartet KOrganizer or Kontact in KDE)
 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.