<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN"
 "dtd/kdex.dtd" [
<!ENTITY kappname "&korganizer;">
<!ENTITY package "kdepim">
<!ENTITY % addindex "IGNORE">
<!ENTITY % English "INCLUDE">
]>

<book id="korganizer" lang="&language;">

<bookinfo>

<title>The &korganizer; Handbook</title>

<authorgroup>
<author>
<firstname>Milos</firstname>
<surname>Prudek</surname>
</author>

<author>
<firstname>Paul</firstname>
<othername>E.</othername>
<surname>Ahlquist</surname>
<lineage>Jr.</lineage>
<affiliation><address><email>pea@ahlquist.org</email></address></affiliation>
</author>

<othercredit role="developer">
<firstname>Cornelius</firstname>
<surname>Schumacher</surname>
<affiliation><address><email>schumacher@kde.org</email></address></affiliation>
<contrib>Developer</contrib>
</othercredit>

<othercredit role="developer">
<firstname>Preston</firstname>
<surname>Brown</surname>
<affiliation><address><email>pbrown@kde.org</email></address></affiliation>
<contrib>Developer</contrib>
</othercredit>

<othercredit role="reviewer">
<firstname>Lauri</firstname>
<surname>Watts</surname>
<affiliation><address><email>lauri@kde.org</email></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>

<legalnotice>&FDLNotice;</legalnotice>

<date>2001-07-29</date>
<releaseinfo>2.20.00</releaseinfo>

<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>
</keywordset>

<abstract><para>&korganizer; is an easy to use personal information manager
(<acronym>PIM</acronym>). You can schedule appointments, events, and to-do
tasks. &korganizer; will remind you about pending tasks, and help you keep your
schedule. </para></abstract>

</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<para>&korganizer; is a personal information manager (<abbrev>PIM</abbrev>).
You can schedule appointments, events, and to-do tasks. &korganizer; will
remind you about pending tasks, and help you keep your schedule.</para>

<para>Main features of &korganizer;:</para>
<para><itemizedlist>
<listitem><para>To-Do's and Events supported</para></listitem>
<listitem><para>Easy editing and change from one type of event to
another</para></listitem>
<listitem><para>Categories can be assigned to events</para></listitem>
<listitem><para>Category color highlighting</para></listitem>
<listitem><para>Multiple calendars can be open</para></listitem>
<listitem><para>Reschedule by drag-and-drop</para></listitem>
<listitem><para>Numerous options for generating repeated
events</para></listitem>
<listitem><para>Emerging group scheduling support</para></listitem>
<listitem><para>vCalendar open standard native support</para></listitem>
<listitem><para>Calendar merging and import</para></listitem>
<listitem><para>Full &PalmPilot; synchronization</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>Command line parameters</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="reference">reference 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.</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 on the desired date in the
<link linkend="glossary" endterm="gloss-date-navigator">Date Navigator.</link>
</para></step>

<step><para>Click on <guiicon><inlinemediaobject><imageobject>
<imagedata fileref="i_view_day.png" format="PNG"/></imageobject>
</inlinemediaobject></guiicon>.  This will bring up the <guilabel>
Day View</guilabel> pane.</para></step>

<step><para>Double-click the text area beside the desired
hour in the main panel.</para></step>

<step><para>Enter event details. Use tabs <guilabel>General</guilabel>,
<guilabel>Attendees</guilabel>, and <guilabel>Recurrence</guilabel> to move
around.</para></step>

<step><para>Click on <guibutton>OK</guibutton> to save the
event.</para></step>
</procedure>
</sect1>

<sect1 id="course-entering-todos">
<title>Entering To-Do's</title>

<procedure>
<step><para>Click on <menuchoice><guimenu>Actions</guimenu>
<guimenuitem>New To-Do</guimenuitem></menuchoice>.</para></step>

<step><para>Enter To-Do details. Use tabs <guilabel>General</guilabel> and
<guilabel>Attendees</guilabel> to move around.</para></step>

<step><para>Click on <guibutton>OK</guibutton> to save the
To-Do.</para></step>
</procedure>

</sect1>

<sect1 id="course-event-types">
<title>Event Types</title>

<para>There are two types of entries in &korganizer;:</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 are events that 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
uncheck the <guilabel>No time associated</guilabel> checkbox
and enter the appropriate time, your To-Do becomes very similar to an event
(but without recurrence tab, which is natural, since a to-do task is supposed
to be a one-time only event).</para>

</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 event that you want to reschedule.</para></step>

<step><para>Drag and drop the event to the new date and time
location.</para></step>
</procedure>

<para>You should choose an appropriate <link
linkend="reference-menus-view">view</link> before beginning this operation.
Only the Day, Work week and Week views show 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>

<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 enough precision, you can enter the
desired time directly.</para>

</sect1>
<sect1 id="course-rescheduling-todos">
<title>Rescheduling To-Do's</title>

<para>To reschedule a To-Do, right click the To-Do in the To-Do panel.
This will bring up a context menu.  Select <guimenuitem>Edit...</guimenuitem>
Reschedule the To-Do.</para>

<para>Alternatively, if the main panel holds List View or To-Do View, you can
locate and right click the To-Do there.</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="config">
<title>Configuration </title>

<para>You can change &korganizer;'s behavior if you wish. To display the
configuration dialog window, click on
<menuchoice><guimenu>Settings</guimenu><guimenuitem> Configure
KOrganizer...</guimenuitem></menuchoice>.  You can get more information
in the <link linkend="reference-windows-preferences">Preferences window
description</link>.</para>

<para>You can also modify the toolbars.  For visual appearance changes,
right click on the toolbar and select from the presented menu.  To
customize the set of tools available on the bar, click on
<menuchoice><guimenu> Settings</guimenu><guimenuitem>Configure toolbars
</guimenuitem></menuchoice> and read the <link
linkend="reference-windows-config-toolbars">detailed
description</link>.</para>

<para>You can also drag both 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 &kcontrol; within the <menuchoice>
<guisubmenu>Personalization</guisubmenu> <guimenuitem>Country &amp;
Language</guimenuitem> </menuchoice> module.  This control module can be
accessed from within &korganizer;; select <menuchoice><guimenu>
Settings</guimenu><guimenuitem>Configure Date &amp;
Time...</guimenuitem></menuchoice>.  &korganizer; has to be restarted
for changes done in &kcontrol; to take effect.</para>

<!-- Filters and Catagories should be mentioned here, refering to detail -->

</chapter>

<chapter id="entering-data">
<title>Entering Data</title>

<sect1 id="entering-data-events">
<title>Events</title>

<para>Events are future appointments, like business meetings, personal
anniversaries and cinema visits. Events can also take several days, like
holidays.</para>

<para>Entering a new event is very easy. Just click on
<menuchoice><guimenu>Actions</guimenu><guimenuitem>New
Event</guimenuitem></menuchoice>. A window with
<guilabel>General</guilabel>, <guilabel>Attendees</guilabel>, and
<guilabel>Recurrence</guilabel> tabs appears. </para>

<para>If you wish you can use a different way to start 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-Do tasks, described below.</para></step>

<step><para>In the main panel, double click on the time and date when your
event starts. </para></step>

<step><para>A window with <guilabel>General</guilabel>,
<guilabel>Attendees</guilabel> and <guilabel>Recurrence</guilabel> tabs
appears. Enter your data as described below.</para></step>
</procedure>

<sect2 id="entering-data-events-general">
<title><guilabel>General tab</guilabel></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>

