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

51 files changed, 5315 insertions, 0 deletions

diff --git a/doc/korganizer/Makefile.am b/doc/korganizer/Makefile.am
new file mode 100644
index 000000000..171f575ce
--- /dev/null
+++ b/doc/korganizer/Makefile.am
@@ -0,0 +1,2 @@
+KDE_LANG = en
+KDE_DOCS = AUTO
diff --git a/doc/korganizer/event-attachments.png b/doc/korganizer/event-attachments.png
new file mode 100644
index 000000000..9f3d6aced
--- /dev/null
+++ b/doc/korganizer/event-attachments.png
diff --git a/doc/korganizer/event-attendees.png b/doc/korganizer/event-attendees.png
new file mode 100644
index 000000000..76046352b
--- /dev/null
+++ b/doc/korganizer/event-attendees.png
diff --git a/doc/korganizer/event-freebusy.png b/doc/korganizer/event-freebusy.png
new file mode 100644
index 000000000..4e83859be
--- /dev/null
+++ b/doc/korganizer/event-freebusy.png
diff --git a/doc/korganizer/event-general.png b/doc/korganizer/event-general.png
new file mode 100644
index 000000000..15e91eac7
--- /dev/null
+++ b/doc/korganizer/event-general.png
diff --git a/doc/korganizer/event-recurrence.png b/doc/korganizer/event-recurrence.png
new file mode 100644
index 000000000..f157f6a7e
--- /dev/null
+++ b/doc/korganizer/event-recurrence.png
diff --git a/doc/korganizer/groupevent.png b/doc/korganizer/groupevent.png
new file mode 100644
index 000000000..31b6f3399
--- /dev/null
+++ b/doc/korganizer/groupevent.png
diff --git a/doc/korganizer/i_actions_newevent.png b/doc/korganizer/i_actions_newevent.png
new file mode 100644
index 000000000..22aa13e8f
--- /dev/null
+++ b/doc/korganizer/i_actions_newevent.png
diff --git a/doc/korganizer/i_actions_newtodo.png b/doc/korganizer/i_actions_newtodo.png
new file mode 100644
index 000000000..5d337346b
--- /dev/null
+++ b/doc/korganizer/i_actions_newtodo.png
diff --git a/doc/korganizer/i_copy.png b/doc/korganizer/i_copy.png
new file mode 100644
index 000000000..cfa9cb431
--- /dev/null
+++ b/doc/korganizer/i_copy.png
diff --git a/doc/korganizer/i_cut.png b/doc/korganizer/i_cut.png
new file mode 100644
index 000000000..79d2dcae3
--- /dev/null
+++ b/doc/korganizer/i_cut.png
diff --git a/doc/korganizer/i_edit_delete.png b/doc/korganizer/i_edit_delete.png
new file mode 100644
index 000000000..6fb193f06
--- /dev/null
+++ b/doc/korganizer/i_edit_delete.png
diff --git a/doc/korganizer/i_edit_find.png b/doc/korganizer/i_edit_find.png
new file mode 100644
index 000000000..91f6eb656
--- /dev/null
+++ b/doc/korganizer/i_edit_find.png
diff --git a/doc/korganizer/i_edit_redo.png b/doc/korganizer/i_edit_redo.png
new file mode 100644
index 000000000..a424839e7
--- /dev/null
+++ b/doc/korganizer/i_edit_redo.png
diff --git a/doc/korganizer/i_edit_undo.png b/doc/korganizer/i_edit_undo.png
new file mode 100644
index 000000000..e5f15b2f3
--- /dev/null
+++ b/doc/korganizer/i_edit_undo.png
diff --git a/doc/korganizer/i_file_close.png b/doc/korganizer/i_file_close.png
new file mode 100644
index 000000000..8acc84d11
--- /dev/null
+++ b/doc/korganizer/i_file_close.png
diff --git a/doc/korganizer/i_file_new.png b/doc/korganizer/i_file_new.png
new file mode 100644
index 000000000..6e838b325
--- /dev/null
+++ b/doc/korganizer/i_file_new.png
diff --git a/doc/korganizer/i_file_open.png b/doc/korganizer/i_file_open.png
new file mode 100644
index 000000000..503a00459
--- /dev/null
+++ b/doc/korganizer/i_file_open.png
diff --git a/doc/korganizer/i_file_print.png b/doc/korganizer/i_file_print.png
new file mode 100644
index 000000000..d554b554f
--- /dev/null
+++ b/doc/korganizer/i_file_print.png
diff --git a/doc/korganizer/i_file_quit.png b/doc/korganizer/i_file_quit.png
new file mode 100644
index 000000000..744588794
--- /dev/null
+++ b/doc/korganizer/i_file_quit.png
diff --git a/doc/korganizer/i_file_revert.png b/doc/korganizer/i_file_revert.png
new file mode 100644
index 000000000..5111dd0b2
--- /dev/null
+++ b/doc/korganizer/i_file_revert.png
diff --git a/doc/korganizer/i_file_save.png b/doc/korganizer/i_file_save.png
new file mode 100644
index 000000000..dd00abd16
--- /dev/null
+++ b/doc/korganizer/i_file_save.png
diff --git a/doc/korganizer/i_file_saveas.png b/doc/korganizer/i_file_saveas.png
new file mode 100644
index 000000000..61a080ecd
--- /dev/null
+++ b/doc/korganizer/i_file_saveas.png
diff --git a/doc/korganizer/i_go_backward.png b/doc/korganizer/i_go_backward.png
new file mode 100644
index 000000000..60caccf07
--- /dev/null
+++ b/doc/korganizer/i_go_backward.png
diff --git a/doc/korganizer/i_go_forward.png b/doc/korganizer/i_go_forward.png
new file mode 100644
index 000000000..d3e6d1e59
--- /dev/null
+++ b/doc/korganizer/i_go_forward.png
diff --git a/doc/korganizer/i_go_to_today.png b/doc/korganizer/i_go_to_today.png
new file mode 100644
index 000000000..2a842d2ec
--- /dev/null
+++ b/doc/korganizer/i_go_to_today.png
diff --git a/doc/korganizer/i_paste.png b/doc/korganizer/i_paste.png
new file mode 100644
index 000000000..a192060bd
--- /dev/null
+++ b/doc/korganizer/i_paste.png
diff --git a/doc/korganizer/i_settings_prefs.png b/doc/korganizer/i_settings_prefs.png
new file mode 100644
index 000000000..11415643f
--- /dev/null
+++ b/doc/korganizer/i_settings_prefs.png
diff --git a/doc/korganizer/i_view_day.png b/doc/korganizer/i_view_day.png
new file mode 100644
index 000000000..97bc5cdf3
--- /dev/null
+++ b/doc/korganizer/i_view_day.png
diff --git a/doc/korganizer/i_view_journal.png b/doc/korganizer/i_view_journal.png
new file mode 100644
index 000000000..0fe1dd10d
--- /dev/null
+++ b/doc/korganizer/i_view_journal.png
diff --git a/doc/korganizer/i_view_list.png b/doc/korganizer/i_view_list.png
new file mode 100644
index 000000000..fd1eec19e
--- /dev/null
+++ b/doc/korganizer/i_view_list.png
diff --git a/doc/korganizer/i_view_month.png b/doc/korganizer/i_view_month.png
new file mode 100644
index 000000000..3c1a0b177
--- /dev/null
+++ b/doc/korganizer/i_view_month.png
diff --git a/doc/korganizer/i_view_todo_list.png b/doc/korganizer/i_view_todo_list.png
new file mode 100644
index 000000000..cec783150
--- /dev/null
+++ b/doc/korganizer/i_view_todo_list.png
diff --git a/doc/korganizer/i_view_week.png b/doc/korganizer/i_view_week.png
new file mode 100644
index 000000000..0d0908b71
--- /dev/null
+++ b/doc/korganizer/i_view_week.png
diff --git a/doc/korganizer/i_view_whatsnext.png b/doc/korganizer/i_view_whatsnext.png
new file mode 100644
index 000000000..02577bb80
--- /dev/null
+++ b/doc/korganizer/i_view_whatsnext.png
diff --git a/doc/korganizer/i_view_work_week.png b/doc/korganizer/i_view_work_week.png
new file mode 100644
index 000000000..0e02d4c4e
--- /dev/null
+++ b/doc/korganizer/i_view_work_week.png
diff --git a/doc/korganizer/i_view_xdays.png b/doc/korganizer/i_view_xdays.png
new file mode 100644
index 000000000..441e2f802
--- /dev/null
+++ b/doc/korganizer/i_view_xdays.png
diff --git a/doc/korganizer/index.docbook b/doc/korganizer/index.docbook
new file mode 100644
index 000000000..a0398ed26
--- /dev/null
+++ b/doc/korganizer/index.docbook
@@ -0,0 +1,4982 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
+ "dtd/kdex.dtd" [
+  <!ENTITY kappname "&korganizer;">
+  <!ENTITY package "kdepim">
+  <!ENTITY plugins-chapter SYSTEM "plugins-chapter.docbook">
+  <!ENTITY exchange-plugin-workshop SYSTEM "exchange-plugin.docbook">
+  <!ENTITY group-scheduling-workshop SYSTEM "group-scheduling.docbook">
+  <!ENTITY outlook-to-vcalendar-workshop SYSTEM "outlook-to-vcalendar.docbook">
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE">
+]>
+
+<book id="korganizer" lang="&language;">
+
+<bookinfo>
+
+<title>The &korganizer; Handbook</title>
+
+<authorgroup>
+
+<author>
+<firstname>Carlos</firstname>
+<othername>Leonhard</othername>
+<surname>Woelz</surname>
+<affiliation><address><email>carloswoelz@imap-mail.com</email></address></affiliation>
+</author>
+
+<author>
+<firstname>Milos</firstname>
+<surname>Prudek</surname>
+</author>
+
+<author>
+<firstname>Paul</firstname>
+<othername>E.</othername>
+<surname>Ahlquist</surname>
+<lineage>Jr.</lineage>
+<affiliation><address>&Paul.E.Ahlquist.Jr.mail;</address></affiliation>
+</author>
+
+<author>
+<firstname>J&uuml;rgen</firstname>
+<surname>Nagel</surname>
+<affiliation><address><email>juergen.nagel@student.fh-reutlingen.de</email></address></affiliation>
+</author>
+
+<author>
+<firstname>Michel</firstname>
+<surname>Boyer de la Giroday</surname>
+<affiliation><address><email>michel@klaralvdalens-datakonsult.se</email></address></affiliation>
+</author>
+
+<othercredit role="developer">
+<firstname>Reinhold</firstname>
+<surname>Kainhofer</surname>
+<affiliation><address><email>reinhold@kainhofer.com</email></address></affiliation>
+<contrib>Developer</contrib>
+</othercredit>
+
+<othercredit role="developer">
+<firstname>Cornelius</firstname>
+<surname>Schumacher</surname>
+<affiliation><address>&Cornelius.Schumacher.mail;</address></affiliation>
+<contrib>Developer</contrib>
+</othercredit>
+
+<othercredit role="developer">
+<firstname>Preston</firstname>
+<surname>Brown</surname>
+<affiliation><address>&Preston.Brown.mail;</address></affiliation>
+<contrib>Developer</contrib>
+</othercredit>
+
+<othercredit role="reviewer">
+<firstname>Lauri</firstname>
+<surname>Watts</surname>
+<affiliation><address>&Lauri.Watts.mail;</address></affiliation>
+<contrib>Reviewer</contrib>
+</othercredit>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+
+
+<copyright>
+<year>2000</year><holder>&Milos.Prudek;</holder>
+</copyright>
+
+<copyright>
+<year>2001</year>
+<holder>&Paul.E.Ahlquist.Jr;</holder>
+</copyright>
+
+<copyright>
+<year>2004</year>
+<holder>J&uuml;rgen Nagel</holder>
+</copyright>
+
+<copyright>
+<year>2005</year>
+<holder>Carlos Leonhard Woelz</holder>
+</copyright>
+
+<legalnotice>&FDLNotice;</legalnotice>
+
+<date>2005-08-29</date>
+<releaseinfo>3.00.00</releaseinfo>
+
+<abstract><para>&korganizer; is an easy to use personal information manager
+(<acronym>PIM</acronym>).  You can write journal entries, schedule appointments,
+events, and to-dos. &korganizer; will remind you about pending tasks, and
+help you keep your schedule. </para></abstract>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KOrganizer</keyword>
+<keyword>kdepim</keyword>
+<keyword>manager</keyword>
+<keyword>time</keyword>
+<keyword>schedule</keyword>
+<keyword>alarm</keyword>
+<keyword>appointment</keyword>
+<keyword>event</keyword>
+<keyword>jornal</keyword>
+<keyword>to-do</keyword>
+</keywordset>
+
+</bookinfo>
+
+<chapter id="introduction">
+<title>Introduction</title>
+
+<para>&korganizer; is an intuitive and easy to use personal information manager
+(<abbrev>PIM</abbrev>). You can schedule appointments, events, create
+to-dos and write journal entries. &korganizer; will remind you about
+pending tasks, record your occurrences, experiences, and reflections and help
+you keep your schedule.</para>
+
+<para>But &korganizer; is not only about your personal calendar, it can
+help you to interact with your colleagues and friends too. With &korganizer;,
+you can publish a calendar as a web page, invite anyone with an email address
+to an event and process responses, share a calendar (using a groupware
+server or simply a file over the network), and share events (&eg;
+the schedule of a championship or a conference), using the get hot new stuff
+framework. &korganizer; is based on open standards, and works with
+many different group scheduling servers, giving you the control over your
+information and the freedom to choose the best solutions.
+</para>
+
+<para>&korganizer; is also the calendar, journal and to-do component of
+&kontact;, offering you an integrated solution for your
+communication and information management needs: email, notes, contacts
+management, news reader, synchronization with portable devices, and news feeds
+reader.  Even if you don't use it inside &kontact;, &korganizer; is
+integrated with the other &kde; <acronym>PIM</acronym> applications.
+For instance, you can configure it to show birthdays from &kaddressbook; in your
+agenda, use &kmail; to send and receive invitations, &etc;</para>
+
+<para>Main features of &korganizer;:</para>
+<para><itemizedlist>
+<listitem><para>Create To-dos, schedule events, and write journal entries.</para></listitem>
+<listitem><para>Organize your events and to-dos by grouping the related items in categories.</para></listitem>
+<listitem><para>Highlight categories with colors.</para></listitem>
+<listitem><para>Open multiple calendars, and seamless view and edit them.</para></listitem>
+<listitem><para>Reschedule your events by drag-and-drop.</para></listitem>
+<listitem><para>Generate recurring events easily.</para></listitem>
+<listitem><para>Organize or attend events using the group scheduling features.</para></listitem>
+<listitem><para>Choose among the multiple supported groupware servers.</para></listitem>
+<listitem><para>vCalendar and iCalendar (open standards) native support.</para></listitem>
+<listitem><para>Calendar merging and import.</para></listitem>
+<listitem><para>Synchronize your data with &PalmOS; devices.</para></listitem>
+<listitem><para>Drag-and-drop between open calendars.</para></listitem>
+<listitem><para>Embedding collaboration with &konqueror;.</para></listitem>
+<listitem><para>Customizable icon sets.</para></listitem>
+<listitem><para>Drag-and-drop tool panels.</para></listitem>
+<listitem><para>Much more...</para></listitem>
+</itemizedlist></para>
+
+
+<para>Now take a <link linkend="five-minute-course">Five-minute fly-over
+course</link> of &korganizer;, or delve into <link
+linkend="managing-data">the documentation</link>!</para>
+
+</chapter>
+
+<chapter id="five-minute-course">
+<title>Five-minute Fly-over Course of &korganizer;</title>
+<subtitle> (for the experienced and for the impatient)</subtitle>
+
+<para>Pressed for time? Let's kick you started with a fast, hands-on overview
+of &korganizer;!</para>
+
+<para>If you ever worked with a personal information program before, you'll be
+right at home with &korganizer;. You can enter new events, reschedule existing
+events, assign categories to your events, devise new categories, enter and
+modify lists of attendees and their roles, email event invitations
+automatically and exchange data with other &korganizer; calendars, create
+to-dos and write journal entries.</para>
+
+<para>This course assumes that you know how to work with the &kde;, and that
+you prefer to explore on your own. Only the basic functions of &korganizer;
+are covered here.</para>
+
+<sect1 id="course-entering-events">
+<title>Entering Events</title>
+
+<procedure>
+<step><para>Click the <guiicon><inlinemediaobject><imageobject>
+<imagedata fileref="i_view_day.png" format="PNG"/></imageobject>
+</inlinemediaobject></guiicon><guibutton>Day View</guibutton> toolbar button
+or choose the <menuchoice><guimenu>View</guimenu>
+<guimenuitem>Day</guimenuitem></menuchoice> menu item.
+This will bring up the <link linkend="agenda-view"><guilabel>Day View</guilabel>
+</link>.</para></step>
+
+<step><para>Click on the desired date in the
+<link linkend="glossary" endterm="gloss-date-navigator">Date Navigator</link>.
+</para></step>
+
+<step><para>Select the text area beside the desired
+hour in the main panel that reflects the time of the event. Double click
+this area, or just start typing the title of the event to open the
+<guilabel>New Event</guilabel> dialog.</para></step>
+
+<step><para><link linkend="entering-data-events">Enter event details</link>. Use tabs <guilabel>General</guilabel>,
+<guilabel>Recurrence</guilabel>, <guilabel>Attendees</guilabel>,
+<guilabel>Free/Busy</guilabel> and <guilabel>Attachments</guilabel> to move
+around the dialog and access all the event's characteristics.</para></step>
+
+<step><para>Press <guibutton>OK</guibutton> to save the
+event.</para></step>
+</procedure>
+</sect1>
+
+<sect1 id="course-entering-todos">
+<title>Entering To-dos</title>
+
+<procedure>
+<step><para>Select the <menuchoice><guimenu>Actions</guimenu>
+<guimenuitem>New To-do...</guimenuitem></menuchoice> menu item to open the
+<guilabel>New To-do</guilabel> dialog.</para></step>
+
+<step><para><link linkend="entering-data-to-do">Enter the to-do details</link>.
+Use tabs <guilabel>General</guilabel>,
+<guilabel>Attendees</guilabel>, <guilabel>Recurrence</guilabel> and
+<guilabel>Attachments</guilabel> to move around the dialog.</para></step>
+
+<step><para>Press <guibutton>OK</guibutton> to save the
+to-do.</para></step>
+</procedure>
+
+</sect1>
+
+<sect1 id="course-entering-journals">
+<title>Adding Journal Entries</title>
+
+<procedure>
+
+<step><para>Select the <guiicon><inlinemediaobject><imageobject>
+<imagedata fileref="i_view_journal.png" format="PNG"/></imageobject>
+</inlinemediaobject></guiicon><menuchoice><guimenu>View</guimenu>
+<guimenuitem>Journal</guimenuitem></menuchoice> menu item to open the
+<link linkend="journal-view"><guilabel>Journal</guilabel> main
+view</link>.</para></step>
+
+<step><para>Click the <guilabel>Add Journal Entry</guilabel> link.</para></step>
+
+<step><para>Enter journal entry title and text.</para></step>
+
+</procedure>
+
+</sect1>
+
+<sect1 id="course-rescheduling-events">
+<title>Rescheduling Events</title>
+
+<para>Rescheduling events is a simple drag-and-drop operation:</para>
+
+<procedure>
+<step><para>Using the
+<link linkend="glossary" endterm="gloss-date-navigator">Date Navigator</link>
+go to the date of the event that you want to reschedule.</para></step>
+
+<step><para>You should choose an appropriate <link
+linkend="reference-menus-view">view</link> before beginning this operation.
+Only the <link linkend="agenda-view"><guilabel>agenda view</guilabel>
+</link> (day, work week and week views) shows individual hours and are suitable
+for rescheduling exactly-timed events (appointments), while the Month view
+only shows days. Therefore the Month view is most suitable for long-time
+events like holidays.</para></step>
+
+<step><para>To display the week view, press the
+<guiicon><inlinemediaobject><imageobject>
+<imagedata fileref="i_view_week.png" format="PNG"/></imageobject>
+</inlinemediaobject></guiicon><guibutton>Week View</guibutton> toolbar button,
+or choose the <menuchoice><guimenu>View</guimenu>
+<guimenuitem>Week</guimenuitem></menuchoice> menu item.
+</para></step>
+
+<step><para>Drag and drop the event to the new date and time
+location.</para></step>
+
+</procedure>
+
+<para>If you wish to reschedule more precisely, double-click the event and
+change the start and end time using the drop down menus that divide the day
+into quarter hours. If that is not precision enough, you can enter the
+desired time directly.</para>
+
+</sect1>
+<sect1 id="course-rescheduling-todos">
+<title>Rescheduling or Editing To-dos</title>
+
+<para>You should choose an appropriate <link
+linkend="reference-menus-view">view</link> before beginning this operation.
+Only the <link linkend="list-view"><guiicon><inlinemediaobject><imageobject>
+<imagedata fileref="i_view_list.png" format="PNG"/></imageobject>
+</inlinemediaobject></guiicon><guilabel>list view</guilabel>
+</link>, <link linkend="todo-view"><guiicon><inlinemediaobject><imageobject>
+<imagedata fileref="i_view_todo_list.png" format="PNG"/></imageobject>
+</inlinemediaobject></guiicon><guilabel>to-do list view</guilabel>
+</link> and <link linkend="description-view">the to-do view sidebar component
+</link> show to-dos which do not have a due date.</para>
+
+<para>To display the to-do list view, press the
+<guiicon><inlinemediaobject><imageobject>
+<imagedata fileref="i_view_todo_list.png" format="PNG"/></imageobject>
+</inlinemediaobject></guiicon><guibutton>To-do List View</guibutton> toolbar button,
+or choose the <menuchoice><guimenu>View</guimenu>
+<guimenuitem>To-do List</guimenuitem></menuchoice> menu item.
+</para>
+
+<para>To reschedule a to-do, right click it.
+This will bring up a context menu.  Choose the <guimenuitem>Copy to</guimenuitem> or
+<guimenuitem>Move to</guimenuitem> menu items and select the new date from the calendar
+now appearing. The to-do is now copied or moved to the selected date.
+Alternatively, if the main panel holds a <guilabel>To-do List View</guilabel>,
+just right click the column <guilabel>Due Date</guilabel>. A calender will
+appear instantly, allowing you to set the new due date.</para>
+
+<para>To <link linkend="entering-data-to-do">edit a to-do</link>, right click it and choose the
+<guimenuitem>Edit...</guimenuitem> menu item.</para>
+
+</sect1>
+
+<sect1 id="course-conclusion">
+<title>Conclusion</title>
+
+<para>This five-minute course covered only the basic operation of &korganizer;.
+Now you should go on and read the rest of this manual to unleash the full
+power of &korganizer;'s capabilities. But if you don't feel like it, you
+should at least skip through the <link linkend="faq">&FAQ;</link>.</para>
+
+</sect1>
+
+</chapter>
+
+
+<chapter id="managing-data">
+<title>Importing, Exporting, and Managing Calendars</title>
+
+<para>&korganizer; can store (and retrieve) events, journals entries
+and to-dos using various methods, and to different locations.
+Each of these locations is called a <firstterm>calendar resource</firstterm>.
+</para>
+
+<para>&korganizer; supports calendar files based on standards such as
+iCalendar and vCalendar natively (adding them as new resources), but you can
+import the data (merge) into an existing resource and open the file in a new
+window too. Importing files in the format used by the old
+<application>ical</application> application is also supported.</para>
+
+<para>You can export your data as a web page, as an iCalendar or
+vCalendar file. These files are supported by most scheduling applications.
+The web page can be used to publish your calendar and to-dos list in the
+web or in the local network.</para>
+
+<para>If you have a calendar containing events of public interest, such as
+a conference or championship schedule, you can upload it using the
+<link linkend="managing-get-hot-new-stuff">get hot new stuff</link> framework.
+You can use the same framework to check if there are events worth downloading.
+</para>
+
+<para>In this chapter, we will explain how to manage your calendar, using the
+resources, import and export actions and the get hot new stuff scheme.</para>
+
+<sect1 id="managing-resources">
+<title>Calendar Resources</title>
+
+<para>&korganizer; uses a local file, usually
+<filename>$KDEHOME/share/apps/korganizer/std.ics</filename>,
+as its default resource. But this is not your only option: there are several
+other resources you can add: groupware servers, journal entries as blogs,
+network files, &etc;. If you use more than one resource, &korganizer;
+<link linkend="config-main-personal">can be configured to use the default
+resource or ask which resource to use</link> when saving new events, to-dos or
+journal entries. &korganizer; will seamlessly merge the items from
+two or more resources in the <link linkend="description-view">views</link>.
+</para>
+
+<para>The default resource is a good choice for many use cases, but you may
+want to use another resource, especially if you use a supported groupware
+server. Please ask the server administrator for the information required to
+configure the groupware resource, including free/busy information publishing
+and retrieving. Access to free/busy information allows an event organizer to
+take the attendee's calendar in consideration when adding him to the the event's
+attendee list.</para>
+
+<note><para>Besides calendar storage, groupware servers typically offer contacts,
+mail and <link linkend="glossary" endterm="gloss-freebusy">free/busy
+information</link> storage. Therefore, some of the resources discussed here
+may be related to other resources from &kmail; and &kaddressbook; (the mail and
+contacts components of &kontact;), or to the
+<link linkend="config-main-free-busy">free/busy settings in the main
+configuration</link>.</para>
+<para>Please note that &korganizer;
+<link linkend="group-scheduling">group scheduling</link> communication is
+based on a peer to peer email standard. This means that you do not need a
+groupware server to use it!</para></note>
+
+<screenshot id="screenshot-resources">
+<screeninfo>A screenshot of &korganizer;'s Resource View Sidebar</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="korganizer-resource.png" format="PNG"/></imageobject>
+<textobject><phrase>A screenshot of &korganizer;'s Resource View Sidebar</phrase></textobject>
+<caption><para>A screenshot of &korganizer;'s Resource View Sidebar</para></caption>
+</mediaobject>
+</screenshot>
+
+<procedure id="procedure-add-resource">
+<title>Adding a New &korganizer; Resource</title>
+
+<step><para>If the resource view is not available on &korganizer;'s sidebar,
+choose the <menuchoice><guimenu>Settings</guimenu>
+<guisubmenu>Sidebar</guisubmenu><guimenuitem>Show Resource
+View</guimenuitem></menuchoice> menu item to display it.
+</para></step>
+
+<step><para>If the resource buttons are not displayed on the resource viewer,
+choose the <menuchoice><guimenu>Settings</guimenu><guisubmenu>Sidebar</guisubmenu>
+<guimenuitem>Show Resource Buttons</guimenuitem></menuchoice> menu item to
+display them.</para></step>
+
+<step><para>Press the <guilabel>Add...</guilabel> button to add new resources to
+the list of available resources.</para></step>
+
+<step><para>Check or uncheck the resource box to enable or
+disable it.</para></step>
+
+<step><para>Later, if you want to edit or delete a resource, select it on the
+list and press <guilabel>Delete</guilabel> to remove it or
+<guilabel>Edit...</guilabel> to modify it.</para></step>
+
+</procedure>
+
+<para>Alternatively, you can configure the &korganizer; resources (plus all
+other &kde; resources), in the &kcontrolcenter;, using the <guilabel>&kde;
+Resources</guilabel> configuration module.</para>
+
+<para>Among the existing resources, you can find:</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Birthdays from &kaddressbook;</guilabel></term>
+<listitem><para>Add this resource to view birthdays from contacts in &kaddressbook;
+in your calendar. The birthday appears in your calendar as a read only event and
+without associated time.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Journal Entries as Blogs on Server</guilabel></term>
+<listitem><para>Add this resource to be able to read your blogs as journal entries,
+directly from blog servers, such as blogger and drupal.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Bugzilla To-do List</guilabel></term>
+<listitem><para>Add this resource to load bugzilla open bugs as to-dos.
+This resource is based on the &kbugbuster; application, and uses its bug cache
+information. Bugzilla is an open source bug tracking system.</para>
+
+<para>If you are a developer working on a project that uses bugzilla, you can
+use this resource to view as to-dos the open bugs of the applications or
+libraries you are interested in (they are called <quote>products</quote> and / or <quote>components</quote> in bugzilla). This resource is available as part of
+the &kde; Software Development kit.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>&XML; Feature Plan</guilabel></term>
+<listitem><para>Add this resource to load a &XML; Feature Plan as to-dos.
+The &XML; Feature Plan is a scheme designed to document the new features of
+future software releases. It was designed to fit the &kde; release schedule
+needs, but can be helpful for any software project. The information from the
+&XML; file can be used to control feature freezes, to report the new
+features of new release or the status of the new features of a future release.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Calendar in Local File</guilabel></term>
+<listitem><para>Add this resource to be able to save (and load) your events,
+to-dos and journal entries to a local file. The file can be in the iCalendar or
+in the vCalendar standard format. &korganizer; uses this resource by default,
+storing your calendar information under
+<filename>$KDEHOME/share/apps/korganizer/std.ics</filename>.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>GroupDav Server (e.g. Open Groupware)</guilabel></term>
+<listitem><para>
+If you have access to a server that supports the
+<ulink url="http://www.groupdav.org">GroupDav protocol</ulink>, add this
+resource in order to be able to to save (and load) events<!--, journals, free/busy information?--> and to-dos
+to the server. To add the resource, you will need to know the server &URL;, your
+user name and your password. The GroupDav protocol supports the storage of 
+contacts, so you may want to add and configure the &kaddressbook;
+resource too.</para>
+<para>As of June 2005, the groupware servers that implement this protocol
+are the <ulink url="http://www.opengropware.org">OpenGroupware server</ulink>
+and the <ulink url="http://www.citadel.org">Citadel server</ulink>. An up to
+date list can be obtained at the
+<ulink url="http://www.groupdav.org">GroupDav website</ulink>.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Novell Groupwise Server</guilabel></term>
+<listitem><para>
+If you have access to a
+<ulink url="http://www.novell.com/products/groupwise">Novell GroupWise Server</ulink>
+(version 6.5 or later), add this resource in order to be able to to save (and load)
+events, free/busy information <!--,journals ?-->and to-dos to the server. To add the resource, you will
+need to know the server &URL;, your user name and your password. There is
+support for storage of contacts, so you may want to configure &kaddressbook;
+resource.</para>
+<para>The most practical way to configure the access to a GroupWise server is
+to use the <application>groupwisewizard</application> wizard. You can start it
+from the command line prompt:
+
+<screen><prompt>$</prompt><command>groupwisewizard</command></screen>
+
+The wizard will configure not only &korganizer; to use the
+GroupWise resources, but &kmail;, &kaddressbook; too.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Calendar on IMAP Server via &kmail;</guilabel></term>
+<listitem><para>
+If you have access to a server that shares calendar data via IMAP, add this
+resource in order to be able to to save (and load) events, to-dos, free/busy
+information and journal entries to the IMAP server. To enable IMAP access, you
+will need to configure &kmail; first, then add the &korganizer; resource.
+Also, since you are using &kmail; to contact the server, &korganizer; will
+open &kmail; automatically, and use it to access your data. The
+<quote>IMAP server via &kmail;</quote> schema supports the storage
+of contacts, so you may want to add the &kaddressbook; resource too.</para>
+
+<para>Most IMAP servers can be used to hold calendar and address book resources,
+allowing you to use access your data from just anywhere! If you are a user
+looking for a simple way to access and manage your groupware information,
+this is a simple and very efficient solution.</para>
+
+<para>To use this resource, it is necessary to configure &kmail; first. Choose
+the <menuchoice><guimenu>Settings</guimenu>
+<guimenuitem>Configure &kmail;...</guimenuitem></menuchoice> menu item.
+Click the <guilabel>Accounts</guilabel> icon in the configure dialog sidebar
+and add the IMAP server as a disconnected IMAP incoming account. Now click the
+<guilabel>Misc</guilabel> icon in the sidebar and click the
+<guilabel>Groupware tab</guilabel> to enable and configure the IMAP resource
+folder options. Only then you can add the &korganizer; (and &kaddressbook;)
+resources. For more information on configuring &kmail;, consult the &kmail;
+handbook.</para>
+
+<para>A more complete implementation of this schema is the
+<ulink url="http://www.kolab.org">Kolab Server</ulink>. This groupware
+implementation offers additional features for system administrators, such as
+support of mixed client environments (&Microsoft; Outlook&reg;, &kde;
+<acronym>PIM</acronym>  and web mail), a web administration interface, shared
+address book, email server, &etc; As of June 2005, the groupware servers that
+implement the <quote>Kolab 1</quote> and <quote>Kolab 2</quote> protocols are
+the Kolab server, version 1 and 2, and the 
+<ulink url="http://www.citadel.org">Citadel server</ulink> (Kolab 1 only). An up
+to date list can be obtained at the <ulink url="http://www.kolab.org">Kolab
+website</ulink>.</para>
+
+<para>The most practical way to configure the access to a Kolab server is to use
+the <application>kolabwizard</application> wizard application. You can start it
+from the command line prompt:
+
+<screen><prompt>$</prompt><command>kolabwizard</command></screen>
+
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Calendar in Local Directory</guilabel></term>
+<listitem><para>Add this resource to be able to save and load your events,
+to-dos and journal entries from a local folder. Each calendar item will be saved
+in a separate file, inside the folder.
+</para>
+<para>Since there is only one file per event, to-do, or journal entry, &korganizer;
+does not need to parse one big calendar file, sometimes with thousands of items
+when saving or loading, just one single calendar item. Also, in case of file
+corruption, you will lose only one calendar item, not the whole calendar.</para>
+</listitem>
+</varlistentry>
+
+<!--
+<varlistentry>
+<term><guilabel>Calendar on Exchange Server (Experimental)</guilabel></term>
+<listitem><para>
+If you have access to a
+<ulink url="http://www.microsoft.com/exchange">Exchange 2000 Server</ulink>,
+add this resource in order to be able to to save (and load)
+events FIXME:,journals, free/busy information and to-dos? to the server. To add the resource, you will
+need to know the server &URL;, FIXME:port? your user name and your password. There
+is support for (read only) contacts, so you may want to configure &kaddressbook;
+resource.</para>
+FIXME: does the wizard work?
+<para>The most practical way to configure the access to a Exchange server is
+to use the <application>exchangewizard</application> wizard. You can start it
+from the command line prompt:
+
+<screen><prompt>$</prompt><command>exchangewizard</command></screen>
+
+The wizard will configure not only &korganizer; to use the
+Exchange resources, but &kmail;, &kaddressbook; too.</para>
+</listitem>
+</varlistentry>
+-->
+
+<varlistentry>
+<term><guilabel>Calendar in Remote File</guilabel></term>
+<listitem><para>Add this resource to be able to save and load your events,
+to-dos and journal entries from a remote file.
+<!--FIXME: make sure this is all true-->
+There are two main advantages of keeping your calendar data in a remote server:
+you can access your data even if you are away from your computer, and
+you can let other people (for instance, a secretary) view it.
+&korganizer; keeps a cache of the data locally.
+</para>
+
+<screenshot id="screenshot-remotefile-resource">
+<screeninfo>A screenshot of &korganizer;'s Remote File Resource Configuration</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="remotefile-resource.png" format="PNG"/></imageobject>
+<textobject><phrase>A screenshot of &korganizer;'s Remote File Resource Configuration</phrase></textobject>
+<caption><para>A screenshot of &korganizer;'s Remote File Resource Configuration</para></caption>
+</mediaobject>
+</screenshot>
+
+<para>You can configure the resource to be read only, keeping the remote file
+untouched. In this case, you won't need to supply a  <quote><guilabel>Upload
+to</guilabel></quote> location, just a <quote><guilabel>Download
+from</guilabel></quote> location for the remote file. If you plan to use a
+writable remote resource, you will have to supply both locations. The reason
+to have separate  locations, is that some servers may have an upload queue,
+a place where you need to put the upload file, different from where it will be.
+In most cases, if you have write access to the remote file, the <guilabel>Upload
+to</guilabel> and <guilabel>Download from</guilabel> file locations should be
+the same.
+</para>
+
+<para>It is important to understand that the remote file resource does not
+add or remove individual items from the remote file, it simply saves the
+remote file over local cache when downloading and save the local cache over the
+remote file when uploading. Therefore, if the resource is read only, it makes
+sense to set the <guilabel>Automatic Reload</guilabel> option to a
+<guilabel>Regular interval</guilabel>, but if not (if the resource is writable),
+it is recommended to reload the file only before starting to edit it, by setting
+the <guilabel>Automatic Reload</guilabel> option to <guilabel>On
+startup</guilabel>, and to save it before exiting, by setting the
+<guilabel>Automatic Save</guilabel> option at least to
+<guilabel>On exit</guilabel>, or better yet, if you have a fast and stable
+connection to the remote file, set it to <guilabel>On every change</guilabel>
+to avoid data loss.</para>
+
+<warning><para>If you add, change or remove events, journal entries or to-dos and
+reload the remote file, all your local changes will be lost, and the
+file will revert to its previous state. This can happen in different scenarios
+(for instance if the system crashes, &korganizer; will reload the remote file on
+the next start, if you set the <guilabel>Automatic Save</guilabel> to
+<guilabel>Never</guilabel>, or if you set the <guilabel>Automatic Reload</guilabel>
+to a regular interval). If you plan to use a calendar resource in
+writable mode, make sure that your connection is stable, configure the
+resource to save the file on each change (or at frequent intervals),
+and don't reload the file at regular intervals.</para>
+
+<para>A related, but opposite problem, is that two users cannot safely edit
+the same remote file at the same time, because the remote file resource does not
+offer a conflict resolution mechanism. For instance, if someone else changes
+(and saves) the remote file, after you loaded it, and a some time later you save
+the file, his changes will be lost.
+</para></warning>
+
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>SUSE &Linux; OpenExchange Server</guilabel></term>
+<listitem><para>
+If you have access to a
+<ulink url="http://www.novell.com/products/groupwise">SUSE &Linux; OpenExchange
+Server</ulink>, version 4.1, add this resource in order to be able to to save
+(and load) events, free/busy information <!--,journals ?-->and to-dos to the server. To add the
+resource, you will need to know the server &URL;, your user name and your
+password. There is support for storage of contacts, so you may want to configure
+&kaddressbook; resource.</para>
+<para>The most practical way to configure the access to a GroupWise server is
+to use the <application>sloxwizard</application> wizard. You can start it
+from the command line prompt:
+
+<screen><prompt>$</prompt><command>sloxwizard</command></screen>
+
+The wizard will configure not only &korganizer; to use the
+OpenExchange resources, but &kmail;, &kaddressbook; too.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+
+<!--FIXME: are there other XML-RPC servers?-->
+<term><guilabel>eGroupware Server (via &XML;-RPC)</guilabel></term>
+<listitem><para>
+If you have access to a
+<ulink url="http://www.egroupware.org">eGroupware
+Server</ulink>, version 1.0, add this resource in order to be able to to save
+(and load) events, free/busy information <!--,journals ?-->and to-dos to the server. To add the
+resource, you will need to know the server &URL;, your user name and your
+password. There is support for storage of contacts, so you may want to configure
+&kaddressbook; resource.</para>
+<para>The most practical way to configure the access to a eGroupware server is
+to use the <application>egroupwarewizard</application> wizard. You can start it
+from the command line prompt:
+
+<screen><prompt>$</prompt><command>egroupwarewizard</command></screen>
+
+The wizard will configure not only &korganizer; to use the
+eGroupware resources, but &kmail;, &kaddressbook; too.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+
+<sect1 id="managing-import-export">
+<title>Importing, Exporting and Maintaining Calendars</title>
+
+<para>While local files are just one among many other resources that can be used
+by &korganizer;, they are the most convenient way to share calendars, save
+copies, or import items from your old calendar program.</para>
+
+<sect2 id="managing-import">
+<title>Importing Calendars</title>
+
+<para>If you have a iCalendar or vCalendar file, and you
+would like to import it, choose the <menuchoice><guimenu>File</guimenu>
+<guisubmenu>Import</guisubmenu><guimenuitem>Import Calendar...</guimenuitem>
+</menuchoice>. &korganizer; will ask you if you want to <guilabel>Add as new
+calendar</guilabel>, which adds the calendar file as a new local file resource,
+<guilabel>Merge into existing calendar</guilabel>, which merges the calendar
+items into an existing resource or <guilabel>Open in separate window</guilabel>,
+which will allow you to view and edit the calendar, but will not add to
+its default view.</para>
+
+<para>A good time to do this would be if you received a
+vCalendar with a few entries via email, for instance, or if you are planning
+to import your calendar from another application. In the latter case, the first
+thing to do is to use that application to export the calendar data in one of the
+formats above, or use a tool to convert from the application's native format. If you
+are migrating from &Microsoft; Outlook&reg;, please check
+<xref linkend="outlook-to-vcalendar-ws" />.</para>
+
+<para>If you have used <application>ical</application>, a popular but
+older calendar program for &UNIX;, you may wish to <action>import your events,
+journal entries, and to-dos</action> directly to &korganizer;. To do so, choose the
+<menuchoice><guimenu>File</guimenu><guisubmenu>Import</guisubmenu>
+<guimenuitem>Import From &UNIX; Ical Tool</guimenuitem></menuchoice>.
+This action will read the <filename>.calendar</filename> file from your home
+folder and merge any entries it contains into your current calendar.
+If any errors or suspicious things occur during the process, you will be
+notified via a message box.</para>
+
+</sect2>
+
+<sect2 id="managing-export">
+<title>Exporting Calendars</title>
+
+<para>You can export your data as a web page, or as an iCalendar or
+vCalendar file, which are supported by most scheduling applications.
+The web page can be used to publish your calendar and to-dos list on the
+web or on the local network. Either way, &korganizer; will export all calendar
+items from the enabled (checked) resources which are
+<link linkend="filters-view">not filtered out</link> (let's call these items
+<quote>active</quote> items). In other words, if you cannot see a calendar
+item, it won't be in the exported file. To filter out the undesired items
+before exporting them, you can create
+<link linkend="filters-view">filters</link>. Filters even are more effective
+if you classify your events and to-dos in
+<link linkend="categories-view">categories</link>. To enable and disable
+resources, check or uncheck the resource box in the
+<link linkend="managing-resources"><guilabel>Resource View</guilabel></link>
+sidebar.</para>
+
+<para>To export all your <quote>active</quote> events, to-dos and journal entries
+(independent of to what resource they belong) as a new iCalendar
+file, choose the <menuchoice><guimenu>File</guimenu><guisubmenu>Export</guisubmenu>
+<guimenuitem>iCalendar...</guimenuitem></menuchoice> menu item. To export the same
+data as a new vCalendar file choose the <menuchoice><guimenu>File</guimenu>
+<guisubmenu>Export</guisubmenu> <guimenuitem>vCalendar...</guimenuitem>
+</menuchoice> menu item. The <guilabel>Save As</guilabel> dialog will pop up.
+Enter the file name and location for the new file to complete the export
+action.</para>
+
+<para>You can export your calendar or a part of it as a &HTML;
+file, suitable for publishing in the web. Anyone with access to this file,
+using a web browser, will be able to view it. This is an easy way to share
+calendar information with your colleagues and friends.</para>
+
+<!--TODO: use case: export your friends birthdays?-->
+
+<procedure id="procedure-export-html">
+<step><para>Disable all the resources you don't want to export, and filter out
+the items you don't want to export.</para></step>
+<step><para>Choose the <menuchoice><guimenu>File</guimenu>
+<guisubmenu>Export</guisubmenu><guimenuitem>Export Web Page...</guimenuitem>
+</menuchoice> menu item. You will get a window with three tabs:
+<guilabel>General</guilabel>,  <guilabel>Events</guilabel>, and
+<guilabel>To-dos</guilabel>.</para></step>
+<step><para><guilabel>General</guilabel> tab:</para>
+<substeps>
+<step><para>Specify the date range that you want published. Enter dates
+manually or use the Calendar Widget.</para></step>
+<step><para>If you want to export to-dos, check the <guilabel>Export
+to-do list</guilabel> box.</para></step>
+<step><para>If you want to export the items displayed in the month view, check the
+<guilabel>Export in month view</guilabel> box.</para></step>
+<step><para>If you want to export events formatted as a list of events, check the
+<guilabel>Export events as list</guilabel> box.</para></step>
+<step><para>Specify the web output file in the <guilabel>Output file</guilabel>
+field. If set another location, press the <guibutton><inlinemediaobject>
+<imageobject><imagedata fileref="i_file_open.png" format="PNG"/></imageobject>
+</inlinemediaobject>Browse Folders</guibutton> button to find it.</para></step>
+</substeps></step>
+<step><para><guilabel>Events</guilabel> tab: specify if you want to include
+categories and attendees in the exported web page.</para></step>
+<step><para><guilabel>To-dos</guilabel> tab: specify if you want to list Due
+Dates, Categories, and Attendees.</para></step>
+</procedure>
+
+</sect2>
+
+<sect2 id="managing-purge-archive">
+<title>Maintaining Your Calendars</title>
+
+
+<para>Contemporary computers have ample storage space. However, if you
+ synchronize your &korganizer; calendar with a limited-memory machine like the
+ Palm device, you will find archiving useful. The performance of &korganizer;
+ can also become worse when there are many events. To archive old
+items, follow the procedure below:</para>
+
+<procedure>
+<step><para>Choose the <menuchoice><guimenu>File</guimenu><guimenuitem>Archive
+Old Entries...</guimenuitem></menuchoice>.</para></step>
+<step><para>Fill in the date in <guilabel>Archive now items older than</guilabel> field or
+use the Calendar Widget to choose the date. Alternatively, you can automatically
+archive all items older than a certain period of time.</para></step>
+<step><para>If you have chosen archiving, you must also provide a filename for
+the archive in the <guilabel>Archive File</guilabel> field. If you want to
+re-use an older archive file, press the <guilabel>Browse</guilabel> button
+and find an existing archive. The entries will be added to the file,
+so any item already in the file will not be modified.</para></step>
+</procedure>
+
+<para>Archiving will keep all old items in a file, including completed
+to-dos. But if you do not want to keep completed to-dos at all, choose the
+<menuchoice><guimenu>File</guimenu><guimenuitem>Purge Completed To-dos</guimenuitem>
+</menuchoice> menu item to remove all the completed to-dos from your
+active resources. If you want to keep your completed to-dos, but
+do not wish to view in the to-do lists, consider
+<link linkend="filters-view">filtering them out</link> instead of purging them.
+</para>
+
+</sect2>
+
+</sect1>
+
+<sect1 id="managing-get-hot-new-stuff">
+<title>Uploading and Downloading Using Get Hot New Stuff</title>
+
+<para>If you have a calendar containing events of public interest, such as
+a conference or championship schedule, you can upload it (or check if there
+is something worth downloading) using the
+<ulink url="http://ghns.berlios.de/">get hot new stuff framework</ulink>.
+</para>
+
+<para>
+To open the <guilabel>Get Hot New Stuff</guilabel>
+dialog, which offers a list of calendars to download, choose the
+<menuchoice><guimenu>File</guimenu><guisubmenu>Import</guisubmenu>
+<guimenuitem>Get Hot New Stuff...</guimenuitem></menuchoice> menu item.
+If you select one of the calendars, a dialog with the list of events from the
+calendars will appear. To merge the displayed events with your default resource,
+press <guilabel>Merge</guilabel>.</para>
+
+<para>
+To open the <guilabel>Upload Hot New Stuff</guilabel> dialog, which allow you
+to export calendars containing events which may be useful to other people, such
+as a conference program, a list of holidays, special events, &etc;,
+choose the <menuchoice><guimenu>File</guimenu><guisubmenu>Export</guisubmenu>
+<guimenuitem>Upload Hot New Stuff...</guimenuitem></menuchoice>.</para>
+
+<para>Before uploading the events, make sure you have
+<link linkend="filters-view">filtered out</link> all unrelated data.</para>
+
+</sect1>
+
+</chapter>
+
+<chapter id="chapter-views-and-filters">
+<title>Views and Filters</title>
+
+<para>While calendars (resources) can hold events, to-dos and / or journal
+entries, these items are very different in nature. To-dos may have no
+date associated with them, so a schedule view is not suitable to them.
+Journal entries are a collection your reflections, occurrences or experiences.
+They require their own view mode, as they are not related
+with the list upcoming events or the list of to-dos, &etc;</para>
+
+<para>To solve the challenge of displaying your information in an useful and
+intuitive fashion, &korganizer; offers different views, filters and search
+capabilities. You can also assign related events and to-dos to
+categories, which will help you to view them later, using filters or
+colors.</para>
+
+<sect1 id="description-view">
+<title>&korganizer; Views</title>
+
+<para>In this section, we describe the different view modes, and present an
+overview of how to browse your personal data using &korganizer;.</para>
+
+<para>The &korganizer; window can be divided in two main areas: the
+main window and the sidebar. The main window displays the main views and the
+sidebar displays the date navigator, the
+to-do view, the item viewer and the resource view. To show or hide the
+sidebar components, check or uncheck the menu items under the
+<menuchoice><guimenu>Settings</guimenu>
+<guisubmenu>Sidebar</guisubmenu></menuchoice> submenu.</para>
+
+<para>The date navigator is provided to browse and select dates. Today's date
+will be outlined with a small box, dates which have events scheduled on them
+will be bold (daily or weekly recurring events may not be marked as bold,
+<link linkend="config-main-views">depending on the view configuration</link>),
+and holidays will be colored red. If you want to jump to a date, simply click
+on it. Hold down the mouse to select multiple contiguous dates at once.
+The <guilabel>What's Next</guilabel>,
+<guilabel>List</guilabel>, <guilabel>Agenda</guilabel> and
+<guilabel>Journal</guilabel> views will only show events, to-dos or
+journals items from the dates selected in the date navigator. The
+<guilabel>Month</guilabel> view will show events or to-dos from the first
+month shown in the date navigator (the selected days in the month won't change
+the month view, only month changes).</para>
+
+<para>The to-do view sidebar component lists your to-dos, just like the
+<link linkend="todo-view">To-do view</link>. It is useful if you want
+to see your to-dos while using the other views.</para>
+
+<para>The item viewer sidebar component shows details of the currently selected
+events, to-dos or journal entries.</para>
+
+<para>Finally, the resource viewer sidebar component allow you to enable or
+disable the resources on the list, by checking or unchecking the resource
+box, and to manage your resources. For more information, please check
+<xref linkend="managing-resources" />.</para>
+
+<para>You can also browse your calendar view choosing
+the <menuchoice><guimenu>Go</guimenu>
+<guimenuitem>Go Backward</guimenuitem></menuchoice> menu item (or pressing the
+<inlinemediaobject><imageobject><imagedata fileref="i_go_backward.png"
+format="PNG"/></imageobject></inlinemediaobject>toolbar button), which goes to
+the previous day, week, month or year, choosing the <menuchoice><guimenu>
+Go</guimenu><guimenuitem>Go Forward</guimenuitem></menuchoice> menu item (or
+pressing the <inlinemediaobject><imageobject>
+<imagedata fileref="i_go_forward.png"  format="PNG"/></imageobject>
+</inlinemediaobject>toolbar button), which goes to
+the next day, week, month or year (depending on the view), and choosing the
+<menuchoice><guimenu>Go</guimenu><guimenuitem>Go to Today</guimenuitem>
+</menuchoice> menu item (or pressing the <inlinemediaobject><imageobject>
+<imagedata fileref="i_go_to_today.png" format="PNG"/></imageobject>
+</inlinemediaobject>toolbar button), which will include the current day in the
+current view.</para>
+
+<sect2 id="whatsnext-view">
+<title>What's Next View</title>
+
+<para>This view displays events and to-dos in a simple format you can
+quickly read. All open to-dos will be displayed, but only the events from
+the days selected in the <guilabel>Date Navigator</guilabel> sidebar will be
+shown. Events and to-dos are displayed one per line.</para>
+
+<para>Switch to the What's Next view by choosing the
+<menuchoice><guimenu>View</guimenu>
+<guimenuitem>What's Next</guimenuitem></menuchoice>
+menu item or pressing the <guilabel><inlinemediaobject><imageobject><imagedata fileref="i_view_whatsnext.png"
+ format="PNG"/></imageobject></inlinemediaobject>What's Next</guilabel> button
+in the toolbar.</para>
+
+</sect2>
+
+<sect2 id="list-view">
+<title>List View</title>
+
+<para>This view displays all your to-dos, events and journal entries for
+the dates selected in the date navigator as a list. Open to-dos that are
+not due on the selected dates are not shown. This view is good for displaying
+many different items in a compact fashion. It is also useful if your
+events are spread out over a long time period that would not be displayed
+completely on the screen when using one of the other views.</para>
+
+<para>The items are displayed one per line. Columns show if an alarm is set
+(a bell icon displayed in it means the alarm is set),  if it repeats multiple
+times (a chasing-arrows icon means a repeating event), the start and end time
+information. Hovering the mouse over an item will bring up a
+tooltip with detailed information about the item.</para>
+
+<para>Switch the display to the list view by choosing the
+<menuchoice><guimenu>View</guimenu>
+<guimenuitem>List</guimenuitem></menuchoice>
+menu item or pressing the <guilabel><inlinemediaobject><imageobject><imagedata fileref="i_view_list.png"
+ format="PNG"/></imageobject></inlinemediaobject>List</guilabel> button
+in the toolbar.</para>
+
+
+</sect2>
+
+<sect2 id="agenda-view">
+<title>Agenda View</title>
+
+<!--TODO: add agenda view options, color of resources and categories-->
+
+<para>The agenda view presents your events or due to-dos for one or more days,
+sorted chronologically. You can also see the length of each event in the day
+timetable. The <guilabel>Day</guilabel>, <guilabel>Work Week</guilabel> and
+<guilabel>Week</guilabel> views are variations of the agenda view.
+In fact, you can set the days shown in the agenda view at any time by selecting
+them in the date navigator.</para>
+
+<para>Time is indicated by a time bar on the left side of the view. A scrollbar
+on the right is provided when the whole day cannot be displayed on a single
+screen (which is the usual case). Each rectangle in the view represents an
+individual event or to-do due for that time, and displays the start and end time
+and summary. A <guiicon>bell</guiicon> icon is displayed if an alarm is set, and
+a <guiicon>chasing-arrows</guiicon> icon is displayed if it repeats multiple
+times. Hovering the mouse over an calendar item will bring up a tooltip
+with the item detailed information. To make &korganizer; show a red line
+marking the current-time on the current day (the Marcus Bains line),
+check the <guilabel>Show current-time (Marcus Bains Line)</guilabel> box in the
+<link linkend="config-main-views">&korganizer; view
+configuration</link>.</para>
+
+<para>Any event can be re-sized with your mouse. Simply move the mouse pointer
+near the top or bottom edge of the event, and drag the edge up or
+down. This way you can visually modify the starting and ending time of your
+event. This also works in the Week and Work Week views. In other words, it
+is possible to change start and end times with the mouse by just moving the
+upper or lower border of the event to the new time.</para>
+
+<para>Any event can be rescheduled with your mouse. Move the mouse pointer over
+the event, and drag it to a new time location. This also works in the Week and
+Work Week views. Events can be moved to other, presently non-visible dates.
+Move the mouse pointer over the event, and drag it to the date navigator.</para>
+
+<para>Since the agenda view cannot contain the whole day on most screens, you
+will have to scroll up and down to see the whole day. There is a useful hint that
+tells you if there are any currently invisible events above or below your current
+view; it is a small down-pointing at the bottom  of each day view or
+up-pointing arrow at the top.</para>
+
+<tip><para>There are a useful shortcut for adding events:
+
+<itemizedlist>
+<listitem><para>Double-click any
+open region of time, and &korganizer; will automatically create an event with
+default duration (which is customizable in the preferences dialog).
+You can immediately add the title. The events <quote>snap</quote> to
+half-hour increments, rounding off to the closest half hour from where you
+clicked.</para></listitem>
+<listitem><para>Select any open region of time, and double click it or start
+writing the title of the event.  &korganizer; will automatically set the
+duration and start time as defined by the selection area in the agenda
+view.</para></listitem>
+</itemizedlist>
+</para></tip>
+
+<para>To help you organize your agenda, the color of the events reflect their
+category, and depending on the <link linkend="config-main-views">&korganizer;
+view configuration</link>, it may also reflect its
+<link linkend="managing-resources">resource</link>. Therefore, if you assign
+<link linkend="categories-view">categories to events</link> and
+<link linkend="config-main-colors">different colors to categories</link> , you
+will be able to quickly identify the type of event by its color.
+</para>
+
+<para>
+The aganda view can display events from all your calendars merged into one view or
+show a view per calendar. Having both views available via tabs is also possible and
+can be <link linkend="config-main-views">customized in the preferences dialog</link>.
+</para>
+
+<sect3 id="day-view">
+<title>Day View</title>
+
+<para>This view presents the <link linkend="agenda-view">agenda view</link> for
+a single day.</para>
+
+<para>Switch the display to the day view by choosing the
+<menuchoice><guimenu>View</guimenu>
+<guimenuitem>Day</guimenuitem></menuchoice>
+menu item or pressing the <guilabel><inlinemediaobject><imageobject><imagedata fileref="i_view_day.png"
+ format="PNG"/></imageobject></inlinemediaobject>Day</guilabel> button
+in the toolbar.</para>
+
+</sect3>
+
+<sect3 id="next-x-days-view">
+<title>Next X Days View</title>
+
+<para>This view presents the <link linkend="agenda-view">agenda view</link> for
+the next days, starting from today. You can change the number of days to be
+displayed in the <link linkend="config-main-views">&korganizer; view
+configuration</link>. The default value is 3.</para>
+
+<para>Switch the display to the next days view by choosing the
+<menuchoice><guimenu>View</guimenu>
+<guimenuitem>Next X Days</guimenuitem></menuchoice>
+menu item, (X represents the number of days, usually 3).</para>
+
+</sect3>
+
+
+<sect3 id="week-view">
+<title>Week View</title>
+
+<para>The week view provides a view similar to the day view. Events for seven
+days are shown next to each other.</para>
+
+<para>Switch the display to the week view by choosing the
+<menuchoice><guimenu>View</guimenu>
+<guimenuitem>Week</guimenuitem></menuchoice>
+menu item or pressing the <guilabel><inlinemediaobject><imageobject><imagedata fileref="i_view_week.png"
+ format="PNG"/></imageobject></inlinemediaobject>Week</guilabel> button
+in the toolbar.</para>
+
+</sect3>
+
+<sect3 id="workweek-view">
+<title>Work Week View</title>
+
+<para>This is the same as the week view, except that it shows only the working
+days of the week.</para>
+
+<para>Switch the display to the work week view by choosing the
+<menuchoice><guimenu>View</guimenu>
+<guimenuitem>Work Week</guimenuitem></menuchoice>
+menu item or pressing the <guilabel><inlinemediaobject><imageobject><imagedata fileref="i_view_work_week.png"
+ format="PNG"/></imageobject></inlinemediaobject>Work Week</guilabel> button
+in the toolbar.</para>
+
+</sect3>
+
+</sect2>
+
+
+<sect2 id="month-view">
+<title>Month View</title>
+
+<!--TODO: add month view options-->
+
+<para>The month view shows all the events and due to-dos for the current
+month in a familiar month calendar layout. Each cell in the view
+represents a day, and each day contains all of the events that can fit in the
+area provided (maximizing the window will enable you to see more appointments).
+Information on repeating and alarm status is indicated through
+<guiicon>bell</guiicon> and <guiicon>chasing arrows</guiicon> icons, just like
+in other views.</para>
+
+<para>Navigate the month view using the date navigator arrows,
+or the items and toolbar buttons from the <guilabel>Go</guilabel> menu.
+Since the visible area of a day cell may not contain all events and
+to-dos, you can use the keyboard to browse the items, or, if you check
+the  <guilabel>Enable scrollbars in month view cells</guilabel> box in the
+<link linkend="config-main-views">&korganizer; view configuration</link>, you
+can use them to see all the events and to-dos from that day.</para>
+
+<para>Hover your mouse over any calendar item to display a tooltip with the
+item details. Double click an empty area to create an event, double
+click any calendar item to edit it.</para>
+
+<para>To help you organize your data, the color of the events may
+reflect their category, and its <link linkend="managing-resources">resource</link>,
+depending on the <link linkend="config-main-views">&korganizer;
+view configuration</link>. Therefore, if you assign
+<link linkend="categories-view">categories to events</link> and
+<link linkend="config-main-colors">different colors to categories</link>,
+you can identify the type of event (or resource) by its color.
+</para>
+
+<para>Switch the display to the month view by choosing the
+<menuchoice><guimenu>View</guimenu>
+<guimenuitem>Month</guimenuitem></menuchoice>
+menu item or pressing the <guilabel><inlinemediaobject><imageobject><imagedata fileref="i_view_month.png"
+ format="PNG"/></imageobject></inlinemediaobject>Month</guilabel> button
+in the toolbar.</para>
+
+</sect2>
+
+<sect2 id="timeline-view">
+<title>Timeline View</title>
+
+<para> The timeline view shows all events for the selected timespan in a gantt
+view. Every calendar is displayed in a separate line. </para>
+
+<para>Hover your mouse over any calendar item to display a tooltip with the
+item details. Double click an empty area to create an event, double
+click any calendar item to edit it.</para>
+
+</sect2>
+
+<sect2 id="todo-view">
+<title>To-do List</title>
+
+<para>The to-do list provides a place for you to jot down quick (or long-term)
+notes about things that need to be done. The to-do view sidebar
+component appears right below the Date Navigator. You can also display it in the
+main panel if you click the <guilabel><inlinemediaobject><imageobject>
+<imagedata fileref="i_view_todo_list.png" format="PNG"/></imageobject>
+</inlinemediaobject>To-do List View</guilabel> toolbar button or if you choose the
+<menuchoice><guimenu>View</guimenu><guimenuitem>To-do
+List</guimenuitem></menuchoice> menu item.</para>
+
+<para>You can give your to-do a <quote>date due</quote>, in other words a
+date when the to-do should be finished.</para>
+
+<para>You can also assign priorities to to-dos, and they will appear
+sorted in order of priority.  The lower the number, the higher the priority,
+except that zero (0) is defined as <quote>no priority.</quote></para>
+
+<para>To make a new to-do entry, right click the to-do view sidebar component,
+or the to-do list view, and choose the <guimenuitem>New To-do</guimenuitem> menu
+item. If you right click an already existing to-do, you will get more
+choices: you can <guimenuitem>Show</guimenuitem> the summary,
+<guimenuitem>Edit...</guimenuitem> the to-do details,
+<guimenuitem>Delete</guimenuitem> the to-do altogether, or you can
+create a <guimenuitem>New Sub-To-do...</guimenuitem> You could for example make
+a large to-do like building a house, and make sub-to-dos like choosing the
+right building site, hiring an architect, hiring workers and finally arranging
+a party for your friends.</para> 
+
+<para>When you choose <guimenuitem>New To-do...</guimenuitem>, a dialog will
+pop up, allowing you to enter all necessary <link
+linkend="entering-data-to-do">information</link>.</para>
+
+<para>Click any to-do in the list to highlight it. If you click the
+thick-line box on the left of the to-do description, you will change the
+<quote>completed</quote> status of the to-do. If you double-click the to-do
+description, you will be able to edit all its details.</para>
+
+<para>You may also pick <link linkend="managing-purge-archive">Purge
+Completed</link> from the <mousebutton>right</mousebutton> mouse button menu to
+delete all to-do entries that you have marked completed.</para> 
+
+<para>To-dos can also dragged around with the mouse to rearrange the
+hierarchy or to exchange to-dos with other calendar windows. You can also
+read an <link linkend="other-features-drag-and-drop">overview</link> of all
+available drag-and-drop operations.</para>
+</sect2>
+
+<sect2 id="journal-view">
+<title>Journal View</title>
+
+<para>The journal view provides a place for you to record your reflections,
+occurrences or experiences. You can display the journal view in the main
+panel if you press the <guilabel><inlinemediaobject><imageobject>
+<imagedata fileref="i_view_journal.png" format="PNG"/></imageobject>
+</inlinemediaobject>Journal View</guilabel> toolbar button or if you choose the
+<menuchoice><guimenu>View</guimenu><guimenuitem>Journal</guimenuitem>
+</menuchoice> menu item.</para>
+
+<para>When you click the <guilabel>add journal entry</guilabel> link, a new journal
+entry will be created. If you want to edit an journal entry, just click the
+text box and edit it! To remove a journal entry, press the <inlinemediaobject>
+<imageobject><imagedata fileref="i_edit_delete.png"  format="PNG"/>
+</imageobject></inlinemediaobject>delete button next to the
+<guilabel>Title</guilabel> of the journal entry.</para>
+
+</sect2>
+
+</sect1>
+
+<sect1 id="categories-view">
+<title>Categories</title>
+
+<!--TODO: Add screenshot?-->
+
+<para>To help you organize your entries in related groups, you can assign
+categories to events and to-dos. If you assign categories, you can use them
+later when searching, filtering, and displaying events and to-dos.</para>
+
+<para>To assign categories when editing or creating new
+<link linkend="entering-data-events-general">events</link> or
+<link linkend="entering-data-to-do-general">to-dos</link>, press the
+<guilabel>Select Categories...</guilabel> button in the
+<guilabel>General</guilabel> tab to open the
+<guilabel>Select Categories</guilabel> dialog. You can assign more than
+one category for each item.</para>
+
+<para>To create, delete and edit categories, choose the <menuchoice>
+<guimenu>Settings</guimenu><guimenuitem>Manage Categories...</guimenuitem>
+</menuchoice> menu item to open the <guilabel>Edit Categories</guilabel> dialog.
+If you assign <link linkend="config-main-colors">different colors to categories</link>,
+you will be able to quickly identify the type of event by its color, either in
+the agenda view or in the month view (depending on the
+<link linkend="config-main-views">&korganizer; view configuration</link>).
+</para>
+
+</sect1>
+
+<sect1 id="filters-view">
+<title>Filters</title>
+
+<para>To help you view, find and export your data, you can create and
+use filters for your calendars. For instance, if you don't want to view
+completed to-dos, you can filter them out, instead of
+<link linkend="managing-purge-archive">purging them</link>. If you assign
+categories, you can use them to create filters.</para>
+
+<para>To create, delete and edit filters, choose the <menuchoice>
+<guimenu>Settings</guimenu><guimenuitem>Manage View Filters...</guimenuitem>
+</menuchoice> menu item to open the <guilabel>Edit Calendar Filters</guilabel>
+dialog. Using this dialog, you can create, delete
+and edit filters that will affect which items will be displayed by
+&korganizer;.</para>
+
+<!--TODO: Add detailed description of the dialog. Is it stable yet?-->
+
+<para>The <menuchoice><guimenu>View</guimenu>
+<guisubmenu>Filter</guisubmenu></menuchoice> submenu and the filter toolbar drop
+down offer access to all available filters  created using
+the <link linkend="menu-settings-edit-filters"><guilabel>Edit
+Filters</guilabel></link> dialog. To toggle the display of the filters toolbar
+on and off, choose the <menuchoice><guimenu>Settings</guimenu>
+<guisubmenu>Toolbars</guisubmenu><guimenuitem>Filter toolbar</guimenuitem></menuchoice>.
+If you don't want to use any filter, choose <guilabel>No filter</guilabel>.</para>
+
+<para>Filters are useful when <link linkend="managing-export">exporting your
+calendar</link>. If you use a filter, only the filtered (visible) items will
+be exported. Also, filters are more effective when the items are already
+classified and organized in <link linkend="categories-view">categories</link>,
+as you can easily create filters based on categories.</para>
+
+</sect1>
+
+<sect1 id="search-view">
+<title>Searching</title>
+
+<para>Choose the <menuchoice><guimenu>Edit</guimenu>
+<guimenuitem>Find</guimenuitem></menuchoice> menu item, press the
+<guiicon><inlinemediaobject><imageobject><imagedata fileref="i_edit_find.png"
+ format="PNG"/></imageobject></inlinemediaobject>Find</guiicon> button in the
+toolbar, or press the <keycombo action="simul">&Ctrl;<keycap>f</keycap>
+</keycombo> shortcut to find items (events, to-dos or journal
+entries) according to title, description, and/or categories.
+The find action will only search the specified fields.</para>
+
+<tip><para>You can use wildcards if you do not remember the exact summary. If
+you don't know single character of the summary, put <userinput>?</userinput>
+instead of the missing character. If you don't know more characters, use
+<userinput>*</userinput>. For instance if you know that the event or to-do has
+<emphasis>meeting</emphasis> in the beginning and <emphasis>product</emphasis>
+after, you would write <userinput>meeting*product</userinput> in the Find dialog.
+&korganizer; will locate  entries like <quote>To-do: arrange meeting about the new product</quote>,
+<quote>Meeting to discuss the old product line</quote> and
+similar. Letter case is ignored.</para></tip>
+
+<para>The result of the Find operation is a list of events, journal entries
+and/or to-dos with the specified keyword. The search list characteristics are
+the same as the <link linkend="list-view">List View</link>.</para>
+
+<para>This resulting list is active. You can double-click a line to display
+or edit the event or to-do details. Get more information about these details in
+<xref linkend="entering-data-events" /> and
+<xref linkend="entering-data-to-do" />.</para>
+
+</sect1>
+
+</chapter>
+
+<chapter id="entering-data">
+<title>Entering Data</title>
+
+<sect1 id="entering-data-events">
+<title>Events</title>
+
+<para>Events are future or past appointments, like business meetings, personal
+anniversaries and cinema visits. An event can also take several days, like
+holidays.</para>
+
+<para>Entering a new event is very easy. Just choose the
+<menuchoice><guimenu>Actions</guimenu><guimenuitem>New
+Event...</guimenuitem></menuchoice> menu item. A window with
+<guilabel>General</guilabel>, <guilabel>Recurrence</guilabel>, 
+<guilabel>Attendees</guilabel>, <guilabel>Free/Busy</guilabel>, and
+<guilabel>Attachments</guilabel> tabs will appear.</para>
+
+<para>If you wish you can use a different way to create a new event:</para>
+
+<procedure>
+<step><para>Use the Date Navigator to go to the event date.</para></step>
+
+<step><para>Click the desired view's icon on the
+<guimenu>View Toolbar</guimenu> or select the desired view from the
+<guimenu>View</guimenu> menu. Since your event starts at a particular time,
+you should choose a <link linkend="reference-menus-view">view</link>
+that displays hours of the day. You may choose <guimenuitem>Day</guimenuitem>,
+<guimenuitem>Work Week</guimenuitem> view or <guimenuitem>Week</guimenuitem>
+view.  The <guimenuitem>Month</guimenuitem> view is more suitable for
+to-dos, described below.</para></step>
+
+<step><para>In the main panel, double click the time and date when your
+event starts. </para></step>
+
+<step><para>A dialog with
+<guilabel>General</guilabel>, <guilabel>Recurrence</guilabel>, 
+<guilabel>Attendees</guilabel>, <guilabel>Free/Busy</guilabel>, and
+<guilabel>Attachments</guilabel> tabs appears.
+Enter your data as described below.</para></step>
+</procedure>
+
+<sect2 id="entering-data-events-general">
+<title><guilabel>General</guilabel> Tab</title>
+
+<para>This is a thorough description of the individual event window fields and
+widgets. Not all fields have to be filled in; some can be left empty. Read the
+<link linkend="entering-data-required-fields">Required fields section</link>
+for detailed information. And if you prefer to learn by example, there's one
+in the <link linkend="examples-entering-event">Entering event</link> section.
+</para>
+
+<screenshot id="screenshot-event-general">
+<screeninfo>A screenshot of &korganizer;'s Edit Event dialog - General tab</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="event-general.png" format="PNG"/></imageobject>
+<textobject><phrase>A screenshot of &korganizer;'s Edit Event dialog - General tab</phrase></textobject>
+<caption><para>A screenshot of &korganizer;'s Edit Event dialog - General tab</para></caption>
+</mediaobject>
+</screenshot>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Title:</guilabel></term>
+<listitem><para>Enter short description of the event into the
+<guilabel>Title</guilabel> field.  This description is the text shown
+on the &korganizer; main panel.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Location:</guilabel></term>
+<listitem><para>Enter short description of the <guilabel>location</guilabel> 
+where the event will take place.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Date &amp; Time</guilabel></term>
+<listitem><para>The &korganizer; suggested Start and End dates of your event.
+ Events are
+expected to start and end on the same date. Change these dates as desired. Enter
+the dates directly or use the <link linkend="glossary"
+ endterm="gloss-calendar-widget">
+Calendar Widget</link>.  Select the time from quarter hour intervals, or enter
+the desired time directly into the time fields. These fields are only available
+when the <guilabel>Time associated</guilabel> box is checked.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Time associated</guilabel></term>
+<listitem><para>Uncheck the <guilabel>Time associated</guilabel> box if your
+event is not scheduled on an exact time.</para>
+
+<tip><para>Most events are scheduled to an exact time. If your event does not
+need specific time, perhaps it should be created as a <link
+linkend="entering-data-to-do">to-do</link></para></tip></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Reminder</guilabel></term>
+<listitem><para>Check the <guilabel>Reminder</guilabel> box if
+&korganizer; should remind you about an event.</para>
+<!--
+<tip><para>&korganizer; can also run a specific program at that time.
+Make sure, however, that you have sufficient rights to run that
+program; if you do not, the program will not run.</para></tip>-->
+<para>Choose how many minutes, hours or days before the event you want to be
+reminded, or click the <guibutton>Advanced</guibutton> button to open the
+<guilabel>Edit Reminders</guilabel> dialog. Using this dialog, you can set
+repeating intervals for your reminders, and create special reminders that play
+sounds, run programs, or send emails.</para>
+
+<!--Click the musical <guiicon>Note</guiicon> symbol to choose the
+alarm sound. Click the <guiicon>Gear</guiicon> icon to browse for a
+program that should run at the alarm time.</para>--></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Show Time As:</guilabel></term>
+<listitem><para>The duration of the event may be shown as Busy or Free in your
+schedule. Choose it from the <guilabel>Show Time As</guilabel>
+menu.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Details:</term>
+<listitem><para>Enter a long description of the event in the large, untitled
+rectangle. You can write as many details as you wish here. For example, If the
+event is, say, planned general repair of your car, you can list all items that
+need repairing. Later on you can print this list and hand it over to the
+serviceman. If the event is shopping, you should list the goods that you
+need to buy. Print the event and take it to the shop with
+you.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Select Categories</guilabel></term>
+<listitem><para>You can assign several
+<link linkend="categories-view">categories</link> to a calendar item. Click the
+<guilabel>Select Categories</guilabel> button to open the
+<guilabel>Select Categories</guilabel> dialog. Check the category boxes to
+assign suitable categories to the event. You can also add a new category, modify
+a category or delete a category by pressing the button
+<guilabel>Edit Category</guilabel>.</para>
+
+<tip><para>Your language lesson at work may belong to both Business
+and Education categories, while the anniversary of your marriage belongs to
+either Personal or Special Occasion - it is your choice.</para></tip>
+</listitem>
+</varlistentry>
+
+<!--TODO: check if the following is still true-->
+<varlistentry>
+<term><guilabel>Access:</guilabel></term>
+<listitem><para>Choose <guilabel>Private</guilabel> or <guilabel>Confidential</guilabel>
+to keep the event private or confidential. Currently, this choice correctly
+sets the <quote>CLASS</quote> attribute of the events to
+<quote>PUBLIC</quote>, <quote>PRIVATE</quote> or <quote>CONFIDENTIAL</quote>.
+However, if these settings are really used to restrict the access of the information
+depends on the client and / or groupware server implementation.</para>
+<warning><para>Currently, &korganizer; <emphasis>will</emphasis> display
+items owned by other people and marked as confidential. Other
+clients may treat them differently, but be careful when publishing private or
+confidential events: vCalendar and iCalendar are text files, and can be read
+with any text editor (if someone has read access to them). So if you want to
+keep items really confidential, make sure you use a resource that
+only you can access.</para></warning></listitem>
+</varlistentry>
+
+</variablelist>
+
+<para>When you want to confirm, call off or revert the entered data, choose
+among the <link linkend="reference-action-buttons">Action Buttons</link>,
+<guibutton>OK</guibutton>, <guibutton>Apply</guibutton> and
+<guibutton>Cancel</guibutton>.</para>
+
+</sect2>
+
+<sect2 id="entering-data-events-recurrence">
+<title><guilabel>Recurrence</guilabel> Tab</title>
+
+<para>Some events take place regularly. You can specify their exact scheduling
+here.</para>
+
+<screenshot id="screenshot-event-recurrence">
+<screeninfo>A screenshot of &korganizer;'s Edit Event dialog - Recurrence tab</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="event-recurrence.png" format="PNG"/></imageobject>
+<textobject><phrase>A screenshot of &korganizer;'s Edit Event dialog - Recurrence tab</phrase></textobject>
+<caption><para>A screenshot of &korganizer;'s Edit Event dialog - Recurrence tab</para></caption>
+</mediaobject>
+</screenshot>
+
+
+<note><para>To activate the settings, start by checking the
+<guilabel>Enable recurrence</guilabel> check box. If it is not checked, you are 
+not able to make any changes on this tab.</para></note>
+
+<para>The Recurrence tab window is divided into four groups:
+<guilabel>Appointment Time</guilabel>, <guilabel>Recurrence Rule</guilabel>,
+<guilabel>Recurrence Range</guilabel>, and <guilabel>Exceptions</guilabel>.
+</para>
+
+<sect3 id="recurrence-event-time">
+<title><guilabel>Appointment Time</guilabel></title>
+
+<para>The appointment time is set in the <link linkend="entering-data-events-general">
+<guilabel>General</guilabel> tab window</link>. It is displayed here to guide
+you while you set the recurrence options.</para>
+
+</sect3>
+
+<sect3 id="recurrence-recurrence-rule">
+<title>Recurrence Rule</title>
+
+<para>Choose if you want to repeat this event daily, weekly, monthly or
+yearly. More detailed options are as follows:</para>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Daily</guilabel></term>
+<listitem><para>Specify whether the event occurs every day (1), every other
+day (2) and so on.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Weekly</guilabel></term>
+<listitem><para>Specify whether the event occurs every week (1), every other
+week (2) and so on. Also specify the days (Sunday ... Monday) on which the
+event occurs. </para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Monthly</guilabel></term>
+<listitem><para>You can either have the event occur on the same day of the
+month, or in a specific week on a specific day of the week.  You need to
+choose between these two possibilities.  By default, &korganizer; assumes you
+want to repeat on the same calendar day of the month (for instance the 15th).
+You can also adjust the period, so you can repeat monthly, tri-monthly and so
+on.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Yearly</guilabel></term>
+<listitem>
+<para>This is similar to Monthly.  You need to choose whether or not you
+are indicating a calendar day of the year (&eg;, the 250th day of the
+year) - <guilabel>Recur on day <replaceable>#</replaceable> of the
+year</guilabel>, in in a specific week on a specific day of the week of a month
+(&eg;, the 2nd Tuesday of March), or the day of the month in a
+particular month of the year - <guilabel>Recur on day <replaceable>#</replaceable>
+of the <replaceable>month</replaceable></guilabel>.  By default, &korganizer;
+assumes you mean the day of the month.  You can adjust the period to
+reflect events that occur bi-annually, every four years, and so on.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</sect3>
+
+<sect3 id="recurrence-recurrence-range">
+<title>Recurrence Range</title>
+
+<para>By default, events which repeat will do so forever; there is no
+<quote>end</quote> to the repetition.  This may or may not be desirable,
+so you are provided with two ways of terminating the repetition: either
+by giving an ending date, or by specifying a total number of
+recurrences.  In this area, you can choose the method that is suitable
+for this event.</para>
+
+</sect3>
+
+<sect3 id="recurrence-exceptions">
+<title>Exceptions</title>
+
+<para>You may have a very nice recurrence rule set up, but realize that
+there are a few exceptions.  If you set up your college class schedule
+for instance, you may want to make exceptions for holidays and the like.
+In this area, you can add, change, and delete dates from the list of
+exceptions (&ie; times when even if the recurrence rule matches, the
+event will <emphasis>not be scheduled</emphasis>).  Pick a date with the
+date selector, and press <guibutton>Add</guibutton> to include it. For
+removing dates, highlight them in the box on the right side, and then
+click <guibutton>Delete</guibutton>.</para>
+
+<para>When you want to confirm, call off or revert the entered data,
+choose among the <link linkend="reference-action-buttons">Action
+Buttons</link>, <guibutton>OK</guibutton>, <guibutton>Apply</guibutton>
+and <guibutton>Cancel</guibutton>.</para>
+</sect3>
+</sect2>
+
+<sect2 id="entering-data-events-attendees">
+<title><guilabel>Attendees</guilabel> Tab</title>
+
+<para>Chose in this tab the people you want to invite to your event.</para>
+
+<screenshot id="screenshot-event-attendees">
+<screeninfo>A screenshot of &korganizer;'s Edit Event dialog - Attendees tab</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="event-attendees.png" format="PNG"/></imageobject>
+<textobject><phrase>A screenshot of &korganizer;'s Edit Event dialog - Attendees tab</phrase></textobject>
+<caption><para>A screenshot of &korganizer;'s Edit Event dialog - Attendees tab</para></caption>
+</mediaobject>
+</screenshot>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Identity as organizer:</guilabel></term>
+<listitem><para>Sets the identity corresponding to the organizer of this to-do
+or event. If &korganizer; is configured to send invitation mails, the identity
+selected on this combo box will be used when sending these mails. The default
+identity can be set in the <guilabel>Personal</guilabel> section of the
+&korganizer; configuration, other identities in the <guilabel>Security &amp;
+Privacy</guilabel>-&gt;<guilabel>Password &amp; User Account</guilabel> section
+of the &kcontrolcenter;. In addition, identities are gathered from your &kmail;
+settings and from your address book. If you choose to set it globally for &kde;
+in the &kcontrolcenter;, be sure to check the <guilabel>Use email settings from
+Control Center</guilabel>' box in the <guilabel>Personal</guilabel> section of
+the &korganizer; configuration.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Attendee list</term>
+<listitem><para>The list in the center of the tab displays the attendees
+selected for this event, and lets you select attendees to edit or
+remove. Please note that you can change the order of attendees.
+Click any of the column headings (Name, Email, Role, Status,
+<acronym>RSVP</acronym>) to sort the list according to that column.
+The <acronym>RSVP</acronym> column indicates whether or not a response is
+requested from the attendee.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guibutton>Select Addressee</guibutton></term>
+<listitem><para>If the attendee(s) are in your Address Book, you do not have to
+remember or type his email address to add it to the attendee list. Just click
+the <guibutton>Select Addressee...</guibutton>  button and choose the attendee(s)
+from the list. Please note that this is the standard &kde; address book, which
+is also used by &kmail; and can also be called as a separate application
+(&kaddressbook;).</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guibutton>New</guibutton></term>
+<listitem><para>Press the <guibutton>New</guibutton> button to add a new
+manually added attendee to the list. If you want to add contacts from your
+address book, press <guibutton>Select Addressee</guibutton> instead.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Name</guilabel> field</term>
+<listitem><para>Fill in the Attendee <guilabel>Name</guilabel> and
+<guilabel>Email</guilabel> address fields, or select one of the attendees in
+the list above to edit it.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Role</guilabel></term>
+<listitem><para>Choose the role of the attendee (Participant,
+Optional participant, Observer, Chair) from the drop down menu. The role is a
+simple reminder of what part the attendee plays in this event. It can be used
+for sorting (see above).
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Status</guilabel></term>
+<listitem><para>Choose the status of the attendee (Needs Action, Accepted,
+Declined, Tentative, Delegated, Completed, In progress). The status, which
+is displayed in the details list window gives you quick overview of what
+should be done to make the event successful. It can be used for sorting (see
+above). If you use groupware schedule and request responses from your
+attendees, as you receive the responses the status of the attendee will be
+updated. If you don't request responses, you will have to update the status
+manually.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Request Response</guilabel></term>
+<listitem><para>Check the <guilabel>Request Response</guilabel> check box if
+this attendee should respond to your schedule plan. Consequently the attendee
+will be emailed with the event schedule information. A small envelope will
+appear in the details list to indicate this. This feature is specially useful
+when groupware scheduling is enabled, as the attendees status are updated 
+automatically.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+<para>When you want to confirm, call off or revert the entered data, choose
+among the <link linkend="reference-action-buttons">Action Buttons</link>,
+<guibutton>OK</guibutton>, <guibutton>Apply</guibutton> and
+<guibutton>Cancel</guibutton>.</para>
+
+</sect2>
+
+<sect2 id="entering-data-events-freebusy">
+<title><guilabel>Free/Busy</guilabel> Tab</title>
+
+<para>When adding attendees to your event, you need to know if they are
+busy or free in that particular time. If the attendees make their free /
+busy information available, you can view here their schedule before
+sending the invitations.</para>
+
+<screenshot id="screenshot-event-freebusy">
+<screeninfo>A screenshot of &korganizer;'s Edit Event dialog - Free/Busy tab</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="event-freebusy.png" format="PNG"/></imageobject>
+<textobject><phrase>A screenshot of &korganizer;'s Edit Event dialog - Free/Busy tab</phrase></textobject>
+<caption><para>A screenshot of &korganizer;'s Edit Event dialog - Free/Busy tab</para></caption>
+</mediaobject>
+</screenshot>
+
+<para>This tab shows the free/busy schedule chart on the right, where each line
+represents one of the attendees, listed on the left. The marked areas on the
+chart represent the time already taken by other events, unmarked areas represent
+time free from other events. You can move the event to a different point in time
+by dragging it with the mouse, or resize it, by moving the edges of the highlighted
+area with the mouse.</para>
+
+<para>The free/busy information is only available if the
+attendee publishes his free/busy schedule, and if &korganizer; is correctly
+configured to retrieve it. For more information about configuring &korganizer;
+to publish and retrieve free/busy information, please check the
+<xref linkend="config" />. Double-clicking on an attendee entry in the list
+will allow you to enter the location of their free/busy information. 
+</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Scale</guilabel></term>
+<listitem><para>Sets the zoom level on the schedule chart. <guilabel>Hour</guilabel>
+shows a range of several hours, <guilabel>Day</guilabel> shows a range of a few
+days, <guilabel>Week</guilabel> shows a range of a few months, and
+<guilabel>Month</guilabel> shows a range of a few years, while
+<guilabel>Automatic</guilabel> selects the range most appropriate for the
+current event or to-do.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guibutton>Center on Start</guibutton></term>
+<listitem><para>Press this button to center the free/busy schedule chart on the
+start time and day of this event.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guibutton>Zoom to Fit</guibutton></term>
+<listitem><para>Press this button to zoom the free/busy schedule chart so that you
+can see the entire duration of the event on it.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guibutton>Pick Date</guibutton></term>
+<listitem><para>Press this button to automatically move the event to a date and
+time when all the attendees are free.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guibutton>Reload</guibutton></term>
+<listitem><para>Press this button to reload Free/Busy data for all attendees
+from the corresponding servers.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+<para>When you want to confirm, call off or revert the entered data, choose
+among the <link linkend="reference-action-buttons">Action Buttons</link>,
+<guibutton>OK</guibutton>, <guibutton>Apply</guibutton> and
+<guibutton>Cancel</guibutton>.</para>
+
+</sect2>
+
+<sect2 id="entering-data-events-attachments">
+<title><guilabel>Attachments</guilabel> Tab</title>
+
+<screenshot id="screenshot-event-attachments">
+<screeninfo>A screenshot of &korganizer;'s Edit Event dialog - Attachments tab</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="event-attachments.png" format="PNG"/></imageobject>
+<textobject><phrase>A screenshot of &korganizer;'s Edit Event dialog - Attachments tab</phrase></textobject>
+<caption><para>A screenshot of &korganizer;'s Edit Event dialog - Attachments tab</para></caption>
+</mediaobject>
+</screenshot>
+
+<para>Events and to-dos can contain attachments. Attachments can either be stored as links
+or inline. The following actions are provided to work with attachments:</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guibutton>Add URI...</guibutton></term>
+<listitem><para>Adds a link attachment.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guibutton>Add File...</guibutton></term>
+<listitem><para>Adds an inline attachment.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guibutton>Edit...</guibutton></term>
+<listitem><para>Allows to change an existing attachment.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guibutton>Remove</guibutton></term>
+<listitem><para>Deletes the selected attachment.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guibutton>Show</guibutton></term>
+<listitem><para>Display the selected attachment.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+<para>When you want to confirm, call off or revert the entered data, choose
+among the <link linkend="reference-action-buttons">Action Buttons</link>,
+<guibutton>OK</guibutton>, <guibutton>Apply</guibutton> and
+<guibutton>Cancel</guibutton>.</para>
+
+</sect2>
+
+<sect2 id="entering-data-events-template-buttons">
+<title><guilabel>Load/Save as Template</guilabel></title>
+
+<para>The <guilabel>Save as Template</guilabel> button enables you to save the
+current event as a template, so that you can reuse the data entered for future
+events. As an example you can save a template for a meeting that takes place at
+the same location and with the same people.</para>
+<para>With the <guilabel>Load Template</guilabel> button you can use an existing
+template for your event. Continuing the example in the preceding paragraph you
+can specify the agenda of the meeting.</para>
+
+</sect2>
+
+</sect1>
+
+<sect1 id="entering-data-to-do">
+<title>To-dos</title>
+
+<para>The To-do List is a place for you to write down notes to yourself about
+things that you need to do. To-dos are tasks, that may or may not be
+scheduled. There are short-term and long-term to-dos. For instance you should go
+to a hairdresser within a week, and you should sell your old car within a
+year. You likely do not want an alarm go off at a particular time, you just
+want to have a list of things that you must do, and dates when they must be
+finished at the latest (date due).</para>
+
+<para>To enter a new to-do, choose
+<menuchoice><guimenu>Actions</guimenu><guimenuitem>New
+To-do...</guimenuitem></menuchoice>. A window with <guilabel>General</guilabel>, 
+<guilabel>Recurrence</guilabel>, <guilabel>Attendees</guilabel>, and
+<guilabel>Attachments</guilabel> tabs appears.</para>
+
+<sect2 id="entering-data-to-do-general">
+<title><guilabel>General</guilabel> Tab</title>
+
+<screenshot id="screenshot-todo-general">
+<screeninfo>A screenshot of &korganizer;'s Edit To-do dialog - General tab</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="todo-general.png" format="PNG"/></imageobject>
+<textobject><phrase>A screenshot of &korganizer;'s Edit To-do dialog - General tab</phrase></textobject>
+<caption><para>A screenshot of &korganizer;'s Edit To-do dialog - General tab</para></caption>
+</mediaobject>
+</screenshot>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Title</guilabel></term>
+<listitem><para>Enter short description of the to-do into the
+<guilabel>Title</guilabel> field. This description is the text shown
+on the &korganizer; <guilabel>To-do list</guilabel>.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Location:</guilabel></term>
+<listitem><para>Enter short description of the <guilabel>location</guilabel> 
+where the to-do will take place.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Date &amp; Time</guilabel></term>
+<listitem><para>The <guilabel>Due</guilabel> and <guilabel>Start</guilabel>
+boxes are not initially checked, as to-dos usually do not have a start and due
+date. Check one of both boxes and 
+change these dates as desired. Enter the dates directly or use the 
+<link linkend="glossary" endterm="gloss-calendar-widget">Calendar Widget</link>. 
+Choose time from quarter hour intervals, or enter the desired time directly into 
+the time fields. These fields are only available when <guilabel>Time associated</guilabel> 
+is checked.</para>
+<tip><para>The date and time are initially unchecked, because to-dos do not
+have the character of a fixed event. Some of them do not need a due date at
+all. Most of them certainly do not need the exact time of fulfillment. If your
+to-do requires exact time, maybe it actually belongs to <link
+linkend="entering-data-events">events</link>.</para></tip></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Completed</guilabel></term>
+<listitem><para>
+This is a percent completed pull down menu initially set at 0% complete.
+Later on, you can indicate your progress by adjusting the percent completed
+in steps of 10%.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Priority</guilabel></term>
+<listitem><para>Assign a priority to your to-do.  This drop down menu offers
+priorities from one to five, one being the highest.  Initially to-dos are set
+to priority five (medium).</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Reminder</guilabel></term>
+<listitem><para>Check the <guilabel>Reminder</guilabel> box if
+&korganizer; should remind you about the to-do.</para>
+<!--
+<tip><para>&korganizer; can also run a specific program at that time.
+Make sure, however, that you have sufficient rights to run that
+program; if you do not, the program will not run.</para></tip>-->
+<para>Choose how many minutes, hours or days before the to-do you want to be
+reminded, or click the <guibutton>Advanced</guibutton> button to open the
+<guilabel>Edit Reminders</guilabel> dialog. Using this dialog, you can set
+repeating intervals for your reminders, and create special reminders that play
+sounds, run programs, or send emails.</para>
+
+<!--Click the musical <guiicon>Note</guiicon> symbol to choose the
+alarm sound. Click the <guiicon>Gear</guiicon> icon to browse for a
+program that should run at the alarm time.</para>--></listitem>
+</varlistentry>
+
+
+<varlistentry>
+<term>Details</term>
+<listitem><para>Enter a long description of the to-do in the large
+rectangle.</para>
+<para>For example, If the to-do is, say, planned general repair of your car,
+you can list all items that need repairing. Later on you can print this list
+and hand it over to the serviceman. If the to-do is shopping, you should
+list the goods that you need to buy. Print the to-do and take it to the
+shop with you.</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><guilabel>Select Categories</guilabel></term>
+<listitem><para>You can assign several categories to a calendar item. Click the
+<guilabel>Select Categories</guilabel> button to open the
+<guilabel>Select Categories</guilabel> dialog. Check the category boxes to
+assign suitable categories to the to-do. You can also add a new category, modify
+a category or delete a category by pressing the button
+<guilabel>Edit Category</guilabel>.</para>
+
+<tip><para>Your language lesson at work may belong to both Business
+and Education categories, while the anniversary of your marriage belongs to
+either Personal or Special Occasion - it is your choice.</para></tip>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Access</guilabel></term>
+<listitem><para>Choose <guilabel>Private</guilabel> or <guilabel>Confidential</guilabel>
+to keep the to-do private or confidential. Currently, this choice correctly
+sets the <quote>CLASS</quote> attribute of the events or to-dos to
+<quote>PUBLIC</quote>, <quote>PRIVATE</quote> or <quote>CONFIDENTIAL</quote>.
+However, if these settings are really used to restrict the access of the information
+depends on the client and / or groupware server implementation.</para>
+<warning><para>Currently, &korganizer; <emphasis>will</emphasis> display
+items owned by other people and marked as confidential. Other
+clients may treat them differently, but be careful when publishing private or
+confidential to-dos: vCalendar and iCalendar are text files, and can be read
+with any text editor (if someone has read access to them). So if you want to
+keep items really confidential, make sure you use a resource that
+only you can access.</para></warning></listitem>
+</varlistentry>
+</variablelist>
+
+<para>When you want to confirm, call off or revert the entered data, choose
+among the <link linkend="reference-action-buttons">Action Buttons</link>,
+<guibutton>OK</guibutton>, <guibutton>Apply</guibutton> and
+<guibutton>Cancel</guibutton>.</para>
+
+</sect2>
+
+<sect2 id="entering-data-to-do-recurrence">
+<title><guilabel>Recurrence</guilabel> Tab</title>
+
+<para>Some to-dos take place regularly. You can specify exact scheduling
+here.</para>
+
+<note><para> If the to-do does not have a due date, this tab is completely
+disabled. To activate the settings, start by checking the
+<guilabel>Enable recurrence</guilabel> check box. If it is not checked, you are
+not able to make any changes on this tab.</para></note>
+
+<para>The Recurrence tab window is divided into four groups:
+<guilabel>Appointment Time</guilabel>, <guilabel>Recurrence Rule</guilabel>,
+<guilabel>Recurrence Range</guilabel>, and <guilabel>Exceptions</guilabel>.
+</para>
+
+<para>This tab is configure in the same way as the
+<link linkend="entering-data-events-recurrence"><guilabel>Edit Event</guilabel>
+dialog's <guilabel>Recurrence</guilabel> tab</link>. Please check
+<xref linkend="entering-data-events-recurrence" /> for more information
+about setting the recurrence options.</para>
+
+</sect2>
+
+<sect2 id="entering-data-to-do-attendees">
+<title><guilabel>Attendees</guilabel> Tab</title>
+
+<para>Some to-dos may require more people. You can list those people
+here. Please check <xref linkend="entering-data-events-attendees" />
+for more information.</para>
+
+<para>When you want to confirm, call off or revert the entered data,
+choose among the <link linkend="reference-action-buttons">Action
+Buttons</link>, <guibutton>OK</guibutton>,
+<guibutton>Apply</guibutton> and <guibutton>Cancel</guibutton>.</para>
+
+</sect2>
+
+
+<sect2 id="entering-data-to-do-attachments">
+<title><guilabel>Attachments</guilabel> Tab</title>
+
+<para>Some to-dos require attachments. You can <guibutton>Add...</guibutton>, 
+<guibutton>Edit...</guibutton>, <guibutton>Remove</guibutton>, and
+<guibutton>Show</guibutton> attachments. You can refer to the attachment by
+entering the path to the attachment or Internet address.</para>
+
+<para>When you want to confirm, call off or revert the entered data, choose
+among the <link linkend="reference-action-buttons">Action Buttons</link>,
+<guibutton>OK</guibutton>, <guibutton>Apply</guibutton> and
+<guibutton>Cancel</guibutton>.</para>
+
+</sect2>
+</sect1>
+
+<sect1 id="entering-data-required-fields">
+
+<title>Required Fields</title>
+
+<para>This is an overview of what fields are required and what fields can be
+empty when entering events and to-dos:</para>
+
+<itemizedlist>
+<listitem><para>In the <guilabel>General</guilabel> Tab, you should at least
+fill the <guilabel>Title</guilabel> field and the description (the large
+rectangle), even though neither is mandatory. If you check the
+<guilabel>Reminder</guilabel> check box, you should also specify the time, and
+either the sound to be played or the program to be run.</para></listitem>
+<listitem><para>The <guilabel>Attendees</guilabel> tab may be left completely
+empty.</para></listitem>
+<listitem><para>The <guilabel>Recurrence</guilabel> tab must only be filled if
+you checked the <guilabel>Enable Recurrence</guilabel> check box.
+</para></listitem>
+<listitem><para>The <guilabel>Attachments</guilabel> tab may be left completely
+empty.</para></listitem>
+</itemizedlist>
+</sect1>
+</chapter>
+
+<chapter id="group-scheduling">
+<title>Group Scheduling</title>
+
+<para>The group schedule functionality of &korganizer; allows you to
+organize appointments, meetings and shared to-do items, request responses
+from attendees and publish items. If you are being invited to an event or
+to-do, you can reply to it, stating if you will be able to attend, or send a
+counter proposal, with different arrangements, like a different time or
+location. You can also publish your free/busy schedule, to let people know when
+you are available, and request the same information from others.</para>
+
+<para>Currently, &korganizer; schedules events and to-dos using email to
+transport the data, in a standards based scheme, the IMIP-protocol for group
+scheduling. Being a standard, IMIP is a used by many other clients too. For
+example &Microsoft;<application>Outlook</application>, Lotus
+<application>Notes</application> and Novell
+<application>Evolution</application>. This means that you can share
+events with other users using one of these clients.
+&korganizer; is integrated with &kmail; for receiving, processing, and sending
+events, event responses, updates, cancellations, &etc; For instance, when you
+get an invitation in &kmail;, and decide to
+accept it, by clicking the the <guilabel>accept</guilabel> link in the mail
+body, the event is added to your calendar, and a response to the event's
+organizer is sent automatically.</para>
+
+
+<!--TODO: check if to-dos work or not.-->
+<!--TODO: check what happens if you counter without this option on.-->
+
+<para>If you check the <guilabel>Use Groupware Communication</guilabel> box
+in the <link linkend="config-main-groupscheduling">&korganizer; group
+scheduling configuration</link>, &korganizer; will handle the group scheduling
+communication for you. In other words, you will seldom need to use the
+<guimenu>Schedule</guimenu> menu directly to perform the scheduling actions.
+For instance, if you <link linkend="entering-data-events">create an
+event or to-do</link> with attendees, &korganizer; will ask you if you want to send the
+invitations to the attendees, so you will not need to use the <menuchoice>
+<guimenu>Schedule</guimenu><guimenuitem>Send Invitation to Attendees</guimenuitem>
+</menuchoice> menu item later. Also, if you change your status as an attendee
+for an event you were invited to, it will ask you if you want to send your updated
+status to the event's organizer, so you will not need to use the <menuchoice>
+<guimenu>Schedule</guimenu><guimenuitem>Send Status Update</guimenuitem>
+</menuchoice> menu item later.</para>
+
+
+
+<sect1 id="publish">
+<title>Publishing an Event, To-do or Journal Entry</title>
+
+<para>If you simply want to send an event, to-do or journal entry, choose the
+<menuchoice><guimenu>Schedule</guimenu><guimenuitem>Publish
+Item Information...</guimenuitem></menuchoice> menu item, when the item is
+selected. Then a dialog appears, asking you the email addresses which will
+receive the event or to-do. The item will be sent by email, in the iCalendar
+format.</para>
+
+<para>Please note that you can use this action to email any item to
+anyone, not just to the item's attendees. In fact, you can publish an item with no
+attendees at all, as publishing does not request an answer from the
+attendees.</para>
+
+<para>
+An example: you are playing in a band and, from time to time, you
+give live concerts. To notify your fans about the concerts, you maintain
+a mailing list. If you use &korganizer; to organize your concert dates,
+you can just choose the <menuchoice><guimenu>Schedule</guimenu>
+<guimenuitem>Publish Item Information...</guimenuitem></menuchoice> menu item,
+put in the address of the mailing list and the event gets sent. Mailing
+list subscribers who use &korganizer; get the concert date automatically
+inserted in their calendar.
+</para>
+
+<para>Publishing an event as described above will only inform the receiver about
+the event, but not give her the option to ask for attendance. Use
+<menuchoice><guimenu>Schedule</guimenu><guimenuitem>Send as iCalendar...</guimenuitem></menuchoice>
+if you want to provide that option instead.
+</para>
+
+</sect1>
+
+
+<sect1 id="as-organizer">
+<title>Acting as Organizer in Group Scheduling</title>
+
+<para>When you create <link linkend="entering-data-events">an event</link> or
+<link linkend="entering-data-to-do">a to-do</link>, and
+<link linkend="entering-data-events-attendees">add attendees to it</link>, you
+are acting as the event organizer. To add attendees, use the
+<link linkend="entering-data-events-attendees">
+attendee tab</link>, in the <guilabel>Edit Event</guilabel>, or
+<guilabel>Edit To-do</guilabel> dialog. In the
+<link linkend="agenda-view">agenda view</link>, a little icon
+<inlinemediaobject>
+<imageobject>
+<imagedata fileref="organizer.png" format="PNG" />
+</imageobject>
+<textobject>
+<phrase>Organizer Icon</phrase>
+</textobject>
+</inlinemediaobject>
+is placed in the event, if you are the
+organizer of a group scheduling event.</para>
+
+<para>The organizer is responsible for sending the invitations, collecting
+the attendees responses, and for keeping the data of the event or to-do up to
+date for all people involved.</para>
+
+<sect2 id="request">
+<title>Sending Invitations and Processing Responses</title>
+
+<para>To organize an event or to-do,
+<link linkend="entering-data-events">create it</link> in
+&korganizer; and add all people that should attend using the
+attendees tab. &korganizer; can send invitations to the
+attendees, either automatically (depending on
+<link linkend="config-main-groupscheduling">&korganizer; group
+scheduling configuration</link>), or by selecting the event or to-do and 
+choosing the <menuchoice><guimenu>Schedule</guimenu><guimenuitem>Send Invitation
+to Attendees</guimenuitem></menuchoice> menu item.
+The attendees get an email containing all the relevant information
+for the event or to-do. They can respond to the meeting proposal by accepting or
+rejecting it or by making a counter proposal. They can also delegate or forward the 
+invitation.
+All this information is sent to you by email again and, if you have configured &kmail; 
+appropriately the attendees responses are automatically inserted in your calendar. If
+there are additional attendees willing to participate (e.g. by accepting a forwarded 
+invitation) you will be asked to accept the new attendees.
+</para>
+
+</sect2>
+
+<sect2 id="cancel">
+<title>Cancelling an Event or To-do</title> 
+
+<para>To cancel an event or to-do you have to be the organizer. If you
+checked the <guilabel>Use Groupware Communication</guilabel> box
+in the <link linkend="config-main-groupscheduling">&korganizer; group
+scheduling configuration</link>, just delete the item, and &korganizer; will
+ask you to send the cancellation. If not, simply select the
+item, and choose the <menuchoice><guimenu>Schedule</guimenu>
+<guimenuitem>Send Cancellation to Attendees</guimenuitem></menuchoice>
+menu item.</para>
+
+<para>This action will send a cancel-message to all attendees, so
+they can remove the item from their calendars too.</para>
+</sect2>
+</sect1>
+
+
+<sect1 id="as-attendee">
+<title>Acting as the Attendee</title>
+
+<para>When you get an email with an invitation and accept it, the event or to-do
+is added to your calendar. If it is an event, a little icon
+<inlinemediaobject>
+<imageobject>
+<imagedata fileref="groupevent.png" format="PNG" />
+</imageobject>
+<textobject>
+<phrase>Attendee Icon</phrase>
+</textobject>
+</inlinemediaobject>
+is placed in the event in the <link linkend="agenda-view">agenda
+view</link>.</para>
+
+<sect2 id="reply">
+<title>Answering an Invitation</title>
+
+<para>If you have an invitation in your &kmail; inbox you can either press
+<guibutton>Reject</guibutton> to ignore the request, or press
+<guibutton>Accept</guibutton> or <guibutton>Accept Cond.</guibutton>. The
+last two actions will insert the item to your calendar. In any case, &kmail; will
+send your response to the organizer automatically.</para>
+<para>You can also <guibutton>Delegate</guibutton> or <guibutton>Forward</guibutton> 
+the invitation. When delegating, you can suggest another person as your proxy.
+Using <guibutton>Forward</guibutton> you can forward the invitation to one or more 
+people not yet invited.
+When the receiver of the delegation or forward accepts the invitation, 
+the organizer will be asked to approve the new attendee.</para>
+<para>If for any reason you changed your mind, edit your status in the item's
+<link linkend="entering-data-events-attendees">attendee tab</link>. If you
+checked the <guilabel>Use Groupware Communication</guilabel> box
+in the <link linkend="config-main-groupscheduling">&korganizer; group
+scheduling configuration</link>, &korganizer; will ask you to send an email
+updating your attendee status. If not, choose the <menuchoice>
+<guimenu>Schedule</guimenu><guimenuitem>Send Status Update</guimenuitem>
+</menuchoice> menu item to send your status update.
+</para>
+</sect2>
+
+<sect2 id="counter">
+<title>Sending an Alternative Proposal</title>
+
+
+<para>If you are not satisfied with some of the characteristics of the event or
+to-do you got invited to, and want to send a counter proposal to the organizer
+(for instance an alternative location or time), just edit the item and send it
+back as your proposal, by selecting the item and choosing the <menuchoice>
+<guimenu>Schedule</guimenu><guimenuitem>Request Change</guimenuitem>
+</menuchoice> menu item.</para>
+
+<para>The organizer of the event will get your proposal by email, and
+will be able to accept it or decline.</para>
+</sect2>
+
+<sect2 id="refresh">
+
+<title>Requesting the Latest Version of an Event or To-do</title>
+
+<para>To request the latest version of an event or to-do, select
+the item, and choose the <menuchoice><guimenu>Schedule</guimenu>
+<guimenuitem>Request Update</guimenuitem></menuchoice> menu item.
+The organizer should then send you back the latest version of the item.</para>
+
+</sect2>
+</sect1>
+
+<sect1 id="free-busy">
+<title>Free Busy information</title>
+
+<para>The free/busy information represents an availability schedule. By
+presenting the intervals when one already has previous commitments,
+others can avoid arranging appointments for these periods. Note that only the
+times are published, not the events, reasons or attendees.</para>
+
+<para>&korganizer; supports publishing and retrieving free/busy information,
+either manually or automatically.</para>
+
+<para>To email your free/busy information, choose the <guimenu>Schedule</guimenu>
+<guimenuitem>Mail Free Busy Information...</guimenuitem> menu item. Enter the
+email addresses you want to send the information to in the dialog and press
+<guilabel>OK</guilabel>.</para>
+
+<para>Groupware servers usually have a standard location for uploading
+your free busy information, so that other users can access your data, and
+you can access other user's free busy schedule. You can configure
+&korganizer; to upload and download free busy information automatically,
+using the <link linkend="config-main-views">Free Busy preferences</link>,
+in the &korganizer; <guilabel>Configure</guilabel> dialog.</para>
+
+<para>To upload your free/busy information to the server set in &korganizer;
+preferences, choose the <menuchoice><guimenu>Schedule</guimenu>
+<guimenuitem>Upload Free Busy Information</guimenuitem></menuchoice> menu
+item.</para>
+
+</sect1>
+
+<sect1 id="examples">
+<title>Examples</title>
+
+<sect2 id="examples-entering-event">
+<title>Entering a New Group Event</title>
+
+<para>In this example, you'll enter an event. You need to arrange a meeting on
+<emphasis>the next Monday</emphasis> regarding launch of your new
+Product. Your boss <emphasis>Joan Holden</emphasis> will be the event
+chairwoman <emphasis>owner</emphasis>, and you, Jack Smith, will be the event
+<emphasis>organizer</emphasis>. There will be two more
+<emphasis>attendees</emphasis> (participants): <emphasis>Peter
+Krzinski</emphasis> and <emphasis>Kirsten Friese</emphasis>. Joan gave you
+the program of the meeting. The appointment will start at
+<emphasis>12 noon</emphasis> and end at <emphasis>1 pm</emphasis>. The same
+appointment should be scheduled <emphasis>(recurred)</emphasis> each Monday.
+</para>
+
+<procedure>
+<step><para>Using the Date Navigator, go to the next Monday.</para></step>
+
+<step><para>Choose the <menuchoice><guimenu>Actions</guimenu><guimenuitem>New
+Event...</guimenuitem></menuchoice>, or select the area between
+<emphasis>12 noon</emphasis> and end at<emphasis>1 pm</emphasis>,
+and start typing the event title.</para></step>
+
+<step><para>Enter a suitable title. It's important to choose the right brief
+description, because this is the only field that can be searched. We suggest
+that you enter <userinput>Product launch event</userinput>.</para></step>
+
+<step><para>Enter the detailed event program into the largest rectangle
+area. For the sake of this simple example, enter <userinput>Introduction,
+The Plan, Conclusion</userinput> on three separate lines.</para></step>
+
+<step><para>Check the <guilabel>Reminder</guilabel> check box.  Set the
+reminder time to 15 minutes, just long enough to brew a cup of tea
+prior to the meeting start.</para></step>
+
+<step><para>Click the <guilabel>Select Categories</guilabel> button.</para></step>
+
+<step><para>Check <guilabel>Appointment</guilabel> in the Available
+Categories. Then click the
+<guibutton>OK</guibutton> button.</para></step>
+
+<step><para>Click the <guilabel>Recurrence</guilabel> tab and check the 
+<guilabel>Enable recurrence</guilabel> box.</para>
+<note><para>Most work has been done for you automatically. &korganizer;
+defaults to recurring weekly. Also note that <guilabel>No ending date
+</guilabel> is chosen. This means that this event will be repeated each
+Monday (starting, of course, on Monday February 12, 2004) until the end of
+time (that is, until you delete it).</para></note></step>
+
+<step><para>Since everything is all right here, click the
+<guilabel>Attendees</guilabel> tab.</para></step>
+
+<step><para>In the <guilabel>Attendees</guilabel> tab you should do the
+following:</para>
+<substeps>
+
+<step><para>You will see that you are the organizer of the event. Click
+the <guilabel>New</guilabel> button to add the other attendees.</para></step>
+
+<step><para>In the <guilabel>Name</guilabel> field, enter the email in the
+<userinput>Name &#060;email&#062;</userinput> format. In our example, enter
+<userinput>Joan Holden &#060;jholden@thiscompany.com&#062;</userinput>.
+<tip><para>If the attendees are already in your &kde; address book, instead of typing the
+names and emails, you can press the <guibutton>Select Addressee...</guibutton>
+button to add them.</para></tip></para></step>
+
+<step><para>Choose <emphasis>Chair</emphasis> as the role.</para></step>
+
+<step><para>Click <guilabel>New</guilabel>.</para></step>
+
+<step><para>In the <guilabel>Name</guilabel> field, enter <userinput>Peter
+Krzinski &#060;pkrzinski@thiscompany.com&#062;</userinput>.</para></step>
+
+<step><para>Click <guilabel>New</guilabel>.</para></step>
+
+<step><para>In the <guilabel>Name</guilabel> field, enter
+<userinput>Kirsten Friese &#060;kfriese@thiscompany.com&#062;</userinput>.
+</para></step>
+
+<step><para>Click <guilabel>Apply</guilabel>.</para></step>
+</substeps>
+</step>
+
+<step><para>If you have configured &korganizer; use groupware communication,
+you will be asked if you want to send an email to the attendees, with details
+of the event and asking for a response if the
+<guilabel>Request response</guilabel> box from the
+<guilabel>attendees</guilabel> tab is checked. Else, you can
+send the invitations choosing the <menuchoice><guimenu>Schedule</guimenu>
+<guimenuitem>Send Invitation to Attendees</guimenuitem></menuchoice> menu
+item.</para></step>
+
+<step><para>Review the event
+setup by clicking on the <guilabel>General</guilabel>,
+<guilabel>Attendees</guilabel>, and <guilabel>Recurrence</guilabel> tabs.
+If you are satisfied, click <guibutton>OK</guibutton>.</para></step>
+</procedure>
+
+<para>Congratulations, you've scheduled your first event!</para>
+</sect2>
+
+</sect1>
+
+</chapter>
+
+<chapter id="config">
+<title>&korganizer; Configuration</title>
+
+<para>To change &korganizer;'s look and behavior, choose the
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+&korganizer;...</guimenuitem></menuchoice> menu item, or if you are running
+&korganizer; as the calendar component of &kontact;, choose the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+Calendar...</guimenuitem></menuchoice> menu item. You can get more information
+about all the configure options and possibilities in
+<xref linkend="config-main" />.</para>
+
+<para>To customize the set of tools available on the bar, choose the
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Toolbars...
+</guimenuitem></menuchoice> menu item and read the <link
+linkend="config-toolbars">configure toolbars detailed description</link>.</para>
+
+<para>To move toolbars around the screen, point your mouse over
+the toolbar handle and drag the toolbar to a new position on your the
+&korganizer; window.</para>
+
+<para>Localization information like date and time formats can be
+configured from &kcontrolcenter; within the <menuchoice>
+<guisubmenu>Regional &amp; Accessibility</guisubmenu> <guimenuitem>Country/Region &amp;
+Language</guimenuitem> </menuchoice> module.  This control module can be
+accessed from within &korganizer;: just choose the <menuchoice><guimenu>
+Settings</guimenu><guimenuitem>Configure Date &amp;
+Time...</guimenuitem></menuchoice> menu item.  &korganizer; has to be restarted
+for changes done in &kcontrolcenter; to take effect.</para>
+
+<para>To configure where &korganizer; stores and retrieves calendar events,
+journal entries and to-dos, (in local files, groupware servers, journal entries as blogs,
+network files, &etc;), please check <xref linkend="managing-resources" />.</para>
+
+<sect1 id="config-main">
+<title>&korganizer; Main Configuration</title>
+
+<para>The options dialog lets you configure a number of different areas of
+&korganizer;.</para>
+
+<sect2 id="config-main-personal">
+<title>Personal</title>
+
+<para>The personal options relate to your personal identity, and other
+miscellaneous things that don't fall under any of the other general
+categories.</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Use email settings from control center</guilabel></term>
+<listitem><para>Check this box to use your name and email address as set in
+&kcontrolcenter; (<menuchoice><guimenuitem>Security &amp; Privacy</guimenuitem>
+<guimenuitem>Password &amp; User Account</guimenuitem></menuchoice>).</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Full name</guilabel></term>
+<listitem><para><guilabel>Full name</guilabel> is initially set to
+<quote>Anonymous</quote> with an email address of
+<quote>nobody@nowhere</quote>. You can change your name by directly
+entering it here or you can use your Email Settings from &kcontrolcenter; (see
+above).  This name will be displayed by default as
+<guilabel>Organizer</guilabel> in to-dos and Events.</para></listitem> 
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Email address</guilabel></term>
+<listitem><para><guilabel>Email address</guilabel> will be used to identify the
+owner of the calendar. When another person opens your calendar or events, he/she
+will not be able to modify it because it will be read-only.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Export to &HTML; with every save</guilabel></term>
+<listitem><para>By checking this option, you can order &korganizer; to export
+your calendar and to-do list to an html file in your home folder every time you
+save your changes.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Enable automatic saving of manually opened calendar files</guilabel></term>
+<listitem><para>When this box is checked,
+manually opened calendar files are saved automatically when you exit
+&korganizer;, without asking. Furthermore, the calendar file is saved
+periodically as you work to prevent the loss of valuable data. You can also
+specify the save interval in  minutes.
+
+<important><para>This option does not affect your
+resource settings. To change the resource saving options, you have to configure
+each resource individually. For more information about resources, please check
+<xref linkend="managing-resources" />.</para></important>
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Confirm deletes</guilabel></term>
+<listitem><para>When you check <guilabel>Confirm deletes</guilabel> box,
+ &korganizer;
+will ask you to confirm each deletion. If this is not checked, &korganizer;
+will not ask before deleting events.</para></listitem>
+</varlistentry>
+
+
+<varlistentry>
+<term><guilabel>New Events, To-dos and Journal Entries Should</guilabel></term>
+<listitem><para>This option lets you choose between adding new items to
+the standard resource or making &korganizer; ask you which resource should be
+used to save each new item.</para>
+<para>Kolab2 server specificity: It is recommended to choose <guilabel>Be asked
+which resource to use</guilabel>, if you intend to use the shared folder
+functionality of the <guilabel>Kolab</guilabel> server. This
+will allow you to keep control of which information is available only to you, and which information is published in the shared folders.</para> 
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Default email attachment method</guilabel></term>
+<listitem><para>This option allows you to select the way an email is attached to
+an event. You can attach an email the complete email including attachments, the email
+excluding attachments or only a link to the email.</para>
+<para>Note that attaching an email without attachments might invalidate its signature.
+</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<sect2 id="config-main-time-and-date">
+<title>Time &amp; Date</title>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Timezone</guilabel></term>
+<listitem><para>Select your location from the list on the drop
+down. If your city is not listed, select one that shares the same time zone.
+&korganizer; will automatically adjust for daylight savings.</para></listitem> 
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Use holiday region</guilabel></term>
+<listitem><para>Select your country from the list on the drop down, or if
+it is not listed, select <guilabel>(None)</guilabel>.
+If your country is selected, &korganizer; will recognize and display
+its important dates and holidays in the calendar view.</para></listitem> 
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Day begins at</guilabel></term>
+<listitem><para>Select the time you start your day from the list on the drop
+down. It could be the time when you usually get up, or the time when you start
+working. This setting does not prevent you to set or view items before
+this time, it just sets the time that will be displayed by default on the top
+of the calendar view. Use the scrollbar to display earlier or later events
+in the agenda view.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Default appointment time</guilabel></term>
+<listitem><para>Select the default start time for events from the list on
+the drop down. When you choose <link linkend="menu-actions-new-event">New
+Event</link> from the <link linkend="entering-data-events">Action Menu</link>, or
+create an event in some other manner such that &korganizer; cannot guess
+when you would like your event to start, &korganizer; will put this hour
+in the start time editor as the default value.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Default duration of new appointment (HH:MM):</guilabel></term>
+<listitem><para>Select the default duration for events using the spin box. When
+you choose <link linkend="menu-actions-new-event">New Event</link> from the
+<link linkend="entering-data-events">Action Menu</link>, or create an event in
+some other manner such that &korganizer; cannot guess its duration,
+&korganizer; will use this as the default value.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Default alarm time</guilabel></term>
+<listitem><para>Select how long before the actual event's scheduled time will
+the alarm activate.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Working Hours</guilabel></term>
+<listitem><para>The options <guilabel>Daily start hour</guilabel> and
+<guilabel>Daily ending hour</guilabel> let you specify when your working day starts
+and when it ends. &korganizer; set the working hours apart by marking them
+with a different color from the non working hours, holidays and non working
+days.</para>
+<para>Additionally, you have check boxes labeled after the days of the week.
+Check the week days that are working days for you, in order to mark the working
+hours in these days. Check <guilabel>Exclude holidays</guilabel>
+prevent &korganizer; from marking the working hours for the holiday region
+defined in the <guilabel>Use holiday region</guilabel> drop down above.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+</sect2>
+
+<sect2 id="config-main-views">
+<title>Views</title>
+
+<para>These options let you configure &korganizer; views:</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Enable tooltips displaying summary of events</guilabel></term>
+<listitem><para>If your summary for an event is longer than would fit in the
+current View, the remaining characters are not displayed. Check <guilabel>Enable
+tooltips displaying summary of events</guilabel> if you want the full summary
+displayed when the hovering the mouse pointer over the appointment for a few
+seconds.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Show to-dos in day, week and month views</guilabel></term>
+<listitem><para>This check box toggles the display of to-dos in the day, week
+and month views in the agenda (day and week) and month views. If you have
+too many to-dos which have due date associated, you may want to turn them
+off to avoid clutter.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+<para><link linkend="description-view">Date Navigator</link> options:</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Show events that recur daily in date navigator</guilabel></term>
+<listitem><para>If the <guilabel>Show events that recur daily in date
+navigator</guilabel> box is checked, the days containing daily recurring
+events are shown in bold typeface in the date navigator.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Show events that recur weekly in the date
+navigator</guilabel></term>
+<listitem><para>If the <guilabel>Show events that recur weekly in date
+navigator</guilabel> box is checked, the days containing weekly recurring
+events are shown in bold typeface in the date navigator.</para></listitem>
+</varlistentry>
+
+
+</variablelist>
+
+<para><link linkend="agenda-view">Agenda view</link> options:</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Hour size:</guilabel></term>
+<listitem><para>By using this slider you can control the height of the rows
+in the agenda view.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Next x days:</guilabel></term>
+<listitem><para>This option allows you to change the amount of days of the
+<guimenu>Next x Days</guimenu> menu item in the <guimenu>Views</guimenu>
+menu.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Show current-time (Marcus Bains) line</guilabel></term>
+<listitem><para>This check box toggles a red line in the day or week view
+indicating the current time (Marcus Bains line) on and off. This line gives
+you an indication how much time is left &eg; until a meeting takes
+place.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Show seconds on current-time line</guilabel></term>
+<listitem><para>This check box toggles the seconds on the current-time
+line (Marcus Bains line) on and off.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Time range selection in agenda view starts event editor</guilabel></term>
+<listitem><para>Check this box to start the event editor automatically when you
+select a time range in the daily and weekly view. To select a time range, drag
+the mouse from the start time to the end time of the event you are about to
+plan.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Agenda view uses resource colors</guilabel></term>
+<listitem><para>With &korganizer;, you can
+<link linkend="config-main-colors">assign a different color to each
+resource</link>. This check box toggles the use the resource color when
+displaying the to-do or event in the agenda view on and off. Note that if you
+don't assign different colors, there is little sense in using this feature,
+as &korganizer; default configuration is to use the same color for
+all resources.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Agenda view calendar display</guilabel></term>
+<listitem><para>
+Select if all calendars should be merged into one agenda view, each calendar should
+be displayed in its own aganda view or if both view should be available via tabs.
+</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+<para><link linkend="month-view">Month view</link> options:</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Enable scrollbars in month view cells</guilabel></term>
+<listitem><para>This check box toggles the cell scrollbars in the
+month view on and off. Even if you check this box, the scrollbars will
+only appear when needed.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Month view uses full window</guilabel></term>
+<listitem><para>If you check this box, the month view will be displayed
+in the whole &korganizer; window instead of sharing the window with the sidebar
+(the date navigator, the to-dos and the calendar resources).</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Month view uses category colors</guilabel></term>
+<listitem><para>With &korganizer;, you can
+<link linkend="config-main-colors">assign a different color to each
+category</link>. If you check this box, the event or to-do color in the month
+view will reflect the category color, instead of using no color, or only the
+resource color. Note that if you don't assign different category colors,
+there is little sense in using this feature, as &korganizer; default
+configuration is to use the same color for all categories.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Month view uses resource colors</guilabel></term>
+<listitem><para>With &korganizer;, you can
+<link linkend="config-main-colors">assign a different color to each
+resource</link>. If you check this box, the event or to-do color in the month
+view will reflect the resource color, instead of using no color, or only the
+category color. Note that if you don't assign different resource colors, there
+is little sense in using this feature, as &korganizer; default configuration
+is to use the same color for all resources.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+<para><link linkend="todo-view">To-do view</link> options:</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>To-do list view uses full window</guilabel></term>
+<listitem><para>If you enable this option, the to-do list view will be displayed
+in the whole &korganizer; window instead of  sharing the window with the sidebar
+(the date navigator, the to-dos and the calendar resources).</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Record completed to-dos in journal entries</guilabel></term>
+<listitem><para>If you check this box, &korganizer; will automatically add
+a journal entry for every completed to-dos.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<sect2 id="config-main-fonts">
+<title>Fonts</title>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Time bar</guilabel></term>
+<listitem><para>Press this button to pick the font, font style and size for the
+time bar.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Month view</guilabel></term>
+<listitem><para>Press this button to pick the font, font style and size for the
+month view.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Agenda view</guilabel></term>
+<listitem><para>Press this button to pick the font, font style and size for the
+agenda view (day, week and work week views).</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Current-time line</guilabel></term>
+<listitem><para>Press this button to pick the font, font style and size for the
+Marcus Bains line (a red line in the agenda view indicating the current
+time).</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<sect2 id="config-main-colors">
+<title>Colors</title>
+
+<para>Choose the color used for holidays, for highlighting, and for specific
+event categories. You can choose a different color for each category. Of course
+too many colors may be confusing, so use common sense. The use of color
+depend also on the <link linkend="config-main-views">view
+preferences.</link></para>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Holiday color</guilabel></term>
+<listitem><para>This button opens the <guilabel>Select Color</guilabel> dialog,
+allowing you to select the holiday color. The holiday color will be used for the
+holiday name in the month view and the holiday number in the date
+navigator.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Highlight color</guilabel></term>
+<listitem><para>This button opens the <guilabel>Select Color</guilabel> dialog,
+allowing you to select the highlight color. The highlight color will be used for
+marking the currently selected area in your agenda and in the date
+navigator.navigator.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Default event color</guilabel></term>
+<listitem><para>This button opens the <guilabel>Select Color</guilabel> dialog,
+allowing you to select the default event color. The default event color will
+be used for events categories in your agenda and (depending on the settings) in
+the month view. Note that you can specify a separate color for each event
+category below.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Agenda view background color</guilabel></term>
+<listitem><para>This button opens the <guilabel>Select Color</guilabel> dialog,
+allowing you to select the agenda view background color.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Working hours color</guilabel></term>
+<listitem><para>This button opens the <guilabel>Select Color</guilabel> dialog,
+allowing you to select the agenda view.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>To-do due today color</guilabel></term>
+<listitem><para>This button opens the <guilabel>Select Color</guilabel> dialog,
+allowing you to select the to-do due today color.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>To-do overdue color</guilabel></term>
+<listitem><para>This button opens the <guilabel>Select Color</guilabel> dialog,
+allowing you to select the to-do overdue color.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Categories</guilabel></term>
+<listitem><para>This group allows you to assign a color to each category. Select
+a category in the drop down, and press the button to open the
+<guilabel>Select Color</guilabel> dialog, allowing you to select the color for
+that category. <link linkend="config-main-views">Depending on the view
+preferences</link>, this color will be used to mark events and to-dos which
+belong to this category in your agenda and in the month view.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Resources</guilabel></term>
+<listitem><para>This group allows you to assign a color to each resource. Select
+a resource in the drop down, and press the button to open the
+<guilabel>Select Color</guilabel> dialog, allowing you to select the color for
+that resource. <link linkend="config-main-views">Depending on the view
+preferences</link>, this color will be used to mark events and to-dos which are
+stored using this resource in your agenda and in the month
+view.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<sect2 id="config-main-groupscheduling">
+<title>Group Scheduling</title>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Use Groupware Communication</guilabel></term>
+<listitem><para>Check this box to automatically send mails when creating,
+updating or deleting events or to-dos which involve others. This mail can be
+an invitation to attendees of an event you created, a cancellation of an event
+you created, an answer or an update on your invitation status, an event change
+request, &etc; Check this option if you you want to use the groupware
+functionality (e.g Configuring &kontact; as a &kde;
+<guilabel>Kolab</guilabel> client).</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Send copy to owner when mailing events</guilabel></term>
+<listitem><para>When you check the <guilabel>Send copy to owner when mailing
+events</guilabel> box, you will get a copy of all email messages that
+&korganizer; sends at your request to the event attendees.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Mail Client</guilabel></term>
+<listitem><para>Here you can choose which type of mail transport you would like
+to use. You can either use &kmail; or the &Sendmail; command (which must be
+installed on your system in order to work).</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Additional email addresses</guilabel></term>
+<listitem><para>This tells &korganizer; what further email addresses you have.
+You can add, edit or remove additional emails addresses. These email addresses
+are the ones you have in addition to the one set in
+<link linkend="config-main-personal">personal preferences</link>.
+If you get an invitation to an event, but use another email address there, you
+need to list this address here so &korganizer; can recognize it as yours, and
+add the item to your calendar.
+</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<!-- 
+<sect2 id="config-main-groupautomation">
+<title>Group Automation</title>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Auto Send Refresh</guilabel></term>
+<listitem><para>to be written...
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Auto Insert IMIP Replies</guilabel></term>
+<listitem><para>to be written...
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Auto Insert IMIP Requests</guilabel></term>
+<listitem><para>to be written...
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Auto Send FreeBusy information</guilabel></term>
+<listitem><para>to be written...
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>AutoSave FreeBusy Replies</guilabel></term>
+<listitem><para>to be written...
+</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+-->
+
+<sect2 id="config-main-free-busy">
+<title>Free/Busy</title>
+
+<para>The free/busy information represents an availability schedule. By
+presenting the intervals when one already has previous commitments,
+others can avoid arranging appointments for these periods. Note that only the
+times are published, not the events, reasons or attendees.</para>
+
+<para>&korganizer; supports publishing and retrieving free/busy information,
+either manually or automatically.</para>
+
+<para><guilabel>Publish Tab</guilabel>: by publishing your free/busy
+information, you allow others to take your busy time schedule into account
+when inviting you to an event.</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Publish free/busy information</guilabel></term>
+<listitem><para>Enable this option if you wish your Free/Busy information to be
+uploaded automatically. Note that you may skip this option and choose to mail or
+upload your Free/Busy information via the <guilabel>Schedule</guilabel> menu of
+&korganizer;.</para>
+
+<para>If your application is setup to work as a <guilabel>&kde; Kolab
+client</guilabel>, this is not required. The <guilabel>Kolab2</guilabel> server
+can take care of publishing your Free/Busy information and manage the access to
+it from other users.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Minimum time between uploads in minutes</guilabel></term>
+<listitem><para>In case you choose to publish your information automatically,
+you may configure the interval of time in minutes between each upload.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Publish (default 60) days of free/busy</guilabel></term>
+<listitem><para>Configure the number of calendar days you wish to be published
+and available to others</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Server &URL;</guilabel></term>
+<listitem><para>Enter the &URL; for the server on which your Free/Busy information
+shall be published. Ask the server administrator for this information.</para>
+<para>Kolab2 server example:
+<userinput>webdavs://kolab2.com/freebusy/joe@kolab2.com.ifb</userinput>
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Username</guilabel></term>
+<listitem><para>Enter the login information relative to your account on the server</para>
+<para>Kolab2 server specificity: Registered your UID (Unique IDentifier), by
+default your UID would be similar to your email address on the Kolab2 server
+but it may also be different. In the last case enter your UID. Ask about your
+UID to the server administrator if you don't know it.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Password</guilabel></term>
+<listitem><para>Enter here your password (server login password).</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Remember password</guilabel></term>
+<listitem><para>Check this option if you want &korganizer; to remember your
+password and skip asking you each time it upload your Free/Busy
+information.</para>
+<warning><para>It is not recommended to store your password in the configuration
+file for security reasons.</para></warning></listitem>
+</varlistentry>
+
+</variablelist>
+
+<para><guilabel>Retrieve Tab</guilabel>: by retrieving other peoples' free/busy
+information, you can take their busy time schedule into account
+when inviting them to an event.</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Retrieve other peoples' free/busy information
+automatically</guilabel></term>
+<listitem><para>Automate the process for retrieving other users free/busy time.
+Fill in the server information section below to enable this
+option.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Use full email address for retrieval</guilabel></term>
+<listitem><para>This setting lets you change the name of the file which will be
+fetched from the server. If you check this option, it will download a free/busy
+file called <userinput>user@domain.ifb</userinput>, else it will fetch
+<userinput>user.ifb</userinput>. Ask the server Administrator if you are not
+sure about how to configure this option.</para>
+<para><guilabel>Kolab2 server specificity:</guilabel> If you are configuring
+&korganizer; as a component to a <guilabel>&kde; Kolab client
+(&kontact;/Kolab)</guilabel> you have to check this option.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Server &URL;</guilabel></term>
+<listitem><para>Enter the &URL; for the server on which your Free/Busy information
+shall be fetched. Ask the server administrator for this information.</para>
+<para><guilabel>Kolab2 server example:
+</guilabel><userinput>webdavs://kolab2.com/freebusy/</userinput>
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Username</guilabel></term>
+<listitem><para>Enter the login information relative to your account on the
+server.</para>
+<para><guilabel>Kolab2 server specificity:</guilabel> Registered your UID
+(Unique IDentifier), by default your UID would be similar to your email address
+on the <guilabel>Kolab2 server</guilabel> but it may also be different. In the
+last case enter your UID. Ask about your UID to the server administrator if you
+don't know it.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Password</guilabel></term>
+<listitem><para>Enter here your password (server login password).
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Remember password</guilabel></term>
+<listitem><para>Check this option if you want &korganizer; to remember your
+password and skip asking you each time it fetches the free/busy files.</para>
+<warning><para>It is not recommended to store your password in the
+configuration file for security reasons.</para></warning>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<sect2 id="config-main-plugins">
+<title>Plugins</title>
+
+<para>For more information about configuring plugins, please refer to
+<xref linkend="plugins-chapter" /></para>
+
+</sect2>
+
+</sect1>
+
+<sect1 id="config-toolbars">
+<title>Toolbars Configuration</title>
+
+<para>&korganizer; has three toolbars: a Main toolbar (with
+<guiicon>New Event</guiicon>, <guiicon>New To-do</guiicon>,
+<guiicon>Print</guiicon>, <guiicon>Undo</guiicon>, <guiicon>Redo</guiicon>,
+<guiicon>Cut</guiicon>, <guiicon>Copy</guiicon>, <guiicon>Paste</guiicon>,
+<guiicon>Find</guiicon>, <guiicon>Go Backward</guiicon>,
+<guiicon>Go Forward</guiicon> and
+<guiicon>Goto Today</guiicon> buttons), a
+<guiicon>Views</guiicon> toolbar (for selecting between
+<guiicon>Whats Next view</guiicon>,
+<guiicon>List view</guiicon>, <guiicon>Day view</guiicon>,
+<guiicon>Work Week view</guiicon>, <guiicon>Week view</guiicon>,
+<guiicon>Next X Day view</guiicon>, <guiicon>Month view</guiicon>,
+ <guiicon>To-do List view</guiicon> and <guiicon>Journal view</guiicon>
+buttons), a Schedule toolbar (with <guiicon>Publish Item Information</guiicon>,
+<guiicon>Send Invitations to Attendees</guiicon>, <guiicon>Send
+Status Update</guiicon> and <guiicon>Open Address Book</guiicon> buttons) and a
+Filters toolbar, which allows you to choose a filter for the &korganizer; views.
+You can customize these toolbars in various ways: you can add new icons,
+change the icon size, change toolbar position and add text description
+to the icons.</para>
+
+<para>There are two ways to change the position of the toolbars:
+<itemizedlist>
+<listitem><para>
+You can right click the toolbar to bring up the <guimenu>Toolbar Menu</guimenu>.
+The icon size and text position can also be adjusted from this menu.
+</para></listitem>
+<listitem><para>
+You can simply drag the toolbar by the handle on the left border of each
+toolbar, and drop it whenever you wish. Also look at other easy <link
+linkend="other-features-drag-and-drop">drag-and-drop operations</link>.
+</para></listitem></itemizedlist>
+</para>
+
+<para>The toolbars are configured in two places:
+<itemizedlist>
+<listitem><para>The tool set is configured in the <menuchoice><guimenu>
+Settings</guimenu><guimenuitem>Configure
+Toolbars....</guimenuitem></menuchoice> menu item.
+</para></listitem>
+<listitem><para>The graphic style (icon size, text position, &etc;) is
+adjusted through the <guimenu>Toolbar Context Menu</guimenu>. Right click the
+toolbar to access this menu.
+</para></listitem>
+</itemizedlist>
+</para>
+
+<sect2 id="config-toolbars-settings-config">
+<title>Configure Toolbars Dialog</title>
+
+<para>This dialog allows you to customize the selection of tools on the
+toolbar. Open it choosing the <menuchoice><guimenu>Settings</guimenu><guimenuitem>
+Configure Toolbars...</guimenuitem></menuchoice> menu item.</para>
+
+<sect3 id="config-toolbars-choose-toolbar">
+<title>Choosing the toolbar</title>
+
+<para>First you need to choose the toolbar that you want to modify. All actions
+apply to the toolbar that is selected from the drop down menu at the top of
+the window.</para>
+</sect3>
+
+<sect3 id="config-toolbars-available-actions">
+<title>Available Actions</title>
+
+<para>There are two rectangles below the toolbar title: <guilabel>Available
+actions</guilabel> and <guilabel>Current actions</guilabel>. Using the left and
+right arrows (located between the rectangles) you can add icons from the
+Available actions group to the <guilabel>Current actions</guilabel> group. The
+toolbar will have every icon that is in the <guilabel>Current action</guilabel>
+box. The up and down arrows allow you reposition an icon.</para>
+
+<tip><para>Remember that less icons may be better, because the screen is less
+busy and therefore it is easier to find the toolbar buttons you actually use.
+For instance if you always cut and paste with the keyboard hotkeys, you do not
+need the <guiicon>Cut</guiicon>, <guiicon>Copy</guiicon> and
+<guiicon>Paste</guiicon> icons.</para></tip>
+
+</sect3>
+</sect2>
+
+<sect2 id="config-toolbars-context-menu">
+<title>Toolbar Context Menu</title>
+
+<para>This menu allows you to change the look of the toolbars.
+<mousebutton>Right</mousebutton> click the toolbar to access this
+menu.</para>
+
+<sect3 id="config-toolbars-text-position">
+<title>Text Position</title>
+
+<para>Initially, icons do not have any text assigned. You may prefer
+having text under each icon, or text alongside each icon. You can also have
+plain texts without any icons.</para>
+</sect3>
+
+<sect3 id="config-toolbars-toolbar-position">
+<title>Orientation</title>
+
+<para>You can have the toolbar at the top, bottom, left or right side. If you
+choose Floating position, the toolbar will be displayed outside the main
+&korganizer; panel and you can move it around. If you choose Flat, the toolbar
+will collapse into a tiny rectangle. You can later click that rectangle and the
+toolbar will appear again.</para>
+</sect3>
+
+<sect3 id="config-toolbars-icon-size">
+<title>Icon Size</title>
+
+<para>You can change the size of the icons. Make your choice between small,
+medium and large icons.</para>
+</sect3>
+</sect2>
+</sect1>
+
+<!--
+<sect1 id="reference-windows-outgoing">
+<title>Outgoing Messages</title>
+<para>to be written</para>
+</sect1>
+
+<sect1 id="reference-windows-incoming">
+<title>Incoming Messages</title>
+<para>to be written</para>
+</sect1>
+-->
+
+
+</chapter>
+
+&plugins-chapter;
+
+<chapter id="reference">
+<title>Reference</title>
+
+<sect1 id="reference-menus">
+<title>Menus</title>
+
+<para>When &korganizer; starts, the main &korganizer; window
+appears. The window has several components: a menubar, a toolbar, a
+month calendar, a main panel with the current <quote>view</quote> of
+events, and a to-do list.</para>
+
+<para>The menus provide access to all the common operations that can be
+performed with the calendar, including saving, loading, adding and
+deleting events, to-dos and journal entries, printing and more.</para>
+
+<para>Please note that when using &korganizer; as the calendar component
+of &kontact;, the menus differ from the stand alone application.</para>
+
+<sect2 id="reference-menus-file">
+<title><guimenu>File</guimenu></title>
+
+<para>The <guimenu>File</guimenu> menu provides access to functions involving
+the entire calendar.</para>
+
+<variablelist>
+
+<varlistentry id="menu-file-new">
+<term><menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
+</shortcut>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_file_new.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+File</guimenu> <guimenuitem>New</guimenuitem></menuchoice></term>
+<listitem>
+
+<para><action>Opens another main window.</action> This window initially
+contains unnamed calendar. You can use the new window to:</para>
+
+<itemizedlist>
+<listitem><para>open the same calendar twice (select the
+<menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice>
+menu item and choose the same calendar as in the original window)</para></listitem>
+<listitem><para>have two different calendars open at the same time (select the
+<menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice>
+menu item and choose a different calendar). </para></listitem>
+<listitem><para>create a new calendar (select the
+<menuchoice><guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice>
+menu item to give your new calendar a filename and to save it).</para></listitem>
+</itemizedlist>
+
+<para>For more information about this acton, please refer to
+<xref linkend="managing-import-export" />.</para>
+
+</listitem>
+</varlistentry>
+
+<varlistentry id="menu-file-open">
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
+</shortcut>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_file_open.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+File</guimenu> <guimenuitem>Open</guimenuitem></menuchoice></term>
+<listitem><para><action>Opens a file dialog allowing you to select a new
+vCalendar or iCalendar file to load.</action>  If you have made changes to the
+current calendar, you will be given the option of saving them before loading a
+new one.</para>
+<para>For more information about this, please refer to
+<xref linkend="managing-import-export" />.</para>
+</listitem> 
+</varlistentry>
+
+<varlistentry id="menu-file-open-recent">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_file_open.png"
+ format="PNG"/></imageobject></inlinemediaobject>File</guimenu>
+<guimenuitem>Open Recent</guimenuitem>
+</menuchoice></term>
+<listitem><para><guimenuitem>Open Recent</guimenuitem> <action>provides
+a list of recently opened calendar files for quick access, allowing you to
+bypass the file dialog entirely.</action></para>
+<para>For more information about this action, please refer to
+<xref linkend="managing-import-export" />.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="menu-file-save">
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
+</shortcut>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_file_save.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+File</guimenu> <guimenuitem>Save</guimenuitem></menuchoice></term>
+<listitem><para>When you choose <guimenuitem>Save</guimenuitem> or click the
+<guiicon>Save</guiicon> icon, &korganizer; <action>saves the calendar to
+disk, and makes sure all changes that you made will be
+remembered</action>.  If the calendar has no name, Save will behave like
+<guilabel>Save As</guilabel>.</para>
+<para>For more information about this action, please refer to
+<xref linkend="managing-import-export" />.</para>
+</listitem> 
+</varlistentry>
+
+<varlistentry id="menu-file-save-as">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_file_saveas.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+File</guimenu>
+<guimenuitem>Save As...</guimenuitem>
+</menuchoice></term>
+<listitem><para><guilabel>Save As</guilabel> <action>displays a file dialog in
+which you may choose a different name for your calendar than the one currently
+assigned to it</action>. This is useful if you have made changes to a calendar
+that you want to save, but also want to keep separate from your
+<quote>regular</quote> calendar.</para>
+<para>For more information about this action, please refer to
+<xref linkend="managing-import-export" />.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="menu-file-revert">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_file_revert.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+File</guimenu> <guimenuitem>Revert</guimenuitem></menuchoice></term>
+<listitem><para>When you choose <guimenuitem>Revert</guimenuitem>, &korganizer;
+<action>loads the last saved version of the calendar, discarding all the
+changes made after the last save.</action>.</para>
+<para>For more information about this action, please refer to
+<xref linkend="managing-import-export" />.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="menu-file-print">
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo>
+</shortcut>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_file_print.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+File</guimenu> <guimenuitem>Print</guimenuitem></menuchoice></term>
+<listitem><para>Choose <guimenuitem>Print</guimenuitem> or click the
+<guilabel>Print</guilabel> icon to <action>print the current
+calendar</action>. You can specify the range of dates to be printed (either
+manually or with Calendar Widget) and the Print Style (Day, Week, Month or
+To-dos and Journal).</para></listitem>
+</varlistentry>
+
+<!--<varlistentry id="menu-file-print-preview">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject>
+<imagedata fileref="i_file_print_preview.png" 
+format="PNG"/></imageobject></inlinemediaobject>
+File</guimenu><guimenuitem>Print Preview</guimenuitem></menuchoice></term>
+<listitem><para>If you choose <guimenuitem>Print Preview</guimenuitem> or click
+the <guiicon>Print Preview</guiicon> icon, <action>the current calendar will be
+printed on your screen, instead of on your printer</action>. Use this
+feature to check if the printout will be correct before you start
+printing.</para> 
+<para>You can specify the range of dates to be printed (either manually or with
+Calendar Widget) and the View Type (Day, Week, Month or To-do).</para>
+</listitem>
+</varlistentry>-->
+
+<varlistentry id="menu-file-import-calendar">
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guisubmenu>Import</guisubmenu>
+<guimenuitem>Import Calendar</guimenuitem>
+</menuchoice></term>
+<listitem><para>If you have a different iCalendar or
+vCalendar file somewhere, and you would like to <action>merge its contents
+into your own calendar, add as a new resource or open it as a new window</action>,
+choose this menu item.  A good time to do this would be if you received a
+vCalendar with a few entries via email, for instance.</para>
+<para>For more information about this action, please refer to
+<xref linkend="managing-import" />.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="menu-file-import-ical">
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guisubmenu>Import</guisubmenu>
+<guimenuitem>Import From &UNIX; Ical Tool</guimenuitem>
+</menuchoice></term>
+<listitem><para>If you have used <application>ical</application>, a popular but
+older calendar program for &UNIX;, you may wish to <action>import your events,
+events, and to-do</action> directly to &korganizer;. This action
+will read the <filename>.calendar</filename> file from your home
+folder and merge any entries it contains into your current calendar.
+If any errors or suspicious things occur during the process, you will be
+notified via a message box.</para>
+<para>For more information about this action, please refer to
+<xref linkend="managing-import" />.</para>
+</listitem> 
+</varlistentry>
+
+<varlistentry id="menu-file-import-ghns">
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guisubmenu>Import</guisubmenu>
+<guimenuitem>Get Hot New Stuff...</guimenuitem>
+</menuchoice></term>
+<listitem><para>This action will open the <guilabel>Get Hot New Stuff</guilabel>
+dialog, which offers a list of calendars to download. These events can be
+added to your calendar.</para>
+<para>For more information about this action, please refer to
+<xref linkend="managing-get-hot-new-stuff" />.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="menu-file-export-as-web">
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guisubmenu>Export</guisubmenu>
+<guimenuitem>Export Web Page...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>You can export your calendar or a part of it as a &HTML;
+file, suitable for publishing on the World Wide Web.</action></para>
+<para>For more information about this action, please refer to
+<xref linkend="managing-export" />.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-file-export-icalendar">
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guisubmenu>Export</guisubmenu>
+<guimenuitem>iCalendar</guimenuitem>
+</menuchoice></term>
+<listitem><para>This action will export all your active events, to-dos and
+journal entries (independent of to what resource they belong) as a new iCalendar
+file.</para>
+<para>For more information about this action, please refer to
+<xref linkend="managing-export" />.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="menu-file-export-vcalendar">
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guisubmenu>Export</guisubmenu>
+<guimenuitem>vCalendar</guimenuitem>
+</menuchoice></term>
+<listitem><para>This action will export all your active events, to-dos and
+journal entries (independent of to what resource they belong) as a new vCalendar
+file.</para>
+<para>For more information about this action, please refer to
+<xref linkend="managing-export" />.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="menu-file-export-ghns">
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guisubmenu>Export</guisubmenu>
+<guimenuitem>Upload Hot New Stuff...</guimenuitem>
+</menuchoice></term>
+<listitem><para>This action will open the <guilabel>Upload Hot New Stuff</guilabel>
+dialog, which allow you to export calendars containing events which may be
+useful to other people, such as a conference program, a list of holidays,
+special events, &etc;</para>
+<para>For more information about this action, please refer to
+<xref linkend="managing-get-hot-new-stuff" />.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="menu-file-archive-old">
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>Archive Old Entries...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>From time to time you should delete your old
+events.</action></para>
+<para>For more information about this action, please refer to
+<xref linkend="managing-purge-archive" />.</para>
+</listitem>
+</varlistentry>
+
+<!--<varlistentry id="menu-file-make-active">
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>Make active</guimenuitem>
+</menuchoice></term>
+<listitem><para>If you opened more than one calendar, only one calendar can
+display alarms; only one calendar can be active. Click the <guilabel>Make
+active</guilabel> menu item to <action>activate the current calendar
+window.</action></para>
+<para>The active calendar is loaded as default calendar when starting
+&korganizer;. In other words, if you work with more than one calendar, you
+should make your main calendar active.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-file-addressbook">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_file_addressbook.png"
+ format="PNG"/></imageobject></inlinemediaobject>File</guimenu>
+<guimenuitem>Addressbook</guimenuitem>
+</menuchoice></term>
+<listitem><para>This action will open the address book browser in a new
+window.</para></listitem>
+</varlistentry>
+-->
+
+<varlistentry id="menu-file-purge">
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>Purge Completed To-dos</guimenuitem>
+</menuchoice></term>
+<listitem><para>This action will remove all the completed to-dos from your
+active calendar.</para>
+<para>For more information about this action, please refer to
+<xref linkend="managing-purge-archive" />.</para>
+</listitem></varlistentry>
+
+<!--
+<varlistentry id="menu-file-close">
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo>
+</shortcut>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_file_close.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+File</guimenu> <guimenuitem>Close</guimenuitem></menuchoice></term>
+<listitem><para><action>Closes the current calendar. The window itself will
+remain open, and may be reused to open another
+calendar.</action></para></listitem>
+</varlistentry>
+-->
+
+<varlistentry id="menu-file-quit">
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
+</shortcut>
+<guimenu><inlinemediaobject><imageobject><imagedata
+ fileref="i_file_quit.png"/></imageobject></inlinemediaobject> File</guimenu>
+<guimenuitem>Quit</guimenuitem>
+</menuchoice></term>
+<listitem><para>When you choose <guimenuitem>Quit</guimenuitem> or click
+the <guiicon>Quit</guiicon> icon, <action>the current calendar window will quit,
+prompting you to save if the current calendar has been modified but not yet
+saved.</action></para>
+<para>This has no effect on other calendar windows which may be opened. You have
+to quit each calendar window individually.</para> </listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2 id="reference-menus-edit">
+<title>Edit</title>
+
+<para>With the <guilabel>Edit</guilabel> menu you can edit and search events and
+to-dos.</para>
+
+<para><guimenuitem>Cut</guimenuitem>, <guimenuitem>Copy</guimenuitem>, and
+<guimenuitem>Paste</guimenuitem> menu items behave in the same fashion as in
+ other
+&kde; applications. With the <guimenuitem>Find</guimenuitem> menu item you can
+find event and to-dos across the current calendar.</para>
+
+<variablelist>
+
+<varlistentry id="menu-edit-undo">
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
+</shortcut>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_edit_undo.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+Edit</guimenu> <guimenuitem>Undo</guimenuitem> </menuchoice></term>
+<listitem><para><action>Undo the latest action</action>, or in other words,
+return the calendar to the state it was immediately before the latest
+action.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-edit-redo">
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo>
+</shortcut>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_edit_redo.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+Edit</guimenu> <guimenuitem>Redo</guimenuitem> </menuchoice></term>
+<listitem><para><action>Redo the latest action</action>, or in other words,
+return the calendar to the state it was immediately before the latest
+undo.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-edit-cut">
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo>
+</shortcut>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_cut.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+Edit</guimenu> <guimenuitem>Cut</guimenuitem> </menuchoice></term>
+<listitem><para><action>Cuts the currently selected event(s) to the clipboard,
+removing them from your calendar.</action></para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-edit-copy">
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>
+</shortcut>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_copy.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+Edit</guimenu> <guimenuitem>Copy</guimenuitem></menuchoice></term>
+<listitem><para><action>Copies the currently selected item(s) to the
+clipboard, but leaving them untouched.</action></para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-edit-paste">
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
+</shortcut>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_paste.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+Edit</guimenu> <guimenuitem>Paste</guimenuitem></menuchoice></term>
+<listitem><para><guimenuitem>Paste</guimenuitem> <action>inserts the
+contents of the clipboard into your calendar</action>. The clipboard must
+contain a valid vCalendar or iCalendar, provided either by a previous Cut/Copy
+operation or from a selection made outside of &korganizer;. You will be warned
+if the contents of the clipboard cannot be understood.</para>
+<tip><para>However, you can safely use <keycombo action="simul">&Ctrl;
+<keycap>C</keycap></keycombo> and <keycombo action="simul">&Ctrl;
+<keycap>V</keycap></keycombo> hotkeys to copy text data from any outside
+application to a &korganizer; Edit Event window and vice
+versa. </para></tip></listitem>
+</varlistentry>
+
+<varlistentry id="menu-edit-delete">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_edit_delete.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+Edit</guimenu> <guimenuitem>Delete</guimenuitem> </menuchoice></term>
+<listitem><para><action>Delete the currently selected item(s),
+removing them from your calendar.</action></para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-edit-find">
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>f</keycap></keycombo>
+</shortcut>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_edit_find.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+Edit</guimenu> <guimenuitem>Find</guimenuitem>
+</menuchoice></term>
+<listitem><para>Choose <guimenuitem>Find</guimenuitem> from the
+<guimenu>Edit</guimenu> or click the <guiicon>Find</guiicon> icon to
+<action>find events, to-dos and journal entries according to their title,
+description, and/or categories</action>.</para>
+<para>For more information about this action, please refer to
+<xref linkend="search-view" />.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2 id="reference-menus-view">
+<title><guimenu>View</guimenu></title>
+
+<para>There are several different <quote>views</quote> available for
+displaying your events, to-dos and journal entries. &korganizer; is smart
+enough to remember in between sessions what the last active view was, and the
+next time it is started, it will display that view.</para>
+
+<para>In general, each view will provide a way of displaying your journal
+entries, to-dos and and events, constrained to a particular time period or
+style of display. Click any item to select it for further action.
+<mousebutton>Right</mousebutton> click an item to bring up a menu
+with options such as <guimenuitem>edit</guimenuitem>,
+<guimenuitem>delete</guimenuitem>, and so on.  You can also use the
+<guimenu>Action</guimenu> menu to perform similar operations.</para>
+
+<variablelist>
+
+<varlistentry id="menu-view-whatsnext">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_view_whatsnext.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+View</guimenu><guimenuitem>What's Next</guimenuitem></menuchoice></term>
+<listitem><para><action>Switch the display to the what's next view.</action></para>
+<para>This view displays your next events and to-dos. Events and to-dos are
+displayed one per line.</para>
+<para>For more information about this action, please refer to
+<xref linkend="whatsnext-view" />.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="menu-view-day">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_view_day.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+View</guimenu><guimenuitem>Day</guimenuitem></menuchoice></term>
+<listitem><para><action>Switch the display to the day view.</action></para>
+<para>For more information about this action, please refer to
+<xref linkend="agenda-view" />.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="menu-view-xdays">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_view_xdays.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+View</guimenu><guimenuitem>Next x Days</guimenuitem></menuchoice></term>
+<listitem><para><action>Switch the display to the next x day view, where x is
+defined in &korganizer; main configurations.</action></para>
+<para>For more information about this action, please refer to
+<xref linkend="agenda-view" />.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="menu-view-workweek">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata
+ fileref="i_view_work_week.png"
+format="PNG"/></imageobject></inlinemediaobject> View</guimenu><guimenuitem>Work
+Week</guimenuitem></menuchoice></term>
+<listitem><para><action>Switch the display to the work week
+view.</action></para>
+<para>This is the same as the week view, except only the working days of the
+week are shown.</para>
+<para>For more information about this action, please refer to
+<xref linkend="agenda-view" />.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="menu-view-week">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_view_week.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+View</guimenu> <guimenuitem>Week</guimenuitem></menuchoice></term>
+<listitem><para><action>Switch the display to the week view.</action></para>
+<para>The week view provides a view similar to the day view. Events for seven
+days are shown next to each other.  All of the functions available for the day
+view are available in the week view, too.</para>
+<para>For more information about this action, please refer to
+<xref linkend="agenda-view" />.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-view-month">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_view_month.png"
+ format="PNG"/></imageobject></inlinemediaobject> View</guimenu>
+<guimenuitem>Month</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Switch the display to the Month view.</action></para>
+<para>For more information about this action, please refer to
+<xref linkend="agenda-view" />.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="menu-view-list">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_view_list.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+View</guimenu><guimenuitem>List</guimenuitem></menuchoice></term>
+<listitem><para><action>Switch the display to the list view.</action></para>
+<para>For more information about this action, please refer to
+<xref linkend="list-view" />.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="menu-view-todo">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata
+ fileref="i_view_todo_list.png"
+format="PNG"/></imageobject></inlinemediaobject> View</guimenu>
+ <guimenuitem>To-do List</guimenuitem></menuchoice></term>
+<listitem><para><action>Switch the display to the to-do list view.</action></para>
+<para>For more information about this action, please refer to
+<xref linkend="todo-view" />.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="menu-view-journal">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata
+ fileref="i_view_journal.png"
+format="PNG"/></imageobject></inlinemediaobject>View</guimenu>
+<guimenuitem>Journal</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Switch the display to the journal view.</action></para>
+<para>For more information about this action, please refer to
+<xref linkend="journal-view" />.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-view-update">
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Refresh</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+<action>Updates or refreshes the currently displayed view.</action>
+</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-view-zoom">
+<term><menuchoice>
+<guimenu>View</guimenu><guisubmenu>Zoom</guisubmenu></menuchoice></term>
+<listitem><para><action>Use this submenu to adjust the current view to show
+more or less data.</action></para>
+<para>In the agenda view (day(s) or week view), you can use the zoom actions to
+show more or less days (<guimenuitem>Zoom In Horizontally</guimenuitem> and
+<guimenuitem>Zoom Out Horizontally</guimenuitem>), or more or less hours in the
+day (<guimenuitem>Zoom In Vertically</guimenuitem> and
+<guimenuitem>Zoom Out Vertically</guimenuitem>).</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-view-filter">
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guisubmenu>Filter</guisubmenu>
+</menuchoice></term>
+<listitem><para>This submenu offers access to the filters already created using
+the <link linkend="menu-settings-edit-filters"><guilabel>Edit
+Filters</guilabel></link> dialog. <action>Select on this submenu the filter
+that will be used in &korganizer; view.</action>. If you don't want to use a
+filter, choose <guilabel>No filter</guilabel>.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<sect2 id="reference-menus-go">
+<title><guimenu>Go</guimenu></title>
+
+<para>For more information about browsing &korganizer; views, please refer to
+<xref linkend="description-view" />.</para>
+
+<variablelist>
+<varlistentry id="menu-go-previous-day">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_go_backward.png"
+format="PNG"/></imageobject></inlinemediaobject>
+Go</guimenu><guimenuitem>Go Backward</guimenuitem></menuchoice></term>
+<listitem><para><action>Go to the previous day, week or month, depending on
+the view.</action></para></listitem>
+</varlistentry>
+<varlistentry id="menu-go-next-day">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_go_forward.png"
+ format="PNG"/></imageobject></inlinemediaobject>
+Go</guimenu><guimenuitem>Go Forward</guimenuitem></menuchoice></term>
+<listitem><para><action>Go to the next day, week, or month, depending on the
+view.</action></para></listitem>
+</varlistentry>
+<varlistentry id="menu-go-goto-today">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_go_to_today.png"
+format="PNG"/></imageobject></inlinemediaobject>
+Go</guimenu><guimenuitem>Go to Today</guimenuitem></menuchoice></term>
+<listitem><para><action>Go to the period of time that includes the current day.</action></para></listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2 id="reference-menus-actions">
+<title><guimenu>Actions</guimenu></title>
+
+<variablelist>
+<varlistentry id="menu-actions-new-event">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_actions_newevent.png"
+format="PNG"/></imageobject></inlinemediaobject>Actions</guimenu>
+<guimenuitem>New Event...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Choose <guilabel>New Event...</guilabel> to <action>create a
+new event</action>.</para>
+<para>You can get a detailed description of the event window in <link
+linkend="entering-data-events">the Entering Events</link> section.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-actions-new-todo">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_actions_newtodo.png"
+format="PNG"/></imageobject></inlinemediaobject>Actions</guimenu>
+<guimenuitem>New To-do...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Choose <guilabel>New To-do...</guilabel> to <action>create a
+new to-do</action>. Initially the to-do has no due date, but you can specify
+one.</para>
+<para>You can get a detailed description of the to-do window in <link
+linkend="entering-data-to-do">the Entering To-dos</link> section.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-actions-new-subtodo">
+<term><menuchoice>
+<guimenu>Actions</guimenu>
+<guimenuitem>New Sub-to-do...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Choose <guilabel>New Sub-to-do...</guilabel> to <action>start
+writing a new sub-to-do. The currently selected to-do will be the the
+sub-to-do parent.</action>. Initially the to-do has no due date, but you can
+specify one.</para>
+<para>You can get a detailed description of the to-do window in <link
+linkend="entering-data-to-do">Entering To-dos</link> section.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-actions-new-journal">
+<term><menuchoice>
+<guimenu>Actions</guimenu>
+<guimenuitem>New Journal...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Choose <guilabel>New Journal...</guilabel> to <action>start
+writing a new journal entry.</action>.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-actions-show-event">
+<term><menuchoice>
+<guimenu>Actions</guimenu>
+<guimenuitem>Show</guimenuitem>
+</menuchoice></term>
+<listitem><para>Choose <guilabel>Show</guilabel> to <action>open a dialog
+showing the details of the currently selected journal entry, event or
+to-do.</action></para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-actions-edit-event">
+<term><menuchoice>
+<guimenu>Actions</guimenu>
+<guimenuitem>Edit...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Choose <guilabel>Edit...</guilabel> to <action>edit the
+currently selected journal entry, event or to-do.</action></para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-actions-delete-event">
+<term><menuchoice>
+<guimenu>Actions</guimenu>
+<guimenuitem>Delete</guimenuitem>
+</menuchoice></term>
+<listitem><para>Choose <guilabel>Delete</guilabel> to <action>remove the
+currently selected journal entry, event or to-do.</action></para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-actions-make-subtodo-independent">
+<term><menuchoice>
+<guimenu>Actions</guimenu>
+<guimenuitem>Make Sub-to-do Independent</guimenuitem>
+</menuchoice></term>
+<listitem><para>Choose <guilabel>Make Sub-to-do Independent</guilabel> to
+detach the currently selected sub-to-do item from its parent and make it an
+independent to-do item.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<sect2 id="reference-menus-schedule">
+<title><guimenu>Schedule</guimenu></title>
+
+<variablelist>
+
+<varlistentry id="menu-schedule-publish">
+<term><menuchoice>
+<guimenu>Schedule</guimenu>
+<guimenuitem>Publish Item Information...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Email the selected event, to-do or journal entry in the
+iCalendar format.</para>
+<para>For more information about this action, please refer to
+<xref linkend="publish" />.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-schedule-request">
+<term><menuchoice>
+<guimenu>Schedule</guimenu>
+<guimenuitem>Send Invitation to Attendees</guimenuitem>
+</menuchoice></term>
+<listitem><para>Send the selected to-do or event to the attendees, and,
+if necessary, request a response from them.</para>
+<para>For more information about this action, please refer to
+<xref linkend="request" />.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-schedule-reply">
+<term><menuchoice>
+<guimenu>Schedule</guimenu>
+<guimenuitem>Send Status Update</guimenuitem>
+</menuchoice></term>
+<listitem><para>If you changed your status as an attendee, choose this
+menu item to send your updated status (accepted, tentative, &etc;) to the item's
+organizer.</para>
+<para>For more information about this action, please refer to
+<xref linkend="reply" />.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-schedule-cancel">
+<term><menuchoice>
+<guimenu>Schedule</guimenu>
+<guimenuitem>Send Cancellation to Attendees</guimenuitem>
+</menuchoice></term>
+<listitem><para>If you plan to cancel an event or to-do, select it, and 
+choose this menu item to notify the attendees about the cancellation.</para>
+<para>For more information about this action, please refer to
+<xref linkend="cancel" />.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-schedule-refresh">
+<term><menuchoice>
+<guimenu>Schedule</guimenu>
+<guimenuitem>Request Update</guimenuitem>
+</menuchoice></term>
+<listitem><para>Request the latest version of the selected event or to-do from
+the organizer.</para>
+<para>For more information about this action, please refer to
+<xref linkend="refresh" />.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-schedule-counter">
+<term><menuchoice>
+<guimenu>Schedule</guimenu>
+<guimenuitem>Request Change</guimenuitem>
+</menuchoice></term>
+<listitem><para>Send an alternative proposal to the organizer of the selected
+event or to-do.
+</para>
+<para>For more information about this action, please refer to
+<xref linkend="counter" />.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-schedule-mail-freebusy">
+<term><menuchoice>
+<guimenu>Schedule</guimenu>
+<guimenuitem>Mail Free Busy Information...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Email your Free Busy information to one or more
+email addresses.</para>
+<para>For more information about this action, please refer to
+<xref linkend="free-busy" />.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-schedule-upload-freebusy">
+<term><menuchoice>
+<guimenu>Schedule</guimenu>
+<guimenuitem>Upload Free Busy Information</guimenuitem>
+</menuchoice></term>
+<listitem><para>Upload your Free Busy information to the groupware server.
+Other users will then be able to retrieve the information.</para>
+<para>For more information about this action, please refer to
+<xref linkend="free-busy" />.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<sect2 id="reference-menus-settings">
+<title><guimenu>Settings</guimenu></title>
+
+<variablelist>
+<varlistentry id="menu-settings-show-toolbar">
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guisubmenu>Toolbars</guisubmenu>
+</menuchoice></term>
+<listitem><para><action>Click the menu items of this submenu to show or hide
+&korganizer; toolbars.</action></para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-settings-show-statusbar">
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show Status bar</guimenuitem>
+</menuchoice> or <menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Hide Status bar</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Choose this menu item to toggle the display of the
+status bar on and off</action>.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-settings-sidebar">
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guisubmenu>Sidebar</guisubmenu>
+</menuchoice></term>
+<listitem><para><action>Click the menu items of this submenu to show or hide
+&korganizer; sidebar components</action>. Note that the sidebar is visible only
+when <link linkend="config-main-views">the current view does not use the full
+window.</link></para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-settings-show-resource-buttons">
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guisubmenu>Sidebar</guisubmenu>
+<guimenuitem>Show Resource Buttons</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Click this menu item toggle the display of the
+<link linkend="managing-resources">resource view sidebar</link> buttons on and
+off</action>.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-settings-configure-date-time">
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure Date &amp; Time...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Click this menu item to set the desktop date and time
+formats</action>. Note that this setting is shared between other desktop
+applications.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-settings-edit-filters">
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guisubmenu>Manage View Filters...</guisubmenu>
+</menuchoice></term>
+<listitem><para><action>Choose this menu item to open the <guilabel>Edit
+Filters</guilabel> dialog</action>. Using this dialog, you can create, delete
+and edit filters that will affect which items will be displayed by
+&korganizer;.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-settings-edit-categories">
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Manage Categories...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Choose this menu item to open the <guilabel>Edit
+Categories</guilabel> dialog</action>. Using this dialog, you can create, delete
+and edit calendar item categories. Categories are used to organize your events and
+to-dos in related groups.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-settings-configure-shortcuts">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata
+ fileref="i_settings_prefs.png"
+format="PNG"/></imageobject></inlinemediaobject>
+Settings</guimenu>
+<guimenuitem>Configure Shortcuts...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Choose this menu item to open the <guilabel>Configure
+Shortcuts</guilabel> dialog</action>. This dialog allows you to assign shortcuts
+to &korganizer; actions, and configure the shortcuts already assigned.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-settings-configure-toolbars">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata
+ fileref="i_settings_prefs.png"
+format="PNG"/></imageobject></inlinemediaobject>
+Settings</guimenu>
+<guimenuitem>Configure Toolbars...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Choose this menu item to open the <link
+linkend="config-toolbars"><guilabel>Configure
+Toolbars</guilabel> dialog</link></action>. This dialog allows you to add, remove and
+change the order of the actions in &korganizer; toolbars.</para></listitem>
+</varlistentry>
+
+<varlistentry id="menu-settings-configure-korganizer">
+<term><menuchoice>
+<guimenu><inlinemediaobject><imageobject><imagedata
+ fileref="i_settings_prefs.png"
+format="PNG"/></imageobject></inlinemediaobject>
+Settings</guimenu><guimenuitem>Configure &korganizer;...</guimenuitem></menuchoice></term>
+<listitem><para>Choose the <menuchoice><guimenu>Settings</guimenu>
+<guimenuitem>Configure &korganizer;...</guimenuitem> </menuchoice> menu item
+ to display &korganizer; <link linkend="config-main">Configure
+dialog</link>.</para>
+<para>For more information about this action, please refer to
+<xref linkend="config-main" />.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<sect2 id="reference-menus-help">
+<title><guimenu>Help</guimenu></title>
+
+&help.menu.documentation;
+
+</sect2>
+
+</sect1>
+
+<sect1 id="reference-hotkey">
+<title>HotKeys</title>
+
+<para>This is a reference to all hotkeys and their corresponding description in
+the handbook.</para>
+
+
+<sect2 id="reference-hotkey-sortalpha">
+<title>Hotkeys Sorted Alphabetically</title> 
+
+<informaltable>
+<tgroup cols="2">
+<colspec colname="hotkey"/>
+<colspec colname="desc"/>
+<thead>
+<row>
+  <entry>Hotkey</entry>
+  <entry>Description</entry>
+</row>
+</thead>
+<tbody>
+<row>
+  <entry><keycombo action="simul">&Ctrl; <keycap>C</keycap> </keycombo></entry>
+  <entry><link linkend="menu-edit-copy"><menuchoice><guimenu>Edit</guimenu>
+  <guimenuitem>Copy</guimenuitem></menuchoice></link> equivalent; copy the
+  selection to clipboard.</entry>
+</row>
+<row>
+  <entry><keycombo action="simul">&Ctrl; <keycap>F</keycap></keycombo></entry>
+  <entry><link linkend="menu-edit-find"><menuchoice><guimenu>Edit</guimenu>
+  <guimenuitem>Find</guimenuitem></menuchoice></link> equivalent; Find data in
+  current calendar.</entry>
+</row>
+<row>
+  <entry><keycap>F1</keycap></entry>
+  <entry><menuchoice><guimenu>Help</guimenu>
+  <guimenuitem>Contents</guimenuitem></menuchoice> equivalent; help for
+  &korganizer;.</entry>
+</row>
+<row>
+  <entry><keycombo action="simul">&Ctrl; <keycap>N</keycap></keycombo></entry>
+  <entry><link linkend="menu-file-new"><menuchoice><guimenu>File</guimenu>
+  <guimenuitem>New</guimenuitem></menuchoice></link> equivalent; create and open
+  new calendar.</entry>
+</row>
+<row>
+  <entry><keycombo action="simul">&Ctrl; <keycap>O</keycap></keycombo></entry>
+  <entry><link linkend="menu-file-open"><menuchoice><guimenu>File</guimenu>
+  <guimenuitem>Open</guimenuitem></menuchoice></link> equivalent; open a
+  calendar file in the current window.</entry>
+</row>
+<row>
+  <entry><keycombo action="simul">&Ctrl; <keycap>P</keycap></keycombo></entry>
+  <entry><link linkend="menu-file-print"><menuchoice><guimenu>File</guimenu>
+  <guimenuitem>Print</guimenuitem></menuchoice></link> equivalent; print current
+  calendar.</entry>
+</row>
+<row>
+  <entry><keycombo action="simul">&Ctrl; <keycap>Q</keycap></keycombo></entry>
+  <entry><link linkend="menu-file-quit"><menuchoice><guimenu>File</guimenu>
+  <guimenuitem>Quit</guimenuitem></menuchoice></link> equivalent; quit current
+  calendar. </entry>
+</row>
+<row>
+  <entry><keycombo action="simul">&Ctrl; <keycap>S</keycap></keycombo></entry>
+  <entry><link linkend="menu-file-save"><menuchoice><guimenu>File</guimenu>
+  <guimenuitem>Save</guimenuitem></menuchoice></link> equivalent; save current
+  calendar.</entry>
+</row>
+<row>
+  <entry><keycombo action="simul">&Ctrl; <keycap>V</keycap></keycombo></entry>
+  <entry><link linkend="menu-edit-paste"><menuchoice><guimenu>Edit</guimenu>
+  <guimenuitem>Paste</guimenuitem></menuchoice></link> equivalent; paste data
+  from clipboard.</entry>
+</row>
+<!--<row>
+  <entry><keycombo action="simul">&Ctrl; <keycap>W</keycap></keycombo></entry>
+  <entry><link linkend="menu-file-close"><menuchoice><guimenu>File</guimenu>
+  <guimenuitem>Close</guimenuitem></menuchoice></link> equivalent; close current
+  calendar.</entry>
+</row>-->
+<row>
+  <entry><keycombo action="simul">&Ctrl; <keycap>X</keycap></keycombo></entry>
+  <entry><link linkend="menu-edit-cut"><menuchoice><guimenu>Edit</guimenu>
+  <guimenuitem>Cut</guimenuitem></menuchoice></link> equivalent; cut the
+  selection to the clipboard.</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+
+</sect2>
+
+<sect2 id="reference-hotkey-sortbyfunc">
+<title>Hotkeys Sorted by Function</title> 
+
+<informaltable>
+<tgroup cols="2">
+<colspec colname="desc"/>
+<colspec colname="hotkey"/>
+<thead>
+<row>
+  <entry>Description</entry>
+  <entry>Hotkey</entry>
+</row>
+</thead>
+<tbody>
+<!--<row>
+  <entry><emphasis>Close:</emphasis> <link linkend="menu-file-close"> <menuchoice>
+  <guimenu>File</guimenu> <guimenuitem>Close</guimenuitem></menuchoice></link>
+  equivalent; close current calendar.</entry>
+  <entry><keycombo action="simul">&Ctrl; <keycap>W</keycap></keycombo></entry>
+</row>-->
+<row>
+  <entry><emphasis>Copy:</emphasis> <link linkend="menu-edit-copy"> <menuchoice>
+  <guimenu>Edit</guimenu> <guimenuitem>Copy</guimenuitem></menuchoice> </link>
+  equivalent; copy the selection to clipboard.</entry>
+  <entry><keycombo action="simul">&Ctrl; <keycap>C</keycap></keycombo></entry>
+</row>
+<row>
+  <entry><emphasis>Cut:</emphasis> <link linkend="menu-edit-cut"> <menuchoice>
+  <guimenu>Edit</guimenu> <guimenuitem>Cut</guimenuitem></menuchoice> </link>
+  equivalent; cut the selection to the clipboard.</entry>
+  <entry><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></entry>
+</row>
+<row>
+  <entry><emphasis>Find:</emphasis> <link linkend="menu-edit-find"> <menuchoice>
+  <guimenu>Edit</guimenu> <guimenuitem>Find</guimenuitem></menuchoice></link>
+  equivalent; Find data in current calendar.</entry>
+  <entry><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></entry>
+</row>
+<row>
+  <entry><emphasis>Help:</emphasis>  <menuchoice>
+  <guimenu>Help</guimenu>
+  <guimenuitem>Contents</guimenuitem></menuchoice> equivalent; help for
+  &korganizer;.</entry>
+  <entry><keycap>F1</keycap></entry>
+</row>
+<row>
+  <entry><emphasis>New:</emphasis> <link linkend="menu-file-new"> <menuchoice>
+  <guimenu>File</guimenu> <guimenuitem>New</guimenuitem></menuchoice></link>
+  equivalent; create and open new calendar.</entry>
+  <entry><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></entry>
+</row>
+<row>
+  <entry><emphasis>Open:</emphasis> <link linkend="menu-file-open"> <menuchoice>
+  <guimenu>File</guimenu> <guimenuitem>Open</guimenuitem></menuchoice></link>
+  equivalent; open a calendar file in the current window.</entry>
+  <entry><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></entry>
+</row>
+<row>
+  <entry><emphasis>Paste:</emphasis> <link linkend="menu-edit-paste"> <menuchoice>
+  <guimenu>Edit</guimenu> <guimenuitem>Paste</guimenuitem></menuchoice></link>
+  equivalent; paste data from clipboard.</entry>
+  <entry><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></entry>
+</row>
+<row>
+  <entry><emphasis>Print:</emphasis> <link linkend="menu-file-print"> <menuchoice>
+  <guimenu>File</guimenu> <guimenuitem>Print</guimenuitem> </menuchoice> </link>
+  equivalent; print current calendar.</entry>
+  <entry><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></entry>
+</row>
+<row>
+  <entry><emphasis>Quit:</emphasis> <link linkend="menu-file-quit"> <menuchoice>
+  <guimenu>File</guimenu> <guimenuitem>Quit</guimenuitem></menuchoice></link>
+  equivalent; quit current calendar. </entry>
+  <entry><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></entry>
+</row>
+<row>
+  <entry><emphasis>Save:</emphasis> <link linkend="menu-file-save"> <menuchoice>
+  <guimenu>File</guimenu> <guimenuitem>Save</guimenuitem></menuchoice></link>
+  equivalent; save current calendar.</entry>
+  <entry><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+
+</sect2> 
+
+</sect1>
+
+<sect1 id="reference-action-buttons">
+<title>Action Buttons</title>
+
+<para>Many windows contain buttons <guibutton>Default</guibutton>,
+<guibutton>Delete</guibutton>, <guibutton>OK</guibutton>,
+<guibutton>Apply</guibutton>, and <guibutton>Cancel</guibutton>. With these
+buttons you will decide whether the data that you entered into the window will
+be saved or forgotten.</para>  
+
+<variablelist>
+<varlistentry>
+<term><guibutton>Default</guibutton></term>
+<listitem><para>If you click the <guibutton>Default</guibutton> button, changes
+you have made will be forgotten, and all choices will be returned to their
+default values.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guibutton>Delete</guibutton></term>
+<listitem><para>Click <guibutton>Delete</guibutton> to completely remove the
+event or event that you are editing from the calendar.</para></listitem> 
+</varlistentry>
+<varlistentry>
+<term><guibutton>OK</guibutton></term>
+<listitem><para>When you click the <guibutton>OK</guibutton> button, your
+changes will be remembered and &korganizer; will close the
+ window.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guibutton>Apply</guibutton></term>
+<listitem><para>When you click the <guibutton>Apply</guibutton> button, your
+changes will be remembered, and the window will remain on screen for further
+editing.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guibutton>Cancel</guibutton></term>
+<listitem><para>If you click the <guibutton>Cancel</guibutton> button, your
+editing will be forgotten, and &korganizer; will close the
+ window.</para></listitem> 
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+</chapter>
+
+<chapter id="other-features">
+<title>Other Features</title>
+
+<para>In this chapter, you'll learn other useful features of
+&korganizer;: what tricks you can do with a click
+of your mouse and what interaction between &korganizer; and &konqueror; is
+possible.</para>
+
+<para>You'll also learn about synchronizing with your &PalmPilot; or
+compatible handheld
+computer.</para>
+
+<sect1 id="other-features-commandline-options">
+<title>Command Line</title>
+
+<para>A nice program to access a &kde; calendar from the command line is konsolekalendar, which 
+is included in the kdepim package together with &korganizer;.</para>
+
+</sect1>
+
+<sect1 id="other-features-drag-and-drop">
+<title>Drag and Drop Operations</title>
+
+<para>&korganizer; can be easily controlled with your mouse. The supported
+ drag-and-drop
+operations are detailed below.</para>
+
+<itemizedlist>
+<listitem><para>Any event can be re-sized with your mouse. Simply move the mouse
+pointer near the top or bottom edge of the event, and drag the edge up or
+down. This way you can visually modify the starting and ending time of your
+appointment. This works in the Day, Week and Work Week views.</para></listitem> 
+<listitem><para>Any event can be rescheduled with your mouse. Move the mouse
+pointer over the event, and drag it to a new time location. This works in the
+Day, Week and Work Week views.</para></listitem>
+<listitem><para>Events can be copied to other, presently non-visible dates. Move
+the mouse pointer over the event, and drag it to the Date Navigator on the left
+side of the current calendar, or to the Date Navigator of a different
+calendar.</para>
+<tip><para>However, you cannot drag from agenda view in one calendar to
+agenda view in other calendar.</para></tip></listitem>
+<listitem><para>Toolbars can be dragged on the screen. Move the mouse pointer
+over the tollbar's handle, and drag it to a new location on your
+screen.</para></listitem>
+</itemizedlist>
+
+</sect1>
+
+<sect1 id="other-features-konqueror-interaction">
+<title>&konqueror; Interaction</title>
+
+<para>&konqueror; recognizes the vCalendar format used by
+&korganizer;. If you use &konqueror; to navigate to your calendar, it
+will be displayed <emphasis>inside</emphasis> &konqueror; as a live
+object. You will be able to perform most operations with your calendar
+inside &konqueror;; you will not need to start &korganizer;. In
+technical jargon, this is described as <quote>embedding vCalendar as
+KPart inside &konqueror;</quote>.</para>
+
+</sect1>
+
+<sect1 id="other-features-palm-sync">
+<title>Palm Synchronization</title>
+
+<para>Palm Synchronization can be done via &kpilot;. Choose 
+<menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure &kpilot;</guimenuitem>
+</menuchoice> and check the <guilabel>Calendar (&korganizer;)</guilabel> and
+<guilabel>To-do's (&korganizer;)</guilabel> boxes. After synchronization the
+Calendar and To-do's should be visible in &korganizer;.</para>
+<para>See the <link linkend="faq">&FAQ;</link> for one of the most common &PalmPilot;
+syncing problems.</para>
+
+</sect1>
+
+</chapter>
+
+<chapter id="faq">
+<title>Questions and Answers</title>
+
+<qandaset id="faq-questions">
+<qandaentry>
+<question>
+<para>Can I import my old <application>Ical</application> data?</para>
+</question>
+<answer><para>Sure! Follow the instructions in <link
+linkend="menu-file-import-ical">Import From &UNIX; Ical section</link>.</para>
+</answer>
+</qandaentry>
+<qandaentry>
+<question>
+<para>Can I import data from &Microsoft;
+<application>Outlook</application>?</para> 
+</question>
+<answer><para>Yes you can, but you must first tell
+<application>Outlook</application> to export its data to vCalendar format. Then
+you must copy this data to your home folder, click
+<menuchoice><guimenu>File</guimenu> <guimenuitem>Open</guimenuitem>
+</menuchoice>, navigate to the file and double-click it.
+For more information on importing data from &Microsoft;
+<application>Outlook</application>, please check
+<xref linkend="outlook-to-vcalendar-ws" />.</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question><para>I'm trying to sync &korganizer; with my &PalmPilot;,
+but nothing happens.  What else do I need to do?</para>
+</question>
+<answer><para>
+<itemizedlist>
+<listitem><para>Make sure no form of &korganizer; is running: neither
+&korganizer; itself nor the alarm daemon in the system tray.
+</para>
+</listitem>
+<listitem><para>Make sure the versions of the &kpilot; datebook conduit and
+&korganizer; are compatible.</para>
+</listitem>
+</itemizedlist>
+</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question>
+<para>Can I use freebusy-time with &korganizer;?</para>
+</question>
+<answer><para>yes, follow the instructions in <link
+linkend="config-main-free-busy">Free/Busy</link>.</para>
+</answer>
+</qandaentry>
+</qandaset>
+
+</chapter>
+
+&outlook-to-vcalendar-workshop;
+
+<chapter id="credits">
+<title>Credits and License</title>
+
+<para>&korganizer;</para>
+
+<para>Program copyright 2000-2004, The &kde; Developers</para>
+
+<para>&korganizer; homepage is at <ulink
+url="http://korganizer.kde.org">http://korganizer.kde.org</ulink></para>
+
+<para>If you discover bugs or see room for improvement in &korganizer; please
+visit <ulink url="http://korganizer.kde.org/contact/bugswishes.html">
+http://korganizer.kde.org/contact/bugswishes.html</ulink>.</para>
+
+<para>Contributors:</para>
+
+<itemizedlist>
+<listitem><para>Reinhold Kainhofer <email>reinhold@kainhofer.com</email></para>
+</listitem>
+<listitem><para>&Cornelius.Schumacher; &Cornelius.Schumacher.mail;</para>
+</listitem>
+<listitem><para>&Preston.Brown; &Preston.Brown.mail;</para>
+</listitem>
+</itemizedlist>
+
+<para>Documentation copyright 2000 &Milos.Prudek;</para>
+<para>Documentation copyright 2001 Paul E. Ahlquist, Jr
+<email>&Paul.E.Ahlquist.Jr.mail;</email></para>
+<para>Documentation copyright 2004 J&uuml;rgen Nagel
+<email>juergen.nagel@student.fh-reutlingen.de</email></para>
+<para>Documentation copyright 2005 Carlos Leonhard Woelz
+<email>carloswoelz@imap-mail.com</email></para>
+
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+&underFDL;
+
+&underGPL;
+
+</chapter>
+
+<appendix id="installation">
+<title>Installation</title>
+
+<sect1 id="getting-korg">
+<title>How to Obtain &korganizer;</title>
+
+&install.intro.documentation;
+
+<para>Click the <guisubmenu>Applications</guisubmenu> menu of the
+<guimenu>main</guimenu> menu to see if &korganizer; is already installed on your
+system. If &korganizer; is not there,  either it is not installed, or perhaps
+ the
+administrator of your system has moved it to some other place.</para>
+
+<para>&korganizer; homepage is at <ulink
+url="http://korganizer.kde.org">http://korganizer.kde.org</ulink>
+</para>
+
+</sect1>
+
+<sect1 id="requirements">
+<title>Requirements</title>
+
+<para>&korganizer; requires &kde; 3.4. It requires roughly 2MB of space
+in your &kde; system folder. Your calendars will require additional
+space in your home folder. Very large calendars slow down
+&korganizer; operation, therefore periodic cleanup is advisable.</para>
+
+<para>&korganizer; needs about 5 Megabytes of memory to run, but this may vary
+ depending
+on your platform and the size of your calendar(s).</para>
+
+<para>All required libraries are part of standard &kde; libraries
+(kdelibs). &kde; base package (kdebase) must also be installed to change
+localization preferences like date and time formats. &korganizer; itself
+is in the kdepim package. All packages can be found on <ulink
+url="http://www.kde.org">&kde; home page.</ulink>.</para>
+
+<para>The &korganizer; homepage is at <ulink
+url="http://korganizer.kde.org">http://korganizer.kde.org</ulink>
+</para>
+
+</sect1>
+
+</appendix>
+
+<glossary id="glossary">
+<title>Glossary</title>
+
+<glossentry id="gloss-calendar-widget">
+<glossterm>Calendar Widget</glossterm>
+<glossdef>
+
+<para>A tool for choosing the date inside certain entry windows, like event
+editing window. It is displayed as a small button to the right of the date
+field. When you click the button, you will see a month calendar. Use the arrows
+to go to a desired date, or click the month name or year number to go
+directly to the desired month or year.</para>
+
+</glossdef>
+</glossentry>
+
+<glossentry id="gloss-date-navigator">
+<glossterm>Date Navigator</glossterm>
+<glossdef>
+
+<para>The calendar that is in the upper-left corner of the &korganizer; window.
+It is the main way provided to navigate among dates, and to select from them.
+The single-arrow icons move forwards and backwards in time by increments of a
+month, while the double-arrows allow moving by years at a time. Today's date
+will be outlined with a small box. Dates which have events scheduled on them
+will be bold. If you want to select a date, simply click it. Hold down the
+Control key and click the dates if you wish to select multiple neighbor dates at
+once. The dates will be displayed in the main panel.</para>
+
+<para>Recurring events are not always displayed. You can forbid the display of
+recurring appointments in the Date Navigator. Get more information in the <link
+linkend="config-main-views">Views chapter</link>.</para>
+
+</glossdef>
+</glossentry>
+
+<glossentry id="gloss-due-date">
+<glossterm>Due Date</glossterm>
+<glossdef>
+
+<para>A due date is simply the date when your to-do must be finished. For
+instance, if your to-do is that you must return your books to the library
+by 16th November, that date is called <quote>the to-do due
+date</quote></para>
+
+</glossdef>
+</glossentry>
+
+<!--<glossentry id="gloss-group-scheduling">
+<glossterm>Group scheduling features</glossterm>
+<glossdef>
+
+<para>These features are planned for the future versions of &korganizer;. Group
+scheduling will facilitate member roles (attendee, owner, organizer), time
+conflict resolution, event reminder distribution, response collection and
+evaluation. In other words, you will be able to appoint attendees, invite them
+automatically, and see who accepted or refused attending the appointment.</para>
+
+<para>Currently, group scheduling features are not working. However, hooks exist
+in the calendar data structures for these features. <guilabel>Private</guilabel>
+check box, <guilabel>Require response</guilabel> check box and
+<guilabel>E-mail</guilabel> field will then be fully employed. These controls
+are described in more detail in <link linkend="entering-data">Entering
+Data</link> chapter, in the <link
+linkend="entering-data-events-attendees">Attendees section</link> of Windows
+reference, and in the <link linkend="config-main-personal">Personal
+Preferences</link> section.</para>
+
+</glossdef>
+</glossentry>
+-->
+<glossentry id="gloss-main-panel">
+<glossterm>Main panel</glossterm>
+<glossdef>
+<para>Normally the largest part of the screen, to the right of the Date
+Navigator. It displays the View of the day, workdays, week or month, the List
+View or the to-do list view.</para>
+<para>The right mouse button can be used in the List view and to-do list view
+only. It displays a local menu. The left mouse button can be used in any
+view.</para>
+</glossdef>
+</glossentry>
+
+<glossentry id="gloss-freebusy">
+<glossterm>Free/busy</glossterm>
+<glossdef>
+<para>The free/busy information is a set of busy time intervals. By presenting
+the intervals when one already has previous commitments, others can avoid
+arranging appointments for these periods. Note that only the times are published,
+not the event titles, descriptions or attendees. In other words, the
+free/busy information is the availability schedule.</para>
+<para>When adding attendees to your event, you need to know if they are
+busy or free in that particular time before sending the invitations.
+If the attendees make their free/busy information available, &korganizer;
+can retrieve this information and display it in the
+<guilabel>Free/Busy</guilabel> tab of the <guilabel>Edit Event</guilabel>
+dialog.</para>
+</glossdef>
+</glossentry>
+
+<!--FIXME: remove this or transform in glossary items
+
+<sect1 id="course-event-types">
+<title>Calendar Item Types</title>
+
+<para>There are three types of items:</para>
+
+<itemizedlist>
+<listitem><para>Events start and finish at distinct date. You can also specify
+distinct start and finish times, but you don't have to. While business
+meetings, personal anniversaries and cinema visits are examples of carefully
+planned events with exact time scheduling, a holiday is an event that takes
+several days and thus there is no need to specify exact start and finish
+times.</para></listitem>
+
+<listitem><para>To-do's must take place no later than a
+certain date, but they can also take place sooner.</para></listitem>
+</itemizedlist>
+
+<para>Naturally, what began as a To-do may later require exact timing.
+Say it is July 1 and you need to go to a hairdresser within a week.
+On July 3 you talk to your hairdresser and agree on an exact time. Thus the
+original To-do becomes similar to an appointment. </para>
+
+<para>&korganizer; makes adding exact time to a To-do very easy. If you
+check the <guilabel>Due</guilabel> check box and/or the <guilabel>Start</guilabel>
+check box you can specify the appropriate dates, when you check the
+<guilabel>Time associated</guilabel> check box and fill in the associated times, your
+To-do becomes very similar to an event.</para>
+
+</sect1>
+
+-->
+
+</glossary>
+
+&documentation.index;
+
+</book>
+<!--
+Local Variables:
+mode: sgml
+sgml-minimize-attributes:nil
+sgml-general-insert-case:lower
+sgml-indent-step:0
+sgml-indent-data:nil
+End:
+
+// vim:ts=2:sw=2:tw=78:noet
+-->
diff --git a/doc/korganizer/korganizer-resource.png b/doc/korganizer/korganizer-resource.png
new file mode 100644
index 000000000..09b682d79
--- /dev/null
+++ b/doc/korganizer/korganizer-resource.png
diff --git a/doc/korganizer/o2v_importing1.png b/doc/korganizer/o2v_importing1.png
new file mode 100644
index 000000000..6d4402add
--- /dev/null
+++ b/doc/korganizer/o2v_importing1.png
diff --git a/doc/korganizer/o2v_importing2.png b/doc/korganizer/o2v_importing2.png
new file mode 100644
index 000000000..19bfba2f5
--- /dev/null
+++ b/doc/korganizer/o2v_importing2.png
diff --git a/doc/korganizer/o2v_importing3.png b/doc/korganizer/o2v_importing3.png
new file mode 100644
index 000000000..efc085056
--- /dev/null
+++ b/doc/korganizer/o2v_importing3.png
diff --git a/doc/korganizer/o2v_main.png b/doc/korganizer/o2v_main.png
new file mode 100644
index 000000000..3f9e47acb
--- /dev/null
+++ b/doc/korganizer/o2v_main.png
diff --git a/doc/korganizer/o2v_progress.png b/doc/korganizer/o2v_progress.png
new file mode 100644
index 000000000..50662af38
--- /dev/null
+++ b/doc/korganizer/o2v_progress.png
diff --git a/doc/korganizer/o2v_save.png b/doc/korganizer/o2v_save.png
new file mode 100644
index 000000000..ba3109154
--- /dev/null
+++ b/doc/korganizer/o2v_save.png
diff --git a/doc/korganizer/o2v_warning.png b/doc/korganizer/o2v_warning.png
new file mode 100644
index 000000000..83208e14b
--- /dev/null
+++ b/doc/korganizer/o2v_warning.png
diff --git a/doc/korganizer/organizer.png b/doc/korganizer/organizer.png
new file mode 100644
index 000000000..e507dadbf
--- /dev/null
+++ b/doc/korganizer/organizer.png
diff --git a/doc/korganizer/outlook-to-vcalendar.docbook b/doc/korganizer/outlook-to-vcalendar.docbook
new file mode 100644
index 000000000..1c5d51eec
--- /dev/null
+++ b/doc/korganizer/outlook-to-vcalendar.docbook
@@ -0,0 +1,283 @@
+<chapter id="outlook-to-vcalendar-ws">
+
+<chapterinfo>
+<authorgroup>
+
+<author>
+<firstname>Randy</firstname> <surname>Pearson</surname>
+<affiliation><address><email>blueboy@bamafolks.com</email></address></affiliation>
+<contrib>Original author</contrib>
+</author>
+
+<author>
+<firstname>Klaus</firstname> <surname>St&auml;rk</surname>
+<affiliation><address><email>staerk@kde.org</email></address></affiliation>
+<contrib>Additionals texts</contrib>
+</author>
+
+<othercredit role="reviewer">
+<firstname>Eric</firstname> <surname>Bischoff</surname>
+<affiliation><address><email>e.bischoff@noos.fr</email></address></affiliation>
+<contrib>Editor</contrib>
+</othercredit>
+
+
+</authorgroup>
+
+<abstract>
+<para>This version of the &korganizer; workshop <quote>Outlook
+to vCalendar</quote> was released on October 17, 2002. See the
+<filename>ChangeLog</filename> for details.</para>
+<para>Please note that the descriptions and screenshots refer to version 3.1 of &korganizer;.</para>
+</abstract>
+
+<keywordset>
+<keyword>kdepim</keyword>
+<keyword>KOrganizer</keyword>
+<keyword>KOrganizer workshop</keyword>
+<keyword>Outlook</keyword>
+<keyword>vCalendar</keyword>
+<keyword>Outlook2VCal</keyword>
+</keywordset>
+
+<date>2002-10-17</date>
+<releaseinfo>3.1</releaseinfo>
+</chapterinfo>
+
+<title>KOrganizer workshop: Outlook to vCalendar</title>
+
+<sect1 id="outlook-to-vcalendar-overview">
+<title>Overview</title>
+
+<para>
+When moving from &Microsoft; Outlook&reg; to using &kde;'s &korganizer;
+to manage schedules and appointments, you will probably wish to
+export your scheduling data from Outlook&reg; and import it into
+&korganizer;. &Microsoft;'s Outlook&reg; program does provide an export
+option that can save an appointment to the industry standard vCalendar
+format.
+</para>
+
+<para>
+Unfortunately, Outlook&reg; will only export the appointment you have
+selected, one at a time. This is fine if you only wish to transfer a
+few appointments, but transferring the 200-300 appointments you may
+have in your Outlook&reg; folder would not be much fun. Therefore,
+<ulink url="mailto:blueboy@bamafolks.com">Randy Pearson</ulink> created
+a small application named <application>Outlook2VCal</application> that
+can scan and export all the appointments to a vCalendar file at one time.
+</para>
+
+</sect1>
+
+<sect1 id="outlook-to-vcalendar-installation">
+<title>Installation</title>
+
+<para>
+The <application>Outlook2VCal 2.0</application> program is <ulink
+url="http://korganizer.kde.org/learning/importdata.html">delivered as a compress
+ZIP file</ulink>, which contains a <application>SETUP.EXE</application>
+application. Merely extract the files using your favorite utility,
+such as <ulink url="http://www.winzip.com">WinZip</ulink> and run the
+<application>SETUP.EXE</application> program to install the program
+on your Windows computer. This should be the same computer where you
+normally run &Microsoft; Outlook 97&reg;, 2000&reg; or 2002&reg;.
+</para>
+
+<para>
+Depending on how up to date your system is, you may or may not be prompted
+to reboot during the installation.
+</para>
+
+</sect1>
+
+<sect1 id="outlook-to-vcalendar-export">
+<title>Export Usage</title>
+
+<para>
+After the program is installed, you can run it
+by accessing <menuchoice><guimenu>Start</guimenu>
+<guisubmenu>Programs</guisubmenu> <guisubmenu>Outlook2vCal</guisubmenu>
+<guimenuitem>Outlook2vCal</guimenuitem></menuchoice>. You should see
+this screen appear:
+</para>
+
+<screenshot id="screenshot-outlook2vcal-main">
+<screeninfo>Outlook2VCal main window</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="o2v_main.png" format="PNG"/></imageobject>
+<textobject><phrase>Outlook2VCal main window</phrase></textobject>
+<caption><para>Outlook2VCal main window</para></caption>
+</mediaobject>
+</screenshot>
+
+
+<para>
+The program automatically attempts to communicate with Outlook&reg;
+using OLE Automation. If an error is reported, this probably means you
+do not have Outlook&reg; installed.
+</para>
+
+<para>
+You should first decide if you want to include information about holidays
+in the exported file or not. Normally you will probably not wish to
+do this, so the <guilabel>Skip Holidays</guilabel> box is checked by
+default. Next, click the <guibutton>Export</guibutton> button, which will
+display a standard <guilabel>File Save</guilabel> dialog box. Browse to
+the desired folder and enter the filename where you wish to create
+the new vCalendar data file.
+</para>
+
+<screenshot id="screenshot-outlook2vcal-save">
+<screeninfo>Outlook2VCal Save File dialog</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="o2v_save.png" format="PNG"/></imageobject>
+<textobject><phrase>Outlook2VCal Save File dialog</phrase></textobject>
+<caption><para>Outlook2VCal Save File dialog</para></caption>
+</mediaobject>
+</screenshot>
+
+<para>
+Depending on the security settings in Outlook&reg;, you may see this
+screen next. If so, be sure to allow access for a minute or two.
+</para>
+
+<screenshot id="screenshot-outlook2vcal-warning">
+<screeninfo>Outlook2VCal Warning message</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="o2v_warning.png" format="PNG"/></imageobject>
+<textobject><phrase>Outlook2VCal Warning message</phrase></textobject>
+<caption><para>Outlook2VCal Warning message</para></caption>
+</mediaobject>
+</screenshot>
+
+<para>
+The program will display progress messages in its main window as it
+loads, converts and saves your appointments. Here is a final shot of
+what a successful run looks like:
+</para>
+
+<screenshot id="screenshot-outlook2vcal-progress">
+<screeninfo>Outlook2VCal Progress message</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="o2v_progress.png" format="PNG"/></imageobject>
+<textobject><phrase>Outlook2VCal Progress message</phrase></textobject>
+<caption><para>Outlook2VCal Progress message</para></caption>
+</mediaobject>
+</screenshot>
+
+</sect1>
+
+<sect1 id="outlook-to-vcalendar-import">
+<title>Import Usage</title>
+
+<para>
+Now that you have exported Outlook's&reg; appointments, the final step is
+to load the appointments into &korganizer;. Transfer the file over to the
+computer running &korganizer; (via network, floppy disk, whatever). Now,
+run &korganizer;. If desired, you can create a new calendar, or open an
+existing one.
+</para>
+
+<screenshot id="screenshot-outlook2vcal-importing1">
+<screeninfo>Outlook2VCal Importing Data #1</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="o2v_importing1.png" format="PNG"/></imageobject>
+<textobject><phrase>Outlook2VCal Importing Data #1</phrase></textobject>
+<caption><para>Outlook2VCal Importing Data #1</para></caption>
+</mediaobject>
+</screenshot>
+
+
+<para>
+Now, choose the <menuchoice><guimenu>File</guimenu><guisubmenu>Import</guisubmenu>
+<guimenuitem>Import Calendar</guimenuitem></menuchoice> menu item. Browse and/or enter
+the name of the vCalendar file you just transferred to this computer.
+</para>
+
+<screenshot id="screenshot-outlook2vcal-importing2">
+<screeninfo>Outlook2VCal Importing Data #2</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="o2v_importing2.png" format="PNG"/></imageobject>
+<textobject><phrase>Outlook2VCal Importing Data #2</phrase></textobject>
+<caption><para>Outlook2VCal Importing Data #2</para></caption>
+</mediaobject>
+</screenshot>
+
+<para>&korganizer; will ask you if you want to <guilabel>Add as new
+calendar</guilabel>, which adds the calendar file as a new local file resource,
+<guilabel>Merge into existing calendar</guilabel>, which merges the calendar
+items into an existing resource or <guilabel>Open in separate window</guilabel>,
+which will allow you to view and edit the calendar, but will not add to
+its default view. To add the calendar items, select one of the two first
+options, and press <guibutton>OK</guibutton>.</para>
+
+<para>
+After you select the <guibutton>OK</guibutton> button, &korganizer;
+will load the appointments from the file and update its calendar.
+</para>
+
+<screenshot id="screenshot-outlook2vcal-importing3">
+<screeninfo>Outlook2VCal Importing Data #3</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="o2v_importing3.png" format="PNG"/></imageobject>
+<textobject><phrase>Outlook2VCal Importing Data #3</phrase></textobject>
+<caption><para>Outlook2VCal Importing Data #3</para></caption>
+</mediaobject>
+</screenshot>
+<para>
+Save your modified calendar and enjoy using &korganizer;!
+</para>
+
+</sect1>
+
+<sect1 id="outlook-to-vcalendar-limitations">
+<title>Limitations</title>
+
+<para>
+The first version of this program (1.0) was tested on &Microsoft; Windows
+2000 Server&reg; and Professional&reg; running &Microsoft; Outlook 2000&reg;.
+When attempting to use &Microsoft; Outlook 97&reg;, the program failed miserably.
+</para>
+
+<para>
+The second (2.0) version, is reported to work (at least) with &Microsoft;
+Outlook 97&reg;, 2000&reg;, and 2002&reg;.
+</para>
+
+<para>
+If anyone has a work around for this problem, feel free to send a note to
+Randy Pearson (<email>blueboy@bamafolks.com</email>).
+</para>
+
+</sect1>
+
+<sect1 id="outlook-to-vcalendar-credits">
+<title>Credits and license</title>
+
+<para>Contributors:</para>
+
+<variablelist>
+<varlistentry>
+<term>Original author</term>
+<listitem><para>Randy Pearson
+  <email>blueboy@bamafolks.com</email></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Additionals texts</term>
+<listitem><para>Klaus St&auml;rk
+  <email>staerk@kde.org</email></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Conversion to DocBook</term>
+<listitem><para>Eric Bischoff
+  <email>e.bischoff@noos.fr</email></para></listitem>
+</varlistentry>
+</variablelist>
+
+
+</sect1>
+
+</chapter>
diff --git a/doc/korganizer/plugins-chapter.docbook b/doc/korganizer/plugins-chapter.docbook
new file mode 100644
index 000000000..34df8f5c3
--- /dev/null
+++ b/doc/korganizer/plugins-chapter.docbook
@@ -0,0 +1,48 @@
+<chapter id="plugins-chapter">
+
+<title>Plugins</title>
+
+<para>
+&korganizer; provides you the possibility of extending the application with plugins.
+</para>
+
+<para>
+The plugins can be configured under the &korganizer; main configuration dialog
+Choose <menuchoice><guimenu>Settings</guimenu><guimenuitem>
+Configure &korganizer;</guimenuitem></menuchoice> or
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>
+Configure Calendar</guimenuitem></menuchoice>, inside &kontact;, and click the
+<guilabel>Plugin</guilabel> icon on the icon list sidebar of the dialog.
+</para>
+
+<sect1 id="plugins-chapter-availableplugins">
+<title>Available Plugins</title>
+
+<sect2 id="date-numbers-plugin">
+<title>Date Numbers Plugin for Calendars</title>
+<para>
+This plugin adds the day number of day in the the year to the agenda view. For
+instance, February 1 is the day number 32.
+</para>
+</sect2>
+
+<sect2 id="jewish-calendar-plugin">
+<title>Jewish Calendar Plugin</title>
+<para>
+The plugin provides you a the the Jewish calendar dates in addition to the
+Gregorian calendar dates. In the configuration dialog of the plugin, you can
+choose if you want to display Israeli holidays, weekly prasha, day of Omer and /
+or Chol HaMoed.
+</para>
+</sect2>
+
+<sect2 id="journal-print-plugin">
+<title>Journal Print Style</title>
+<para>
+The plugin allows you to print journal (diary) entries.
+</para>
+</sect2>
+
+</sect1>
+
+</chapter>
diff --git a/doc/korganizer/remotefile-resource.png b/doc/korganizer/remotefile-resource.png
new file mode 100644
index 000000000..eabf409c8
--- /dev/null
+++ b/doc/korganizer/remotefile-resource.png
diff --git a/doc/korganizer/todo-general.png b/doc/korganizer/todo-general.png
new file mode 100644
index 000000000..6d620a76b
--- /dev/null
+++ b/doc/korganizer/todo-general.png