added readmes

6 files changed, 282 insertions, 34 deletions

diff --git a/bin/.kdbgrc.kopi b/bin/.kdbgrc.kopi
deleted file mode 100644
index a48d84f..0000000
--- a/bin/.kdbgrc.kopi
+++ b/dev/null
@@ -1,28 +0,0 @@
-[Breakpoint 0]
-Enabled=true
-File=mainwindow.cpp
-Line=94
-Temporary=false
-
-[Breakpoint 1]
-Enabled=true
-File=mainwindow.cpp
-Line=86
-Temporary=false
-
-[Breakpoint 2]
-Enabled=true
-File=koagenda.cpp
-Line=1329
-Temporary=false
-
-[General]
-DebuggerCmdStr=
-FileVersion=1
-ProgramArgs=
-TTYLevel=7
-WorkingDirectory=
-
-[Memory]
-ColumnWidths=80,0
-NumExprs=0
diff --git a/bin/ReadMe.txt b/bin/ReadMe.txt
deleted file mode 100644
index 361cf1f..0000000
--- a/bin/ReadMe.txt
+++ b/dev/null
@@ -1,6 +0,0 @@
-This is the Windows version of KO/Pi or KA/Pi. (www.pi-sync.net).
-In order to know what files you need to run it on windows and to install it,
-please read the migration HowTo (file Migration-HowTo.txt) in the same dir
-as this file.
-KO/Pi or KA/Pi are licensed under the GPL.
-Please read the file kdepim/LICENCE.TXT
diff --git a/bin/ReadMe_Linux.txt b/bin/ReadMe_Linux.txt
new file mode 100644
index 0000000..a487313
--- a/dev/null
+++ b/bin/ReadMe_Linux.txt
@@ -0,0 +1,106 @@
+This is the Linux desktop (SuSE 9.1 or later) 
+version of KO/Pi and KA/Pi (www.pi-sync.net),
+the platform independent PIM programs based on the PIM programs 
+(KOrganizer and KAddressbook) of KDE (www.kdeorg). 
+
+KO/Pi or KA/Pi are licensed under the GPL.
+Please read the file kdepim/LICENCE.TXT
+
+
+Contents of the packages and how to install:
+
+*****************************************************
+4) Linux Desktop (SuSE 9.1)
+*****************************************************
+Filename: KDE-Pim-Pi-1.9.10-SuSE9.1.i586.rpm
+Package contains:
+KAddessbook/Pi
+KOrganizer/Pi
+PasswordManager/Pi
+KPhone/Pi
+KTimeTracker/Pi
+and the needed microkde libs.
+
+Download file and install it on console with
+su
+rpm -ihv KDE-Pim-Pi-1.9.10-SuSE9.1.i586.rpm
+Note:
+   If you want to update, please do it with
+   rpm -Uhv KDE-Pim-Pi-1.9.10-SuSE9.1.i586.rpm
+
+
+If you want to be able to sync your phone via infrared
+(if you have an infrared port on your laptop)
+please make an online update to get infrared working.
+
+If you want to be able to sync KDE-Pim/Pi with the KDE-desktop
+please update SuSE 9.1 to KDE 3.3.0 or higher.
+NOTE:
+Currently only syncing of calendar data is supported by
+the KDE-Pim/Pi <-> KDE-desktop sync feature.
+Possibility of syncing addressbook data will follow before
+release 2.0.0 of KDE-Pim/Pi.
+
+Here is the information,
+provided in the rpm file about the content:
+
+KDE-Pim-Pi
+Version: 1.9.10-SuSE9.1
+This package contains the platform-independent PIM programs from
+www.pi-sync.net, compiled for SuSE 9.1:
+KTimeTacker/Pi
+KPhone/Pi
+KAddressbook/Pi
+KOrganizer/Pi
+PasswordManager/Pi
+These applications do not need anything from the KDE-desktop
+at all to run on Linux. However, there is a dependency from
+two KDE libs, because a small command line program is included
+to make it possible to sync with the KDE-desktop applications.
+These applications are independent from the KDE-desktop
+environment. That means, nothing of your existing
+KDE-desktop setup will be changed, or any data
+(calendar-addressbook) used by the KDE-desktop
+applications will be changed or accessed.
+These applications stores their data and config in
+$HOME/kdepim/
+However, because the same file format is used,
+an easy exchange of data with the KDE-desktop
+is possible.
+A small command line program is included
+to make it possible to sync with the KDE-desktop applications.
+You do not need to call this program from the commandline,
+it is called from the KDE-Pim/Pi apps when you choose there:
+Sync with KDE_Desktop.
+If something is going wrong, please start the
+KDE-Pim/Pi program itself from the console to get detailed output.
+After installation, you should have a
+PIM-pi
+folder in your KDE start menu, where you can
+start the applications from.
+These programs makes it possible to sync your Zaurus easily
+(with the KDE-Pim/Pi programs running on the Zaurus)
+with the KDE-desktop calendar/addressbook data.
+If you want to use that, you have to update your
+KDE-desktop to version 3.3.0 or higher.
+Actually - after the (non difficult) configuration is set up -
+with two mouseklicks on the Zaurus,
+the Zaurus syncs with the corresponding KDE-Pim/Pi
+program on the Linux Desktop which syncs automatically
+with the KDE-desktop data.
+If you want to use the KDE-desktop calendar/addressbook applications,
+just install these apps in this package and use them as a syncing tool for the
+Zaurus <-> KDE-desktop sync.
+The sync requires a network connection from your Zaurus to
+the PC. A detailed Sync HowTo is available in the
+Help menu of the applications.
+These applications makes it also possible, that you can sync
+(or just export the data to) your mobile phone with your
+data of the KDE-desktop calendar/addressbook applications.
+This is tested and working for Nokia mobile phones,
+it may work with others as well.
+(More info about that: -> Sync HowTo)
+NOTE:
+You have to make an online update in SuSE 9.1 to make it
+possible to get the infrared connection working, such that
+you can sync your (Nokia) mobile phone via infrared.
diff --git a/bin/ReadMe_Windows.txt b/bin/ReadMe_Windows.txt
new file mode 100644
index 0000000..47c7002
--- a/dev/null
+++ b/bin/ReadMe_Windows.txt
@@ -0,0 +1,24 @@
+This is the Windows version of KO/Pi and KA/Pi (www.pi-sync.net),
+the platform independent PIM programs based on the PIM programs 
+(KOrganizer and KAddressbook) of KDE (www.kdeorg). 
+
+KO/Pi or KA/Pi are licensed under the GPL.
+Please read the file kdepim/LICENCE.TXT
+
+
+Contents of the packages and how to install:
+
+*****************************************************
+1) Windows 32
+*****************************************************
+Filename: kdepim_1.9.11_for_Windows.exe.zip
+Package contains:
+KO/Pi
+KA/Pi
+Phone access(kammu.exe)
+Libs for file, dir, qtopia resources.
+
+Download file.
+Unzip the file, then you are almost done.
+For details read the file
+Migration-Howto.txt in the package.
diff --git a/bin/ReadMe_Zaurus.txt b/bin/ReadMe_Zaurus.txt
new file mode 100644
index 0000000..f29e549
--- a/dev/null
+++ b/bin/ReadMe_Zaurus.txt
@@ -0,0 +1,148 @@
+This is the Zaurus version of KO/Pi and KA/Pi (www.pi-sync.net),
+the platform independent PIM programs based on the PIM programs 
+(KOrganizer and KAddressbook) of KDE (www.kdeorg). 
+
+KO/Pi or KA/Pi are licensed under the GPL.
+Please read the file kdepim/LICENCE.TXT
+
+This ReadMe is included in two different packages.
+Depending if the filename of the package, please read
+section 2) or 3)
+
+*****************************************************
+2) Zaurus Sharp ROM, gcc 2.95 compiled
+*****************************************************
+Filename: kdepim_X.X.X_for_SharpROM.ipk.zip
+Package contains:
+kaddressbook_X.X.X_arm.ipk
+korganizer-alarm_X.X.X_arm.ipk
+kmicrokdelibs_X.X.X_arm.ipk
+kmobilephoneaccess_X.X.X_arm.ipk
+ksharpPIM-DTMaccess_X.X.X_arm.ipk
+kopiemail_X.X.X_arm.ipk
+pimTABicon_X.X.X_arm.ipk
+korganizer_X.X.X_arm.ipk
+pwmanager_X.X.X_arm.ipk
+
+This package is for users of the Sharp ROM and clones.
+Users of old OpenZaurus releases, which are gcc2.95
+compiled can use it as well.
+
+CONTENT:
+
+File kmicrokdelibs_X.X.X_arm.ipk:
+  The libs in this file are needed to run
+  any of the included programs.
+  Install it.
+
+File kaddressbook_X.X.X_arm.ipk:
+  Contains KA/Pi addressbook program and needed additional libs.
+
+File korganizer-alarm_X.X.X_arm.ipk:
+  Contains KO/Pi calendar program and needed additional libs.
+
+File kopiemail_X.X.X_arm.ipk:
+  Contains OM/Pi email program and needed additional libs.
+
+File pwmanager_X.X.X_arm.ipk:
+  Contains PwM/Pi password manager program.
+
+File ksharpPIM-DTMaccess_X.X.X_arm.ipk:
+  Contains needed program/lib to sync KA/Pi and KO/Pi
+  with the Sharp PIM applications on the Zaurus,
+  which use the new Sharp DMT Pim format.
+
+File korganizer-alarm_X.X.X_arm.ipk:
+   Provides an alarm applet to get informed about alarms.
+   The Zaurus will wake up from suspend
+   if an event triggers an alarm.
+
+File kmobilephoneaccess_X.X.X_arm.ipk:
+  Contains a command line tool for accessing mobile phones.
+  It is used from Kx/Pi to sync with / export to
+  mobile phones. It is not working very well, please do not
+  expect too much.
+
+File pimTABicon_X.X.X_arm.ipk:
+  If you insatll a program of the package, you may get
+  a new TAB wchich is called Pim.
+  If you did not have had this TAB on your Z, that
+  TAB will not display an icon.
+  Install this small package to assihn an icon to 
+  the new Pim TAB. 
+
+
+Unzip package and install the apps in the usual way.
+
+*****************************************************
+3) OpenZaurus ROM, gcc 3.xx compiled
+*****************************************************
+Filename: kdepim_X.X.X_for_OZ-gcc3xx.ipk.zip
+Package contains:
+kaddressbook_OZ-gcc3xx_X.X.X_arm.ipk
+kmicrokdelibs_OZ-gcc3xx_X.X.X_arm.ipk
+kopiemail_OZ-gcc3xx_X.X.X_arm.ipk
+korganizer-alarm_OZ-gcc3xx_X.X.X_arm.ipk
+korganizer_OZ-gcc3xx_X.X.X_arm.ipk
+kmobilephoneaccess_OZ-gcc3xx_X.X.X_arm.ipk
+pimTABicon_OZ-gcc3xx_X.X.X_arm.ipk
+pwmanager_OZ-gcc3xx_X.X.X_arm.ipk
+
+
+This package is for users of the Open Zaurus ROM 3.3.6,
+compiled by coredump (aka known as Hentges-Rom).
+The programs may run on the new
+Open Zaurus Release 3.5.1 as well, but
+they cannot be installed there properly,
+because the package manager of OZ needs more
+information in the ipk files to install them properly.
+
+If you have Open Zaurus 3.5.1, you should use
+the packages of the OZ 3.5.1 feed,
+compiled and maintained by Hrw.
+Do not ask the OZ people about problems with these
+packages, they cannot help you.
+
+CONTENT:
+
+By the way, I cannot help you as well, because I
+am not using OZ.
+
+File kmicrokdelibs_OZ-gcc3xx_X.X.X_arm.ipk:
+  The libs in this file are needed to run
+  any of the included programs.
+  Install it.
+
+File kaddressbook_OZ-gcc3xx_X.X.X_arm.ipk:
+  Contains KA/Pi addressbook program and needed additional libs.
+
+File korganizer-alarm_OZ-gcc3xx_X.X.X_arm.ipk:
+  Contains KO/Pi calendar program and needed additional libs.
+
+File kopiemail_OZ-gcc3xx_X.X.X_arm.ipk:
+  Contains OM/Pi email program and needed additional libs.
+
+File pwmanager_OZ-gcc3xx_X.X.X_arm.ipk:
+  Contains PwM/Pi password manager program.
+
+File korganizer-alarm_OZ-gcc3xx_X.X.X_arm.ipk:
+   Provides an alarm applet to get informed about alarms.
+   The Zaurus will wake up from suspend
+   if an event triggers an alarm.
+
+File kmobilephoneaccess_OZ-gcc3xx_X.X.X_arm.ipk:
+  Contains a command line tool for accessing mobile phones.
+  It is used from Kx/Pi to sync with / export to
+  mobile phones. It is not working very well, please do not
+  expect too much.
+
+File pimTABicon_OZ-gcc3xx_X.X.X_arm.ipk:
+  If you insatll a program of the package, you may get
+  a new TAB wchich is called Pim.
+  If you did not have had this TAB on your Z, that
+  TAB will not display an icon.
+  Install this small package to assihn an icon to 
+  the new Pim TAB. 
+
+Unzip package and install the apps in the usual way. 
+
diff --git a/bin/kdepim/WhatsNew.txt b/bin/kdepim/WhatsNew.txt
index 98d6bdd..41b3e45 100644
--- a/bin/kdepim/WhatsNew.txt
+++ b/bin/kdepim/WhatsNew.txt
@@ -1,227 +1,231 @@
 Info about the changes in new versions of KDE-Pim/Pi
 
 ********** VERSION 1.9.11 ************
 
 Fixed several problems in PWM/Pi, like
 asking the user, if unsaved changed are pending
 when closing the app.
 
 Fixed a crash in KO/Pi , when importing/loading vcs files
 which have an entry with an attendee with state:
 NEEDS ACTION
 
 Fixed some problems in the German translation of OM/Pi,
 which makes some dialogs not fitting on the screen
 of the Z 5500.
 
 Fixed Qtopia crash, when disabling/deinstalling
 KO/Pi alarm applet.
 
 Implemented direct KDE<->KA/Pi sync for KA/Pi running 
 on Linux desktop.
 
 Added "remove sync info" to sync menu.
 
 Tweaked the KO/Pi What's next view a bit, added
 setting to hide events that are done.
 
 Disabled "beam receive enabled" on startup to 
 avoid problems if Fastload is enabled.
 Please set "beam receive enabled",
 if you want to receive data via IR.
 
 Fixed bug in  direct KDE<->KO/Pi sync for KO/Pi running 
 on Linux desktop.
 