<variablelist>
<varlistentry>
<term><guilabel>Owner:</guilabel></term>
<listitem><para>Please note that your name is displayed above the
<guilabel>Summary</guilabel> field.  This means that the task is owned by
you.  Initially the name is <quote>Anonymous</quote> who has an email
address of <quote>nobody@nowhere</quote>.  This can be changed.
In <menuchoice> <guimenu>Settings</guimenu> <guisubmenu>Configure KOrganizer;...
</guisubmenu><guisubmenu>Personal</guisubmenu></menuchoice> there are two
 methods of
setting your name and email address.</para>
<itemizedlist>
<listitem>
<para>Enter your name and email in the provided fields.
</para>
</listitem>
<listitem>
<para>
Set the check box for <guilabel>Use Email settings from Control Center
</guilabel>.  This uses your name and email address as specified
in &kcontrolcenter;, under <menuchoice><guisubmenu>Network</guisubmenu>
<guimenuitem>E-mail</guimenuitem></menuchoice>.
</para>
</listitem></itemizedlist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Summary:</guilabel></term>
<listitem><para>Enter short description of the task into the
<guilabel>Summary</guilabel> field.  This description is the text shown
on the &korganizer; main panel.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Start Date</guilabel> and <guilabel>End Date</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>.  Choose time from quarter hour intervals, or enter
the desired time directly into the time fields.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>No time associated</guilabel></term>
<listitem><para>Check the <guilabel>No time associated</guilabel> 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 belongs to <link
linkend="entering-data-to-do">To-Do tasks</link></para></tip></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Start Time</guilabel> and <guilabel>End Time</guilabel></term>
<listitem><para>These fields only appear if the <guilabel>No time
associated</guilabel> checkbox is not checked. Change the suggested times as
desired. Enter the times directly or use the drop down menu to choose time
from quarter-hour intervals.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Recurring event</guilabel></term>
<listitem><para>Check the <guilabel>Recurring event</guilabel> checkbox if this
event happens regularly. You can later specify the exact schedule in the <link
linkend="entering-data-events-recurrence">Recurrence tab window</link>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Reminder</guilabel></term>
<listitem><para>Check the <guilabel>Reminder</guilabel> checkbox if
&korganizer; should remind you about an event. &korganizer; can also run a
specific program at that time.</para>
<tip><para>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. Click on the musical <guiicon>Note</guiicon> symbol to choose the
alarm sound. Click on the <guiicon>Running Man</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><guilabel>Private</guilabel></term>
<listitem><para>Check the <guilabel>Private</guilabel> box to keep the event
private. Currently, this checkbox has no real effect. However, when group
scheduling features of &korganizer; are completed, private tasks will only be
 visible to
you. The checkbox may also have an effect when the calendar file is loaded in
another calendar understanding the vCalendar format.</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>Categories</guilabel></term>
<listitem><para>You can assign the event to several categories. Get more
information in the <link linkend="reference-windows-categories">Categories
description</link>.</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-attendees">
<title><guilabel>Attendees</guilabel> tab</title>

<para>Some tasks may require more people. You can list those people here. Get
more information in the <link linkend="reference-windows-attendees">Attendees
section</link> of the Windows reference.</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-events-recurrence">
<title><guilabel>Recurrence</guilabel> tab</title>

<para>Some events take place regularly. You can specify exact scheduling
here.</para>

<warning><para>Make sure that the <guilabel>Recurring Event</guilabel>
checkbox in <link linkend="entering-data-events-general">General tab
window</link> is checked. If it is not, you will see a message
<computeroutput>This event does not recur</computeroutput> in the middle
of the <guilabel>Recurrence</guilabel> tab window.</para></warning>

<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>Event Time</guilabel></title>

<para>This is a copy of the <link linkend="entering-data-events-general">
<guilabel>General</guilabel> tab window</link> time specification.</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 (&ie;, the 250th day of the
year) - <guilabel>Recur on this day</guilabel>, or this day of the month
in a particular month of the year - <guilabel>Recur in the month
of</guilabel>.  By default, &korganizer; assumes you mean the actual day
of the year.  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>
</sect1>

<sect1 id="entering-data-to-do">
<title>To-Do</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-Do entries are tasks that do not have to be
scheduled. There are short-term and long-term tasks. For instance you should go
to a hairdresser within a week, and you should sell your old car within a
year. You 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, click on
<menuchoice><guimenu>Actions</guimenu><guimenuitem>New
To-Do</guimenuitem></menuchoice>. A window with <guilabel>General</guilabel>
and <guilabel>Attendees</guilabel> tabs appears.</para>

<!--  this section is not correct
<para>If you wish you can use a different way to start a new event:</para>

<procedure>
<step><para>Use Date Navigator to go to the due date of your To-Do
 task.</para> <note><para>A due date is simply the date when your task
 must be finished. For instance, if your To-Do task is that you must
 return your books to the library by 16th November, that date is called
 "the To-Do task due date".</para> </note></step> <step><para>Use the
 View toolbar to choose the desired view icon (or select the desired
 view from the View menu). Since your To-Do normally does not start at a
 particular time, you should choose a <link
 linkend="reference-menus-view">view</link> that displays as many days
 as possible, like the Month view. You may choose other views of course,
 as appropriate.</para></step> <step><para>In the main panel,
 double-click on the due date of your To-Do task.</para></step>
 <step><para>A window with <guilabel>General</guilabel> and
 <guilabel>Attendees</guilabel> tabs appears. Enter your data as
 described below.</para></step>
</procedure>
-->

<sect2 id="entering-data-to-do-general">
<title><guilabel>General</guilabel> tab</title>

<variablelist>
<varlistentry>

<!-- original in to-do section <term><guilabel>Owner:</guilabel></term>
<listitem><para>Please note that your name is displayed above the
<guilabel>Summary</guilabel> field. This means that the task is owned by
you. While initially this name is the same as Full Name (specified in
&kcontrol;, in <menuchoice> <guisubmenu>Personalization</guisubmenu>
<guimenuitem>E-mail</guimenuitem> </menuchoice>), you can change it in
<menuchoice> <guimenu>Settings</guimenu>
<guimenuitem>Preferences</guimenuitem>
<guimenuitem>Personal</guimenuitem><guimenuitem>Your name</guimenuitem>
</menuchoice>.</para></listitem>
</varlistentry>
-->

<term><guilabel>Owner:</guilabel></term>
<listitem><para>Please note that your name is displayed above the
<guilabel>Summary</guilabel> field.  This means that the task is owned by
you.  Initially the name is <quote>Anonymous</quote> who has an email
address of <quote>nobody@nowhere</quote>.  This can be changed.
In <menuchoice> <guimenu>Settings</guimenu> <guisubmenu>Configure KOrganizer...
</guisubmenu><guisubmenu>Personal</guisubmenu></menuchoice> there are two
 methods of
setting your name and email address.</para>

