Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdepim@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 280 insertions, 0 deletions

diff --git a/korganizer/README b/korganizer/README
new file mode 100644
index 000000000..07453be9b
--- /dev/null
+++ b/korganizer/README
@@ -0,0 +1,280 @@
+		       +-----------------------+
+                       | K   O R G A N I Z E R |
+                       +-----------------------+
+
+                            version 3.3 pre
+
+                       http://korganizer.kde.org
+
+Next release: KDEPIM-3.3 (something like May 2004)
+
+QUICK NOTES ON WHAT'S NEW IN THE DIFFERENT VERSIONS:
+
+* Official 3.2 release (January 2004)
+
+  - New Features:
+    - Support for multiple calendars and todo lists. Korganizer can now
+      transparently merge calendar data from different files or other calendar
+      data sources for example calendars on the web. They can conveniently
+      activated, deactivated, added and removed from the graphical user
+      interface.
+    - Kontact integration. KOrganizer now is fully integrated with Kontact, the
+      complete KDE personal information management application. Within Kontact
+      some additional features are available like conversion of mails to events
+      or todos by drag and drop.
+    - New storage model: The notion of an active calendar was replaced by a
+      persistant calendar. The user doesn't have to take care of loading or
+      saving the calendar. Changes are immediately saved to disk. If the
+      calendar is changed externally it is automatically loaded and updated in
+      the view. A locking mechansim handles concurrent access to the calendar.
+    - Undo and Redo. KOrganizer now supports unlimited undo and redo.
+    - Todo integration with agenda view. Todos are shown in the week and day
+      views. Todos can be converted to events by dragging from the todo list and
+      dropping on the agenda view.
+    - Attachements for events and todos. References to web pages, local files or
+      mails can be attached to events and todos. The attached data can easily be
+      accessed by a single click from the event and todo views as well as the
+      summary view or the editors.
+    - Quick todo entry. A special input field allows to quickly create a todo
+      without needing to open an editor. This is especially handy for creating
+      multiple todos in a row.
+    - Quick event entry. There are several new ways to create events from the
+      agenda view: Per type-ahead events can be created by selecting a time
+      range and then simply starting to type. An editor will be opened and the
+      type text will be go into the summary input line. Optionally the event
+      editor can be opened when the time selection is finished and in addition
+      to the usual menu and toolbar entries there are key bindings and a context
+      menu to start the editor dialog.
+    - Plugin for Jewish calendar dates. When enabled this plugin shows the
+      Jewish calendar dates for each day in the calendar view.
+    - Improved print support. The print dialogs were rewritten. Printing now
+      supports colors and overlapping events.
+
+  - User interface polishing. The visual appearance of KOrganizer was improved
+    by a rewrite of the agenda view rendering and other enhancements like the
+    text fade-out when there isn't enough space to display the full text or the
+    graphical display of the completion state of todos. Many usability
+    improvements were incoreporated, like support for moving multi-day events in
+    the agenda view by dragging with the mouse, more complete and consistent key
+    bindings and context menus, better menu structure and more concise texts.
+    Some of these improvements were stimulated by external usability studies.
+
+  - Bug fixes. Countless bug fixes went into this version, one of them being a
+    fix for the session management which closes the, according to Bugzilla, most
+    hated bug of KOrganizer 3.1.
+
+  - Better performance. The speed of calendar loading and saving was
+    significantly improved and memory consumption of calendars was decreased.
+
+  - Architecture and framework:
+     - KOrganizer makes use of the KDE resource framework KResources which
+       provides uniform management of calendar, addressbook and similar
+       resources including generic ways to handle locking and change
+       notification. This also provides a plugin interface for adding resources
+       which makes it possible to easily extend Korganizer for example to access
+       groupware servers or other ways to store calendar data. 
+     - KOrganizer configuration is now based on KConfig XT. That means that
+       there is an abstract XML based description of the configuration which is
+       used for generating the needed code to access the configuration data and
+       serves as base for external configuration tools.
+     - Simplification of alarm daemon. KOrganizer doesn't use kalarmd anymore,
+       it only needs the korgac daemon which also rpovides the system tray icon
+       for being able to notify about alarms. Run control of the alarm daemon
+       also was simplified, it's now all done by the context menu of the system
+       tray icon and doesn't need the control center anymore.
+     - The configuration dialog is now based on kcontrol modules. This is a
+       prerequisite for integrating the configuration within Kontact.
+     - KMail now directly supports transfer of invitations and other calendar
+       attachments to KOrganizer. This supercedes the korganizerIn script
+       solution.
+     - Accessing the calendar from the command line is now exclusively handled
+       by a native command line application, konsolekalendar.
+
+
+* Official 3.1 release (January 2003)
+
+  - General:
+    - User-definable templates for events and todos.
+    - Alarms for todos.
+    - Automatic HTML export on save of calendar file.
+    - Time table print view.
+    - New "location" attribute for events.
+    - Experimental "Get Hot New Stuff" button for downloading and uploading
+      calendar files of common interest.
+
+  - Views:
+    - New "Next 3 days" view.
+    - Selection of time span for a new event in day and week views.
+    - Direct manipulation of priority, completion status and categories of todos
+      by context menus.
+    - Deletion of individual instances of recurring events.
+    - Rewritten month view.
+    - Coloring of events in month view based on categories.
+    - Coloring of due and overdue todos.
+    - Improved "What's Next" view.
+    - Configurable cell height in week and day views
+
+  - Group scheduling:
+    - iMIP group scheduling functions for todos.
+    - Publishing of Free/Busy information by iMIP conformant email.
+    - Improved automatisation of group scheduling.
+    
+  - Interoperability and integration
+    - Support for "webcal" URLs in Konqueror.
+    - Support for iCalendar based drag&drop.
+    - KOrganizer now shares the dialogs for categories with KAddressBook.
+    - Improved iCalendar conformance.
+    - Improved right-to-left languages support.
+    - Bug fixes for non-latin1 encodings.
+
+  - Plugins:
+    - New plugin for importing birthdays from The KDE address book.
+    - New plugin for accessing calendar data on an Exchange server.
+
+* Official 3.0.3 release (August 2002)
+
+  - Fixed problem caused by Qt 3.0.5 that made context menus in todo and list
+    view inaccessible.
+
+* Official 3.0.2 release (June 2002)
+
+  - Bug fixes
+    - Respect secrecy setting in HTML export also in non-english languages.
+    - Insert page breaks in todo printouts when necessary.
+
+* Official 3.0.1 release (May 2002)
+
+  - Lots of bug fixes including fixes to two major bugs:
+    - Fixed time shift problem which occurred sometimes when saving a calendar.
+    - Fixed memory leaks in loading and saving the calendar
+
+* Official 3.0 release (March 2002)
+
+  - Bug fixes
+
+* Beta Release 3.0beta2 (Februrary 2002)
+
+  - More group scheduling fixes
+  - Other bug fixes
+
+* Beta Release 3.0beta1 (December 2001)
+
+  - Group scheduling fixes
+
+* Alpha Release 3.0alpha1 (October 2001)
+
+  - Group scheduling
+  - Plugin interface
+  - Marcus Bain line
+  - Full port to Qt3/KDE3
+  - Major code cleanup
+
+* Official 2.2 release (August 2001)
+
+  - Bug fixes
+
+* Beta Release 2.2beta1 (June 2001)
+
+  - Drag&Drop of attendees from kaddressbook to korganizer
+
+* Alpha Release 2.2alpha2 (May 2001)
+
+  - Active remote calendar
+  - Sending events via KMail
+  - Tip of the Day
+  - "Percent completed" setting for todos
+  - Bug fixes
+
+* Alpha 1 release of version 2.2 (April 2001)
+
+  This release is mainly to try out some new technologies and get some
+  feedback after major reorganisation of the code.
+  
+  What's new:
+  - Switch to iCalendar as default file format
+  - "What's next" view
+  - Journal feature
+  - Project view
+  - HTML export of month view
+  
+* Official 2.1 release (February 2001)
+
+  - Highlighting of working hours
+  - Todo and Month View can now use the full window
+  - ScrollBars of month view cells can now be turned off
+  - Better support for non-ascii charsets
+
+* Official 2.0 release (October 2000)
+
+  - No more bugs to fix (sigh, I'm dreaming)
+
+* Beta-Release 1.94 (September 2000)
+
+  - Even more bug fixes
+
+* Beta-Release 1.93 (August 2000)
+
+  - More bug fixes
+
+* Beta-Release 1.92 (July 2000)
+
+  - A couple of bug fixes
+
+* Beta-Release 1.91 (June 2000)
+
+  - Full integration in KDE 2 framework
+  - Improved Todo-View (hierarchical todos, drag and drop, ...)
+  - Web Page Export
+  - Improved Agenda View (colored events, parallel events, ...)
+  - Many, many other improvements and bug fixes
+
+* Official 1.0 release (February 1999)
+
+INTRODUCTION:
+
+KOrganizer aims to be a complete program for organizing your
+appointments, contacts, projects, etc.  It is in the same spirit as
+similar programs like the now ubiquitous Microsoft Outlook, Starfish
+Internet Sidekick, Time & Chaos, etc. (all for the Microsoft Windows
+platform, of course.)  Best of all, It reads and writes the vCalendar
+file format NATIVELY (please see http://www.imc.org/pdi for more
+information), which is now an industry-wide personal data interchange
+format.  Because of this, you should be able to move from other modern
+PIMs to KOrganizer with relative ease.  Current users of the popular
+program ical should definitely take a look at KOrganizer and compare
+features.
+
+KOrganizer also offers full synchronization with your Palm Pilot, if you
+have kpilot installed.
+
+To install KOrganizer, please read the file INSTALL.  The process is
+analogous to other KDE applications.
+
+Documentation is available online from the Help->Contents menu option.
+While it is not complete and has not been updated in several months,
+it is at least partially helpful.  Anyone wishing to help on completing
+or enhancing the documentation should contact me directly at the email
+address given at the end of this document.
+
+BUGS:
+
+Bugs can be reported to the KDE bug tracking system (http://bugs.kde.org).
+There you can also get information about the status of older bugs.
+KOrganizer, as most other KDE 2 programs, offers a menu item "Report Bug"
+in the Help menu for convenient reporting of bugs or feature requests.
+
+NEWS and TODO:
+
+Have a look at the KOrganizer homepage (http://korganizer.kde.org).
+There you find news and a todo list for future KOrganizer development (of
+course generated with KOrganizer itself).
+
+CONTACT INFORMATION:
+
+We want your suggestions and comments! 
+
+Please mail them to the maintainer of KOrganizer:
+
+Cornelius Schumacher (schumacher@kde.org)
+
+I always welcome contributions and new members for the team.