krop's commit fixes my problem in a better way, reverting
[kdepim.git] / korganizer / README
blob07453be9beac75c4ace8506d205022d609d8ee3c
1                        +-----------------------+
2                        | K   O R G A N I Z E R |
3                        +-----------------------+
5                             version 3.3 pre
7                        http://korganizer.kde.org
9 Next release: KDEPIM-3.3 (something like May 2004)
11 QUICK NOTES ON WHAT'S NEW IN THE DIFFERENT VERSIONS:
13 * Official 3.2 release (January 2004)
15   - New Features:
16     - Support for multiple calendars and todo lists. Korganizer can now
17       transparently merge calendar data from different files or other calendar
18       data sources for example calendars on the web. They can conveniently
19       activated, deactivated, added and removed from the graphical user
20       interface.
21     - Kontact integration. KOrganizer now is fully integrated with Kontact, the
22       complete KDE personal information management application. Within Kontact
23       some additional features are available like conversion of mails to events
24       or todos by drag and drop.
25     - New storage model: The notion of an active calendar was replaced by a
26       persistant calendar. The user doesn't have to take care of loading or
27       saving the calendar. Changes are immediately saved to disk. If the
28       calendar is changed externally it is automatically loaded and updated in
29       the view. A locking mechansim handles concurrent access to the calendar.
30     - Undo and Redo. KOrganizer now supports unlimited undo and redo.
31     - Todo integration with agenda view. Todos are shown in the week and day
32       views. Todos can be converted to events by dragging from the todo list and
33       dropping on the agenda view.
34     - Attachements for events and todos. References to web pages, local files or
35       mails can be attached to events and todos. The attached data can easily be
36       accessed by a single click from the event and todo views as well as the
37       summary view or the editors.
38     - Quick todo entry. A special input field allows to quickly create a todo
39       without needing to open an editor. This is especially handy for creating
40       multiple todos in a row.
41     - Quick event entry. There are several new ways to create events from the
42       agenda view: Per type-ahead events can be created by selecting a time
43       range and then simply starting to type. An editor will be opened and the
44       type text will be go into the summary input line. Optionally the event
45       editor can be opened when the time selection is finished and in addition
46       to the usual menu and toolbar entries there are key bindings and a context
47       menu to start the editor dialog.
48     - Plugin for Jewish calendar dates. When enabled this plugin shows the
49       Jewish calendar dates for each day in the calendar view.
50     - Improved print support. The print dialogs were rewritten. Printing now
51       supports colors and overlapping events.
53   - User interface polishing. The visual appearance of KOrganizer was improved
54     by a rewrite of the agenda view rendering and other enhancements like the
55     text fade-out when there isn't enough space to display the full text or the
56     graphical display of the completion state of todos. Many usability
57     improvements were incoreporated, like support for moving multi-day events in
58     the agenda view by dragging with the mouse, more complete and consistent key
59     bindings and context menus, better menu structure and more concise texts.
60     Some of these improvements were stimulated by external usability studies.
62   - Bug fixes. Countless bug fixes went into this version, one of them being a
63     fix for the session management which closes the, according to Bugzilla, most
64     hated bug of KOrganizer 3.1.
66   - Better performance. The speed of calendar loading and saving was
67     significantly improved and memory consumption of calendars was decreased.
69   - Architecture and framework:
70      - KOrganizer makes use of the KDE resource framework KResources which
71        provides uniform management of calendar, addressbook and similar
72        resources including generic ways to handle locking and change
73        notification. This also provides a plugin interface for adding resources
74        which makes it possible to easily extend Korganizer for example to access
75        groupware servers or other ways to store calendar data. 
76      - KOrganizer configuration is now based on KConfig XT. That means that
77        there is an abstract XML based description of the configuration which is
78        used for generating the needed code to access the configuration data and
79        serves as base for external configuration tools.
80      - Simplification of alarm daemon. KOrganizer doesn't use kalarmd anymore,
81        it only needs the korgac daemon which also rpovides the system tray icon
82        for being able to notify about alarms. Run control of the alarm daemon
83        also was simplified, it's now all done by the context menu of the system
84        tray icon and doesn't need the control center anymore.
85      - The configuration dialog is now based on kcontrol modules. This is a
86        prerequisite for integrating the configuration within Kontact.
87      - KMail now directly supports transfer of invitations and other calendar
88        attachments to KOrganizer. This supercedes the korganizerIn script
89        solution.
90      - Accessing the calendar from the command line is now exclusively handled
91        by a native command line application, konsolekalendar.
94 * Official 3.1 release (January 2003)
96   - General:
97     - User-definable templates for events and todos.
98     - Alarms for todos.
99     - Automatic HTML export on save of calendar file.
100     - Time table print view.
101     - New "location" attribute for events.
102     - Experimental "Get Hot New Stuff" button for downloading and uploading
103       calendar files of common interest.
105   - Views:
106     - New "Next 3 days" view.
107     - Selection of time span for a new event in day and week views.
108     - Direct manipulation of priority, completion status and categories of todos
109       by context menus.
110     - Deletion of individual instances of recurring events.
111     - Rewritten month view.
112     - Coloring of events in month view based on categories.
113     - Coloring of due and overdue todos.
114     - Improved "What's Next" view.
115     - Configurable cell height in week and day views
117   - Group scheduling:
118     - iMIP group scheduling functions for todos.
119     - Publishing of Free/Busy information by iMIP conformant email.
120     - Improved automatisation of group scheduling.
121     
122   - Interoperability and integration
123     - Support for "webcal" URLs in Konqueror.
124     - Support for iCalendar based drag&drop.
125     - KOrganizer now shares the dialogs for categories with KAddressBook.
126     - Improved iCalendar conformance.
127     - Improved right-to-left languages support.
128     - Bug fixes for non-latin1 encodings.
130   - Plugins:
131     - New plugin for importing birthdays from The KDE address book.
132     - New plugin for accessing calendar data on an Exchange server.
134 * Official 3.0.3 release (August 2002)
136   - Fixed problem caused by Qt 3.0.5 that made context menus in todo and list
137     view inaccessible.
139 * Official 3.0.2 release (June 2002)
141   - Bug fixes
142     - Respect secrecy setting in HTML export also in non-english languages.
143     - Insert page breaks in todo printouts when necessary.
145 * Official 3.0.1 release (May 2002)
147   - Lots of bug fixes including fixes to two major bugs:
148     - Fixed time shift problem which occurred sometimes when saving a calendar.
149     - Fixed memory leaks in loading and saving the calendar
151 * Official 3.0 release (March 2002)
153   - Bug fixes
155 * Beta Release 3.0beta2 (Februrary 2002)
157   - More group scheduling fixes
158   - Other bug fixes
160 * Beta Release 3.0beta1 (December 2001)
162   - Group scheduling fixes
164 * Alpha Release 3.0alpha1 (October 2001)
166   - Group scheduling
167   - Plugin interface
168   - Marcus Bain line
169   - Full port to Qt3/KDE3
170   - Major code cleanup
172 * Official 2.2 release (August 2001)
174   - Bug fixes
176 * Beta Release 2.2beta1 (June 2001)
178   - Drag&Drop of attendees from kaddressbook to korganizer
180 * Alpha Release 2.2alpha2 (May 2001)
182   - Active remote calendar
183   - Sending events via KMail
184   - Tip of the Day
185   - "Percent completed" setting for todos
186   - Bug fixes
188 * Alpha 1 release of version 2.2 (April 2001)
190   This release is mainly to try out some new technologies and get some
191   feedback after major reorganisation of the code.
192   
193   What's new:
194   - Switch to iCalendar as default file format
195   - "What's next" view
196   - Journal feature
197   - Project view
198   - HTML export of month view
199   
200 * Official 2.1 release (February 2001)
202   - Highlighting of working hours
203   - Todo and Month View can now use the full window
204   - ScrollBars of month view cells can now be turned off
205   - Better support for non-ascii charsets
207 * Official 2.0 release (October 2000)
209   - No more bugs to fix (sigh, I'm dreaming)
211 * Beta-Release 1.94 (September 2000)
213   - Even more bug fixes
215 * Beta-Release 1.93 (August 2000)
217   - More bug fixes
219 * Beta-Release 1.92 (July 2000)
221   - A couple of bug fixes
223 * Beta-Release 1.91 (June 2000)
225   - Full integration in KDE 2 framework
226   - Improved Todo-View (hierarchical todos, drag and drop, ...)
227   - Web Page Export
228   - Improved Agenda View (colored events, parallel events, ...)
229   - Many, many other improvements and bug fixes
231 * Official 1.0 release (February 1999)
233 INTRODUCTION:
235 KOrganizer aims to be a complete program for organizing your
236 appointments, contacts, projects, etc.  It is in the same spirit as
237 similar programs like the now ubiquitous Microsoft Outlook, Starfish
238 Internet Sidekick, Time & Chaos, etc. (all for the Microsoft Windows
239 platform, of course.)  Best of all, It reads and writes the vCalendar
240 file format NATIVELY (please see http://www.imc.org/pdi for more
241 information), which is now an industry-wide personal data interchange
242 format.  Because of this, you should be able to move from other modern
243 PIMs to KOrganizer with relative ease.  Current users of the popular
244 program ical should definitely take a look at KOrganizer and compare
245 features.
247 KOrganizer also offers full synchronization with your Palm Pilot, if you
248 have kpilot installed.
250 To install KOrganizer, please read the file INSTALL.  The process is
251 analogous to other KDE applications.
253 Documentation is available online from the Help->Contents menu option.
254 While it is not complete and has not been updated in several months,
255 it is at least partially helpful.  Anyone wishing to help on completing
256 or enhancing the documentation should contact me directly at the email
257 address given at the end of this document.
259 BUGS:
261 Bugs can be reported to the KDE bug tracking system (http://bugs.kde.org).
262 There you can also get information about the status of older bugs.
263 KOrganizer, as most other KDE 2 programs, offers a menu item "Report Bug"
264 in the Help menu for convenient reporting of bugs or feature requests.
266 NEWS and TODO:
268 Have a look at the KOrganizer homepage (http://korganizer.kde.org).
269 There you find news and a todo list for future KOrganizer development (of
270 course generated with KOrganizer itself).
272 CONTACT INFORMATION:
274 We want your suggestions and comments! 
276 Please mail them to the maintainer of KOrganizer:
278 Cornelius Schumacher (schumacher@kde.org)
280 I always welcome contributions and new members for the team.