<itemizedlist>
<listitem>
<para>Enter your name and email in the provided fields.</para></listitem>
<listitem><para>Set the check box for <guilabel>Use Email settings from Control
Center</guilabel>.  This uses your name and email address as specified
in &kcontrol;, under <menuchoice><guisubmenu>Network</guisubmenu>
<guimenuitem>E-mail</guimenuitem></menuchoice>.</para>
</listitem></itemizedlist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Summary</guilabel></term>
<listitem><para>Enter short description of the task into the
<guilabel>Summary</guilabel> field.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>No due date</guilabel></term>
<listitem><para>Uncheck the <guilabel>No due date</guilabel> checkbox if your
task should be finished by a certain date.  Enter the date in the
<guilabel>Due date</guilabel> field.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>No time associated</guilabel></term>
<listitem><para>Similarly, uncheck <guilabel>No time associated</guilabel> if
your task should be finished at a certain time, and give that time in the field
provided.</para>
<tip><para>The date and time are initially hidden, because To-Do tasks 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
task requires exact time, maybe it actually belongs to <link
linkend="entering-data-events">events</link>.</para></tip></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Due Date</guilabel></term>
<listitem><para>The date the task is to be completed.  Enter the date
directly or use the <link linkend="glossary" endterm="gloss-calendar-widget">
Calendar Widget</link>.  If <guilabel>No time associated</guilabel> is
unchecked, a time drop down menu is also offered.  Set the time from quarter
hour intervals or enter the time directly.
</para></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 20%.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Priority</guilabel></term>
<listitem><para>Assign a priority to your task.  This drop down menu offers
priorities from one to five, one being the highest.  Initially tasks are set
to priority three (midrange).</para></listitem>
</varlistentry>

<varlistentry>
<term>Details</term>
<listitem><para>Enter a long description of the task in the large
rectangle.</para>
<para>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>
<para>If you enter at the end of the description a <userinput>#</userinput>
character followed by a few characters (like <userinput>#002</userinput>),
this appears in the To-Do view in the column <guilabel>SortID</guilabel>.
This can be used to order the to-do's in an user-definable way.</para>
</listitem></varlistentry>

<varlistentry>
<term><guilabel>Categories</guilabel></term>
<listitem><para>You can assign the task to several categories. Get more
information in <link linkend="reference-windows-categories">Categories
description</link>.</para>
</listitem></varlistentry>

<varlistentry>
<term><guilabel>Private</guilabel></term>
<listitem><para>Check the <guilabel>Private</guilabel> box to keep the To-Do
task private. Currently, this checkbox has no real effect. However, when group
scheduling features of &korganizer; are completed, private tasks will only be
visible to you. The checkbox may also have an effect when the calendar file
is loaded in another calendar understanding the vCalendar format.
</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-to-do-attendees">
<title><guilabel>Attendees</guilabel> tab</title>

<para>Some tasks may require more people. You can list those people
here. Find more information in the <link
linkend="reference-windows-attendees">Attendees section</link> of the
Windows reference.</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:</para>

<itemizedlist>
<listitem><para>In the <guilabel>General</guilabel> Tab, you should at least
fill the <guilabel>Summary</guilabel> field and the description (the large
rectangle), even though neither is mandatory. If you check the
<guilabel>Reminder</guilabel> checkbox, 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>Recurring event</guilabel> checkbox.
</para></listitem></itemizedlist>
</sect1>
</chapter>

<chapter id="group-scheduling">
<title>Group Scheduling</title>

<para> Currently &korganizer; can only schedule events using the
IMIP-protocol for group scheduling. IMIP is a standard used by many
other clients too. For example &Microsoft;
<application>Outlook</application>, Lotus
<application>Notes</application> and
<application>Evolution</application>. This means that you can share
events with other users using one of these clients.</para>

<sect1 id="as-organizer">
<title>Acting as Organizer in Group Scheduling</title>

<para>In day and week view a little icon showing one
<guiicon>tux</guiicon> is placed in the event, if you are the
organizer of an group scheduling event.</para>

<sect2 id="publish">
<title>Publishing an Event</title>

<para>If you simply want to send some other people an event, then
click <guimenuitem>publish</guimenuitem> in the
<guimenu>schedule</guimenu> menu, when the event is marked. Then a
dialog appears, asking you for the email addresses you want to send
this event.</para>

<para>Publishing events does not request an answer from the
attendees.</para>

</sect2>

<sect2 id="request">
<title>Organizing an Event</title>

<para>Make a normal event, and add some attendees to the event. Then
click on
<menuchoice><guimenu>Schedule</guimenu><guimenuitem>Request</guimenuitem>
</menuchoice>. If you send your events through the <link
linkend="reference-windows-outgoing">outbox</link>, you have to press
<guibutton>Send Messages</guibutton>. Then you should get answers from
the attendees in your <link
linkend="reference-windows-incoming">inbox</link>.</para>

</sect2>

<sect2 id="cancel">
<title>Cancel an Event</title> 

<para>To cancel an event you have to be
the organizer. Then simply select the event, and press
<menuchoice><guimenu>Schedule</guimenu>
<guimenuitem>Cancel</guimenuitem></menuchoice>. This will send a
cancel-message to all attendees. So if you use the <link
linkend="reference-windows-outgoing">outbox</link>, you have to press the
<guibutton>Send Messages</guibutton>. Then you should get answers from
the attendees in your <link
linkend="reference-windows-incoming">inbox</link>.</para>
</sect2>
</sect1>

<sect1 id="as-attendee">
<title>Being the Attendee in a Group Scheduled Event</title>

<para>In day and week views, a little icon showing <guiicon>three tux
penguins</guiicon> is placed in the event, if you are the organizer of
an groupscheduling event.</para>

<sect2 id="answer">
<title>Answering an Event-Request</title>

<para>If you have an event-request in your <link
linkend="reference-windows-incoming">inbox</link> you can either press
<guibutton>Reject</guibutton> to ignore the request, or press
<guibutton>Accept</guibutton>, and insert it to your calendar. You should then
edit your status in the event's <link linkend="reference-windows-attendees">
attendee tab</link>. And then send a reply by marking the event, and pressing
<menuchoice><guimenu>Schedule</guimenu><guimenuitem>Reply</guimenuitem>
</menuchoice>. If you want to change the date/time of this event, change them,
and then send back your proposal by pressing <menuchoice><guimenu>Schedule
</guimenu><guimenuitem>Counter</guimenuitem></menuchoice>.
</para>
</sect2>

<sect2 id="refresh">

<title>Get the Latest Version of an Event</title> 

<para>To get the latest version of an groupscheduling event, select
the event, and press
<menuchoice><guimenu>Schedule</guimenu><guimenuitem>Refresh</guimenuitem>
</menuchoice>. &korganizer; will then send you back the latest
version.</para>

</sect2>
</sect1>

</chapter>


<chapter id="examples">
<title>Examples</title>

<sect1 id="examples-entering-event">
<title>Entering a New Event</title>

<para>In this example, you'll enter an event. You need to arrange a meeting on
<emphasis>February 12, 2001</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'll 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 February 12, 2001.</para></step>

<step><para>Click on <menuchoice> <guimenu>Actions</guimenu> <guimenuitem>New
Event</guimenuitem> </menuchoice> </para></step>

<step><para>Enter a suitable summary. 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>Recurring event</guilabel>
checkbox.</para></step>

<step><para>Click on the <guilabel>Recurrence</guilabel> tab.</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, 2001) until the end of
time (that is, until you delete it). </para></note></step>

<step><para>Since everything is all right here, click on the
<guilabel>Attendees</guilabel> tab.</para></step>

<step><para>In the <guilabel>Attendees</guilabel> tab you should do the
following:</para>
<substeps>
<step><para>In <guilabel>Attendee Name</guilabel> field, enter <userinput>Jack
Smith</userinput>.</para></step>

<step><para>Choose <guilabel>Organizer</guilabel> as the role, and change the
<guilabel>Need Action</guilabel> item to <guilabel>Accepted</guilabel>.
Uncheck the <guilabel>Request Response</guilabel> checkbox.</para></step>

