Updated whats new info and FAQ

2 files changed, 65 insertions, 0 deletions

diff --git a/bin/kdepim/korganizer/kopiFAQ.txt b/bin/kdepim/korganizer/kopiFAQ.txt
index ae7a3c1..b87ef96 100644
--- a/bin/kdepim/korganizer/kopiFAQ.txt
+++ b/bin/kdepim/korganizer/kopiFAQ.txt
@@ -42,192 +42,209 @@ and then sync KO/Pi with Sharp-DTM.
 Voila - you have your Outlook data in KO/Pi.
 It is planned that KO/Pi windows version syncs directly with Outlook.
 *************************************************************************
 Q:  
 I sync with Outlook via the Sharp DTM.
 But, now, whenever I get an alarm I get notified by both KO/Pi 
 and the Sharp Calendar app. 
 How could I disable Sharp Calendar app?
 A:
 You have to rename datebook (the Sharp Calendar app)
 such that it cannot be automatically started by the system alarm daemon.
 If you rename it and you do not delete it, 
 you can do revert your changes easily.
 For example, rename
 /home/QtPalmtop/bin/datebook
 to
 /home/QtPalmtop/bin/datebookwech
 Then you can sync KO/Pi with the database 
 and then the database with outlook without problems.
 An event( with alarm ) created on outlook make KO/Pi alarm goes off,
 but there will be no datebook alarm :-)
 *************************************************************************
 Q:  
 I cannot sync Outlook with Sharp-DTM. How can I get my data from Outlook?
 A:
 There is a tool called Outport. 
 With that tool you can export your Outlook data to many small .ics files.
 To get one big .ics file to able to import the data quickly in KO/Pi 
 you can do the following on Linux:
 cat *.ics > mycalendar
 mv mycalendar mycalendar.ics
 Now you have one file, but kopi cannot read it.
 You have to remove all lines in the file 
 (take a texteditor where search and replace is done quickly ) which are:
 BEGIN:VCALENDAR
 END:VCALENDAR
 Only the very first 
 BEGIN:VCALENDAR and the very last 
 END:VCALENDAR may remain in the file.
 Now KO/Pi can read the modified file.
 *************************************************************************
 Q:  
 Why does not KO/Pi import several .isc files at once?
 A:
 Because it is not yet implemented.
 *************************************************************************
 Q:  
 Why does not KO/Pi sync directly with Outlook?
 A:
 Because it is not yet implemented.
 But it is planned to be implemented.
 *************************************************************************
 Q:  
 Why does KO/Pi start up on restarts?
 A:
 Fastload causes KO/Pi to startup when Qtopia starts.
 *************************************************************************
 Q:  
 Do I have to deinstall the KO/Pi alarm applet, when I update KO/Pi?
 A:
 No, the KO/Pi alarm applet runs completely independend of KO/Pi.
 That means, it does not need KO/Pi or libraries of KO/Pi for being
 executed. But the applet itself is not very useful without KO/Pi.
 It notifies KO/Pi to start via system calls.
 It needs KO/Pi to get the next alarm from the system alarm daemon.
 Such that the KO/Pi alarm alone may be used only as a timer application.
 Files of KO/Pi are ( with /home/QtPalmtop as base dir): 
 bin/kopi bin/db2file apps/Pim/korganizer.desktop pics/korganizer/* lib/libmicro*
 *************************************************************************
 Q:  
 I have problems updating KO/Pi. Any hints?
 A:
 When deinstalling KO/Pi alarm applet, Qtopia reboots.
 Please do not deinstall KO/Pi alarm applet and KO/Pi together.
 It may be that because of the reboot  KO/Pi itself is not deinstalled properly.
 *************************************************************************
 Q:  
 I installed the qtopiaKABC plugin, 
 but I can't access the addressbook when adding attendees.
 A:
 The qtopiaKABC plug-in is for old non DTM Qtopia Pims only.
 This plug-in works with xml based addressbooks.  
 There is no solution currently for the DTM addressbook.
 On a newer Sharp Rom (using DTM), you can install 
 Opie(for Sharp Rom) libs+adressbook and the opieKABC plug-in.
 That works with KO/Pi.
 *************************************************************************
 Q:  
 Why do I have two pim tabs?
 A:  
 The original tab has the 'PIM' tab and kopi is installed in the 'Pim' tab.  
 The difference in capitalization keeps them separate.
 That is no packaging bug.
 This is a feature.
 The author of KO/pi has a Tab 'Pim'.
 *************************************************************************
+Q:  
+When installing kmicrokdelibs_1.9.2_arm.ipk (or newer version)
+I get a "This application depends on other programs".
+What programs I am missing? 
+A:  
+You probably do not have to care about that.
+kmicrokdelibs_1.9.2 will come with some
+resource plugins, which needs additional libraries.
+(E.g. libopie1, if you want to use the 
+opie resource connector in KA/Pi).
+If you do not have this libraries installed,
+you simply cannot use the resource.
+To make it clear:
+If the libraries are missing, the applications
+using kmicrokdelibs will start, 
+because the resources are plugins.
+*************************************************************************
 *************************************************************************
 *************************************************************************
 
 Q:
 How do I change the timezone? All my appointments do show 6 hours ahead.
 A:
 The default timezone in KO/Pi is CET. 
 CET is (GMT +01:00) or (UTC +01:00), i.e GMT=UTC .
 To adjust the time of your appointments, 
 you have to change the timezone and reload your calendar without closing 
 the application and without saving the data.
 "Without saving the data" is very important. 
 Note that KO/Pi has build in auto saving. 
 If auto saving is performed after changing the timezone and before 
 reloading your calendar no  times will be changed.
 Example:
 Selected timezone in KO/Pi is (+01:00 Oslo).
 You have an appointment shown at 8:00. But it should be at 14:00.
 Your timezone is -05:00 US/Eastern.
 You have to do:
 Select timezone +07:00 Asia/Bangok in config dialog.
 Close dialog with ok button.
 Choose menu: File-Load Calendar Backup.
 Choose file: (your home path)/Applications/korganizer/mycalendar.ics
 (on Windows: file: (your home path)/korganizer/mycalendar.ics).
 Load file.
 Now your appointment is at 14:00.
 Select timezone -05:00 US/Eastern  in config dialog.
 Close KO/Pi (file is saved when closing and changes are not yet saved).
 Restart KO/Pi.
 Your timezone is -05:00 US/Eastern.
 Your appointment is at 14:00.
 Everything is ok.
 *************************************************************************
 Q:
 I want to send appointments via Infrared (IR) to a mobile device. 
 What format I have to choose?
 A:
 You can send data as vcs (vCalendar) or as ics (iCalendar) files. 
 With and without timezone settings( Local time ).
 Usually small mobile devices like mobile phones do not know anything about timezones.
 Choosing vcs and  Local time should work with most mobile phones.
 Most mobile devices should be able to recieve vcs files.
 If it is a smartphone or pda, the device may be able to handle timezones.
 Try vcs and with timezones.
 If you send the data to a laptop it depends on the application.
 If you have a windows laptop and want to get data into an 
 installed KO/Pi on windows, you should choose ics and with timezone. 
 Simply try it out, what data the device does understand.
 *************************************************************************
 Q:
 I want to send a friend all the public holidays in my calendar. Can I do that?
 A:
 Yes.
 Choose search dialog.
 Serach there after the events you want to send.
 Make sure, you get all wanted events and maybe some more.
 Maybe sort the items and select all items you want to send.
 With a 'right' mouse click 
 (hold pen down for a while and then relase) you get a popup menu.
 Choose there 'Save selected to file'.
 Now all selected entries are saved.
 Send the file to your friend, he can import them in his calendar now.
 *************************************************************************
 Q:
 I want to get another alarm sound than the default. What I have to change?
 A:
 The default alarm sound is a wav file:
 It is  (QPEDIR)/pics/korganizer/koalarm.wav.
 (Usually QPEDIR=/home/QtPalmtop).
 Just replace this file by another one und do a 
 'simulate alarm' to ckeck, if it works.
 Wav files can have different sampling data. 
 (e.g. 16/8bit, stereo/mono, 22kHz/11kHz/...)
 Note: It seems to be that there are problems with particular
 combination of these settings.
 If one file is not replayed properly, 
 just try another file/ another sampling data.
 *************************************************************************
 Q:
 Is there a solution to get an alarm on Windows?
 A:
 Yes, but KO/Pi has to be running to notify you about an alarm.
 Choose menu: Action - Configure.
 There the last TAB alarm.
 Check "Use internal alarm notification" to get the alarm on
 Windows and Linux desktop.
 You can configure the behaviour of the alarm there. 
 *************************************************************************
 Q:
 I have Zaurus 5600 and I want to get wav alarm instead of the buzzer.
 Is that possible?
 A:
 Yes.
 The default alarm kind is determined from the screen resolution.
 For all 320x240 displays the buzzer alarm is the default.
diff --git a/bin/kdepim/korganizer/kopiWhatsNew.txt b/bin/kdepim/korganizer/kopiWhatsNew.txt
index 662e45e..1b4e804 100644
--- a/bin/kdepim/korganizer/kopiWhatsNew.txt
+++ b/bin/kdepim/korganizer/kopiWhatsNew.txt
@@ -1,153 +1,201 @@
 Info about the changes in new versions of KO/Pi
 and KDE-Pim/Pi
 
 ********** VERSION 1.9.2 ************
 1)
 KDE-Pim/Pi has got a new member:
 KmicroMail (KM/Pi) is a mail program, 
 which can handle IMAP and POP mail access.
 It is based on Opie-Mail v3.
 All dependencies to the Opie libraries ar removed, 
 such that no additional Opie lib is needed.
 It is already integrated in KO/Pi and KA/Pi.
 It it now available for the Zaurus,probably it 
 will be available for other platforms later.
 Hint:
 Create your own contact (name + email)
 in KA/Pi, select this contact and choose menu:
 Settings - Set Who Am I.
 Now the settings of this contact are used as 
 the sender data in KM/Pi.
 2)
 KDE-Pim/Pi is split up in five different
 packages now precompiled for Sharp Zaurus:
 --kmicrokdelibs_1.9.2_arm.ipk
 The libs are needed for any 
 of the following programs:
 --kaddressbook_1.9.2_arm.ipk
 --kmicromail_1.9.2_arm.ipk
 --korganizer_1.9.2_arm.ipk
 Independ from that, there is the alarm applet
 available for KO/Pi, which also offers
 quick access for a new mail or
 showing the addressbook.:
 --korganizer-alarm_1.9.2_arm.ipk
 Independend means, that the alarm applet
 does not need any of the libs or programs above to run.
 But it would be quite useless without these programs.
+NOTE:
+If you get a
+"This application depends on other programs"
+during installation of 
+--kmicrokdelibs_1.9.2_arm.ipk
+you probably do not have to care about that.
+kmicrokdelibs_1.9.2 will come with some
+resource plugins, which needs additional libraries.
+(E.g. libopie1, if you want to use the 
+opie resource connector in KA/Pi).
+If you do not have this libraries installed,
+you simply cannot use the resource.
+To make it clear:
+If the libraries are missing, the applications
+using kmicrokdelibs will start, 
+because the resources are plugins.
 3)
 KO/Pi and friends are now installable on SD-Card!
 It is recommended to install all libs and apps
 on the SD card or all in the internal storage.
 There may be problems, if this is mixed.
 4)
 Fixed two bugs in the alarm notification on Windows.
 5)
 Great improvement!
 KO/Pi uses now the latest version of libical.
 Libical is the library which actually reads 
 the calendar files and extract the data from it.
 With the old version, there were problems
 (crashes or program hangs) when licical did read
 files, which were not stored from KO/Pi.
 I do not know, if the new libical works perfect,
 but actually it works much better than
 the old version.
 There are no problems with compatibility with 
 old calendar files of KO/Pi, of course!
+6)
+New in KA/Pi:
+Opie addressbook resource connector available!
+You will need libopie1 and the opie addressbook,
+of course.
+With the Opie addressbook resource connector,
+you can access the Opie addressbook readonly in KA/Pi.
+If you want to edit or import the data into KA/Pi,
+do this:
+a) Create an Opie resource.
+   (Menu: Settings-Configure Resources).
+After configuration and restarting KA/Pi you should see
+the Opie contacts in KA/Pi.
+b) Select some or all Opie contacts.
+(NOTE: +++++
+To know exactly, what contacts are Opie contacts, 
+do this: Choose menu: 
+View-Modify View - TAB Fields.
+Select in the above list "Resource" and click
+down arrow to add it to the "Selected fields".
+Click OK.
+Now you have a new column "Resource" in your list,
+where you can see, what an Opie resource is.
+++++ NOTE end.)
+Ok, we do have now some Opie contacts seleted.
+(Use SHIFT or CTRL key in order to multiple select).
+c) Choose menu: Edit-Copy.
+d) Choose menu: Edit-Paste.
+e) Select the resource, you want to add the contacts to.
+Congrats! Now you have read/write access to the copied 
+opie contacts as "real" KA/Pi contacts.
+
 
 ********** VERSION 1.9.1 ************
 1)
        +++ IMPORTANT 1 +++
 
 The storing place of the default calendar 
 file has changed!
 The default calendar file was
 Applications/korganizer/mycalendar.ics 
 on Zaurus and 
 (yourHomeDir)/korganizer/mycalendar.ics 
 on Windows/Linux desktop. Now it is
 (yourHomeDir)/kdepim/korganizer/mycalendar.ics
 on Zaurus, Windows and Linux.
 To load the old file, choose menu
 File-Load calendar backup.
 (It should be loaded automatically
 at startup with a warning message displayed).
 The place of the configuration file has changed too.
 If you want to use your old KO/Pi config,
 copy it to 
 (yourHomeDir)/kdepim/config/korganizerrc
 Please read VERSION 1.9.0 - topic 3) as well!
 
        +++ IMPORTANT 2 +++
 
 Because of the new paths, you will need
 a new version of the KO/Pi alarm applet
 for Zaurus.
 Use version >= 1.9.1
 
 2)
 Now the QWhat'sThis Icon works for items
 in the month view as well.
 (See VERSION 1.7.8 Topic 1) ).
 3)
 You can import birtsdays/anniversaries
 from KA/Pi into KO/Pi.
 Choose menu File-Import birthdays.
 If you import twice, already imported items
 will not be imported again, if they 
 have not been changed in KO/Pi.
 4)
 When syncing with sharp DTM, now a progress 
 is shown, when the data is written back.
 If there is much data in KO/Pi and no data
 in DTM, that can take a long time.
 (But only for the first time ).
 5)
 In the search dialog, you can search 
 now for the name/email of an attendee
 of an event/todo.
 To get more space for displaying
 search results, the buttons
 for "search" and "close" on the 
 bottom are removed in the PDA version. 
 You have to click OK in the top right
 corner to do a search.
 6)
 Now it is possible to disable the displaying
 of todo items in the Allday part of the Agenda.
 Choose Menu Action-Configure,
 TAB Todo View, checkbox
 "Allday Agenda view shows todos"
 7)
 If FastLoad is enabled, now the settings and the 
 calendar data are saved, when KO/Pi is closed.
 (If no Fastload is enabled, KO/Pi saves
 the data as well, of course)
 8)
 The Agenda View has a minimize-splitter now,
 such that the height of the allday part can be
 changed quickly.
 
 ********** VERSION 1.9.0 ************
 1)
 KO/Pi is now merged with the new microKDE from KA/Pi.
 KO/Pi accesses now KA/Pi as the addressbook.
 The other ddressbook-plugins are not working any longer.
 (It is planned, that later KA/Pi itself uses these plugins)
 New versions of KO/Pi are only available
 together with KA/Pi as the KDE-Pim/Pi package. 
 2)
 If you click on an attendee of a meeting in the
 event viewer, a detailed summary of the 
 attendee is shown.
 3)
 The place of the configuration file has changed.
 If you want to use your old KO/Pi config, copy
 Applications/korganizer/config_korganizerrc
 to
 Applications/korganizer/config/korganizerrc
 
 ********** VERSION 1.7.8 ************
 1)
 Now the QWhat'sThis ist working.