summaryrefslogtreecommitdiffabout
Unidiff
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--bin/kdepim/MultiSyncHowTo.txt27
-rw-r--r--bin/kdepim/SyncHowto.txt102
-rw-r--r--bin/kdepim/korganizer/featuresKOPI.txt3
3 files changed, 37 insertions, 95 deletions
diff --git a/bin/kdepim/MultiSyncHowTo.txt b/bin/kdepim/MultiSyncHowTo.txt
index 3591eb9..05bd801 100644
--- a/bin/kdepim/MultiSyncHowTo.txt
+++ b/bin/kdepim/MultiSyncHowTo.txt
@@ -1,203 +1,190 @@
1Multi Sync HowTo 1Multi Sync HowTo
2 2
3With KDE-Pim/Pi you can sync several devices 3With KDE-Pim/Pi you can sync several devices "in one go". That means you choose on one device (where everything is confgured in the right way) "Multiple Sync" and all devices will be synced. All devices must be reachable via network.
4"in one go". That means you choose on one device
5(where everything is confgured in the right way)
6"Multiple Sync" and all devices will be synced.
7All devices must be reachable via network.
8 4
9In this HowTo we will give an explicit example what to set up 5In this HowTo we will give an explicit example what to set up and how configure.
10and how configure.
11 6
12We assume, that we have four devices which should be synced: 7We assume, that we have four devices which should be synced:
13A Sharp Zaurus PDA with KDE-Pim/Pi installed.. 8A Sharp Zaurus PDA with KDE-Pim/Pi installed..
14A Windows laptop with KDE-Pim/Pi installed. 9A Windows laptop with KDE-Pim/Pi installed.
15A Linux Desktop with KDE installed. 10A Linux Desktop with KDE installed.
16A Linux Laptop with KDE installed. 11A Linux Laptop with KDE installed.
17 12
18NOTE: Your KDE version must be 3.3.0 or higher for sncing with. 13NOTE: Your KDE version must be 3.3.0 or higher for sncing with.
19 Please read KDE Sync HowTo how to update your SuSE 9.1 to KDE 3.3.x 14 Please read KDE Sync HowTo how to update your SuSE 9.1 to KDE 3.3.x
20 (KDE Sync HowTo is available in the help menu of KO/Pi and KA/Pi). 15 (KDE Sync HowTo is available in the help menu of KO/Pi and KA/Pi).
21 16
22The Zaurus is connected to the Linux Desktop via USB cable. 17The Zaurus is connected to the Linux Desktop via USB cable.
23 18
24All calendar addressbook data should be synced with the other devices. 19All calendar addressbook data should be synced with the other devices. That means in particular, that the calendar/address data of KDE on the Linux laptop and desktop is synced with the other devices.
25That means in particular, that the calendar/address data of KDE on
26the Linux laptop and desktop is synced with the other devices.
27 20
28First we have to install the needed programs, 21First we have to install the needed programs, then we have to configure the programs.
29then we have to configure the programs.
30 22
31***************************************** 23*****************************************
32(1) Installing the programs: 24(1) Installing the programs:
33***************************************** 25*****************************************
34 26
35Download the files from 27Download the files from
36http://sourceforge.net/projects/kdepimpi/ 28http://sourceforge.net/projects/kdepimpi/
37project name KDE/Pim. 29project name KDE/Pim.
38Download the latest release. 30Download the latest release.
39You will find in every file a ReadMe, 31You will find in every file a ReadMe,
40where you can read how to install. 32where you can read how to install.
41(a) Installing KDE-Pim/Pi on the Windows laptop: 33(a) Installing KDE-Pim/Pi on the Windows laptop:
42 Download file kdepim_X.X.X_for_Windows.exe.zip 34 Download file kdepim_X.X.X_for_Windows.exe.zip
43(b) Installing KDE-Pim/Pi on the Linux laptop and desktop: 35(b) Installing KDE-Pim/Pi on the Linux laptop and desktop:
44 Download file KDE-Pim-Pi-1.9.10-SuSE9.1.i586.rpm.zip 36 Download file KDE-Pim-Pi-2.0.8-SuSE_9.2.i586.rpm.zip
45(c) Installing KDE-Pim/Pi on the Sharp Zaurus PDA: 37(c) Installing KDE-Pim/Pi on the Sharp Zaurus PDA:
46 Depending on your Rom: 38 Depending on your Rom:
47 Download file kdepim_X.X.X_for_SharpROM.ipk.zip 39 Download file kdepim_X.X.X_for_SharpROM.ipk.zip
48 or file kdepim_X.X.X_for_OZ-gcc3xx.ipk.zip for OpenZaurus users. 40 or file kdepim_X.X.X_for_OZ-gcc3xx.ipk.zip for OpenZaurus users.
49 If unsure, download kdepim_X.X.X_for_SharpROM.ipk.zip 41 If unsure, download kdepim_X.X.X_for_SharpROM.ipk.zip
50 42
51We assume that we have now on every device KDE-Pim/Pi installed. 43We assume that we have now on every device KDE-Pim/Pi installed.
52To learn more about syncing, please read now the 44To learn more about syncing, please read now the
53Sync HowTo 45Sync HowTo
54KDE Sync HowTo 46KDE Sync HowTo
55available in the help menu of KO/Pi and KA/Pi. 47available in the help menu of KO/Pi and KA/Pi.
56 48
57 49
58***************************************** 50*****************************************
59(2) Configuring KDE-Pim/Pi for Multiple sync: 51(2) Configuring KDE-Pim/Pi for Multiple sync:
60***************************************** 52*****************************************
61 53
62In mutiple sync, we have one aktive sync device and many 54In mutiple sync, we have one aktive sync device and many other passive sync devices.
63other passive sync devices.
64 55
65We use the Linux desktop as the active sync device. 56We use the Linux desktop as the active sync device. But there is no limitation. In general, you can choose any device as active sync device. The Zaurus is connected to the Linux Desktop via USB cable. Please read the KDE Sync HowTo to know how to set up this connection.
66But there is no limitation. In general, you can choose
67any device as active sync device.
68The Zaurus is connected to the Linux Desktop via USB cable.
69Please read the KDE Sync HowTo to know how to set up this connection.
70 57
71We assume, that the devices have the following IP numbers: 58We assume, that the devices have the following IP numbers:
72Windows laptop: 192.168.0.40 59Windows laptop: 192.168.0.40
73Linux laptop: 192.168.0.88 60Linux laptop: 192.168.0.88
74Zaurus: 192.168.129.201 61Zaurus: 192.168.129.201
75Linux desktop: 192.168.0.99 62Linux desktop: 192.168.0.99
76 63
77***************************************** 64*****************************************
78(2a) Configuring the passive sync devices: 65(2a) Configuring the passive sync devices:
79***************************************** 66*****************************************
80 67
81(i) Windows laptop: 192.168.0.40: Name: XP 68(i) Windows laptop: 192.168.0.40: Name: XP
82Start KO/Pi 69Start KO/Pi
83Choose menu: Synchronize - Enable PiSync 70Choose menu: Synchronize - Enable PiSync
84Leave port as the default 9197. 71Leave port as the default 9197.
85Choose password xyz. 72Choose password xyz.
86Click OK. 73Click OK.
87 74
88(ii) Linux laptop: 192.168.0.88: Name: BUG 75(ii) Linux laptop: 192.168.0.88: Name: BUG
89Start KO/Pi 76Start KO/Pi
90Choose menu: Synchronize - Enable PiSync 77Choose menu: Synchronize - Enable PiSync
91Leave port as the default 9197. 78Leave port as the default 9197.
92Check the box "Automatically sync with KDE-Desktop when receiving sync request". 79Check the box "Automatically sync with KDE-Desktop when receiving sync request".
93Choose password xyz. 80Choose password xyz.
94Click OK. 81Click OK.
95 82
96(iii) Zaurus: 192.168.129.201: Name: Z760 83(iii) Zaurus: 192.168.129.201: Name: Z760
97Start KO/Pi 84Start KO/Pi
98Choose menu: Synchronize - Enable PiSync 85Choose menu: Synchronize - Enable PiSync
99Leave port as the default 9197. 86Leave port as the default 9197.
100Choose password xyz. 87Choose password xyz.
101Click OK. 88Click OK.
102 89
103The configuration of the passive sync devices is done. 90The configuration of the passive sync devices is done.
104 91
105***************************************** 92*****************************************
106(2b) Configuring the aktive sync device: 93(2b) Configuring the aktive sync device:
107***************************************** 94*****************************************
108 95
109Linux desktop: 192.168.0.99: Name: K7 96Linux desktop: 192.168.0.99: Name: K7
110Start KO/Pi 97Start KO/Pi
111Choose menu: Synchronize - Configure... 98Choose menu: Synchronize - Configure...
112 99
113Set "Local device name" to "K7" 100Set "Local device name" to "K7"
114 101
115Choose profile: KDE_Desktop 102Choose profile: KDE_Desktop
116Check "Include in multiple calendar sync". 103Check "Include in multiple calendar sync".
117 104
118Create new profile. 105Create new profile.
119Set name from "noName" to "XP". 106Set name from "noName" to "XP".
120Check "Include in multiple calendar sync". 107Check "Include in multiple calendar sync".
121Set "Profile kind" to "Pi-sync". 108Set "Profile kind" to "Pi-sync".
122Set Calendar: Password for remote access to "xyz" 109Set Calendar: Password for remote access to "xyz"
123Set Calendar: Remote IP address to "192.168.0.40" 110Set Calendar: Remote IP address to "192.168.0.40"
124Do not change: Calendar: Remote port number 111Do not change: Calendar: Remote port number
125 112
126Create new profile. 113Create new profile.
127Set name from "noName" to "BUG". 114Set name from "noName" to "BUG".
128Check "Include in multiple calendar sync". 115Check "Include in multiple calendar sync".
129Set "Profile kind" to "Pi-sync". 116Set "Profile kind" to "Pi-sync".
130Set Calendar: Password for remote access to "xyz" 117Set Calendar: Password for remote access to "xyz"
131Set Calendar: Remote IP address to "192.168.0.88" 118Set Calendar: Remote IP address to "192.168.0.88"
132Do not change: Calendar: Remote port number 119Do not change: Calendar: Remote port number
133 120
134 121
135Create new profile. 122Create new profile.
136Set name from "noName" to "Z760". 123Set name from "noName" to "Z760".
137Check "Include in multiple calendar sync". 124Check "Include in multiple calendar sync".
138Set "Profile kind" to "Pi-sync". 125Set "Profile kind" to "Pi-sync".
139Set Calendar: Password for remote access to "xyz" 126Set Calendar: Password for remote access to "xyz"
140Set Calendar: Remote IP address to "192.168.129.201" 127Set Calendar: Remote IP address to "192.168.129.201"
141Do not change: Calendar: Remote port number 128Do not change: Calendar: Remote port number
142 129
143Click on OK in the sync config dialog to save settings. 130Click on OK in the sync config dialog to save settings.
144 131
145 132
146***************************************************** 133*****************************************************
1473) Test Setup 1343) Test Setup
148***************************************************** 135*****************************************************
149 136
150Choose menu: Synchronize - XP 137Choose menu: Synchronize - XP
151Now the Windows laptop should be syncronized. 138Now the Windows laptop should be syncronized.
152 139
153Choose menu: Synchronize - Z760 140Choose menu: Synchronize - Z760
154Now the Zaurus should be syncronized. 141Now the Zaurus should be syncronized.
155 142
156Choose menu: Synchronize - BUG 143Choose menu: Synchronize - BUG
157Now the Linux laptop (and KDE there) should be syncronized. 144Now the Linux laptop (and KDE there) should be syncronized.
158 145
159Choose menu: Synchronize - KDE_Desktop 146Choose menu: Synchronize - KDE_Desktop
160Now KDE on the Linux desptop (your device you are syncing from) 147Now KDE on the Linux desptop (your device you are syncing from)
161should be syncronized with KO/Pi. 148should be syncronized with KO/Pi.
162 149
163 150
164***************************************************** 151*****************************************************
1654) Sync all devices 1524) Sync all devices
166***************************************************** 153*****************************************************
167 154
168Choose menu: Synchronize - Multiple Sync 155Choose menu: Synchronize - Multiple Sync
169 156
170Watch the devices interchanging the calendar data ... 157Watch the devices interchanging the calendar data ...
171 158
172Wait until you get the message in the KO/Pi header: 159Wait until you get the message in the KO/Pi header:
173 160
1744 profiles synced. Multiple sync complete! 1614 profiles synced. Multiple sync complete!
175 162
176NOTE: 163NOTE:
177If you want to test syncing, you may get wrong results, 164If you want to test syncing, you may get wrong results,
178if the clocks of the synced devices have too much difference. 165if the clocks of the synced devices have too much difference.
179 166
180Example: Your clocks have a difference of 2 minutes. 167Example: Your clocks have a difference of 2 minutes.
181You sync. 168You sync.
182You edit an appointment on two devices. 169You edit an appointment on two devices.
183You sync again. 170You sync again.
184You should get a conflict - but you do not get it. 171You should get a conflict - but you do not get it.
185The reason is: On one device the "last modified" 172The reason is: On one device the "last modified"
186datetime entry of the editet appointment is before the 173datetime entry of the editet appointment is before the
187last sync event datetime on the local device. 174last sync event datetime on the local device.
188Such that the rule is: 175Such that the rule is:
189If you have a clock difference of X seconds, you may get 176If you have a clock difference of X seconds, you may get
190wrong results, if you edit the same event within that 177wrong results, if you edit the same event within that
191X seconds on two devices. 178X seconds on two devices.
192Same is valid for creating a new event, of course. 179Same is valid for creating a new event, of course.
193If creation datetime is before the last sync, it is assumed that there was 180If creation datetime is before the last sync, it is assumed that there was
194an existing event on the local device and the newly created remote 181an existing event on the local device and the newly created remote
195event is deleted. 182event is deleted.
196 183
197 184
198***************************************************** 185*****************************************************
1995) Sync KA/Pi 1865) Sync KA/Pi
200***************************************************** 187*****************************************************
201 188
202Setup KA/Pi in the same way like KO/Pi. 189Setup KA/Pi in the same way like KO/Pi.
203 190
diff --git a/bin/kdepim/SyncHowto.txt b/bin/kdepim/SyncHowto.txt
index b0473a1..a901616 100644
--- a/bin/kdepim/SyncHowto.txt
+++ b/bin/kdepim/SyncHowto.txt
@@ -1,516 +1,470 @@
1WARNING: 1WARNING:
2YOU MAY GET UNEXPECTED (I.E. WRONG) SYNCHRONIZATION RESULTS, 2YOU MAY GET UNEXPECTED (I.E. WRONG) SYNCHRONIZATION RESULTS, IF YOU CHANGE AN EVENT ON THE FIRST DEVICE AND SYNC IMMEDIATELY FROM THE OTHER DEVICE WITH THIS DEVICE, IF THE CLOCKS OF THE TWO DEVICES HAVE TOO MUCH DIFFERENCE.
3IF YOU CHANGE AN EVENT ON THE FIRST DEVICE AND SYNC IMMEDIATELY FROM
4THE OTHER DEVICE WITH THIS DEVICE, IF THE CLOCKS OF THE TWO DEVICES
5HAVE TOO MUCH DIFFERENCE.
6 3
7In other words: Please make sure, that the clocks of the devices 4In other words: Please make sure, that the clocks of the devices you want to sync have only a difference of some seconds!
8you want to sync have only a difference of some seconds!
9 5
10 6
11CONTENT: 7CONTENT:
12 8
130) How syncing works 90) How syncing works
141) Qick overview of settings 101) Qick overview of settings
152) Sync settings in sync dialog 112) Sync settings in sync dialog
163) Syncing background 123) Syncing background
174) Sync preferences 134) Sync preferences
185) How a filter works 145) How a filter works
196) Details about sync profile kinds 156) Details about sync profile kinds
20 16
21************************************************************************* 17*************************************************************************
220) How syncing works 180) How syncing works
23************************************************************************* 19*************************************************************************
24 20
25Note: 21Note:
26The recommended and easiest way to syncronize two devices where 22The recommended and easiest way to syncronize two devices where KO/Pi, KA/Pi or PWM/Pi is installed, is the profile kind "Pi-Sync".
27KO/Pi, KA/Pi or PWM/Pi is installed, is the profile kind "Pi-Sync".
28Details about that in 6) b). 23Details about that in 6) b).
29 24
30In KDE-Pim/Pi you can synchronize ( sync ) your calendar/addressbook/ 25In KDE-Pim/Pi you can synchronize ( sync ) your
31passwordfile with another calendar/addressbook/passwordfile, 26calendar/addressbook/passwordfile with another c
32by syncing your (local) calendar/addressbook/passwordfile 27alendar/addressbook/passwordfile,
28by syncing your (local)
29calendar/addressbook/passwordfile
33with a (remote) file. 30with a (remote) file.
34This remote file may on your local filesystem 31This remote file may on your local filesystem
35or on another (remote) device. 32or on another (remote) device.
36 33
37If you want to sync with another remote device, you have to create 34If you want to sync with another remote device, you have to create
38a sync profile. 35a sync profile.
39You have two choices for choosing the profil kind: 36You have two choices for choosing the profil kind:
40I) You can choose profile kind "Remote file" and specify a 37I) You can choose profile kind "Remote file" and specify a
41 command line download/upload command ( like scp, ftp, ...) to 38 command line download/upload command ( like scp, ftp, ...) to
42 a) download the remote file to your local machine to a temp file 39 a) download the remote file to your local machine to a temp file
43 b) sync with this temp file 40 b) sync with this temp file
44 c) upload the synced file to the remote device 41 c) upload the synced file to the remote device
45II) If you want to sync with a device, where KO/Pi( or KA/Pi, PWM/Pi) is 42II) If you want to sync with a device, where KO/Pi( or KA/Pi, PWM/Pi) is
46 installed, you can easily get the remote file via network 43 installed, you can easily get the remote file via network
47 with the build in file transfer feature: 44 with the build in file transfer feature:
48 Choose profile kind "Pi-Sync" and 45 Choose profile kind "Pi-Sync" and
49 a) Start KO/Pi,KA/Pi or PWM/Pi on remote device and 46 a) Start KO/Pi,KA/Pi or PWM/Pi on remote device and
50 enable "Pi-Sync" on remote device with password and port. 47 enable "Pi-Sync" on remote device with password and port.
51 b) Specify password, port and IP address in your profile. 48 b) Specify password, port and IP address in your profile.
52 49
53 50
54You can sync with your mobile phone as well. 51You can sync with your mobile phone as well.
55Everything is explained in more details below. 52Everything is explained in more details below.
56 53
57NOTE: 54NOTE:
58If you do not use profile kind "Pi-Sync", 55If you do not use profile kind "Pi-Sync", it is recommended to close a running KO/Pi (KA/Pi, PWM/Pi) on the remote device.
59it is recommended to close
60a running KO/Pi (KA/Pi, PWM/Pi) on the remote device.
61(Note: KO/Pi(KA/Pi, PWM/Pi) running on Zaurus with 56(Note: KO/Pi(KA/Pi, PWM/Pi) running on Zaurus with
62FastLoad enabled will never be closed!) 57FastLoad enabled will never be closed!)
63After syncing with a running KO/Pi on the remote device, 58After syncing with a running KO/Pi on the remote device, a "save" on the remote device will tell you that it needs to merge (sync).
64a "save" on the remote device will tell you that it needs to merge (sync). 59After merging (just a syncing with the changed file) you will get the new data showing in remote KO/Pi.
65After merging (just a syncing with the changed file)
66you will get the new data showing in remote KO/Pi.
67 60
68************************************************************************* 61*************************************************************************
691) Qick overview of settings 621) Qick overview of settings
70************************************************************************* 63*************************************************************************
71 64
72a) Open sync settings dialog (Menu Synchronize - Configure...) 65a) Open sync settings dialog (Menu Synchronize - Configure...)
73b) Give your device a unique name. 66b) Give your device a unique name.
74 (unique in the set of all devices you want to sync with). 67 (unique in the set of all devices you want to sync with).
75 If you have already configured another devive and created 68 If you have already configured another devive and created
76 there a sync profile to sync with this device, give your device 69 there a sync profile to sync with this device, give your device
77 the same name as this sync profile! The same name is important, 70 the same name as this sync profile! The same name is important,
78 because it makes it possible to sync first A->B 71 because it makes it possible to sync first A->B
79 (A local device, that performs the sync, B remote device) 72 (A local device, that performs the sync, B remote device)
80 and then B->A. Such that the B->A sync knows about the 73 and then B->A. Such that the B->A sync knows about the
81 already performed A->B sync. 74 already performed A->B sync.
82 That means: It is unimportant if you sync A->B or B->A, 75 That means: It is unimportant if you sync A->B or B->A,
83 the devices A and B will be synced properly. 76 the devices A and B will be synced properly.
84c) Create a new sync profile and give it a unique name. 77c) Create a new sync profile and give it a unique name.
85 (unique in the set of all sync profiles on this device). 78 (unique in the set of all sync profiles on this device).
86 If you want to sync with a device, where KO/Pi is already installed 79 If you want to sync with a device, where KO/Pi is already installed
87 and which has a given unique device name, use this device name as 80 and which has a given unique device name, use this device name as
88 your profile name ( refer to b) ). 81 your profile name ( refer to b) ).
89d) Choose the profile kind of your syncing method: 82d) Choose the profile kind of your syncing method:
90 (i) Local file or 83 (i) Local file or
91 (ii) Pi-Sync or 84 (ii) Pi-Sync or
92 (iii) Remote file or 85 (iii) Remote file or
93 (iiii) Mobile Phone. 86 (iiii) Mobile Phone.
94 Detailed explanation in 6) 87 Detailed explanation in 6)
95e) Choose the other profile options. 88e) Choose the other profile options.
96 Detailed explanation in 2) 89 Detailed explanation in 2)
97f) Close sync dialog with OK. 90f) Close sync dialog with OK.
98g) Sync. 91g) Sync.
99 92
100NOTE: 93NOTE:
101AFTER SYNCING THERE ARE "SYNC EVENTS" CREATED 94AFTER SYNCING THERE ARE "SYNC EVENTS" CREATED
102(OR UPDATED, IF IT ALREADY EXITS) FOR EACH SYNC PROFILE. 95(OR UPDATED, IF IT ALREADY EXITS) FOR EACH SYNC PROFILE.
103YOU MAY NOT DELETE OR CHANGE THESE EVENTS. 96YOU MAY NOT DELETE OR CHANGE THESE EVENTS.
104 97
105************************************************************************* 98*************************************************************************
1062) Sync settings in sync dialog 992) Sync settings in sync dialog
107************************************************************************* 100*************************************************************************
108 101
109a) Local device name: 102a) Local device name:
110 -> 1) b) 103 -> 1) b)
111b) Profile: 104b) Profile:
112 -> 1) c) 105 -> 1) c)
113c) Multiple Sync options: Include in multiple sync: 106c) Multiple Sync options: Include in multiple sync:
114 In the Synchronize menu, there is a multiple sync menu entry. 107 In the Synchronize menu, there is a multiple sync menu entry.
115 If you choose this menu entry, all user defined profiles with this 108 If you choose this menu entry, all user defined profiles with this
116 'Include in multiple sync' option enabled will be synced 109 'Include in multiple sync' option enabled will be synced
117 one after another. And this twice. This will take some time. 110 one after another. And this twice. This will take some time.
118 After that sync, on all devices should be the same data. 111 After that sync, on all devices should be the same data.
119 112
120d)- j) Sync algo options: 113d)- j) Sync algo options:
121 114
122d) Ask for preferences before sync: 115d) Ask for preferences before sync:
123 Check this to be asked for "Sync preferences" settings before each sync. 116 Check this to be asked for "Sync preferences" settings before each sync.
124 If the profile kind is "Pi-Sync" you will be asked to confirm 117 If the profile kind is "Pi-Sync" you will be asked to confirm
125 the "Pi-Sync" specific settings (Password,IP address, port number) 118 the "Pi-Sync" specific settings (Password,IP address, port number)
126 as well. That makes it possible to use that profile for a 119 as well. That makes it possible to use that profile for a
127 device that is connected via DHCP to the network and gets different 120 device that is connected via DHCP to the network and gets different
128 IP addresses when connecting to the network. 121 IP addresses when connecting to the network.
129e) Sync preferences: 122e) Sync preferences:
130 Choose here your sync preferences. 123 Choose here your sync preferences.
131 Details -> 4) 124 Details -> 4)
132f) Show summary after sync: 125f) Show summary after sync:
133 Check this to get a small summary dialog after sync 126 Check this to get a small summary dialog after sync
134 about number of added/changed/deleted events on local/remote. 127 about number of added/changed/deleted events on local/remote.
135g) Apply filter when adding data to local: 128g) Apply filter when adding data to local:
136 What is a filter? You can read this in -> 5) 129 What is a filter? You can read this in -> 5)
137 With this option you can specify a filter for events/contacts, 130 With this option you can specify a filter for events/contacts,
138 which should be added to the local database, because they are 131 which should be added to the local database, because they are
139 in the remote database and not in the local database. 132 in the remote database and not in the local database.
140 (Database = calendar file or addressbook file). 133 (Database = calendar file or addressbook file).
141 Note that the filter is NOT applied to the remote 134 Note that the filter is NOT applied to the remote
142 database before syncing. It is only applied to a particular 135 database before syncing. It is only applied to a particular
143 item which should be added to the local database. 136 item which should be added to the local database.
144 Well, but what is the difference? 137 Well, but what is the difference?
145 The differnce is: If the remote database AND the local database contain 138 The differnce is: If the remote database AND the local database contain
146 an already synced item, which does not match the filter, then this item is synced. 139 an already synced item, which does not match the filter, then this item is synced.
147 If the remote database contains an item which does not match the filter 140 If the remote database contains an item which does not match the filter
148 and the local database does not contain this item, then this item is not added 141 and the local database does not contain this item, then this item is not added
149 to the local database, but it is still in the remote database after syncing. 142 to the local database, but it is still in the remote database after syncing.
150g) Write back synced data: 143g) Write back synced data:
151 Uncheck this to update the local calendar only. 144 Uncheck this to update the local calendar only.
152 I.e. your local calendar is synced with the remote calendar 145 I.e. your local calendar is synced with the remote calendar
153 but nothing on the remote calendar is changed. 146 but nothing on the remote calendar is changed.
154 If you uncheck "Write back synced data", the settings 147 If you uncheck "Write back synced data", the settings
155 under h) and i) are ignored, of course. 148 under h) and i) are ignored, of course.
156 149
157h) - j) Write back options: 150h) - j) Write back options:
158 151
159h) Write back (on remote) existing entries only: 152h) Write back (on remote) existing entries only:
160 Check this to update the remote data only. 153 Check this to update the remote data only.
161 I.e. no data from yor local calendar/addressbook is added to the 154 I.e. no data from yor local calendar/addressbook is added to the
162 remote device. You may use this option to 155 remote device. You may use this option to
163 sync against some kind of "public calendar/addressbook" without 156 sync against some kind of "public calendar/addressbook" without
164 adding anything of your personal data. 157 adding anything of your personal data.
165 But in this case, you cannot add an item to the remoet device. 158 But in this case, you cannot add an item to the remoet device.
166i) Apply filter when adding data to remote: 159i) Apply filter when adding data to remote:
167 What is a filter? You can read this in -> 5) 160 What is a filter? You can read this in -> 5)
168 With this option you can specify a filter for events/contacts, 161 With this option you can specify a filter for events/contacts,
169 which should be added to the remote database, because they are 162 which should be added to the remote database, because they are
170 in the local database and not in the remote database. 163 in the local database and not in the remote database.
171 (Database = calendar file or addressbook file). 164 (Database = calendar file or addressbook file).
172 Note that the filter is NOT applied to the local 165 Note that the filter is NOT applied to the local
173 database before syncing. It is only applied to a particular 166 database before syncing. It is only applied to a particular
174 item of the local database which should be added to the remote database. 167 item of the local database which should be added to the remote database.
175 Well, but what is the difference? 168 Well, but what is the difference?
176 The differnce is: If the local database AND the remote database contain 169 The differnce is: If the local database AND the remote database contain
177 an already synced item, which does not match the filter, then this item is synced. 170 an already synced item, which does not match the filter, then this item is synced.
178 If the local database contains an item which does not match the filter 171 If the local database contains an item which does not match the filter
179 and the remote database does not contain this item, then this item is not added 172 and the remote database does not contain this item, then this item is not added
180 to the remote database, but it is still in the local database after syncing. 173 to the remote database, but it is still in the local database after syncing.
181 Example: 174 Example:
182 You have specified a calendar filter "only public events". 175 You have specified a calendar filter "only public events".
183 You specify this filter as the outgoing filter for syncing. 176 You specify this filter as the outgoing filter for syncing.
184 If there is an event in the local database which is not "public", but "private", 177 If there is an event in the local database which is not "public", but "private",
185 this event is not added to the remote database. 178 this event is not added to the remote database.
186 If there is an event in the local database and in the remote database which is 179 If there is an event in the local database and in the remote database which is
187 "private" (maybe added by someone else) then this event is synced and 180 "private" (maybe added by someone else) then this event is synced and
188 it is in the local database and in the remote database after syncing. 181 it is in the local database and in the remote database after syncing.
189 That means in particular you cannot remove an event from the remote 182 That means in particular you cannot remove an event from the remote
190 database but setting it to "private". 183 database but setting it to "private".
191 If you want to remove the event you can clone it, set it to private and delete the 184 If you want to remove the event you can clone it, set it to private and delete the
192 original event. Then the original event is deleted in the remote database after sync and 185 original event. Then the original event is deleted in the remote database after sync and
193 the cloned event is not added to the remote database, because it is private. 186 the cloned event is not added to the remote database, because it is private.
194j) Write back (calendar) entries for time period only: 187j) Write back (calendar) entries for time period only:
195 Check this to write back only calendar entries for a given time period. 188 Check this to write back only calendar entries for a given time period.
196 (Useful when syncing with mobile phones.) 189 (Useful when syncing with mobile phones.)
197 You can specify the date range in weeks for the weeks in the past to the weeks in the future. 190 You can specify the date range in weeks for the weeks in the past to the weeks in the future.
198 191
199k) Profile kind: 192k) Profile kind:
200 Details -> 6) 193 Details -> 6)
201 194
202************************************************************************* 195*************************************************************************
2033) Syncing background 1963) Syncing background
204************************************************************************* 197*************************************************************************
205 198
206The same mentioned for calendars is valid for addressbooks as well. 199The same mentioned for calendars is valid for addressbooks as well.
207 200
208Synchronizing calendars ( i.e. files ) means, 201Synchronizing calendars ( i.e. files ) means, to merge two calendars in a useful way. If the two calendars are completely different, there is no problem, the resulting calendar contains all data from the local and from the remote calendar.
209to merge two calendars in a useful way. 202
210If the two calendars are completely different, 203Problems will occur, if you have edited items from the local calendar on the remote machine. Then it could be, that items are in conflict. Two items are "in conflict", if they have the same unique ID (which get an item at time of creation and owns it until it is deleted ) and they both are modified after the last synchronization.
211there is no problem, the resulting calendar contains 204
212all data from the local and from the remote calendar. 205At first sync of two calendars there is no item deleted. If the calendars are synced before and there is an item, which is not edited after the last sync and is only available in one calendar, then this item is deleted in this calendar.
213
214Problems will occur, if you have edited items
215from the local calendar on the remote machine.
216Then it could be, that items are in conflict.
217Two items are "in conflict", if they have the
218same unique ID (which get an item at time of
219creation and owns it until it is deleted )
220and they both are modified after the last
221synchronization.
222
223At first sync of two calendars there is no item deleted.
224If the calendars are synced before and there is an item,
225which is not edited after the last sync and is only
226available in one calendar, then this item is deleted
227in this calendar.
228 206
229But when was the last synchronization between two calendars? 207But when was the last synchronization between two calendars?
230 208
231To know that, KO/Pi creates at first syncing 209To know that, KO/Pi creates at first syncing of two files an unique event "<profile name> - sync Event" on the remote and the local calendar. After syncing, the start time of this event is set to the time of syncing. The event is read only and the user may not change it.
232of two files an unique event "<profile name> - sync Event"
233on the remote and the local calendar.
234After syncing, the start time of this event is set
235to the time of syncing.
236The event is read only and the user may not change it.
237 210
238If two such files are synced, that both have an event 211If two such files are synced, that both have an event "<profile name> - sync Event" and the events have the same start time, then deleted items on the one calendar are deleted on the other as well.
239"<profile name> - sync Event" and the events have
240the same start time, then deleted items on the one calendar
241are deleted on the other as well.
242 212
243 213
244************************************************************************* 214*************************************************************************
2454) Sync preferences 2154) Sync preferences
246************************************************************************* 216*************************************************************************
247 217
248Two items are "in conflict", if they have the same unique ID 218Two items are "in conflict", if they have the same unique ID and they both are modified after the last synchronization.
249and they both are modified after the last synchronization.
250(Details -> 3) ). 219(Details -> 3) ).
251 220
252If an item is not modified after the last sync and 221If an item is not modified after the last sync and it is not found in the other calendar, it is deleted.
253it is not found in the other calendar, it is deleted.
254 222
255On the first sync, there is no item deleted. 223On the first sync, there is no item deleted.
256 224
257SYNC PREFERENCES: 225SYNC PREFERENCES:
258 -Take local entry on conflict: 226 -Take local entry on conflict:
259 Takes the local entry on conflict. 227 Takes the local entry on conflict.
260 If it is the first sync, 228 If it is the first sync,
261 "Ask for every entry" 229 "Ask for every entry"
262 is chosen automatically, 230 is chosen automatically,
263 if this is selected. 231 if this is selected.
264 232
265 -Take remote entry on conflict: 233 -Take remote entry on conflict:
266 Takes the remote entry on conflict. 234 Takes the remote entry on conflict.
267 If it is the first sync, 235 If it is the first sync,
268 "Ask for every entry" 236 "Ask for every entry"
269 is chosen automatically, 237 is chosen automatically,
270 if this is selected. 238 if this is selected.
271 239
272 -Take newest entry on conflict: 240 -Take newest entry on conflict:
273 This takes the newest entry on conflict. 241 This takes the newest entry on conflict.
274 May be the most useful syncing mode. 242 May be the most useful syncing mode.
275 243
276 -Ask for every entry on conflict: 244 -Ask for every entry on conflict:
277 Pops up an event viewer dialog and 245 Pops up an event viewer dialog and
278 shows the two conflicting entries there. 246 shows the two conflicting entries there.
279 The user can chose, which entry he would like to take. 247 The user can chose, which entry he would like to take.
280 The button for the newest entry 248 The button for the newest entry
281 is automatically set as default button. 249 is automatically set as default button.
282 The color for the newest entry is green. 250 The color for the newest entry is green.
283 251
284 -Force: Take local entry always: 252 -Force: Take local entry always:
285 Even if the calendars are already synced 253 Even if the calendars are already synced
286 there is no item deleted on local. 254 there is no item deleted on local.
287 255
288 -Force: Take remote entry always: 256 -Force: Take remote entry always:
289 Analogous to 257 Analogous to
290 "Force: Take local entry always" 258 "Force: Take local entry always"
291 259
292************************************************************************* 260*************************************************************************
2935) How a filter works 2615) How a filter works
294************************************************************************* 262*************************************************************************
295 263
296A filter is a rule to decide if a particular item 264A filter is a rule to decide if a particular item (calendar iten item or contact item) belongs to a set of items.
297(calendar iten item or contact item) belongs to a set of items.
298For example, you can specify a set as: 265For example, you can specify a set as:
299Only items, that belongs to that category. 266Only items, that belongs to that category.
300Or: Only items, that does not belong to that category. 267Or: Only items, that does not belong to that category.
301Or: Only items, that are public. 268Or: Only items, that are public.
302 269
303If you specify a filter in a syncing profile, you can set the 270If you specify a filter in a syncing profile, you can set the rules of adding items to the local or remote database.
304rules of adding items to the local or remote database.
305 271
306Example: 272Example:
307You have a public calendar in your company, which contains all 273You have a public calendar in your company, which contains all company relevant data.
308company relevant data. 274
309 275You have different projects in the company and for project specific events is always set the project name as a category:
310You have different projects in the company and for project specific events 276E.g. all events of the project PRO_ABC do have set the categorie PRO_ABC. But you are not interested in events of PRO_ABC, because you are not working on it. Then you can specify a filter: All, but not with categoroy PRO_ABC. When you specify this filter as an incoming filter for your sync profile, all events of the company are synced and added to your local calendar, but not the evenst of the project PRO_ABC.
311is always set the project name as a category: 277
312E.g. all events of the project PRO_ABC do have set the categorie PRO_ABC. 278You do not want that your private data can be seen in the public calendar of your company. Well, set the property to "private" for all your private data and specify an outgoing filter: Only " public" and "confidential". Then you can sync your personal calendar with the calendar of the company, but your private data is not added to the public calendar.
313But you are not interested in events of PRO_ABC, because you are not working on it.
314Then you can specify a filter: All, but not with categoroy PRO_ABC.
315When you specify this filter as an incoming filter for your sync profile,
316all events of the company are synced and added to your local calendar, but not
317the evenst of the project PRO_ABC.
318
319You do not want that your private data can be seen
320in the public calendar of your company.
321Well, set the property to "private" for all your private data
322and specify an outgoing filter: Only " public" and "confidential".
323Then you can sync your personal calendar with the calendar of the company,
324but your private data is not added to the public calendar.
325 279
326************************************************************************* 280*************************************************************************
3276) Details about sync profile kinds 2816) Details about sync profile kinds
328************************************************************************* 282*************************************************************************
329 283
330a) Local file 284a) Local file
331 Please specify a local file you want to sync with. 285 Please specify a local file you want to sync with.
332 Note: If you are syncing a file, which is used by KA/Pi, please check the 286 Note: If you are syncing a file, which is used by KA/Pi, please check the
333 "Addressbook file (*.vcf) is used by KA/Pi". 287 "Addressbook file (*.vcf) is used by KA/Pi".
334 If you are syncing with a file from KAddressbook or another program, 288 If you are syncing with a file from KAddressbook or another program,
335 please uncheck "Addressbook file (*.vcf) is used by KA/Pi". 289 please uncheck "Addressbook file (*.vcf) is used by KA/Pi".
336 To set this properly is important! KA/Pi uses a "last modified" property, 290 To set this properly is important! KA/Pi uses a "last modified" property,
337 which is not supported by KAddressbook. 291 which is not supported by KAddressbook.
338 292
339b) Pi-Sync (direct Kx/Pi to Kx/Pi sync) 293b) Pi-Sync (direct Kx/Pi to Kx/Pi sync)
340 We mention here only KO/Pi, but the same is valid for KA/Pi. 294 We mention here only KO/Pi, but the same is valid for KA/Pi.
341 If you want to sync with a device, where KO/Pi is 295 If you want to sync with a device, where KO/Pi is
342 installed, you can easily get the remote file via network 296 installed, you can easily get the remote file via network
343 with the build in file transfer feature "Pi-Sync": 297 with the build in file transfer feature "Pi-Sync":
344 You have first to enable file transfer on the remote device: 298 You have first to enable file transfer on the remote device:
345 - Start KO/Pi on the remote device. 299 - Start KO/Pi on the remote device.
346 - Choose Menu Synchronize-Enable Pi-Sync. 300 - Choose Menu Synchronize-Enable Pi-Sync.
347 - Choose a port number, where KO/Pi should listen for 301 - Choose a port number, where KO/Pi should listen for
348 file sending requests. Valid port numbers are numbers 302 file sending requests. Valid port numbers are numbers
349 between 1 and 65565. Do not specify port numbers, that are 303 between 1 and 65565. Do not specify port numbers, that are
350 used by other applications. A port number between 9000 and 9999 304 used by other applications. A port number between 9000 and 9999
351 is most likely not used by another application. 305 is most likely not used by another application.
352 The default port number is 9197 for KO/Pi. 306 The default port number is 9197 for KO/Pi.
353 If you specify a port number, which is already in use, 307 If you specify a port number, which is already in use,
354 you will get an error message when closing this dialog. 308 you will get an error message when closing this dialog.
355 - Choose a password. 309 - Choose a password.
356 - Click OK. 310 - Click OK.
357 Now KO/Pi will send the calendar data via the network, 311 Now KO/Pi will send the calendar data via the network,
358 if some other device is sending a "please send calendar" 312 if some other device is sending a "please send calendar"
359 request on the given port using the given password. 313 request on the given port using the given password.
360 If you want to be sure, nobody can access your calendar 314 If you want to be sure, nobody can access your calendar
361 data, simply disable the file transfer feature on the 315 data, simply disable the file transfer feature on the
362 remote device after the syncing is done by choosing: 316 remote device after the syncing is done by choosing:
363 Menu Synchronize-Disable Pi-Sync. 317 Menu Synchronize-Disable Pi-Sync.
364 318
365 Note: If you want to sync with a remote device that gets different 319 Note: If you want to sync with a remote device that gets different
366 IPaddresses each time connected to the network 320 IPaddresses each time connected to the network
367 (this may be the case, if you use DHCP for connection 321 (this may be the case, if you use DHCP for connection
368 of the remote device to the network) simply enable 322 of the remote device to the network) simply enable
369 "Ask for preferences before sync". 323 "Ask for preferences before sync".
370 Then you will be asked to confirm the 324 Then you will be asked to confirm the
371 "Pi-Sync" specific settings 325 "Pi-Sync" specific settings
372 (Password,IP address, port number) 326 (Password,IP address, port number)
373 and you can easily change the IP address before each sync. 327 and you can easily change the IP address before each sync.
374 328
375 On your local device, create a new profile and choose 329 On your local device, create a new profile and choose
376 profile kind "Pi-Sync". 330 profile kind "Pi-Sync".
377 Fill in the needed values: 331 Fill in the needed values:
378 - Password for remote access: 332 - Password for remote access:
379 The password you specified on the remote device. 333 The password you specified on the remote device.
380 - Remote IP address: 334 - Remote IP address:
381 The IP address of the remote device. 335 The IP address of the remote device.
382 - Remote port number: 336 - Remote port number:
383 The port number you specified on the remote device. 337 The port number you specified on the remote device.
384 338
385 Now you can syncronize your local device easily with your 339 Now you can syncronize your local device easily with your
386 remote device. This works well for all platforms KO/Pi is 340 remote device. This works well for all platforms KO/Pi is
387 running on, e.g. syncing a KO/Pi on Zaurus with KO/Pi on Windows 341 running on, e.g. syncing a KO/Pi on Zaurus with KO/Pi on Windows
388 is now very easy. 342 is now very easy.
389 343
390c) Remote file 344c) Remote file
391 Note: If you are syncing a file, which is used by KA/Pi, please check the 345 Note: If you are syncing a file, which is used by KA/Pi, please check the
392 "Addressbook file (*.vcf) is used by KA/Pi". 346 "Addressbook file (*.vcf) is used by KA/Pi".
393 If you are syncing with a file from KAddressbook or another program, 347 If you are syncing with a file from KAddressbook or another program,
394 please uncheck "Addressbook file (*.vcf) is used by KA/Pi". 348 please uncheck "Addressbook file (*.vcf) is used by KA/Pi".
395 To set this properly is important! KA/Pi uses a "last modified" property, 349 To set this properly is important! KA/Pi uses a "last modified" property,
396 which is not supported by KAddressbook. 350 which is not supported by KAddressbook.
397 351
398 Syncing with the profile kind "Remote file" is performed in three steps: 352 Syncing with the profile kind "Remote file" is performed in three steps:
399 i) download the remote file to your local machine to a temp file 353 i) download the remote file to your local machine to a temp file
400 ii) sync with this temp file 354 ii) sync with this temp file
401 iii) upload the synced file to the remote device 355 iii) upload the synced file to the remote device
402 356
403 The down-/uploading if i) and iii) is done via a command line command. 357 The down-/uploading if i) and iii) is done via a command line command.
404 Please specify the download/upload command ( like scp, ftp, ...) and the 358 Please specify the download/upload command ( like scp, ftp, ...) and the
405 file name of the temp file in the corresponding fields. 359 file name of the temp file in the corresponding fields.
406 360
407d) Mobile device (cell phone) 361d) Mobile device (cell phone)
408 Note: On the Zaurus you have to install the phoneaccess_xxx_arm.ipk package 362 Note: On the Zaurus you have to install the phoneaccess_xxx_arm.ipk package
409 to be able to access mobile phones. 363 to be able to access mobile phones.
410 We mention here only KO/Pi, but the same is valid for KA/Pi. 364 We mention here only KO/Pi, but the same is valid for KA/Pi.
411 Note: 365 Note:
412 It is only possible to sync a mobile phone with one particular device 366 It is only possible to sync a mobile phone with one particular device
413 running KO/Pi. If you want to be able to write data of more than one device 367 running KO/Pi. If you want to be able to write data of more than one device
414 to the mobile phone (e.g. from your Zaurus and from your Windows Laptop) 368 to the mobile phone (e.g. from your Zaurus and from your Windows Laptop)
415 do not sync with the mobile phone at all, but use the 369 do not sync with the mobile phone at all, but use the
416 "Export to phone" functionality from the different devices. 370 "Export to phone" functionality from the different devices.
417 Using "Export to phone" makes it not possible to get back data from the 371 Using "Export to phone" makes it not possible to get back data from the
418 phone, if it was changed there, of course. 372 phone, if it was changed there, of course.
419 If you sync with the phone, do not use "Export to phone" from any device. 373 If you sync with the phone, do not use "Export to phone" from any device.
420 (And do not sync, as mentioned above, from any other device with that phone). 374 (And do not sync, as mentioned above, from any other device with that phone).
421 It would delete the needed information for syncing with that phone! 375 It would delete the needed information for syncing with that phone!
422 376
423 We are using Gammu (Version: 0.98.9) ( http://freshmeat.net/projects/gammu/ ) 377 We are using Gammu (Version: 0.98.9) ( http://freshmeat.net/projects/gammu/ )
424 for accessing the phones. 378 for accessing the phones.
425 Note: You cannot use the original Gammu for syncing KDE-Pim/Pi, because 379 Note: You cannot use the original Gammu for syncing KDE-Pim/Pi, because
426 we have modified the original version to make it useable for syncing! 380 we have modified the original version to make it useable for syncing!
427 Gammu allows access to many phones in many ways (Irda, Bluetooth, serial,...). 381 Gammu allows access to many phones in many ways (Irda, Bluetooth, serial,...).
428 The recommended phone access using Gammu with KDE-Pim/Pi is Irda (infrared). 382 The recommended phone access using Gammu with KDE-Pim/Pi is Irda (infrared).
429 Bluetooth access is disabled on the Zaurus, but may work on Windows. 383 Bluetooth access is disabled on the Zaurus, but may work on Windows.
430 Please look at the Gammu homepage and documentation about more details 384 Please look at the Gammu homepage and documentation about more details
431 configuring Gammu how to access your phone. 385 configuring Gammu how to access your phone.
432 If you have problems accessing your phone, start KO/Pi from the konsole 386 If you have problems accessing your phone, start KO/Pi from the konsole
433 and you will get a more detailed output what went wrong. 387 and you will get a more detailed output what went wrong.
434 About Gammu from the Gammu homepage: 388 About Gammu from the Gammu homepage:
435 Gammu (formerly known as MyGnokii2) is a cellular 389 Gammu (formerly known as MyGnokii2) is a cellular
436 manager for various mobile phones/modems. 390 manager for various mobile phones/modems.
437 It supports the Nokia 2100, 3100, 32xx, 33xx, 391 It supports the Nokia 2100, 3100, 32xx, 33xx,
438 3410, 35xx, 51xx, 5210, 5510, 61xx, 62xx, 392 3410, 35xx, 51xx, 5210, 5510, 61xx, 62xx,
439 63xx, 6510, 6610, 6800, 71xx, 7210, 7250, 393 63xx, 6510, 6610, 6800, 71xx, 7210, 7250,
440 7250i, 82xx, 83xx, 8910, 9110, 9210 394 7250i, 82xx, 83xx, 8910, 9110, 9210
441 and compatible and AT devices (Siemens, Alcatel, 395 and compatible and AT devices (Siemens, Alcatel,
442 Falcom, WaveCom, IPAQ, Samsung, SE, and others) 396 Falcom, WaveCom, IPAQ, Samsung, SE, and others)
443 over cables/infrared/BlueTooth. 397 over cables/infrared/BlueTooth.
444 398
445 Here is an example what to specify to access a Nokia 6310i via infrared: 399 Here is an example what to specify to access a Nokia 6310i via infrared:
446 On Linux (Zaurus): 400 On Linux (Zaurus):
447 I/O device: /dev/ircomm 401 I/O device: /dev/ircomm
448 Connection: irda 402 Connection: irda
449 Model: <leave empty> 403 Model: <leave empty>
450 404
451 On Windows: 405 On Windows:
452 I/O device: <ignored - i.e. leave empty> 406 I/O device: <ignored - i.e. leave empty>
453 Connection: irda 407 Connection: irda
454 Model: <leave empty> 408 Model: <leave empty>
455 409
456 Here is the overview from the Gammu documentation, 410 Here is the overview from the Gammu documentation,
457 how to specify the connection settings for 411 how to specify the connection settings for
458 I/O device: 412 I/O device:
459 Connection: 413 Connection:
460 Model: 414 Model:
461 415
462 Note: The documentation uses the term "port", 416 Note: The documentation uses the term "port",
463 where we use the term "I/O device". 417 where we use the term "I/O device".
464 Note: You do not have to create/change the gammurc configuration file. 418 Note: You do not have to create/change the gammurc configuration file.
465 That will do KO/Pi for you. 419 That will do KO/Pi for you.
466 Note: For a known model, leave "Model:" always empty, 420 Note: For a known model, leave "Model:" always empty,
467 such that Gammu can auto detect the model. 421 such that Gammu can auto detect the model.
468 422
469# This is a sample ~/.gammurc file. 423# This is a sample ~/.gammurc file.
470# In Unix/Linux copy it into your home directory and name it .gammurc 424# In Unix/Linux copy it into your home directory and name it .gammurc
471# or into /etc and name it gammurc 425# or into /etc and name it gammurc
472# In Win32 copy it into directory with Gammu.exe and name gammurc 426# In Win32 copy it into directory with Gammu.exe and name gammurc
473# More about parameters later 427# More about parameters later
474# ----------------------------------------------------------------------------- 428# -----------------------------------------------------------------------------
475 429
476[gammu] 430[gammu]
477 431
478port = com8: 432port = com8:
479#model = 6110 433#model = 6110
480connection = fbusblue 434connection = fbusblue
481#synchronizetime = yes 435#synchronizetime = yes
482#logfile = gammulog 436#logfile = gammulog
483#logformat = textall 437#logformat = textall
484#use_locking = yes 438#use_locking = yes
485#gammuloc = locfile 439#gammuloc = locfile
486#startinfo = yes 440#startinfo = yes
487#gammucoding = utf8 441#gammucoding = utf8
488 442
489[gammu1] 443[gammu1]
490 444
491port = com8: 445port = com8:
492#model = 6110 446#model = 6110
493connection = fbusblue 447connection = fbusblue
494#synchronizetime = yes 448#synchronizetime = yes
495#logfile = gammulog 449#logfile = gammulog
496#logformat = textall 450#logformat = textall
497#use_locking = yes 451#use_locking = yes
498#gammuloc = locfile 452#gammuloc = locfile
499#startinfo = yes 453#startinfo = yes
500#gammucoding = utf8 454#gammucoding = utf8
501 455
502# ----------------------------------------------------------------------------- 456# -----------------------------------------------------------------------------
503# Now info about "Connection" parameter and connected with it port type 457# Now info about "Connection" parameter and connected with it port type
504# (more about port types later) 458# (more about port types later)
505# ----------------------------------------------------------------------------- 459# -----------------------------------------------------------------------------
506# "Connection" parameter | Port type | More details 460# "Connection" parameter | Port type | More details
507# -----------------------|-----------|----------------------------------------- 461# -----------------------|-----------|-----------------------------------------
508# "fbus" | serial | Nokia FBUS2 462# "fbus" | serial | Nokia FBUS2
509# "fbusirda"/"infrared" | serial | Nokia FBUS2 over direct infrared device 463# "fbusirda"/"infrared" | serial | Nokia FBUS2 over direct infrared device
510# "fbusdlr3"/"dlr3" | serial | Nokia FBUS2 with DLR3 cable 464# "fbusdlr3"/"dlr3" | serial | Nokia FBUS2 with DLR3 cable
511# "fbusdku5" | dku5 | Nokia FBUS2 with DKU5 cable. WIN32 ONLY 465# "fbusdku5" | dku5 | Nokia FBUS2 with DKU5 cable. WIN32 ONLY
512# "fbuspl2303" | usb | Nokia FBUS2 with USB cable based on 466# "fbuspl2303" | usb | Nokia FBUS2 with USB cable based on
513# | | PL2303 chip. 467# | | PL2303 chip.
514# "fbusblue" | serial | Nokia FBUS2 over Bluetooth serial device 468# "fbusblue" | serial | Nokia FBUS2 over Bluetooth serial device
515# "phonetblue" | serial | Nokia PHONET FBUS over Bluetooth serial 469# "phonetblue" | serial | Nokia PHONET FBUS over Bluetooth serial
516# | | device 470# | | device
diff --git a/bin/kdepim/korganizer/featuresKOPI.txt b/bin/kdepim/korganizer/featuresKOPI.txt
index dc10a6b..283ec8e 100644
--- a/bin/kdepim/korganizer/featuresKOPI.txt
+++ b/bin/kdepim/korganizer/featuresKOPI.txt
@@ -1,231 +1,232 @@
1Features of KO/Pi and hints for usage of KO/Pi 1Features of KO/Pi and hints for usage of KO/Pi
2(www.pi-sync.net) 2(www.pi-sync.net)
3 3
4A) General features 4A) General features
5 0) Main features 5 0) Main features
6 1) Import - export - connection - syncing 6 1) Import - export - connection - syncing
7 2) Filter 7 2) Filter
8 3) Managing categories: 8 3) Managing categories:
9 4) Cancelling of items: 9 4) Cancelling of items:
10 5) Addressbook access: 10 5) Addressbook access:
11 6) Quick editing: 11 6) Quick editing:
12 7) Fast navigation: 12 7) Fast navigation:
13 8) Printing: 13 8) Printing:
14 9) Configuration: 14 9) Configuration:
15 10) Language: 15 10) Language:
16 11) Alarm: 16 11) Alarm:
17 12) What'sThis Help: 17 12) What'sThis Help:
18 18
19B) Useful features, that are not straighforward to see 19B) Useful features, that are not straighforward to see
20 1) Right mouse click on Zaurus 20 1) Right mouse click on Zaurus
21 2) Moving of items in the agenda view 21 2) Moving of items in the agenda view
22 3) Creating exceptions for recurring events 22 3) Creating exceptions for recurring events
23 4) Navigation in month view 23 4) Navigation in month view
24 5) Navigation in agenda view 24 5) Navigation in agenda view
25 6) Monthview as week view 25 6) Monthview as week view
26 7) Switching display mode in date edit 26 7) Switching display mode in date edit
27 8) Recurring todos 27 8) Recurring todos
28 28
29 29
30****************************************************** 30******************************************************
31A) General features 31A) General features
32****************************************************** 32******************************************************
33Features of KO/Pi 1.9.12: 33Features of KO/Pi 2.0.8:
340) 340)
35Main features: 35Main features:
36KO/Pi makes synchronizing your data easy! 36KO/Pi makes synchronizing your data easy!
37Details in 1) and the sync HowTos. 37Details in 1) and the sync HowTos.
38With KO/Pi you can manage your events/todos/journals. 38With KO/Pi you can manage your events/todos/journals.
39Todos may have subtodos. 39Todos may have subtodos.
40Todos may recur ( details: B)8) Recurring todos)
40A subtodo can be changed to a parent root todo. 41A subtodo can be changed to a parent root todo.
41A (sub)todo can be reparented to make it a subtodo of another todo. 42A (sub)todo can be reparented to make it a subtodo of another todo.
42KO/Pi has a monthview, a What's Next view, an event list view, a small and big todo-view and an agenda view to display 1-42 days. 43KO/Pi has a monthview, a What's Next view, an event list view, a small and big todo-view and an agenda view to display 1-42 days.
43KO/Pi is Qt-only based and runs on Sharp Zaurus PDA, Linux and Windows. 44KO/Pi is Qt-only based and runs on Sharp Zaurus PDA, Linux and Windows.
441) 451)
45Import - export - connection - syncing: 46Import - export - connection - syncing:
46KO/Pi on Windows can import calendar data easyly from Outlook directly via OLE. 47KO/Pi on Windows can import calendar data easyly from Outlook directly via OLE.
47 Recurring events with exceptions and attendee lists of meetings are imported properly. 48 Recurring events with exceptions and attendee lists of meetings are imported properly.
48KO/Pi can import/export ics and vcs files. 49KO/Pi can import/export ics and vcs files.
49KO/Pi can save/load ics backup files. 50KO/Pi can save/load ics backup files.
50KO/Pi can send ics and vcs files via infrared, with and without timezone settings.( Zaurus only ) 51KO/Pi can send ics and vcs files via infrared, with and without timezone settings.( Zaurus only )
51KO/Pi can receive files via infrared directly, after beam receive is enabled.( Zaurus only ) 52KO/Pi can receive files via infrared directly, after beam receive is enabled.( Zaurus only )
52 Via the search function you can send any number/selection of events/tasks/journal via infrared. 53 Via the search function you can send any number/selection of events/tasks/journal via infrared.
53Via the search function you can export and save any number/selection of events/tasks/journal to an ics file. 54Via the search function you can export and save any number/selection of events/tasks/journal to an ics file.
54Via the search function you can export and save any number/selection of journals and descriptions of events/todos to a plain text file. 55Via the search function you can export and save any number/selection of journals and descriptions of events/todos to a plain text file.
55KO/Pi can import xml calendar/todo data from Opie/old Qtopia environment. 56KO/Pi can import xml calendar/todo data from Opie/old Qtopia environment.
56KO/Pi can sync calendar/todo data with new Sharp Rom DTM model PIM applications, found on Zaurus 7x0/860 and Sharp Rom 3.1 (and above) for 5x00 series. 57KO/Pi can sync calendar/todo data with new Sharp Rom DTM model PIM applications, found on Zaurus 7x0/860 and Sharp Rom 3.1 (and above) for 5x00 series.
57(Hint: Rename /home/QtPalmtop/bin/datebook to e.g. /home/QtPalmtop/bin/datebookwech 58(Hint: Rename /home/QtPalmtop/bin/datebook to e.g. /home/QtPalmtop/bin/datebookwech
58to prevent alarm notification by the Sharp calendar app) 59to prevent alarm notification by the Sharp calendar app)
59KO/Pi can sync calendar/todo/journal data with any local ics file. 60KO/Pi can sync calendar/todo/journal data with any local ics file.
60In KO/Pi you can create a specific profile for each device to sync with. 61In KO/Pi you can create a specific profile for each device to sync with.
61 KO/Pi can automatically down/upload a remote ics file to a temp file via user specified system command (e.g. ssh/scp, ftp, ...) to sync with. 62 KO/Pi can automatically down/upload a remote ics file to a temp file via user specified system command (e.g. ssh/scp, ftp, ...) to sync with.
62 KO/Pi can ask you, if a conflict while syncing is detected and displays a detailed view of both events/todos. 63 KO/Pi can ask you, if a conflict while syncing is detected and displays a detailed view of both events/todos.
63 Multiple sync with many profiles at once is supported. Read "Multi Sync HowTo". 64 Multiple sync with many profiles at once is supported. Read "Multi Sync HowTo".
64 KO/Pi can sync after an easy and quick setup via network in the "Pi-Sync" mode with another running instance of KO/Pi with "Pi-Sync" enabled. 65 KO/Pi can sync after an easy and quick setup via network in the "Pi-Sync" mode with another running instance of KO/Pi with "Pi-Sync" enabled.
65 KO/Pi on Linux can sync with KDE calendar data. 66 KO/Pi on Linux can sync with KDE calendar data.
66 KO/Pi on the Zaurus can sync with KDE calendar data on desktop via Pi-Sync. Read "KDE-Sync HowTo". 67 KO/Pi on the Zaurus can sync with KDE calendar data on desktop via Pi-Sync. Read "KDE-Sync HowTo".
67 KO/Pi can sync and export data to mobile phones. Supported models are depending of the used lib, libgammu. 68 KO/Pi can sync and export data to mobile phones. Supported models are depending of the used lib, libgammu.
68 If KO/Pi detects that the saved file on disk has changed,(e.g. a remote sync from somewhere has happened), 69 If KO/Pi detects that the saved file on disk has changed,(e.g. a remote sync from somewhere has happened),
69 it asks you, if you want to overwrite the file or if you want to sync with the file. Such that no data is lost. 70 it asks you, if you want to overwrite the file or if you want to sync with the file. Such that no data is lost.
70KO/Pi can save/load templates for events/todos. 71KO/Pi can save/load templates for events/todos.
712) 722)
72Filter: 73Filter:
73You can define filters for displaying/not displaying specified categories. 74You can define filters for displaying/not displaying specified categories.
74Quick access to the first 20 filters via hotkeys 1-0 and <ctrl>1-0 75Quick access to the first 20 filters via hotkeys 1-0 and <ctrl>1-0
753) 763)
76Managing categories: 77Managing categories:
77After importing/loading/syncing there may be new categories in events or todos which are not in the category list. 78After importing/loading/syncing there may be new categories in events or todos which are not in the category list.
78 You can choose what to do with these categories: 79 You can choose what to do with these categories:
79 -Add to category list 80 -Add to category list
80 -Or remove them from events/todos 81 -Or remove them from events/todos
81In the list view/search dialog you can quickly assign categories to all selected items. 82In the list view/search dialog you can quickly assign categories to all selected items.
82 You can choose 83 You can choose
83 -to add a selection of categories to the list of categories 84 -to add a selection of categories to the list of categories
84 -to set a selection of categories as the new list of categories 85 -to set a selection of categories as the new list of categories
85You can specify a color to every categorie. 86You can specify a color to every categorie.
86 The events/tasks of this categorie are displayed with this color in the agenda view. 87 The events/tasks of this categorie are displayed with this color in the agenda view.
87 You can configure, if the events/tasks categorie color is shown in todo view/month view as well. 88 You can configure, if the events/tasks categorie color is shown in todo view/month view as well.
884) 894)
89Cancelling of items: 90Cancelling of items:
90You can cancel an event/todo without deleting them. 91You can cancel an event/todo without deleting them.
91The cancelled event/todo is then displayed stricked out. 92The cancelled event/todo is then displayed stricked out.
925) 935)
93Addressbook access: 94Addressbook access:
94You can access address entries stored in KA/Pi. 95You can access address entries stored in KA/Pi.
95You cam import birtdays from KA/Pi. 96You cam import birtdays from KA/Pi.
96In KA/Pi you can configure a new resource to get read-only acces to Opie addressbook data. 97In KA/Pi you can configure a new resource to get read-only acces to Opie addressbook data.
976) 986)
98Quick editing: 99Quick editing:
99You can quickly clone, move, cancel, beam events/todos. 100You can quickly clone, move, cancel, beam events/todos.
100When dragging a recurrent event in agenda view, this recurrence is automatically added to the list of recurrence exceptions and a non-recurring clone is created. 101When dragging a recurrent event in agenda view, this recurrence is automatically added to the list of recurrence exceptions and a non-recurring clone is created.
101If you click on a day number in month view, a new edit event dialog pops up. 102If you click on a day number in month view, a new edit event dialog pops up.
1027) 1037)
103Fast navigation: 104Fast navigation:
104There are many shortcuts for fast changing the view. Please refer to shortcut-key description. 105There are many shortcuts for fast changing the view. Please refer to shortcut-key description.
105If you click on the week number in month view, this week is shown in agenda view. 106If you click on the week number in month view, this week is shown in agenda view.
1068) 1078)
107Printing: 108Printing:
108On the desktop version, you can print out a vertical range of the agenda view "as you see it". 109On the desktop version, you can print out a vertical range of the agenda view "as you see it".
109And you can print on the desktop version a day view, three kinds of a week view and a month view. 110And you can print on the desktop version a day view, three kinds of a week view and a month view.
110You can print the todo list as well. 111You can print the todo list as well.
1119) 1129)
112Configuration: 113Configuration:
113There are many advanced configuration possibilities. 114There are many advanced configuration possibilities.
114You can configure for every item in the toolbar, whether it should be shown or not. 115You can configure for every item in the toolbar, whether it should be shown or not.
115There are two item sizes for toolbar icons available. (Useful for 5x00 user and small display). 116There are two item sizes for toolbar icons available. (Useful for 5x00 user and small display).
116You can configure the font/fontsize for every view. 117You can configure the font/fontsize for every view.
11710) 11810)
118Language: 119Language:
119KO/Pi is available in English, German, French and Italian. 120KO/Pi is available in English, German, French and Italian.
12011) 12111)
121Alarm: 122Alarm:
122For Zaurus there is an alarm applet available with additional timer functionality. 123For Zaurus there is an alarm applet available with additional timer functionality.
123This alarm applet will make the Zaurus wake up, if the device is in suspend mode. 124This alarm applet will make the Zaurus wake up, if the device is in suspend mode.
124On the desktop (e.g. Windows) you can enable in KO/Pi the internal alarm notification, 125On the desktop (e.g. Windows) you can enable in KO/Pi the internal alarm notification,
125such that you are informed about an alarm, if the program is running. 126such that you are informed about an alarm, if the program is running.
12612) 12712)
127What'sThis Help: 128What'sThis Help:
128To use the What'sThis Help, you have to enable the What'sThis icon in the toolbar. 129To use the What'sThis Help, you have to enable the What'sThis icon in the toolbar.
129(Choose menu: ME-Toolbar or Action-Configure Toolbar ). 130(Choose menu: ME-Toolbar or Action-Configure Toolbar ).
130(You have to restart to reload the changed toolbar config). 131(You have to restart to reload the changed toolbar config).
131Now click on the QWhat'sThis Icon 132Now click on the QWhat'sThis Icon
132in the top right corner of KO/Pi. 133in the top right corner of KO/Pi.
133Then click now after that on an item in the Agenda View or in the month view 134Then click now after that on an item in the Agenda View or in the month view
134you will get a detailed display of the items content. 135you will get a detailed display of the items content.
135 136
136 137
137 138
138****************************************************** 139******************************************************
139B) Useful features, that are not straighforward to see 140B) Useful features, that are not straighforward to see
140****************************************************** 141******************************************************
141 142
1421) Right mouse click on Zaurus 1431) Right mouse click on Zaurus
1432) Moving of items in the agenda view 1442) Moving of items in the agenda view
1443) Creating exceptions for recurring events 1453) Creating exceptions for recurring events
1454) Navigation in month view 1464) Navigation in month view
1465) Navigation in agenda view 1475) Navigation in agenda view
1476) Monthview as week view 1486) Monthview as week view
1487) Switching display mode in date edit 1497) Switching display mode in date edit
1498) Recurring todos 1508) Recurring todos
150 151
1511) 1521)
152Right mouse click on Zaurus: 153Right mouse click on Zaurus:
153In KO/Pi on the desktop a right mouse click will popup an menu on some items. 154In KO/Pi on the desktop a right mouse click will popup an menu on some items.
154On the Zaurus there can only the stylus be used. 155On the Zaurus there can only the stylus be used.
155To simulte a right mouse click with the stylus press is and hold it down 156To simulte a right mouse click with the stylus press is and hold it down
156for 1-2 seconds. If you release it then, a menu pops up, if there is 157for 1-2 seconds. If you release it then, a menu pops up, if there is
157a menu available for this particular item. 158a menu available for this particular item.
158On some places the menu pops up without releasing the stylus. 159On some places the menu pops up without releasing the stylus.
159That bevaviour is not a bug, it is caused by the the behaviour of the 160That bevaviour is not a bug, it is caused by the the behaviour of the
160single left click on the item. 161single left click on the item.
161 162
1622) 1632)
163Moving of items in the agenda view: 164Moving of items in the agenda view:
164In the agenda view you can move an item by clicking on it and holding 165In the agenda view you can move an item by clicking on it and holding
165the mouse down. 166the mouse down.
166You have to move the mouse some distance before the items actually 167You have to move the mouse some distance before the items actually
167starts to move. That is not abug, that is a feature to prevent 168starts to move. That is not abug, that is a feature to prevent
168you to make unwanted moves of the item when you click on it(and moving the 169you to make unwanted moves of the item when you click on it(and moving the
169mouse only a small distance with this click) 170mouse only a small distance with this click)
170 171
1713) 1723)
172Creating exceptions for recurring events: 173Creating exceptions for recurring events:
173To create an exception for a recurring event, 174To create an exception for a recurring event,
174move this event in the agenda view. 175move this event in the agenda view.
175This recurrence is automatically added to the list 176This recurrence is automatically added to the list
176of recurrence exceptions and a non-recurring clone is created. 177of recurrence exceptions and a non-recurring clone is created.
177To cancel a single recurrence, create an exception by moving it 178To cancel a single recurrence, create an exception by moving it
178and then move it back and cancel it. 179and then move it back and cancel it.
179 180
1804) 1814)
181Navigation in month view: 182Navigation in month view:
182If you select the month view with the icon in the toolbar, 183If you select the month view with the icon in the toolbar,
183the selected data range in the date navigator 184the selected data range in the date navigator
184is set automatically to the complete month. 185is set automatically to the complete month.
185(Click on month view and then the space bar to see the 186(Click on month view and then the space bar to see the
186selected data range in the date navigator). 187selected data range in the date navigator).
187If you select in the data navigator 188If you select in the data navigator
188(automatically by clicking on the month view or manually) 189(automatically by clicking on the month view or manually)
189a date range from the first of the month to the 190a date range from the first of the month to the
19028.-31. of the month (the 28.-31. is valid for every month!) 19128.-31. of the month (the 28.-31. is valid for every month!)
191then the (month-)navigation keys will select automatically the 192then the (month-)navigation keys will select automatically the
192complete next month as date range. 193complete next month as date range.
193 194
1945) 1955)
195Navigation in agenda view: 196Navigation in agenda view:
196If you select (as an example) 4 days in the date navigator 197If you select (as an example) 4 days in the date navigator
197the (week-) navigation key will select the same 4 days in the next week. 198the (week-) navigation key will select the same 4 days in the next week.
198If you want to get the next 4 days after the selected 4 days selected, 199If you want to get the next 4 days after the selected 4 days selected,
199you have to switch the navigation mode to "next days mode" 200you have to switch the navigation mode to "next days mode"
200by clicking on the next days icons. 201by clicking on the next days icons.
201Now the next days from today are selected, but after selecting 202Now the next days from today are selected, but after selecting
2024 days in the day navigator the (week-) navigation key 2034 days in the day navigator the (week-) navigation key
203will select the next 4 days. 204will select the next 4 days.
204The "next days mode" is turned off by clicking on the 205The "next days mode" is turned off by clicking on the
205week view, work week view or day view button. 206week view, work week view or day view button.
206The agenda view has "time labels" on the left, which displays the hours from 0-24. 207The agenda view has "time labels" on the left, which displays the hours from 0-24.
207If you press the mouse on the timelabels and move it up/down you can 208If you press the mouse on the timelabels and move it up/down you can
208increase/decrease the agenda size quickly. 209increase/decrease the agenda size quickly.
209 In the agenda view you can click on the day labels (e.g. Mon 14) 210 In the agenda view you can click on the day labels (e.g. Mon 14)
210to see the selected date in single day mode. 211to see the selected date in single day mode.
211If you click in single day mode the day label you will switch back to 212If you click in single day mode the day label you will switch back to
212the previously selected date range. 213the previously selected date range.
213Right of the day labels is a ">" button. 214Right of the day labels is a ">" button.
214If you click this button, you will go one day ahead. 215If you click this button, you will go one day ahead.
215Left of the day labels is the month name displayed. 216Left of the day labels is the month name displayed.
216If you click this button, the month view is shown. 217If you click this button, the month view is shown.
217 218
2186) 2196)
219Monthview as week view: 220Monthview as week view:
220On the left side of the monthview are the week number labels displayed. 221On the left side of the monthview are the week number labels displayed.
221If you click on these labels, the month view will show this week zoomed. 222If you click on these labels, the month view will show this week zoomed.
222To go back to monthly view click the left label again. 223To go back to monthly view click the left label again.
223You can quickly select a week number by clicking the black triangle 224You can quickly select a week number by clicking the black triangle
224on top of the week number labels. 225on top of the week number labels.
225 226
2267) 2277)
227Switching display mode in date edit: 228Switching display mode in date edit:
228On several places is a date edit used. 229On several places is a date edit used.
229You can scroll the dates by selecting the part of the date (month, day, year) 230You can scroll the dates by selecting the part of the date (month, day, year)
230in the lineedit and pressing the key up/key down key. 231in the lineedit and pressing the key up/key down key.
231The display mode of a date edit is initially short date mode. 232The display mode of a date edit is initially short date mode.