<step><para>Click <guibutton>Add</guibutton>.</para></step>

<step><para>In <guilabel>Attendee Name</guilabel> field, enter <userinput>Joan
Holden</userinput>. In <guilabel>Email Address</guilabel> field, enter
<userinput>jholden@thiscompany.com</userinput>.</para></step>

<step><para>Choose <emphasis>Owner</emphasis> as the role.</para></step>

<step><para>Click <guilabel>Add</guilabel>.</para></step>

<step><para>In <guilabel>Attendee Name</guilabel> field, enter <userinput>Peter
Krzinski</userinput>. In <guilabel>Email Address</guilabel> field, enter
<userinput>pkrzinski@thiscompany.com</userinput>.</para></step>

<step><para>Click <guilabel>Add</guilabel>.</para></step>

<step><para>In <guilabel>Attendee Name</guilabel> field, enter
<userinput>Kirsten Friese</userinput>. In <guilabel>Email Address</guilabel>
field, enter <userinput>kfriese@thiscompany.com</userinput>.</para></step>

<step><para>Click <guilabel>Add</guilabel>.</para></step>
</substeps>
</step>

<step><para>Click the <guilabel>Categories</guilabel> button.</para></step>

<step><para>Choose <guilabel>Appointment</guilabel> in the Available
Categories. Click the <guilabel>Add>></guilabel> button. Then click the
<guibutton>OK</guibutton> button.</para></step>

<step><para>Check the <guilabel>Reminder</guilabel> checkbox.  Set the
reminder time to 15 minutes&mdash;just long enough to brew a cup of tea
prior to the meeting start.</para></step>

<step><para>You'll be back in the main event entry window. 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>
</sect1>

</chapter>

<chapter id="reference">
<title>Reference</title>

<sect1 id="reference-windows">
<title>Windows</title>

<para>This section contains description of the following windows:</para>
<itemizedlist>

<listitem><para><guilabel>Categories tab window</guilabel> that is part of both
<link linkend="entering-data-events">Event</link> and <link
linkend="entering-data-to-do">To-Do</link> entry window.</para></listitem>
<listitem><para><guilabel>Attendees tab window</guilabel> that is part of both
<link linkend="entering-data-events">Event</link> and <link
linkend="entering-data-to-do">To-Do</link> entry window.</para></listitem>
<listitem><para><guilabel>Configure toolbars window</guilabel> that is accessed
by clicking <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
toolbars</guimenuitem></menuchoice> menu item.</para></listitem>
<listitem><para><guilabel>Preferences window</guilabel> that is accessed by
clicking <menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Configure KOrganizer...</guimenuitem> </menuchoice> menu
 item.</para></listitem>
</itemizedlist>

<sect2 id="reference-windows-categories">
<title>Categories</title>

<para>You can assign several categories to the task. Click on
<guilabel>Categories</guilabel> button.
Check the boxes to assign suitable categories to the task.
You can also add a new category in the <guilabel>New Category</guilabel>
field.</para>

<tip><para>For instance your language lesson at work belongs to both Business
and Education categories, while the anniversary of your marriage belongs to
either Personal or Special Occasion - it's your choice.</para></tip>

</sect2>

<sect2 id="reference-windows-attendees">
<title>Attendees</title>

<variablelist>
<varlistentry>
<term><guilabel>Attendee Name</guilabel> field</term>
<listitem><para>Fill in the <guilabel>Attendee Name</guilabel> and
<guilabel>Email address</guilabel> fields.  To use your Address Book, see
the <guibutton>Address Book...</guibutton> entry below.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Role</guilabel></term>
<listitem><para>Choose the role of the attendee (Attendee, Organizer, Owner,
Delegate) 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 below).
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Status</guilabel></term>
<listitem><para>Choose the status of the attendee (Needs Action, Accepted,
Sent, Tentative, Confirmed, Declined, Completed, Delegated). 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
below).</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Request Response</guilabel></term>
<listitem><para>Check the <guilabel>Request Response</guilabel> checkbox 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 will be more useful
when full group scheduling is implemented.</para></listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Add</guibutton></term>
<listitem><para>Click on the <guibutton>Add</guibutton> button to add the
attendee to the list.</para></listitem>
</varlistentry>
</variablelist>

<para>Repeat the above procedure for all attendees.</para>

<variablelist>
<varlistentry>
<term><guilabel>Address Book</guilabel></term>
<listitem><para>If the attendee is in your Address Book, you do not have to
remember his email address. Just click on the <guibutton>Address
Book...</guibutton> button and choose the attendee 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><guilabel>Sorting</guilabel></term>
<listitem><para>Please note that you can change the order of attendees.
Click on any of the column headings (Name, Email, Role, Status,
<acronym>RSVP</acronym>) to sort the list according to that column.
</para></listitem>
</varlistentry>

<varlistentry>
<term>Changing the Status</term>
<listitem><para>As the attendees send you feedback (they confirm, decline,
delegate the event), you will need to edit the status and perhaps other
information. First select the attendee from the list (click on his/her
line). Attendee name, email and other data will appear in the appropriate
fields. Now edit the information and change the status as needed. When
finished, click on the <guibutton>Modify</guibutton> button to save your
changes.</para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="reference-windows-config-toolbars">
<title>Configure toolbars</title>

<para>&korganizer; has two toolbars: a Main toolbar (with
<guiicon>New</guiicon>, <guiicon>Open</guiicon>, <guiicon>Print</guiicon>,
<guiicon>Cut</guiicon>, <guiicon>Copy</guiicon>, <guiicon>Paste</guiicon>,
<guiicon>Goto Today</guiicon>, <guiicon>New Event</guiicon> and
<guiicon>Mail Event</guiicon> icons, and with actions specific to &korganizer;,
like <guiicon>Find</guiicon> and <guiicon>Print</guiicon> preview) and a
<guiicon>View</guiicon> toolbar (for selecting between
<guiicon>List view</guiicon>, <guiicon>Day view</guiicon>,
<guiicon>Workday view</guiicon>, <guiicon>Week view</guiicon>, and
<guiicon>Month view</guiicon>). 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 on the toolbar to bring up the <guimenu>Toolbar Menu
</guimenu>.  The style 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 graphic style is adjusted through the <guimenu>Toolbar
Menu</guimenu>.  Right click on the toolbar to access this menu.
</para></listitem>
<listitem><para>The tool set is configured in the <menuchoice><guimenu>
Settings</guimenu><guimenuitem>Configure
toolbars</guimenuitem></menuchoice> menu.
</para></listitem></itemizedlist>
</para>

<sect3 id="config-toolbars-settings-config">
<title><menuchoice><guimenu>Settings</guimenu><guimenuitem>
Configure toolbars</guimenuitem></menuchoice></title>

<para>This dialog allows you to customize the selection of tools on the
toolbar.</para>

<sect4 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>
</sect4>

<sect4 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>
rectangle. 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
cluttered and therefore looks cleaner. 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>

</sect4>
</sect3>

<sect3 id="config-toolbars-context-menu">
<title>Toolbar Menu</title>

<para>This menu allows you to change the look of the toolbars.
<mousebutton>Right</mousebutton> click on the toolbar to access this
menu.</para>

<sect4 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>
</sect4>

<sect4 id="config-toolbars-toolbar-position">
<title>Toolbar position</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 on that rectangle and the toolbar
will appear again.</para>
</sect4>

