<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
<!ENTITY kappname "&korganizer;">
<!ENTITY % addindex "IGNORE">
<!ENTITY % English "INCLUDE">
<!ENTITY % ents PUBLIC "-//KDE//ENTITIES Documentation V1.0//EN">
  %ents;
]>

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

<bookinfo>

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

<authorgroup>
<author>
<firstname>Milos</firstname>
<surname>Prudek</surname>
</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>vampyr@atconnex.net</email></address></affiliation>
<contrib>Reviewer</contrib>
</othercredit>
</authorgroup>

<copyright>
<year>2000</year>
<holder>Milos Prudek</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>14/12/2000</date>
<releaseinfo>1.92.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 Palm Pilot 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="installation">reference
documentation</link>!</para>

<sect1 id="korg-revhistory">
<title>&korganizer; Revision History</title>

<itemizedlist>
<listitem><para>1.92 - current release</para></listitem>
</itemizedlist>

</sect1>
</chapter>

<chapter id="five-minute-course">
<title>Five-minute Fly-over Course of &korganizer; (for the experienced and for the
impatient)</title>

<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 Date Navigator.</para></step>
<step><para>Click on <guiicon><inlinemediaobject><imageobject>
<imagedata fileref="i_view_day.png" format="PNG"></imageobject>
</inlinemediaobject></guiicon>.</para></step> 
<step><para>Double-click 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 the desired date in the Date Navigator.</para></step>
<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 withing 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<footnote><para>The <guilabel>No
time associated</guilabel> checkbox only appears when the <guilabel>No due
date</guilabel> is unchecked.</para> </footnote> 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 Date Navigator 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, Workweek 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 pulldown 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, double click the To-Do in the To-Do panel.</para>

<para>Alternatively, if the main panel holds List View or To-Do View, you can
locate and double-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 configuration
window, click on <menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Preferences</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 toolbar. 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 place on your screen.</para>

<para>Localisation information like date and time formats can be configured from
<application>KDE Control Center</application> within the <menuchoice>
<guisubmenu>Personalization</guisubmenu> <guimenuitem>Country &
Language</guimenuitem> </menuchoice> module. &korganizer; has to be restarted for changes
done in <application>KDE Control Center</application> to take effect.</para>

