| -rw-r--r-- | Makefile | 1 | ||||
| -rw-r--r-- | Makefile.Embedded | 1 | ||||
| -rw-r--r-- | bin/kdepim/SyncHowto.txt | 117 | ||||
| -rw-r--r-- | version | 2 |
4 files changed, 103 insertions, 18 deletions
@@ -253,4 +253,5 @@ dist: endif mkipks pimTABicon.control + zip kdepim_$(KDEPIM_VERSION)_for_SharpRom.ipk.zip *.ipk tmake: objects \ diff --git a/Makefile.Embedded b/Makefile.Embedded index 467710f..a9ea199 100644 --- a/Makefile.Embedded +++ b/Makefile.Embedded @@ -253,4 +253,5 @@ dist: endif mkipks pimTABicon.control + zip kdepim_$(KDEPIM_VERSION)_for_SharpRom.ipk.zip *.ipk tmake: objects \ diff --git a/bin/kdepim/SyncHowto.txt b/bin/kdepim/SyncHowto.txt index 6c1da16..64f6f14 100644 --- a/bin/kdepim/SyncHowto.txt +++ b/bin/kdepim/SyncHowto.txt @@ -16,5 +16,6 @@ CONTENT: 3) Syncing background 4) Sync preferences -5) Details about sync profile kinds +5) How a filter works +6) Details about sync profile kinds ************************************************************************* @@ -25,5 +26,5 @@ Note: The recommended and easiest way to syncronize two devices where KO/Pi, KA/Pi or PWM/Pi is installed, is the profile kind "Pi-Sync". -Details about that in 5) b). +Details about that in 6) b). In KDE-Pim/Pi you can synchronize ( sync ) your calendar/addressbook/ @@ -91,5 +92,5 @@ d) Coose the profile kind of your syncing method: (iii) Remote file or (iiii) Mobile Phone. - Detailed explanation in 5) + Detailed explanation in 6) e) Choose the other profile options. Detailed explanation in 2) @@ -110,5 +111,5 @@ a) Local device name: b) Profile: -> 1) c) -c) Include in multiple sync: +c) Multiple Sync options: Include in multiple sync: In the Synchronize menu, there is a multiple sync menu entry. If you choose this menu entry, all user defined profiles with this @@ -116,11 +117,14 @@ c) Include in multiple sync: one after another. And this twice. This will take some time. After that sync, on all devices should be the same data. + +d)- j) Sync algo options: + d) Ask for preferences before sync: - Check this to be asked for sync preferences settings before each sync. + Check this to be asked for "Sync preferences" settings before each sync. If the profile kind is "Pi-Sync" you will be asked to confirm the "Pi-Sync" specific settings (Password,IP address, port number) as well. That makes it possible to use that profile for a device that is connected via DHCP to the network and gets different - IP addresses when connection to the network. + IP addresses when connecting to the network. e) Sync preferences: Choose here your sync preferences. @@ -129,4 +133,19 @@ f) Show summary after sync: Check this to get a small summary dialog after sync about number of added/changed/deleted events on local/remote. +g) Apply filter when adding data to local: + What is a filter? You can read this in -> 5) + With this option you can specify a filter for events/contacts, + which should be added to the local database, because they are + in the remote database and not in the local database. + (Database = calendar file or addressbook file). + Note that the filter is NOT applied to the remote + database before syncing. It is only applied to a particular + item which should be added to the local database. + Well, but what is the difference? + The differnce is: If the remote database AND the local database contain + an already synced item, which does not match the filter, then this item is synced. + If the remote database contains an item which does not match the filter + and the local database does not contain this item, then this item is not added + to the local database, but it is still in the remote database after syncing. g) Write back synced data: Uncheck this to update the local calendar only. @@ -135,19 +154,49 @@ g) Write back synced data: If you uncheck "Write back synced data", the settings under h) and i) are ignored, of course. -h) --Write back (on remote) existing entries only: + +h) - j) Write back options: + +h) Write back (on remote) existing entries only: Check this to update the remote data only. I.e. no data from yor local calendar/addressbook is added to the remote device. You may use this option to sync against some kind of "public calendar/addressbook" without - writing back your personal data. -i) --Write back (calendar) entries in future only: - Check this to write back only calendar entries in future. + adding anything of your personal data. + But in this case, you cannot add an item to the remoet device. +i) Apply filter when adding data to remote: + What is a filter? You can read this in -> 5) + With this option you can specify a filter for events/contacts, + which should be added to the remote database, because they are + in the local database and not in the remote database. + (Database = calendar file or addressbook file). + Note that the filter is NOT applied to the local + database before syncing. It is only applied to a particular + item of the local database which should be added to the remote database. + Well, but what is the difference? + The differnce is: If the local database AND the remote database contain + an already synced item, which does not match the filter, then this item is synced. + If the local database contains an item which does not match the filter + and the remote database does not contain this item, then this item is not added + to the remote database, but it is still in the local database after syncing. + Example: + You have specified a calendar filter "only public events". + You specify this filter as the outgoing filter for syncing. + If there is an event in the local database which is not "public", but "private", + this event is not added to the remote database. + If there is an event in the local database and in the remote database which is + "private" (maybe added by someone else) then this event is synced and + it is in the local database and in the remote database after syncing. + That means in particular you cannot remove an event from the remote + database but setting it to "private". + If you want to remove the event you can clone it, set it to private and delete the + original event. Then the original event is deleted in the remote database after sync and + the cloned event is not added to the remote database, because it is private. +j) Write back (calendar) entries for time period only: + Check this to write back only calendar entries for a given time period. (Useful when syncing with mobile phones.) - You can specify the date range in weeks with - ---- Max. weeks in future. - Note: The date range starts always 7 days before the actual date! - I.e. the calendar events of the last week are written back always. -j) Profile kind: - Details -> 5) + You can specify the date range in weeks for the weeks in the past to the weeks in the future. + +k) Profile kind: + Details -> 6) ************************************************************************* @@ -242,5 +291,39 @@ SYNC PREFERENCES: ************************************************************************* -5) Details about sync profile kinds +5) How a filter works +************************************************************************* + +A filter is a rule to decide if a particular item +(calendar iten item or contact item) belongs to a set of items. +For example, you can specify a set as: +Only items, that belongs to that category. +Or: Only items, that does not belong to that category. +Or: Only items, that are public. + +If you specify a filter in a syncing profile, you can set the +rules of adding items to the local or remote database. + +Example: +You have a public calendar in your company, which contains all +company relevant data. + +You have different projects in the company and for project specific events +is always set the project name as a category: +E.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. + +You 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. + +************************************************************************* +6) Details about sync profile kinds ************************************************************************* @@ -1 +1 @@ -version = "1.9.17"; +version = "1.9.18"; |