<sect4 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>
</sect4>
</sect3>
</sect2>

<sect2 id="reference-windows-preferences">
<title>Preferences</title>

<para>The options dialog lets you configure a number of different areas of
&korganizer;.</para>

<sect3 id="preferences-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>Your Name</guilabel></term>
<listitem><para><guilabel>Your 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 &kcontrol; (see
below).  This name will be displayed as <guilabel>Owner</guilabel> in
To-Do tasks 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>Use Email settings from Control Center</guilabel></term>

<listitem><para>Check this to use your name and email address as set in
&kcontrol; (<menuchoice><guimenuitem>Network</guimenuitem>
<guimenuitem>E-mail</guimenuitem></menuchoice> in &kcontrol;)</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>, you will get a copy of all e-mail messages that
&korganizer; sends at your request to the event attendees.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Holidays</guilabel></term>
<listitem><para><guilabel>Holidays</guilabel> menu defines public holidays
automatically according to the chosen country. In the Date Navigator,
public holidays and weekends are displayed in red color.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Auto-save calendar</guilabel></term>
<listitem><para>When <guilabel>Auto-save calendar</guilabel> is checked,
calendar is saved automatically when you exit &korganizer;, without asking.
Furthermore, the calendar is saved periodically as you work to prevent the
loss of valuable data. You can also specify the save interval in
 minutes.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Confirm Deletes</guilabel></term>
<listitem><para>When you check <guilabel>Confirm Deletes</guilabel>,
 &korganizer;
will ask you to confirm each deletion. If this is not checked, &korganizer;
will never ask before deleting events.</para></listitem>
</varlistentry>
</variablelist>
<!-- Mail client selection-->

<!-- Auto-start Alarm Daemon -->

</sect3>

<sect3 id="preferences-time-and-date">
<title>Time &amp; Date</title>

<variablelist>
<varlistentry>
<term><guilabel>Time Zone</guilabel></term> <!-- drop down -->
<listitem><para><guilabel>Time Zone</guilabel> specifies your time zone
in hours offset from <acronym>UTC</acronym> (<acronym>GMT</acronym>).
For the US East Coast, that means -0500 when Daylight Savings are not in
effect, and -0400 when they are.  &korganizer; will automatically adjust
for daylight savings.  </para></listitem> 
</varlistentry>

<varlistentry>
<term><guilabel>Default Event Time</guilabel></term> <!--spin box-->
<listitem><para>When you choose <link linkend="entering-data-events">New
Event</link> from the <link linkend="actions-new-event">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> <!--spin box-->
<term><guilabel>Default duration time of a new appointment</guilabel></term>
<listitem><para>When you choose <link linkend="entering-data-events">New
Event</link> from the <link linkend="actions-new-event">Action Menu</link>, or
create an event in some other manner such that &korganizer; cannot guess
the duration of your event, &korganizer; will use this as the default value. 
 </para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Default Alarm Time</guilabel></term>
<listitem><para>In <guilabel>Default Alarm Time</guilabel> you decide how long
before the actual event's scheduled time will alarm activate.</para></listitem>
</varlistentry>

<!--working hours-->

</variablelist>

</sect3>

<sect3 id="preferences-fonts">
<title>Fonts</title>

<itemizedlist>
<listitem><para>Click the <guilabel>Time Bar Font</guilabel> button to choose
Font, Font style and Size for the time bar.</para></listitem>
<listitem><para>Click the <guilabel>Month</guilabel> button to choose Font,
Font style and Size for the Month View.</para></listitem>
<listitem><para>Click the <guilabel>Agenda</guilabel> button to choose Font,
Font style and Size for the Day View, Week View and Work Week
 View.</para></listitem>
</itemizedlist>

</sect3>

<sect3 id="preferences-colors">
<title>Colors</title>

<para>Choose the color used for holidays, for highlighting, and for specific
event categories. You can choose different color for each category. Of course
too many colors may be confusing, so use common sense.</para>

<para>You can also choose a default event color and agenda view background
color.</para>

</sect3>

<sect3 id="preferences-views">
<title>Views</title>

<variablelist>
<varlistentry>
<term><guilabel>Day Begins At</guilabel></term>
<listitem><para><guilabel>Day Begins At</guilabel> is the hour that
&korganizer; will display at the top. You can of course scroll to an
earlier hour, but the <guilabel>Day Begins At</guilabel> should be the
earliest time that you use for events. It could be the time when you
usually get up, or the time when you start working.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Show events that recur daily in the Date
Navigator</guilabel></term>
<listitem><para>If the <guilabel>Show events that recur daily in Date
Navigator</guilabel> checkbox 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> checkbox is checked, the days containing weekly recurring
events are shown in bold typeface in the Date Navigator.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Enable ToolTips displaying summary</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</guilabel> if you want the full summary displayed
when the mouse pointer remains over the appointment for a few
seconds.</para></listitem>
</varlistentry>

<!--Enable Scrollbars in Month View cells-->

<!--Month view uses full window-->

<!--Todo View uses full window-->

</variablelist>

</sect3>

<sect3 id="preferences-printing">
<title>Printing</title>

<para>The <guilabel>Preview Program</guilabel> field tells &korganizer;
what program you want to use when you choose <guimenuitem>Print
Preview</guimenuitem> from the <link linkend="file-print-preview">File
Menu</link>. To be able to use the <link
linkend="file-print-preview"><guimenuitem>Print
preview...</guimenuitem></link> feature, you need a program that can
accept printing output of &korganizer; and display it on the
screen. Since &korganizer; uses the &PostScript; language to talk to
your printer, you need a program that understands &PostScript; and that
can show it on your screen. Historically, the best results have been
achieved with <application>gv</application>, but &kde;-specific program
&kghostview; is quite mature and therefore is the default. You may of
course specify <application>gv</application> if you wish, or any other
&PostScript;-to-screen software.</para>

</sect3>

<sect3 id="preferences-groupscheduling">
<title>Group Scheduling</title>

<variablelist>
<varlistentry>
<term><guilabel>Scheduler mail client</guilabel></term>
<listitem><para>This field tells &korganizer;
what mail-clinet you want to use groupscheduling. <guilabel>Mail Client
</guilabel> uses a real client you can choose in <link 
linkend="preferences-personal">personal preferences</link>.
With <guilabel> Dummy</guilabel> groupsheduling is disabled.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Scheduler mails should be</guilabel></term>
<listitem><para>
Here you can choose if the event-messages should be cached in the outbox, or
should be sent immediately.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Additional email addresses</guilabel></term>
<listitem><para>This tells &korganizer; what further emailaddresses you have in
addition to the one set in personal preferences <link
linkend="preferences-personal">personal preferences</link>. This is needed, if
you are an attenddee of one event, but have another emailaddress there.
</para></listitem>
</varlistentry>

</variablelist>

</sect3>

</sect2>

<sect2 id="reference-windows-outgoing">
<title>Outgoing Messages</title>
<para>to be written</para>
</sect2>

<sect2 id="reference-windows-incoming">
<title>Incoming Messages</title>
<para>to be written</para>
</sect2>
</sect1>

<!-- end 2.2.0 modifications -->