</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 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 Date Navigator to go to the event date.</para></step>
<step><para>Use the View toolbar to choose the desired view icon (or select the
desired view from the View 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 Day View, Work Week View or Week View
(the Month 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>General tab</title>

<para>This is a thorough description of the individual event window fields and
widgets. Not all fields have to be filled in; some can be left empty. Read the
<link linkend="entering-data-required-fields">Required fields section</link> for
detailed information. And if you prefer to learn by example, there's one in the
<link linkend="examples-entering-event">Entering event</link> section.</para>

<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. While initially this name is the same as Full Name (specified in
<application>KDE Control Center</application>, in <menuchoice>
<guisubmenu>Personalisation</guisubmenu>
<guimenuitem>E-mail</guimenuitem></menuchoice>), you can change it in
<menuchoice> <guimenu>Settings</guimenu> <guisubmenu>Preferences</guisubmenu>
<guisubmenu>Personal</guisubmenu> <guimenuitem>Your
name</guimenuitem></menuchoice>.</para></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>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 Calendar Widget. Choose time from half-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 menu to choose time from half-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 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 <guiicon>Note</guiicon> symbol to choose the alarm
sound. Click on the <guiicon>Running Man</guiicon> icon to browse to 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><guilabel>Details:</guilabel></term>
<listitem><para>Enter a long description of the event in the large
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 several categories to the event. 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 "This event does not reccur" in
the middle of the <guilabel>Recurrence</guilabel> tab window.</para></warning>

<para>The Recurrence tab window is divided into four groups: <guilabel>Event
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 just a copy of the <link
linkend="entering-data-events-general"><guilabel>General</guilabel> tab
window</link> time specification. Changes that you make here will be displayed
in the <guilabel>General</guilabel> tab window and vice versa. Note the
automatically calculated duration time to the right.</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 (i.e., 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 "end" 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 (i.e. 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 General and Attendees tabs
appears.</para>

<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>
<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
<application>KDE Control Center</application>, in <menuchoice>
<guisubmenu>Personalisation</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>
<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 at a certain datem, and give that 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>Completed</guilabel></term>
<listitem><para>Leave the <guilabel>Completed</guilabel> checkbox
unchecked. Later on, when you finish your task, you can check this and your task
will be displayed as completed.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Priority</guilabel></term>
<listitem><para>Assign a priority to your task. Highest priority tasks are at
the top of the To-Do list.</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> <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></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Categories</guilabel></term>
<listitem><para>You can assign several categories to the task. 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. 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>

</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="examples">
<title>Examples</title> 

<sect1 id="examples-entering-event">
<title>Entering 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>12am</emphasis>
and end at <emphasis>1pm </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 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
weekly recurring. 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 Avaliable
Categories. Click the <guilabel>Add>></guilabel> button. Then click the
<guibutton>OK</guibutton> button.</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>Preferences</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. Click on the
<guibutton>Add&lt;&lt;</guibutton> button to assign suitable categories to the
task. You can also add a new category in the <guilabel>New Category</guilabel>
field.</para>

<para>The first category that you assign to the task is special. It defines the
color of the event in the agenda view. Thus Meeting will get colored grey while
Holiday will be displayed in red. The colors can be configured in the
<menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Preferences</guimenuitem>
</menuchoice> dialog. Other categories that your assign to the task have no
special meaning. The <guilabel>Find</guilabel> dialog ignores categories.</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>

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

</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.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Role</guilabel></term>
<listitem><para>Choose the role of the attendee (Attendee, Organizer, Owner,
Delegate). The role is a simple reminder of what is the role of this
attendee. 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 successfull. It can be used for sorting (see
below).</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Require Response</guilabel></term>
<listitem><para>Check the <guilabel>Require 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 <guilabel>Address
Book...</guilabel> button and choose the attendee from the list. Please note
that this is the standard KDE address book, which is also used by
<application>KMail</application> and can also be called as a separate application
(<application>kab</application>).</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, <abbrev>RSVP</abbrev>) 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, e-mail 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>Although the text below describes how you can change the toolbar location
in the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
toolbars</guimenuitem></menuchoice> menu, there is another and perhaps easier
way to move the toolbars around the screen. 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>

<sect3 id="config-toolbars-choose-toolbar">
<title>Choosing the toolbar</title>

<para>First you need to choose the toolbar that you want to modify. All actions
apply to the toolbar that is selected at the top of the window. </para>

</sect3>

<sect3 id="config-toolbars-available-actions">
<title>Available actions</title>

<para>There are two rectangles below the toolbar title: <guilabel>Available
actions</guilabel> and <guilabel>Current actions</guilabel>. Using the left and
right arrows (located between the rectangles) you can add icons from the
Available actions group to the <guilabel>Current actions</guilabel> group. The
toolbar will have every icon that is in the <guilabel>Current action</guilabel>
rectangle.</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>

</sect3>

<sect3 id="config-toolbars-text-position">
<title>Text position</title>

<para>Initially, icons do not have any text assigned. You may prefer having text
under each icon, or text aside each icon. You can also have plain texts without
any icons.</para>

</sect3>

<sect3 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 outsite 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> 

</sect3>

<sect3 id="config-toolbars-icon-size">
<title>Icon size</title>

<para>You can change the size of the icons. Make your choice between small,
medium and large icons.</para> 

</sect3>

</sect2>

<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> initially contains the Full Name
from <menuchoice> <guimenuitem>Personalization</guimenuitem>
<guimenuitem>E-mail</guimenuitem> </menuchoice> in <application>KDE Control
Center</application>, but you can of course type in a different name. 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>Additional</guilabel></term>
<listitem><para><guilabel>Additional</guilabel> information about
yourself. Currently this field is unused, so you may safely ignore
it.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Send Bcc to owner when mailing events</guilabel></term>
<listitem><para>When you check the <guilabel>Send Bcc 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>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 confim each deletion. If this is not checked, &korganizer; will never ask
before deleting events.</para></listitem>  
</varlistentry>
<varlistentry>
<term><guilabel>Holidays</guilabel></term>
<listitem><para><guilabel>Holidays</guilabel> menu defines public holidays
automatically according to the chosen country. Public holidays
and weekends are displayed in red color.</para></listitem>
</varlistentry>
</variablelist>

</sect3>

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

<variablelist>
<varlistentry>
<term><guilabel>Time Zone</guilabel></term>
<listitem><para><guilabel>Time Zone</guilabel> specifies your time zone in hours
offset from <abbrev>UTC</abbrev> (<abbrev>GMT</abbrev>).  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>
<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>
<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>
</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>Week</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 much 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 recuring
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 recuring
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>
</variablelist>

</sect3>

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

<para>Select the appropriate <guilabel>Printer Name</guilabel> which
you want to use for printing in &korganizer;.</para>

<para><guilabel>Paper Orientation</guilabel> specifies the orientation
of the printounts. Portait is vertical printing (more tall than wide), Landscape
is horizontal (more wide than tall).</para>

<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>. Typically you will
want to use <application>kghostview</application>,
<application>ghostview</application>ghostview>, or <application>gv</application>
here.</para>

<para>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
<application>kghostview</application> 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>

</sect2>

</sect1>

<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 "view" 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><keycap>Ctrl</keycap><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><keycap>Ctrl</keycap><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><guilabel>Open Recent</guilabel> <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><keycap>Ctrl</keycap><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 "regular"
calendar.</para></listitem>
</varlistentry>
<varlistentry id="file-close">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><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><keycap>Ctrl</keycap><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
.calendar 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><keycap>Ctrl</keycap><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 accross the current calendar.</para>

<variablelist>
<varlistentry id="edit-cut">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><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><keycap>Ctrl</keycap><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><keycap>Ctrl</keycap><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><keycap>Ctrl</keycap>
<keycap>C</keycap></keycombo> and <keycombo> <keycap>Ctrl</keycap>
<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><keycap>Ctrl</keycap><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
"Must go to work", "Wine workshop" and similar. Letter case isignored.</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 "views" available for displaying your list of
events, including a "list" view, a "day" view, a "week" view, and a "month"
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 tooltip 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 tooltip
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 "snap" 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 "date due", 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 "no priority."</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
"completed" 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-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>

<variablelist>
<varlistentry id="help-contents">
<term><menuchoice>
<guimenu><inlinemediaobject><imageobject><imagedata fileref="i_help_contents.png"
format="PNG"></imageobject></inlinemediaobject> Help</guimenu>
<guimenuitem>Contents</guimenuitem></menuchoice></term>
<listitem><para>Choose
<menuchoice><guimenu>Help</guimenu><guimenuitem>Contents</guimenuitem></menuchoice>
or click the Help Contents icon to <action>display the help pages</action> for &korganizer; which you are right now reading.</para></listitem> 
</varlistentry>
<varlistentry id="help-report-bug">
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>Report Bug</guimenuitem>
</menuchoice></term>
<listitem><para>Choose <guilabel>Report Bug</guilabel> if you believe that you
have discovered a bug in &korganizer;. A bug reporting window will be shown. Decide how
annoying is the bug, and indicate it on <guilabel>Severity</guilabel>
buttons. The KDE Team welcomes your bug reports, for they contribute
significantly to improving the &kde;.</para>
<para>You can also ask the &korganizer; authors to add additional features to the
program. Just choose <guilabel>Wishlist</guilabel> as the Severity, and enter
your wish. We are honestly looking forward to receiving your
ideas.</para></listitem>
</varlistentry>
<varlistentry id="help-about-korganizer">
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>About KOrganizer</guimenuitem>
</menuchoice></term>
<listitem><para>Choose <guimenuitem>About KOrganizer</guimenuitem> to
<action>display copyright information</action> about &korganizer;, and the author
list.</para></listitem>
</varlistentry>
<varlistentry id="help-about-kde">
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>About KDE</guimenuitem>
</menuchoice></term>
<listitem><para>Choose <guilabel>About KDE</guilabel> to <action>display
copyright information about KDE</action>.</para></listitem>
</varlistentry>
</variablelist>

</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><keycap>Ctrl</keycap> <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><keycap>Ctrl</keycap> <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><link linkend="help-contents"><menuchoice><guimenu>Help</guimenu>
  <guimenuitem>Contents</guimenuitem></menuchoice></link> equivalent; help for
  &korganizer;.</entry>
</row>
<row>
  <entry><keycombo><keycap>Ctrl</keycap> <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><keycap>Ctrl</keycap> <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><keycap>Ctrl</keycap> <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><keycap>Ctrl</keycap> <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><keycap>Ctrl</keycap> <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><keycap>Ctrl</keycap> <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><keycap>Ctrl</keycap> <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><keycap>Ctrl</keycap> <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><keycap>Ctrl</keycap> <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><keycap>Ctrl</keycap> <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><keycap>Ctrl</keycap> <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><keycap>Ctrl</keycap> <keycap>F</keycap></keycombo></entry>
</row>
<row>
  <entry><emphasis>Help:</emphasis> <link linkend="help-contents"> <menuchoice>
  <guimenu>Help</guimenu>
  <guimenuitem>Contents</guimenuitem></menuchoice></link> 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><keycap>Ctrl</keycap> <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><keycap>Ctrl</keycap> <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><keycap>Ctrl</keycap> <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><keycap>Ctrl</keycap> <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><keycap>Ctrl</keycap> <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><keycap>Ctrl</keycap> <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
<abbrev>ASCII</abbrev> 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
<application>Konqueror</application> is possible.</para>

<para>You'll also learn about merging and importing data, and about
synchronizing with your Palm Pilot or compatible hanheld 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
  <replaceable>numdays</replaceable></option></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><application>Konqueror</application> interaction</title>

<para><application>Konqueror</application> recognizes the vCalendar format used
by &korganizer;. If you use <application>Konqueror</application> to navigate to your
calendar, it will be displayed <emphasis>inside</emphasis>
<application>Konqueror</application> as a live object. You will be able to


perform most operations with your calendar inside
<application>Konqueror</application>; you will not need to start &korganizer;. In
technical jargon, this is described as "embedding vCalendar as KPart inside
<application>Konqueror</application>".</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>

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

<para>&korganizer; is part of the KDE project
<ulink url="http://www.kde.org">http://www.kde.org</ulink>.
&korganizer; can be found in the kdepim package on
<ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, the
main ftp site of the KDE project.</para>

<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 KDE2 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>kdepim2.i386.rpm</filename>" or similar. The correct
installation command is: <command>rpm <option>-i
<replaceable>kdepim2.i386.rpm</replaceable></option></command>, and the correct
upgrade command is: <command>rpm <option>-U
<replaceable>kdepim2.i386.rpm</replaceable></option></command></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. Find a file
"<filename>kdepim2.tar.gz</filename>" or similar, unpack it in a new directory,
and enter the following in that directory:</para>

<screen width="40">
<prompt>%</prompt> <command>./configure</command>
<prompt>%</prompt> <command>make</command>
<prompt>%</prompt> <command>make <option>install</option></command>
</screen>
</listitem> 

</itemizedlist>

<para>Since &korganizer; uses <application>autoconf</application> and
<application>automake</application> you should have not trouble compiling
it. Should you run into problems please report them to the <ulink
 url="http://lists.kde.org">KDE mailing lists</ulink>.</para> 
</sect1>

</appendix>

<glossary id="glossary">
<title>Glossary</title> 

<glossentry id="gloss-calendar-widget">
<glossterm>Calendar Widget</glossterm>
<glossdef>

<para>A tool for choosing the date inside certain entry windows, like event
editing window. It is displayed as a small button to the right of the date
field. When you click the button, you will see a month calendar. Use the arrows
to go to a desired date, or click 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>Recuring events are not always displayed. You can forbid the display of
recuring 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 "the To-Do task due date"</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>

<![ %addindex; [ &kdedocindex; ]]>
</book>