+Made in KA/Pi scrolling possible, if details view is selected.
+
+
+
 
 ********** VERSION 1.9.10 ************
 
 Many internal small bugfixes.
 And fix of the "big" bug in KO/Pi, 
 that after Syncing the appointments had an offset by several hours.
 That was a problem with the internal timezone setting,
 introduced by the changed timezone configuration settings.
 
 German translation for OM/Pi is now available.
 
 
 ********** VERSION 1.9.9 ************
 
 KDE-Pim/Pi has a new Member!
 It is called PWM/Pi (Passwordmanager/platform-independent) 
 and it is available for the Zaurus.
 It is planned, that it will be available later for Windows.
 (And for Linux, of course).
 It is a port of the Passwordmanager of KDE.
 It will need the MicroKDElibs to run.
 
 Made loading of addressbooks in KA/Pi up to 7 times faster!
 The bigger your addressbook file, the more starting speed 
 will you gain. (relatively)
 
 The Qtopia addressbook connector is now platform independend
 as well and should work on any platform for importing/exporting
 Qtopia and Opie XML files.
 
 Added a +30min feature to the timezone settings to make 
 KDE-Pim/Pi useable in Australia and other parts on the 
 world with strange timezones ;-)
 
 German "Umlaute" should now be sorted correctly on the Z in KA/Pi.
 
 It is now possible to disable the
 "receive data via infrared" feature, such that syncing with
 Outlook is now possible again with Kx/Pi runing.
 Please disable it, before syncing Sharp DTM with Outlook.
 For your convenience, the "receive data via infrared" feature
 is disabled automatically, if you sync Kx/Pi with DTM.
 You have to enable it again manually after syncing.
 Enabling this feature makes it impossible to start the
 Sharp DTM apps. If this feature is enabled, you will only get the 
 alarm notification from KO/Pi and not from the Sharp calendar.
 This is very useful if you sync KO/Pi with Sharp DTM,
 because after syncing you usually would get notified about
 an alarm by KO/Pi and the Sharp Calendar.
 
 Together with the Linux desktop version of KO/Pi
 it is now possible to sync KO/Pi on the Zaurus
 with the complete KDE-desktop (3.3 or later)
 calendar data easily.
 That makes it possible to sync the Z with one 
 click of a mouse with the KDE-Desktop.
 This feature it available for all Zaurus platforms KO/Pi
 is running on.
 The only thing needed is a running KO/Pi on Linux and
 a compiled version of the small 
 KDE-Pim/Pi<->KDE-Desktop access command line program, 
 which is in the KDE-Pim/Pi sources available.
 
 The "KDE-desktop" syncing feature for KA/Pi will follow
 in the next releases.
 
 Fixed the vcard export bug, which had the version 1.9.8.
 
 Added missing GERMAN translation to KO/Pi.
 Hi PsionX, could you add the missing french translation?Thx!
 
 Translation files for KA/Pi are available as well.
 GERMAN translation will be available in the next release.
 PsionX ( yres, you again ;-) ), could you start translating
 KA/Pi? Thx!
 
 You can download the version 1.9.9 at
 
 http://sourceforge.net/project/showfiles.php?group_id=104103&package_id=112604
 
 Note:
 To run the mail program OM/Pi you need libopenssl.
 A link to a download loaction is available at
 ZSI at www.killefiz.de
 
 
 ********** VERSION 1.9.8 ************
 
 Fixed character decoding in OM/Pi.
 (e.g. German "Umlaute" were not displayed properly.)
 
 Made is possible to reparent todos in KO/Pi.
 Use contextmenu or keys (look at Help-Keys + Colors) for that.
 
 Added the missing Sync-Howto and WhatsNew to the packages.
 
 KO/Pi on Linux desktop can now sync with KDE desktop.
 That means: When using KO/Pi on Linux desktop for syncing with
 KDE desktop and the Zaurus, the Zaurus can be synced now
 with all KDE-Calendar resources, not only with one local file.
 (That makes it possible to sync the Zaurus with the 
 calendar data on a Kolab server) 
 
 KA/Pi syncing with KDE desktop will be available in the next version.
 
 
 ********** VERSION 1.9.7 ************
 
 KO/Pi - KA/Pi on Windows:
 Now a directory can be defined by the user, where the 
 application/config data should be saved.
   Define your desired path in the evironment variable
   MICROKDEHOME
   before starting KO/Pi or KA/Pi.
 
 An easy Kx/Pi to Kx/Pi syncing is now possible 
 (it is called Pi-Sync) via network.
 Please look at the Sync Howto.
 
 Exporting of calendar data and contacts to mobile phones is now possible.
 The SyncHowto is updated with information howto
 access/sync mobile phones. 
 Please look at the Sync Howto.
 
 Now KO/Pi and KA/Pi on the Zaurus can receive data via infrared directly.
 Please disable Fastload for the original contact/calendar applications
 and close them.
 KO/Pi and KA/Pi must be running in order to receive the data.
 (KO/Pi and KA/Pi are always running if Fastload for them is enabled!)
 
 In the KA/Pi details view are now the preferred tel. numbers displayed on top 
 of the other data ( emails/tel.numbers/addresses)
 
 Fixed some syncing problems in KA/Pi.
 
 Added font settings for the KA/Pi details view.
 Added fields "children's name" and "gender" to KA/Pi.
 
 Made searching in KA/Pi better:
 Now the first item in a view is selected after a search automatically and
 the views can be scrolled up/down when the search input field has the keyboard focus.
 
 And, of course, fixed a bunch of reported bugs in KO/Pi and KA/Pi.
 
 
 ********** VERSION 1.9.6 ************
 
 Changes in the external application communication on the Zaurus 
 in order to use less RAM when the apps are running.
 First syncing of addressbooks (KA/Pi) is possible.
 
 
 ********** VERSION 1.9.5a ************
 
 Fixed a bug in KO/Pi in the SharpDTM sync of version 1.9.5.
 Fixed some small bugs.
 KA/Pi shows now the birthday in summary view.
 Now OM/Pi and KA/Pi are using the date format defined in KO/Pi
 for displaying dates.
 
 
 ********** VERSION 1.9.5 ************
 
 There is still no Addressbook syncing!
 
 New in 1.9.5:
 
 Many bugfixes.
 Better searching in KA/Pi.
 You can configure in KA/Pi if you want to search only after 
 <return> key pressed.
 
 Better mail downloading in OM/Pi.
 
 First experimental alpha version of sync of KO/Pi with mobile phones.
 See gammu documentation for supported phones.
 You need to install the package kammu_1.9.5_arm.ipk for sync of KO/Pi with mobile phones. kammu_1.9.5_arm.ipk needs libbluetooth and libsdp.
 Quick hint how to use:
 NOTE: MOBILE PHONE SYNC IS EXPERIMENTAL!
 Install kammu_1.9.5_arm.ipk , libbluetooth and libsdp.
 Create syncprofile - mobile device
 Remove entry for model. (Leave empty ).
 Enable infrared on Zaurus and your Phone.
 Sync.
 To get a more detailed log, start kopi from konsole.
 
 ********** VERSION 1.9.4 ************
 
 This is the version 1.9.4 of KDE-Pim/Pi for the Zaurus.
 
 WARNING:
 PLEASE BACKUP ALL YOUR DATA!