<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 tasklist. The calendar initially displays today's
date.</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, printing and other operations.</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="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 (click on
<menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice>
and choose the same calendar as in the original window)</para></listitem>
<listitem><para>have two different calendars open at the same time (click on
<menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice>
and choose a different calendar). </para></listitem>
<listitem><para>create a new calendar (click on
<menuchoice><guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice>
to give your new calendar a filename and to save it).</para></listitem>
</itemizedlist>
</listitem>
</varlistentry>
<varlistentry id="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 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></listitem> 
</varlistentry>
<varlistentry id="file-open-recent">
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Open Recent</guimenuitem>
</menuchoice></term>
<listitem><para><guimenuitem>Open Recent</guimenuitem> <action>provides
a list of recently opened calendars for quick access, allowing you to
bypass the file dialog entirely.</action></para></listitem>
</varlistentry>
<varlistentry id="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></listitem> 
</varlistentry>
<varlistentry id="file-save-as">
<term><menuchoice>
<guimenu>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></listitem>
</varlistentry>
<varlistentry id="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="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 View Type (Day, Week, Month or
To-Do).</para></listitem>
</varlistentry>
<varlistentry id="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>
<para>You can choose the program that you use to preview output in the <link
linkend="preferences-printing">Printing Preferences</link>
dialog.</para></listitem>
</varlistentry>
<varlistentry id="file-print-setup">
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Print Setup</guimenuitem>
</menuchoice></term>
<listitem><para><guilabel>Print Setup</guilabel> <action>brings up the print
setup dialog</action>. You can set up the look of your printed output.
See the section on <link linkend="preferences-printing">Printing
Preferences</link> for more information.</para></listitem>
</varlistentry>
<varlistentry id="file-import-ical">
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Import From Ical</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 items</action> directly to &korganizer;. This action
will read the <filename>.calendar</filename> file from your home
directory 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></listitem> 
</varlistentry>
<varlistentry id="file-merge">
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Merge</guimenuitem>
</menuchoice></term>
<listitem><para><guilabel>Merge Calendar:</guilabel> If you have a different
vCalendar file somewhere, and you would like to <action>include its contents
into your own calendar</action>, choose this option.  A good time to do this
would be if you received a vCalendar with a few entries via e-mail, for
instance.</para></listitem>
</varlistentry>
<varlistentry id="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>
<tip><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.</para></tip>
<procedure>
<step><para>Click the <guilabel>Archive Old Entries</guilabel>.</para></step>
<step><para>Fill in the date in <guilabel>Events older than</guilabel> field or
use the Calendar Widget to choose the date. </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, click on the <guilabel>Browse</guilabel> button
and find an existing archive. It will be overwritten, therefore make sure that
you do not need the original data or that you have a backup copy.</para></step>
</procedure></listitem>
</varlistentry>

<varlistentry id="file-export-as-web">
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Export as 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>
<procedure>
<step><para>Click the <guilabel>Export as web page...</guilabel>.You will get a
window with three tabs: <guilabel>General</guilabel>,
 <guilabel>Event</guilabel>, and <guilabel>To-Do</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>Choose the View type: <guilabel>Event List</guilabel>,
<guilabel>To-Do List</guilabel> or <guilabel>Both</guilabel>.</para></step>
<step><para>Specify the web output file in the <guilabel>Output file</guilabel>
field. If you want to overwrite an existing web file, click on the
<guibutton>Browse</guibutton> button to find it.</para></step>
<step><para>Specify if you want to include categories and attendees in the
exported web page.</para></step>
</substeps></step>
<step><para><guilabel>To-Do</guilabel> tab: specify if you want to list Due
Dates, Categories, and Attendees.</para></step>
</procedure></listitem>
</varlistentry>

<varlistentry id="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 on 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="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-Do entries.</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-do entries across the current calendar.</para>

<variablelist>
<varlistentry id="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="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 event(s) to the
clipboard, leaving them untouched in your calendar.</action></para></listitem>
</varlistentry>
<varlistentry id="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, 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="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 an event according to it's summary description</action>. The Find
will only search in the summary field.</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 summary has
<emphasis>work</emphasis> in the middle, you would write 
<userinput>*work*</userinput> in the Find dialog. &korganizer; will locate
 summary entries like
<quote>Must go to work</quote>, <quote>Wine workshop</quote> and
similar. Letter case is ignored.</para></tip>
<para>The result of the Find operation is a list of events with the specified
summary description. The columns shown in the list are the same as the <link
linkend="view-list-view">List View</link> columns.</para> 
<para>This resulting list is active. You can double-click on a line to display
or edit the event details. Get more information about these details in
the <link linkend="entering-data-events">Entering events</link> and
<link linkend="entering-data-to-do">Entering To-Do's</link>
 sections.</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 list of events, including a <quote>list</quote> view, a
<quote>day</quote> view, a <quote>week</quote> view, and a
<quote>month</quote> view.  &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 events
and events constrained to a particular time period or style of display.
Click on any event to select it for further action.
<mousebutton>Right</mousebutton> click an appointment 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="view-list-view">
<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>This view displays all your events for the day as a list. Events are
displayed one per line.  The first column of the appointment will have a bell
icon displayed in it if an alarm is set for the appointment.  The second column
will display a chasing-arrows icon if the appointment repeats multiple times.
Holding the mouse over the arrows icon will bring up a tool tip with more
detailed recurrence information. The third column displays start and end time
information, and the fourth column gives a summary of the appointment.</para>
<para>The list view is good for displaying many events on a single day 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></listitem>
</varlistentry>
<varlistentry id="view-day-view">
<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>This view presents your event for a single day, sorted
chronologically. You can also see the length of each event.  Time is indicated
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 appointment, and displays
the appointment's start and end time and summary. A <guiicon>bell</guiicon> icon
is displayed if an alarm is set for the appointment.  A
<guiicon>chasing-arrows</guiicon> icon is displayed if the appointment repeats
multiple times. Holding the mouse over the arrows icon will bring up a tool tip
with more detailed recurrence information</para>
<para>Since the Day View cannot contain the whole day on most screens, you can
scroll up and down to see the whole day. However there is a useful hint that
tells you if there is any currently invisible event above or below your current
position; it is a small down-pointing or up-pointing arrow at the bottom,
respectively at the top of the main panel.</para>
<para>Any event can be resized 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.</para>
<para> Events can be moved to other, presently non-visible dates. Move the mouse
pointer over the event, and drag it to the Date Navigator on the left
side.</para>
<tip><para>There is a useful shortcut for adding events: double-click on 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
edit the description.  The events <quote>snap</quote> to half-hour increments,
 rounding off
to the closest half hour from where you clicked.</para></tip> </listitem>
</varlistentry>
<varlistentry id="view-workweek-view">
<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></listitem>
</varlistentry>

<varlistentry id="view-week-view">
<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.  See the <link
linkend="view-day-view">Day View section</link> for further
information.</para></listitem>
</varlistentry>

<varlistentry id="view-month-view">
<term><menuchoice>
<guimenu> View</guimenu>
<guimenuitem>Month</guimenuitem>
</menuchoice></term>
<listitem><para><action>Switch the display to the Month view.</action></para>
<para>The month view shows all the events for the current month in a familar
calendar layout. 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>You can navigate inside the month view using a set of buttons along the
right side of the screen.  By pressing the appropriate upwards-facing button,
you can navigate to the past by week, month, or even year. The downwards-facing
buttons will navigate to the future.</para></listitem>
</varlistentry>

<varlistentry id="view-todo-view">
<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 view.</action></para>
<para>The To-Do list provides a place for you to jot down quick (or long-term)
notes to yourself about things that you need to do. The to-do list always
appears right below the Date Navigator. You can also display it in the main
panel if you click on the <guilabel>To-Do View</guilabel> icon or if you choose
<menuchoice><guimenu>View</guimenu><guimenuitem>To-Do
list</guimenuitem></menuchoice>.</para>
<para>You can give your to-do task 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-do events, 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 in the to-do box.  You will get a
menu with the option to create a new entry.  If you clicked on an already
existing to-do, you will get more choices: you can Show the summary, Edit the
task details, Delete the task altogether, or you can create a sub-todo. You
could for example make a large to-do task like building a house, and make
sub-tasks like choosing the right building site, hiring an architect, hiring
workers and finally arranging a party for your friends.</para> 
<para>When you choose <guilabel>New Todo</guilabel>, a new to-do will be created
and you will be able to enter all neccessary <link
linkend="entering-data-to-do">information</link>.</para> 
<para>Click on any to-do task in the list to highlight it. If you click on the
thick-line box on the left of the task description, you will change the
<quote>completed</quote> status of the task. If you double-click the task
 description, you
will be able to edit all the details of this to-do task.</para>
<para>You may also pick <guilabel>Purge Completed</guilabel> from the
<mousebutton>right</mousebutton> mouse button menu to delete all to-do entries
that you have marked completed. This is handy for quick cleanup.</para> 
<para>To-do tasks can also dragged around with the mouse to rearrange the
hierarchy or to exchange to-do tasks 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></listitem>
</varlistentry>
<varlistentry id="view-update">
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Update</guimenuitem>
</menuchoice></term>
<listitem><para>
<action>Updates or refreshes the currently displayed view.</action>
</para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="reference-menus-go">
<title><guimenu>Go</guimenu></title>

<variablelist>
<varlistentry id="go-previous-day">
<term><menuchoice>
<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_go_backward.png"
format="PNG"/></imageobject></inlinemediaobject>
Go</guimenu><guimenuitem>Previous Day</guimenuitem></menuchoice></term>
<listitem><para><action>Go to the previous day.</action></para></listitem>
</varlistentry>
<varlistentry id="go-next-day">
<term><menuchoice>
<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_go_forward.png"
 format="PNG"/></imageobject></inlinemediaobject>
Go</guimenu><guimenuitem>Next Day</guimenuitem></menuchoice></term>
<listitem><para><action>Go to the next day.</action></para></listitem>
</varlistentry>
<varlistentry id="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 today.</action></para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="reference-menus-actions">
<title><guimenu>Actions</guimenu></title>

<variablelist>
<varlistentry id="actions-new-event">
<term><menuchoice>
<guimenu>Actions</guimenu>
<guimenuitem>New Event</guimenuitem>
</menuchoice></term>
<listitem><para>Choose <guilabel>New Event</guilabel> to <action>start writing a
new event</action>. Initially the appointment window will have current time and
date.</para> <para>Read detailed description of the event window in <link
linkend="entering-data-events">Entering Events</link> section.</para></listitem>
</varlistentry>
<varlistentry id="actions-new-todo">
<term><menuchoice>
<guimenu>Actions</guimenu>
<guimenuitem>New To-do</guimenuitem>
</menuchoice></term>
<listitem><para>Choose <guilabel>New To-Do</guilabel> to <action>start writing a
new To-Do task</action>. Initially the task has no Due date, but you can specify
one.</para> <para>Read detailed description of the event window in <link
linkend="entering-data-events">Entering Events</link> section.</para>
<para>To-Do screen is quite similar to the event screen, except there is no
recurrence tab window. To-Do tasks are supposed to be one-time
only.</para></listitem>
</varlistentry>
<varlistentry id="actions-delete-event">
<term><menuchoice>
<guimenu>Actions</guimenu>
<guimenuitem>Delete Event</guimenuitem>
</menuchoice></term>
<listitem><para>Choose <guilabel>Delete Event</guilabel> to <action>remove the
currently selected event or To-Do task.</action> You will be asked for
confirmation.</para>
<para>However, if the <menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Preferences</guimenuitem>
<guimenuitem>Personal</guimenuitem><guimenuitem>Confirm
Deletes</guimenuitem></menuchoice> checkbox is <emphasis>not</emphasis> checked,
you will not be prompted for confirmation, and the event will be deleted
immediately.</para></listitem>
</varlistentry>

<varlistentry id="actions-mail-event">
<term><menuchoice>
<guimenu>Actions</guimenu>
<guimenuitem>Mail Event</guimenuitem>
</menuchoice></term>
<listitem><para>Choose <guilabel>Mail Event</guilabel> to <action>mail the
currently selected event to it's attendees.</action></para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="reference-menus-schedule">
<title><guimenu>Schedule</guimenu></title>

<variablelist>
<varlistentry id="schedule-outgoing">
<term><menuchoice>
<guimenu>Schedule</guimenu>
<guimenuitem>Outgoing Messages...</guimenuitem>
</menuchoice></term>
<listitem><para>Open the outbox-dialog.</para></listitem>
</varlistentry>

<varlistentry id="schedule-incoming">
<term><menuchoice>
<guimenu>Schedule</guimenu>
<guimenuitem>Incoming Messages...</guimenuitem>
</menuchoice></term>
<listitem><para>Open the inbox-dialog.</para></listitem>
</varlistentry>

<varlistentry id="schedule-publish">
<term><menuchoice>
<guimenu>Schedule</guimenu>
<guimenuitem>Publish</guimenuitem>
</menuchoice></term>
<listitem><para>Publish an event.</para></listitem>
</varlistentry>

<varlistentry id="schedule-request">
<term><menuchoice>
<guimenu>Schedule</guimenu>
<guimenuitem>Request</guimenuitem>
</menuchoice></term>
<listitem><para>Send the marked event as a group-event to the attendees.</para>
</listitem>
</varlistentry>

<varlistentry id="schedule-refresh">
<term><menuchoice>
<guimenu>Schedule</guimenu>
<guimenuitem>Refresh</guimenuitem>
</menuchoice></term>
<listitem><para>Get the latest version of the active event from the event's 
organizer.</para></listitem>
</varlistentry>

<varlistentry id="schedule-cancel">
<term><menuchoice>
<guimenu>Schedule</guimenu>
<guimenuitem>Cancel</guimenuitem>
</menuchoice></term>
<listitem><para>Cancel the groupscheduling-event.</para></listitem>
</varlistentry>

<varlistentry id="schedule-reply">
<term><menuchoice>
<guimenu>Schedule</guimenu>
<guimenuitem>Reply</guimenuitem>
</menuchoice></term>
<listitem><para>Answer to an event-request.</para></listitem>
</varlistentry>

<varlistentry id="schedule-counter">
<term><menuchoice>
<guimenu>Schedule</guimenu>
<guimenuitem>Counter</guimenuitem>
</menuchoice></term>
<listitem><para>Answer to an event-request an make a proposal for new date/time.
</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="reference-menus-settings">
<title><guimenu>Settings</guimenu></title>

<variablelist>
<varlistentry id="settings-show-toolbar">
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Click on this to enable or disable the
toolbar.</action></para></listitem>
</varlistentry>

<varlistentry id="settings-configure-toolbars">
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Toolbars...</guimenuitem>
</menuchoice></term>
<listitem><para>Click on this to display the <link
linkend="reference-windows-config-toolbars">Toolbar Configuration
Window</link>.</para></listitem>
</varlistentry>
<varlistentry id="settings-preferences">
<term><menuchoice>
<guimenu><inlinemediaobject><imageobject><imagedata
 fileref="i_settings_prefs.png"
format="PNG"/></imageobject></inlinemediaobject>
Settings</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice></term>
<listitem><para>Choose <menuchoice> <guimenu>Settings</guimenu>
<guimenuitem>Preferences</guimenuitem> </menuchoice> or click the
<guiicon>Preferences</guiicon> icon to display <link
linkend="reference-windows-preferences">Preferences
window</link>.</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="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="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="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="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="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="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="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="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="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="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="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="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="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="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="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="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="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="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="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="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 on <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 onscreen 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>

<sect1 id="vcalendar-format">
<title>vCalendar Format</title> 

<para>&korganizer; is the first free <abbrev>PIM</abbrev> for &UNIX;
which implements the vCalendar protocol for personal data
interchange. This vendor-independent, open standard allows different
programs and devices to share/synchronize event and calendar information
without proprietary standards. The data is stored in
<acronym>ASCII</acronym> and is easily human-readable. While some
&Windows; programs have implemented a limited import/export ability from
their native formats to vCalendar, &korganizer;'s native file format on
disk is vCalendar, so it bypasses this middle-step entirely. It also
allows you to easily access your data without the program itself, in the
spirit of other &UNIX; programs. </para>

</sect1>

</chapter>

<chapter id="other-features">
<title>Other Features</title>

<para>In this chapter, you'll learn other useful features of
&korganizer;: the parameters you can specify on the command line (when
invoking &korganizer; from a shell), what tricks you can do with a click
of your mouse, what interaction between &korganizer; and &konqueror; is
possible.</para>

<para>You'll also learn about merging and importing data, and about
synchronizing with your &PalmPilot; or compatible handheld
computer.</para>

<sect1 id="other-features-commandline-options">
<title>Command Line</title>

<para>While &korganizer; supports the full score of options that are
common to all &kde; programs, it also supports two options of its own:
it can list the events for the current day, and it can show the list of
events for a specified number of days.</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry>Option</entry>
  <entry>Description</entry>
</row>
</thead>
<tbody>
<row>
  <entry><option>--help</option></entry>
  <entry>Shows a brief options help text.</entry>
</row>
<row>
  <entry><option>--help-qt</option></entry>
  <entry>Shows numerous generic Qt-specific options.</entry>
</row>
<row>
  <entry><option>--help-kde</option></entry>
  <entry>Shows numerous generic KDE-specific options.</entry>
</row>
<row>
  <entry><option>--author</option></entry>
  <entry>Shows the names and email addresses of &korganizer; authors.</entry>
</row>
<row>
  <entry><option>-V</option>, <option>--version</option></entry>
  <entry>Shows the running versions of the Qt library , &kde; and
 &korganizer;.</entry>
</row>
<row>
  <entry><option>-l</option>, <option>--list</option></entry>
  <entry>Lists the events for the current day.</entry>
</row>
<row>
  <entry><option>-s</option>, <option>--show</option>
  <parameter>numdays</parameter></entry>
  <entry>Shows the list of events for a specified number of days</entry>
</row>
</tbody>
</tgroup>
</informaltable> 

</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 resized 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-merging-data">
<title>Merging Data</title>

<para>You can merge data from different calendar. Choose
<menuchoice><guimenu>File</guimenu><guimenuitem>Merge
Calendar...</guimenuitem></menuchoice> and find the vCalendar file that you want
to merge with the current calendar.</para>

</sect1>

<sect1 id="other-features-import">
<title>Import</title>

<para>You can import calendar data from the classic scheduling program
<application>Ical</application>. The <application>Ical</application>
files must reside in your home directory. Choose <menuchoice>
<guimenu>File</guimenu> <guimenuitem>Import from
Ical</guimenuitem></menuchoice> to carry out this task.</para>

</sect1>

<sect1 id="other-features-palm-sync">
<title>Palm Synchronization</title>

<para>### to be written... ###</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="file-import-ical">Import From 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 it's data to vCalendar format. Then
you must copy this data to your home directory, click
<menuchoice><guimenu>File</guimenu> <guimenuitem>Open</guimenuitem>
</menuchoice>, navigate to the file and double-click it.</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>Unfortunately this is not implemented yet, but planned for one of 
the next releases.</para>
</answer>
</qandaentry>
</qandaset>

</chapter>

<chapter id="credits">
<title>Credits and License</title>

<para>&korganizer;</para>

<para>Program copyright 2000, The &kde; Developers</para>

<para>Contributors:</para>

<itemizedlist>
<listitem><para>Cornelius Schumacher <email>schumacher@kde.org</email></para>
</listitem>
<listitem><para>Preston Brown <email>pbrown@kde.org</email></para>
</listitem>
</itemizedlist>

<para>Documentation copyright 2000 Milos Prudek</para>
<para>Documentation copyright 2001 Paul E. Ahlquist, Jr
<email>pea@ahlquist.org</email></para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

<para>&korganizer; homepage is at <ulink
url="http://devel-home.kde.org/~korganiz">http://devel-home.kde.org/~korganiz</ulink></para>




&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://devel-home.kde.org/~korganiz">http://devel-home.kde.org/~korganiz</ulink>



</para>

</sect1>

<sect1 id="requirements">
<title>Requirements</title>

<para>&korganizer; requires &kde; 2.0. It requires roughly 2MB of space
in your &kde; system directory. Your calendars will require additional
space in your home directory. 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
localisation 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://devel-home.kde.org/~korganiz">http://devel-home.kde.org/~korganiz</ulink>



</para>

</sect1>

<sect1 id="compilation">
<title>Compilation and Installation</title>

<para>If &korganizer; is not installed and if you are the administrator
of your system, your best bet is to use a precompiled binary
file. </para>

<itemizedlist>

<listitem><para>If your system understands rpm binary package format,
you should get a file <filename>kdepim-2.2.i386.rpm</filename> or
similar. The correct installation command is: <userinput><command>rpm</command>
<option>-i</option> <replaceable>kdepim-2.2.i386.rpm</replaceable></userinput>,
 and the
correct upgrade command is: <userinput><command>rpm</command>
 <option>-U</option>
<replaceable>kdepim2.i386.rpm</replaceable></userinput></para></listitem>

<listitem><para>If your system uses different binary package format, you
need to read the instructions that came with your
system.</para></listitem>

<listitem><para>If you cannot obtain precompiled binary package, you
have to compile &korganizer; yourself from a source file.</para>

&install.compile.documentation;

</listitem>

</itemizedlist>

</sect1>

<sect1 id="groupscheduling-setup">
<title>Setting up Groupscheduling</title>
<para>To make groupscheduling work with &korganizer; you need to apply a filter to
your mail-client. If you use <application>kmail</application> you have to make 
a filter, that <emphasis>pipes</emphasis> every email through a skript called
<emphasis>korganizerIn</emphasis>, which you should find in the same directory,
as the korganizer binary is.
</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 on 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 on 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="preferences-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 task must be finished. For
instance, if your To-Do task is that you must return your books to the library
by 16th November, that date is called <quote>the To-Do task 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>
checkbox, <guilabel>Require response</guilabel> checkbox 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="reference-windows-attendees">Attendees section</link> of Windows
reference, and in the <link linkend="preferences-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 View.</para>
<para>The right mouse button can be used in the List view and To-Do view
only. It displays a local menu. The left mouse button can be used in any
view.</para>
</glossdef>
</glossentry>

</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
-->
