<?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY kappname "&korganizer;"> <!ENTITY package "kdepim"> <!ENTITY % addindex "IGNORE"> <!ENTITY % English "INCLUDE"> ]> <book id="korganizer" lang="&language;"> <bookinfo> <title>The &korganizer; Handbook</title> <authorgroup> <author> <firstname>Milos</firstname> <surname>Prudek</surname> </author> <author> <firstname>Paul</firstname> <othername>E.</othername> <surname>Ahlquist</surname> <lineage>Jr.</lineage> <affiliation><address><email>pea@ahlquist.org</email></address></affiliation> </author> <othercredit role="developer"> <firstname>Cornelius</firstname> <surname>Schumacher</surname> <affiliation><address><email>schumacher@kde.org</email></address></affiliation> <contrib>Developer</contrib> </othercredit> <othercredit role="developer"> <firstname>Preston</firstname> <surname>Brown</surname> <affiliation><address><email>pbrown@kde.org</email></address></affiliation> <contrib>Developer</contrib> </othercredit> <othercredit role="reviewer"> <firstname>Lauri</firstname> <surname>Watts</surname> <affiliation><address><email>lauri@kde.org</email></address></affiliation> <contrib>Reviewer</contrib> </othercredit> <!-- TRANS:ROLES_OF_TRANSLATORS --> </authorgroup> <copyright> <year>2000</year><holder>Milos Prudek</holder> </copyright> <copyright> <year>2001</year> <holder>Paul E. Ahlquist Jr.</holder> </copyright> <legalnotice>&FDLNotice;</legalnotice> <date>2001-07-29</date> <releaseinfo>2.20.00</releaseinfo> <keywordset> <keyword>KDE</keyword> <keyword>KOrganizer</keyword> <keyword>kdepim</keyword> <keyword>manager</keyword> <keyword>time</keyword> <keyword>schedule</keyword> <keyword>alarm</keyword> <keyword>appointment</keyword> </keywordset> <abstract><para>&korganizer; is an easy to use personal information manager (<acronym>PIM</acronym>). You can schedule appointments, events, and to-do tasks. &korganizer; will remind you about pending tasks, and help you keep your schedule. </para></abstract> </bookinfo> <chapter id="introduction"> <title>Introduction</title> <para>&korganizer; is a personal information manager (<abbrev>PIM</abbrev>). You can schedule appointments, events, and to-do tasks. &korganizer; will remind you about pending tasks, and help you keep your schedule.</para> <para>Main features of &korganizer;:</para> <para><itemizedlist> <listitem><para>To-Do's and Events supported</para></listitem> <listitem><para>Easy editing and change from one type of event to another</para></listitem> <listitem><para>Categories can be assigned to events</para></listitem> <listitem><para>Category color highlighting</para></listitem> <listitem><para>Multiple calendars can be open</para></listitem> <listitem><para>Reschedule by drag-and-drop</para></listitem> <listitem><para>Numerous options for generating repeated events</para></listitem> <listitem><para>Emerging group scheduling support</para></listitem> <listitem><para>vCalendar open standard native support</para></listitem> <listitem><para>Calendar merging and import</para></listitem> <listitem><para>Full &PalmPilot; synchronization</para></listitem> <listitem><para>Drag-and-drop between open calendars</para></listitem> <listitem><para>Embedding collaboration with &konqueror;</para></listitem> <listitem><para>Customizable icon sets</para></listitem> <listitem><para>Drag-and-drop tool panels</para></listitem> <listitem><para>Command line parameters</para></listitem> </itemizedlist></para> <para>Now take a <link linkend="five-minute-course">Five-minute fly-over course</link> of &korganizer;, or delve into <link linkend="reference">reference documentation</link>!</para> </chapter> <chapter id="five-minute-course"> <title>Five-minute Fly-over Course of &korganizer;</title> <subtitle> (for the experienced and for the impatient)</subtitle> <para>Pressed for time? Let's kick you started with a fast, hands-on overview of &korganizer;!</para> <para>If you ever worked with a personal information program before, you'll be right at home with &korganizer;. You can enter new events, reschedule existing events, assign categories to your events, devise new categories, enter and modify lists of attendees and their roles, email event invitations automatically and exchange data with other &korganizer; calendars.</para> <para>This course assumes that you know how to work with the &kde;, and that you prefer to explore on your own. Only the basic functions of &korganizer; are covered here.</para> <sect1 id="course-entering-events"> <title>Entering events</title> <procedure> <step><para>Click on the desired date in the <link linkend="glossary" endterm="gloss-date-navigator">Date Navigator.</link> </para></step> <step><para>Click on <guiicon><inlinemediaobject><imageobject> <imagedata fileref="i_view_day.png" format="PNG"/></imageobject> </inlinemediaobject></guiicon>. This will bring up the <guilabel> Day View</guilabel> pane.</para></step> <step><para>Double-click the text area beside the desired hour in the main panel.</para></step> <step><para>Enter event details. Use tabs <guilabel>General</guilabel>, <guilabel>Attendees</guilabel>, and <guilabel>Recurrence</guilabel> to move around.</para></step> <step><para>Click on <guibutton>OK</guibutton> to save the event.</para></step> </procedure> </sect1> <sect1 id="course-entering-todos"> <title>Entering To-Do's</title> <procedure> <step><para>Click on <menuchoice><guimenu>Actions</guimenu> <guimenuitem>New To-Do</guimenuitem></menuchoice>.</para></step> <step><para>Enter To-Do details. Use tabs <guilabel>General</guilabel> and <guilabel>Attendees</guilabel> to move around.</para></step> <step><para>Click on <guibutton>OK</guibutton> to save the To-Do.</para></step> </procedure> </sect1> <sect1 id="course-event-types"> <title>Event Types</title> <para>There are two types of entries in &korganizer;:</para> <itemizedlist> <listitem><para>Events start and finish at distinct date. You can also specify distinct start and finish times, but you don't have to. While business meetings, personal anniversaries and cinema visits are examples of carefully planned events with exact time scheduling, a holiday is an event that takes several days and thus there is no need to specify exact start and finish times.</para></listitem> <listitem><para>To-Do's are events that must take place no later than a certain date, but they can also take place sooner.</para></listitem> </itemizedlist> <para>Naturally, what began as a To-Do may later require exact timing. Say it is July 1 and you need to go to a hairdresser within a week. On July 3 you talk to your hairdresser and agree on an exact time. Thus the original To-Do becomes similar to an appointment. </para> <para>&korganizer; makes adding exact time to a To-Do very easy. If you uncheck the <guilabel>No time associated</guilabel> checkbox and enter the appropriate time, your To-Do becomes very similar to an event (but without recurrence tab, which is natural, since a to-do task is supposed to be a one-time only event).</para> </sect1> <sect1 id="course-rescheduling-events"> <title>Rescheduling events</title> <para>Rescheduling events is a simple drag-and-drop operation:</para> <procedure> <step><para>Using the <link linkend="glossary" endterm="gloss-date-navigator">Date Navigator</link> go to the event that you want to reschedule.</para></step> <step><para>Drag and drop the event to the new date and time location.</para></step> </procedure> <para>You should choose an appropriate <link linkend="reference-menus-view">view</link> before beginning this operation. Only the Day, Work week and Week views show individual hours and are suitable for rescheduling exactly-timed events (appointments), while the Month view only shows days. Therefore the Month view is most suitable for long-time events like holidays.</para> <para>If you wish to reschedule more precisely, double-click the event and change the start and end time using the drop down menus that divide the day into quarter hours. If that is not enough precision, you can enter the desired time directly.</para> </sect1> <sect1 id="course-rescheduling-todos"> <title>Rescheduling To-Do's</title> <para>To reschedule a To-Do, right click the To-Do in the To-Do panel. This will bring up a context menu. Select <guimenuitem>Edit...</guimenuitem> Reschedule the To-Do.</para> <para>Alternatively, if the main panel holds List View or To-Do View, you can locate and right click the To-Do there.</para> </sect1> <sect1 id="course-conclusion"> <title>Conclusion</title> <para>This five-minute course covered only the basic operation of &korganizer;. Now you should go on and read the rest of this manual to unleash the full power of &korganizer;'s capabilities. But if you don't feel like it, you should at least skip through the <link linkend="faq">&FAQ;</link>.</para> </sect1> </chapter> <chapter id="config"> <title>Configuration </title> <para>You can change &korganizer;'s behavior if you wish. To display the configuration dialog window, click on <menuchoice><guimenu>Settings</guimenu><guimenuitem> Configure KOrganizer...</guimenuitem></menuchoice>. You can get more information in the <link linkend="reference-windows-preferences">Preferences window description</link>.</para> <para>You can also modify the toolbars. For visual appearance changes, right click on the toolbar and select from the presented menu. To customize the set of tools available on the bar, click on <menuchoice><guimenu> Settings</guimenu><guimenuitem>Configure toolbars </guimenuitem></menuchoice> and read the <link linkend="reference-windows-config-toolbars">detailed description</link>.</para> <para>You can also drag both toolbars around the screen. Point your mouse over the toolbar handle and drag the toolbar to a new position on your the &korganizer; window.</para> <para>Localization information like date and time formats can be configured from &kcontrol; within the <menuchoice> <guisubmenu>Personalization</guisubmenu> <guimenuitem>Country & Language</guimenuitem> </menuchoice> module. This control module can be accessed from within &korganizer;; select <menuchoice><guimenu> Settings</guimenu><guimenuitem>Configure Date & Time...</guimenuitem></menuchoice>. &korganizer; has to be restarted for changes done in &kcontrol; to take effect.</para> <!-- Filters and Catagories should be mentioned here, refering to detail --> </chapter> <chapter id="entering-data"> <title>Entering Data</title> <sect1 id="entering-data-events"> <title>Events</title> <para>Events are future appointments, like business meetings, personal anniversaries and cinema visits. Events can also take several days, like holidays.</para> <para>Entering a new event is very easy. Just click on <menuchoice><guimenu>Actions</guimenu><guimenuitem>New Event</guimenuitem></menuchoice>. A window with <guilabel>General</guilabel>, <guilabel>Attendees</guilabel>, and <guilabel>Recurrence</guilabel> tabs appears. </para> <para>If you wish you can use a different way to start a new event:</para> <procedure> <step><para>Use the Date Navigator to go to the event date.</para></step> <step><para>Click the desired view's icon on the <guimenu>View Toolbar</guimenu> or select the desired view from the <guimenu>View</guimenu> menu. Since your event starts at a particular time, you should choose a <link linkend="reference-menus-view">view</link> that displays hours of the day. You may choose <guimenuitem>Day</guimenuitem>, <guimenuitem>Work Week</guimenuitem> view or <guimenuitem>Week</guimenuitem> view. The <guimenuitem>Month</guimenuitem> view is more suitable for To-Do tasks, described below.</para></step> <step><para>In the main panel, double click on the time and date when your event starts. </para></step> <step><para>A window with <guilabel>General</guilabel>, <guilabel>Attendees</guilabel> and <guilabel>Recurrence</guilabel> tabs appears. Enter your data as described below.</para></step> </procedure> <sect2 id="entering-data-events-general"> <title><guilabel>General tab</guilabel></title> <para>This is a thorough description of the individual event window fields and widgets. Not all fields have to be filled in; some can be left empty. Read the <link linkend="entering-data-required-fields">Required fields section</link> for detailed information. And if you prefer to learn by example, there's one in the <link linkend="examples-entering-event">Entering event</link> section. </para> <variablelist> <varlistentry> <term><guilabel>Owner:</guilabel></term> <listitem><para>Please note that your name is displayed above the <guilabel>Summary</guilabel> field. This means that the task is owned by you. Initially the name is <quote>Anonymous</quote> who has an email address of <quote>nobody@nowhere</quote>. This can be changed. In <menuchoice> <guimenu>Settings</guimenu> <guisubmenu>Configure KOrganizer;... </guisubmenu><guisubmenu>Personal</guisubmenu></menuchoice> there are two methods of setting your name and email address.</para> <itemizedlist> <listitem> <para>Enter your name and email in the provided fields. </para> </listitem> <listitem> <para> Set the check box for <guilabel>Use Email settings from Control Center </guilabel>. This uses your name and email address as specified in &kcontrolcenter;, under <menuchoice><guisubmenu>Network</guisubmenu> <guimenuitem>E-mail</guimenuitem></menuchoice>. </para> </listitem></itemizedlist> </listitem> </varlistentry> <varlistentry> <term><guilabel>Summary:</guilabel></term> <listitem><para>Enter short description of the task into the <guilabel>Summary</guilabel> field. This description is the text shown on the &korganizer; main panel.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Start Date</guilabel> and <guilabel>End Date</guilabel></term> <listitem><para>The &korganizer; suggested Start and End dates of your event. Events are expected to start and end on the same date. Change these dates as desired. Enter the dates directly or use the <link linkend="glossary" endterm="gloss-calendar-widget"> Calendar Widget</link>. Choose time from quarter hour intervals, or enter the desired time directly into the time fields.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>No time associated</guilabel></term> <listitem><para>Check the <guilabel>No time associated</guilabel> if your event is not scheduled on an exact time.</para> <tip><para>Most events are scheduled to an exact time. If your event does not need specific time, perhaps it belongs to <link linkend="entering-data-to-do">To-Do tasks</link></para></tip></listitem> </varlistentry> <varlistentry> <term><guilabel>Start Time</guilabel> and <guilabel>End Time</guilabel></term> <listitem><para>These fields only appear if the <guilabel>No time associated</guilabel> checkbox is not checked. Change the suggested times as desired. Enter the times directly or use the drop down menu to choose time from quarter-hour intervals.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Recurring event</guilabel></term> <listitem><para>Check the <guilabel>Recurring event</guilabel> checkbox if this event happens regularly. You can later specify the exact schedule in the <link linkend="entering-data-events-recurrence">Recurrence tab window</link>.</para> </listitem> </varlistentry> <varlistentry> <term><guilabel>Reminder</guilabel></term> <listitem><para>Check the <guilabel>Reminder</guilabel> checkbox if &korganizer; should remind you about an event. &korganizer; can also run a specific program at that time.</para> <tip><para>Make sure, however, that you have sufficient rights to run that program; if you do not, the program will not run.</para></tip> <para>Choose how many minutes, hours or days before the event you want to be reminded. Click on the musical <guiicon>Note</guiicon> symbol to choose the alarm sound. Click on the <guiicon>Running Man</guiicon> icon to browse for a program that should run at the alarm time.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Show Time As:</guilabel></term> <listitem><para>The duration of the event may be shown as Busy or Free in your schedule. Choose it from the <guilabel>Show Time As</guilabel> menu.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Private</guilabel></term> <listitem><para>Check the <guilabel>Private</guilabel> box to keep the event private. Currently, this checkbox has no real effect. However, when group scheduling features of &korganizer; are completed, private tasks will only be visible to you. The checkbox may also have an effect when the calendar file is loaded in another calendar understanding the vCalendar format.</para></listitem> </varlistentry> <varlistentry> <term>Details:</term> <listitem><para>Enter a long description of the event in the large, untitled rectangle. You can write as many details as you wish here. For example, If the event is, say, planned general repair of your car, you can list all items that need repairing. Later on you can print this list and hand it over to the serviceman. If the event is shopping, you should list the goods that you need to buy. Print the event and take it to the shop with you.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Categories</guilabel></term> <listitem><para>You can assign the event to several categories. Get more information in the <link linkend="reference-windows-categories">Categories description</link>.</para></listitem> </varlistentry> </variablelist> <para>When you want to confirm, call off or revert the entered data, choose among the <link linkend="reference-action-buttons">Action Buttons</link>, <guibutton>OK</guibutton>, <guibutton>Apply</guibutton> and <guibutton>Cancel</guibutton>.</para> </sect2> <sect2 id="entering-data-events-attendees"> <title><guilabel>Attendees</guilabel> tab</title> <para>Some tasks may require more people. You can list those people here. Get more information in the <link linkend="reference-windows-attendees">Attendees section</link> of the Windows reference.</para> <para>When you want to confirm, call off or revert the entered data, choose among the <link linkend="reference-action-buttons">Action Buttons</link>, <guibutton>OK</guibutton>, <guibutton>Apply</guibutton> and <guibutton>Cancel</guibutton>.</para> </sect2> <sect2 id="entering-data-events-recurrence"> <title><guilabel>Recurrence</guilabel> tab</title> <para>Some events take place regularly. You can specify exact scheduling here.</para> <warning><para>Make sure that the <guilabel>Recurring Event</guilabel> checkbox in <link linkend="entering-data-events-general">General tab window</link> is checked. If it is not, you will see a message <computeroutput>This event does not recur</computeroutput> in the middle of the <guilabel>Recurrence</guilabel> tab window.</para></warning> <para>The Recurrence tab window is divided into four groups: <guilabel>Appointment Time</guilabel>, <guilabel>Recurrence Rule</guilabel>, <guilabel>Recurrence Range</guilabel>, and <guilabel>Exceptions</guilabel>. </para> <sect3 id="recurrence-event-time"> <title><guilabel>Event Time</guilabel></title> <para>This is a copy of the <link linkend="entering-data-events-general"> <guilabel>General</guilabel> tab window</link> time specification.</para> </sect3> <sect3 id="recurrence-recurrence-rule"> <title>Recurrence Rule</title> <para>Choose if you want to repeat this event daily, weekly, monthly or yearly. More detailed options are as follows:</para> <variablelist> <varlistentry> <term><guilabel>Daily</guilabel></term> <listitem><para>Specify whether the event occurs every day (1), every other day (2) and so on.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Weekly</guilabel></term> <listitem><para>Specify whether the event occurs every week (1), every other week (2) and so on. Also specify the days (Sunday ... Monday) on which the event occurs. </para></listitem> </varlistentry> <varlistentry> <term><guilabel>Monthly</guilabel></term> <listitem><para>You can either have the event occur on the same day of the month, or in a specific week on a specific day of the week. You need to choose between these two possibilities. By default, &korganizer; assumes you want to repeat on the same calendar day of the month (for instance the 15th). You can also adjust the period, so you can repeat monthly, tri-monthly and so on.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Yearly</guilabel></term> <listitem> <para>This is similar to Monthly. You need to choose whether or not you are indicating a calendar day of the year (&ie;, the 250th day of the year) - <guilabel>Recur on this day</guilabel>, or this day of the month in a particular month of the year - <guilabel>Recur in the month of</guilabel>. By default, &korganizer; assumes you mean the actual day of the year. You can adjust the period to reflect events that occur bi-annually, every four years, and so on.</para> </listitem> </varlistentry> </variablelist> </sect3> <sect3 id="recurrence-recurrence-range"> <title>Recurrence Range</title> <para>By default, events which repeat will do so forever; there is no <quote>end</quote> to the repetition. This may or may not be desirable, so you are provided with two ways of terminating the repetition: either by giving an ending date, or by specifying a total number of recurrences. In this area, you can choose the method that is suitable for this event.</para> </sect3> <sect3 id="recurrence-exceptions"> <title>Exceptions</title> <para>You may have a very nice recurrence rule set up, but realize that there are a few exceptions. If you set up your college class schedule for instance, you may want to make exceptions for holidays and the like. In this area, you can add, change, and delete dates from the list of exceptions (&ie; times when even if the recurrence rule matches, the event will <emphasis>not be scheduled</emphasis>). Pick a date with the date selector, and press <guibutton>Add</guibutton> to include it. For removing dates, highlight them in the box on the right side, and then click <guibutton>Delete</guibutton>.</para> <para>When you want to confirm, call off or revert the entered data, choose among the <link linkend="reference-action-buttons">Action Buttons</link>, <guibutton>OK</guibutton>, <guibutton>Apply</guibutton> and <guibutton>Cancel</guibutton>.</para> </sect3> </sect2> </sect1> <sect1 id="entering-data-to-do"> <title>To-Do</title> <para>The To-Do list is a place for you to write down notes to yourself about things that you need to do. To-Do entries are tasks that do not have to be scheduled. There are short-term and long-term tasks. For instance you should go to a hairdresser within a week, and you should sell your old car within a year. You do not want an alarm go off at a particular time, you just want to have a list of things that you must do, and dates when they must be finished at the latest (date due).</para> <para>To enter a new To-Do, click on <menuchoice><guimenu>Actions</guimenu><guimenuitem>New To-Do</guimenuitem></menuchoice>. A window with <guilabel>General</guilabel> and <guilabel>Attendees</guilabel> tabs appears.</para> <!-- this section is not correct <para>If you wish you can use a different way to start a new event:</para> <procedure> <step><para>Use Date Navigator to go to the due date of your To-Do task.</para> <note><para>A due date is simply the date when your task must be finished. For instance, if your To-Do task is that you must return your books to the library by 16th November, that date is called "the To-Do task due date".</para> </note></step> <step><para>Use the View toolbar to choose the desired view icon (or select the desired view from the View menu). Since your To-Do normally does not start at a particular time, you should choose a <link linkend="reference-menus-view">view</link> that displays as many days as possible, like the Month view. You may choose other views of course, as appropriate.</para></step> <step><para>In the main panel, double-click on the due date of your To-Do task.</para></step> <step><para>A window with <guilabel>General</guilabel> and <guilabel>Attendees</guilabel> tabs appears. Enter your data as described below.</para></step> </procedure> --> <sect2 id="entering-data-to-do-general"> <title><guilabel>General</guilabel> tab</title> <variablelist> <varlistentry> <!-- original in to-do section <term><guilabel>Owner:</guilabel></term> <listitem><para>Please note that your name is displayed above the <guilabel>Summary</guilabel> field. This means that the task is owned by you. While initially this name is the same as Full Name (specified in &kcontrol;, in <menuchoice> <guisubmenu>Personalization</guisubmenu> <guimenuitem>E-mail</guimenuitem> </menuchoice>), you can change it in <menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Preferences</guimenuitem> <guimenuitem>Personal</guimenuitem><guimenuitem>Your name</guimenuitem> </menuchoice>.</para></listitem> </varlistentry> --> <term><guilabel>Owner:</guilabel></term> <listitem><para>Please note that your name is displayed above the <guilabel>Summary</guilabel> field. This means that the task is owned by you. Initially the name is <quote>Anonymous</quote> who has an email address of <quote>nobody@nowhere</quote>. This can be changed. In <menuchoice> <guimenu>Settings</guimenu> <guisubmenu>Configure KOrganizer... </guisubmenu><guisubmenu>Personal</guisubmenu></menuchoice> there are two methods of setting your name and email address.</para> <itemizedlist> <listitem> <para>Enter your name and email in the provided fields.</para></listitem> <listitem><para>Set the check box for <guilabel>Use Email settings from Control Center</guilabel>. This uses your name and email address as specified in &kcontrol;, under <menuchoice><guisubmenu>Network</guisubmenu> <guimenuitem>E-mail</guimenuitem></menuchoice>.</para> </listitem></itemizedlist> </listitem> </varlistentry> <varlistentry> <term><guilabel>Summary</guilabel></term> <listitem><para>Enter short description of the task into the <guilabel>Summary</guilabel> field.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>No due date</guilabel></term> <listitem><para>Uncheck the <guilabel>No due date</guilabel> checkbox if your task should be finished by a certain date. Enter the date in the <guilabel>Due date</guilabel> field.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>No time associated</guilabel></term> <listitem><para>Similarly, uncheck <guilabel>No time associated</guilabel> if your task should be finished at a certain time, and give that time in the field provided.</para> <tip><para>The date and time are initially hidden, because To-Do tasks do not have the character of a fixed event. Some of them do not need a due date at all. Most of them certainly do not need the exact time of fulfillment. If your task requires exact time, maybe it actually belongs to <link linkend="entering-data-events">events</link>.</para></tip></listitem> </varlistentry> <varlistentry> <term><guilabel>Due Date</guilabel></term> <listitem><para>The date the task is to be completed. Enter the date directly or use the <link linkend="glossary" endterm="gloss-calendar-widget"> Calendar Widget</link>. If <guilabel>No time associated</guilabel> is unchecked, a time drop down menu is also offered. Set the time from quarter hour intervals or enter the time directly. </para></listitem></varlistentry> <varlistentry> <term><guilabel>Completed</guilabel></term> <listitem><para> This is a percent completed pull down menu initially set at 0% complete. Later on, you can indicate your progress by adjusting the percent completed in steps of 20%.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Priority</guilabel></term> <listitem><para>Assign a priority to your task. This drop down menu offers priorities from one to five, one being the highest. Initially tasks are set to priority three (midrange).</para></listitem> </varlistentry> <varlistentry> <term>Details</term> <listitem><para>Enter a long description of the task in the large rectangle.</para> <para>For example, If the event is, say, planned general repair of your car, you can list all items that need repairing. Later on you can print this list and hand it over to the serviceman. If the event is shopping, you should list the goods that you need to buy. Print the event and take it to the shop with you.</para> <para>If you enter at the end of the description a <userinput>#</userinput> character followed by a few characters (like <userinput>#002</userinput>), this appears in the To-Do view in the column <guilabel>SortID</guilabel>. This can be used to order the to-do's in an user-definable way.</para> </listitem></varlistentry> <varlistentry> <term><guilabel>Categories</guilabel></term> <listitem><para>You can assign the task to several categories. Get more information in <link linkend="reference-windows-categories">Categories description</link>.</para> </listitem></varlistentry> <varlistentry> <term><guilabel>Private</guilabel></term> <listitem><para>Check the <guilabel>Private</guilabel> box to keep the To-Do task private. Currently, this checkbox has no real effect. However, when group scheduling features of &korganizer; are completed, private tasks will only be visible to you. The checkbox may also have an effect when the calendar file is loaded in another calendar understanding the vCalendar format. </para></listitem></varlistentry> </variablelist> <para>When you want to confirm, call off or revert the entered data, choose among the <link linkend="reference-action-buttons">Action Buttons</link>, <guibutton>OK</guibutton>, <guibutton>Apply</guibutton> and <guibutton>Cancel</guibutton>.</para> </sect2> <sect2 id="entering-data-to-do-attendees"> <title><guilabel>Attendees</guilabel> tab</title> <para>Some tasks may require more people. You can list those people here. Find more information in the <link linkend="reference-windows-attendees">Attendees section</link> of the Windows reference.</para> <para>When you want to confirm, call off or revert the entered data, choose among the <link linkend="reference-action-buttons">Action Buttons</link>, <guibutton>OK</guibutton>, <guibutton>Apply</guibutton> and <guibutton>Cancel</guibutton>.</para> </sect2> </sect1> <sect1 id="entering-data-required-fields"> <title>Required fields</title> <para>This is an overview of what fields are required and what fields can be empty when entering events:</para> <itemizedlist> <listitem><para>In the <guilabel>General</guilabel> Tab, you should at least fill the <guilabel>Summary</guilabel> field and the description (the large rectangle), even though neither is mandatory. If you check the <guilabel>Reminder</guilabel> checkbox, you should also specify the time, and either the sound to be played or the program to be run.</para></listitem> <listitem><para>The <guilabel>Attendees</guilabel> Tab may be left completely empty.</para></listitem> <listitem><para>The <guilabel>Recurrence</guilabel> tab must only be filled if you checked the <guilabel>Recurring event</guilabel> checkbox. </para></listitem></itemizedlist> </sect1> </chapter> <chapter id="group-scheduling"> <title>Group Scheduling</title> <para> Currently &korganizer; can only schedule events using the IMIP-protocol for group scheduling. IMIP is a standard used by many other clients too. For example &Microsoft; <application>Outlook</application>, Lotus <application>Notes</application> and <application>Evolution</application>. This means that you can share events with other users using one of these clients.</para> <sect1 id="as-organizer"> <title>Acting as Organizer in Group Scheduling</title> <para>In day and week view a little icon showing one <guiicon>tux</guiicon> is placed in the event, if you are the organizer of an group scheduling event.</para> <sect2 id="publish"> <title>Publishing an Event</title> <para>If you simply want to send some other people an event, then click <guimenuitem>publish</guimenuitem> in the <guimenu>schedule</guimenu> menu, when the event is marked. Then a dialog appears, asking you for the email addresses you want to send this event.</para> <para>Publishing events does not request an answer from the attendees.</para> </sect2> <sect2 id="request"> <title>Organizing an Event</title> <para>Make a normal event, and add some attendees to the event. Then click on <menuchoice><guimenu>Schedule</guimenu><guimenuitem>Request</guimenuitem> </menuchoice>. If you send your events through the <link linkend="reference-windows-outgoing">outbox</link>, you have to press <guibutton>Send Messages</guibutton>. Then you should get answers from the attendees in your <link linkend="reference-windows-incoming">inbox</link>.</para> </sect2> <sect2 id="cancel"> <title>Cancel an Event</title> <para>To cancel an event you have to be the organizer. Then simply select the event, and press <menuchoice><guimenu>Schedule</guimenu> <guimenuitem>Cancel</guimenuitem></menuchoice>. This will send a cancel-message to all attendees. So if you use the <link linkend="reference-windows-outgoing">outbox</link>, you have to press the <guibutton>Send Messages</guibutton>. Then you should get answers from the attendees in your <link linkend="reference-windows-incoming">inbox</link>.</para> </sect2> </sect1> <sect1 id="as-attendee"> <title>Being the Attendee in a Group Scheduled Event</title> <para>In day and week views, a little icon showing <guiicon>three tux penguins</guiicon> is placed in the event, if you are the organizer of an groupscheduling event.</para> <sect2 id="answer"> <title>Answering an Event-Request</title> <para>If you have an event-request in your <link linkend="reference-windows-incoming">inbox</link> you can either press <guibutton>Reject</guibutton> to ignore the request, or press <guibutton>Accept</guibutton>, and insert it to your calendar. You should then edit your status in the event's <link linkend="reference-windows-attendees"> attendee tab</link>. And then send a reply by marking the event, and pressing <menuchoice><guimenu>Schedule</guimenu><guimenuitem>Reply</guimenuitem> </menuchoice>. If you want to change the date/time of this event, change them, and then send back your proposal by pressing <menuchoice><guimenu>Schedule </guimenu><guimenuitem>Counter</guimenuitem></menuchoice>. </para> </sect2> <sect2 id="refresh"> <title>Get the Latest Version of an Event</title> <para>To get the latest version of an groupscheduling event, select the event, and press <menuchoice><guimenu>Schedule</guimenu><guimenuitem>Refresh</guimenuitem> </menuchoice>. &korganizer; will then send you back the latest version.</para> </sect2> </sect1> </chapter> <chapter id="examples"> <title>Examples</title> <sect1 id="examples-entering-event"> <title>Entering a New Event</title> <para>In this example, you'll enter an event. You need to arrange a meeting on <emphasis>February 12, 2001</emphasis> regarding launch of your new Product. Your boss <emphasis>Joan Holden</emphasis> will be the event chairwoman<emphasis>owner</emphasis>, and you, Jack Smith, will be the event <emphasis>organizer</emphasis>. There'll be two more <emphasis>attendees</emphasis> (participants): <emphasis>Peter Krzinski</emphasis> and <emphasis>Kirsten Friese</emphasis>. Joan gave you the program of the meeting. The appointment will start at <emphasis>12 noon</emphasis> and end at <emphasis>1 pm </emphasis>. The same appointment should be scheduled <emphasis>(recurred)</emphasis> each Monday. </para> <procedure> <step><para>Using the Date Navigator go to February 12, 2001.</para></step> <step><para>Click on <menuchoice> <guimenu>Actions</guimenu> <guimenuitem>New Event</guimenuitem> </menuchoice> </para></step> <step><para>Enter a suitable summary. It's important to choose the right brief description, because this is the only field that can be searched. We suggest that you enter <userinput>Product launch event</userinput>.</para></step> <step><para>Enter the detailed event program into the largest rectangle area. For the sake of this simple example, enter <userinput>Introduction, The Plan, Conclusion</userinput> on three separate lines.</para></step> <step><para>Check the <guilabel>Recurring event</guilabel> checkbox.</para></step> <step><para>Click on the <guilabel>Recurrence</guilabel> tab.</para> <note><para>Most work has been done for you automatically. &korganizer; defaults to recurring weekly. Also note that <guilabel>No ending date </guilabel> is chosen. This means that this event will be repeated each Monday (starting, of course, on Monday February 12, 2001) until the end of time (that is, until you delete it). </para></note></step> <step><para>Since everything is all right here, click on the <guilabel>Attendees</guilabel> tab.</para></step> <step><para>In the <guilabel>Attendees</guilabel> tab you should do the following:</para> <substeps> <step><para>In <guilabel>Attendee Name</guilabel> field, enter <userinput>Jack Smith</userinput>.</para></step> <step><para>Choose <guilabel>Organizer</guilabel> as the role, and change the <guilabel>Need Action</guilabel> item to <guilabel>Accepted</guilabel>. Uncheck the <guilabel>Request Response</guilabel> checkbox.</para></step> <step><para>Click <guibutton>Add</guibutton>.</para></step> <step><para>In <guilabel>Attendee Name</guilabel> field, enter <userinput>Joan Holden</userinput>. In <guilabel>Email Address</guilabel> field, enter <userinput>jholden@thiscompany.com</userinput>.</para></step> <step><para>Choose <emphasis>Owner</emphasis> as the role.</para></step> <step><para>Click <guilabel>Add</guilabel>.</para></step> <step><para>In <guilabel>Attendee Name</guilabel> field, enter <userinput>Peter Krzinski</userinput>. In <guilabel>Email Address</guilabel> field, enter <userinput>pkrzinski@thiscompany.com</userinput>.</para></step> <step><para>Click <guilabel>Add</guilabel>.</para></step> <step><para>In <guilabel>Attendee Name</guilabel> field, enter <userinput>Kirsten Friese</userinput>. In <guilabel>Email Address</guilabel> field, enter <userinput>kfriese@thiscompany.com</userinput>.</para></step> <step><para>Click <guilabel>Add</guilabel>.</para></step> </substeps> </step> <step><para>Click the <guilabel>Categories</guilabel> button.</para></step> <step><para>Choose <guilabel>Appointment</guilabel> in the Available Categories. Click the <guilabel>Add>></guilabel> button. Then click the <guibutton>OK</guibutton> button.</para></step> <step><para>Check the <guilabel>Reminder</guilabel> checkbox. Set the reminder time to 15 minutes—just long enough to brew a cup of tea prior to the meeting start.</para></step> <step><para>You'll be back in the main event entry window. Review the event setup by clicking on the <guilabel>General</guilabel>, <guilabel>Attendees</guilabel>, and <guilabel>Recurrence</guilabel> tabs. If you are satisfied, click <guibutton>OK</guibutton>.</para></step> </procedure> <para>Congratulations, you've scheduled your first event!</para> </sect1> </chapter> <chapter id="reference"> <title>Reference</title> <sect1 id="reference-windows"> <title>Windows</title> <para>This section contains description of the following windows:</para> <itemizedlist> <listitem><para><guilabel>Categories tab window</guilabel> that is part of both <link linkend="entering-data-events">Event</link> and <link linkend="entering-data-to-do">To-Do</link> entry window.</para></listitem> <listitem><para><guilabel>Attendees tab window</guilabel> that is part of both <link linkend="entering-data-events">Event</link> and <link linkend="entering-data-to-do">To-Do</link> entry window.</para></listitem> <listitem><para><guilabel>Configure toolbars window</guilabel> that is accessed by clicking <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure toolbars</guimenuitem></menuchoice> menu item.</para></listitem> <listitem><para><guilabel>Preferences window</guilabel> that is accessed by clicking <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure KOrganizer...</guimenuitem> </menuchoice> menu item.</para></listitem> </itemizedlist> <sect2 id="reference-windows-categories"> <title>Categories</title> <para>You can assign several categories to the task. Click on <guilabel>Categories</guilabel> button. Check the boxes to assign suitable categories to the task. You can also add a new category in the <guilabel>New Category</guilabel> field.</para> <tip><para>For instance your language lesson at work belongs to both Business and Education categories, while the anniversary of your marriage belongs to either Personal or Special Occasion - it's your choice.</para></tip> </sect2> <sect2 id="reference-windows-attendees"> <title>Attendees</title> <variablelist> <varlistentry> <term><guilabel>Attendee Name</guilabel> field</term> <listitem><para>Fill in the <guilabel>Attendee Name</guilabel> and <guilabel>Email address</guilabel> fields. To use your Address Book, see the <guibutton>Address Book...</guibutton> entry below.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Role</guilabel></term> <listitem><para>Choose the role of the attendee (Attendee, Organizer, Owner, Delegate) from the drop down menu. The role is a simple reminder of what part the attendee plays in this event. It can be used for sorting (see below). </para></listitem> </varlistentry> <varlistentry> <term><guilabel>Status</guilabel></term> <listitem><para>Choose the status of the attendee (Needs Action, Accepted, Sent, Tentative, Confirmed, Declined, Completed, Delegated). The status, which is displayed in the details list window gives you quick overview of what should be done to make the event successful. It can be used for sorting (see below).</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Request Response</guilabel></term> <listitem><para>Check the <guilabel>Request Response</guilabel> checkbox if this attendee should respond to your schedule plan. Consequently the attendee will be emailed with the event schedule information. A small envelope will appear in the details list to indicate this. This feature will be more useful when full group scheduling is implemented.</para></listitem> </varlistentry> <varlistentry> <term><guibutton>Add</guibutton></term> <listitem><para>Click on the <guibutton>Add</guibutton> button to add the attendee to the list.</para></listitem> </varlistentry> </variablelist> <para>Repeat the above procedure for all attendees.</para> <variablelist> <varlistentry> <term><guilabel>Address Book</guilabel></term> <listitem><para>If the attendee is in your Address Book, you do not have to remember his email address. Just click on the <guibutton>Address Book...</guibutton> button and choose the attendee from the list. Please note that this is the standard &kde; address book, which is also used by &kmail; and can also be called as a separate application (&kaddressbook;).</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Sorting</guilabel></term> <listitem><para>Please note that you can change the order of attendees. Click on any of the column headings (Name, Email, Role, Status, <acronym>RSVP</acronym>) to sort the list according to that column. </para></listitem> </varlistentry> <varlistentry> <term>Changing the Status</term> <listitem><para>As the attendees send you feedback (they confirm, decline, delegate the event), you will need to edit the status and perhaps other information. First select the attendee from the list (click on his/her line). Attendee name, email and other data will appear in the appropriate fields. Now edit the information and change the status as needed. When finished, click on the <guibutton>Modify</guibutton> button to save your changes.</para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="reference-windows-config-toolbars"> <title>Configure toolbars</title> <para>&korganizer; has two toolbars: a Main toolbar (with <guiicon>New</guiicon>, <guiicon>Open</guiicon>, <guiicon>Print</guiicon>, <guiicon>Cut</guiicon>, <guiicon>Copy</guiicon>, <guiicon>Paste</guiicon>, <guiicon>Goto Today</guiicon>, <guiicon>New Event</guiicon> and <guiicon>Mail Event</guiicon> icons, and with actions specific to &korganizer;, like <guiicon>Find</guiicon> and <guiicon>Print</guiicon> preview) and a <guiicon>View</guiicon> toolbar (for selecting between <guiicon>List view</guiicon>, <guiicon>Day view</guiicon>, <guiicon>Workday view</guiicon>, <guiicon>Week view</guiicon>, and <guiicon>Month view</guiicon>). You can customize these toolbars in various ways: you can add new icons, change the icon size, change toolbar position and add text description to the icons.</para> <para>There are two ways to change the position of the toolbars: <itemizedlist> <listitem><para> You can right click on the toolbar to bring up the <guimenu>Toolbar Menu </guimenu>. The style can also be adjusted from this menu. </para></listitem> <listitem><para> You can simply drag the toolbar by the handle on the left border of each toolbar, and drop it whenever you wish. Also look at other easy <link linkend="other-features-drag-and-drop">drag-and-drop operations</link>. </para></listitem></itemizedlist> </para> <para>The toolbars are configured in two places: <itemizedlist> <listitem><para>The graphic style is adjusted through the <guimenu>Toolbar Menu</guimenu>. Right click on the toolbar to access this menu. </para></listitem> <listitem><para>The tool set is configured in the <menuchoice><guimenu> Settings</guimenu><guimenuitem>Configure toolbars</guimenuitem></menuchoice> menu. </para></listitem></itemizedlist> </para> <sect3 id="config-toolbars-settings-config"> <title><menuchoice><guimenu>Settings</guimenu><guimenuitem> Configure toolbars</guimenuitem></menuchoice></title> <para>This dialog allows you to customize the selection of tools on the toolbar.</para> <sect4 id="config-toolbars-choose-toolbar"> <title>Choosing the toolbar</title> <para>First you need to choose the toolbar that you want to modify. All actions apply to the toolbar that is selected from the drop down menu at the top of the window. </para> </sect4> <sect4 id="config-toolbars-available-actions"> <title>Available actions</title> <para>There are two rectangles below the toolbar title: <guilabel>Available actions</guilabel> and <guilabel>Current actions</guilabel>. Using the left and right arrows (located between the rectangles) you can add icons from the Available actions group to the <guilabel>Current actions</guilabel> group. The toolbar will have every icon that is in the <guilabel>Current action</guilabel> rectangle. The up and down arrows allow you reposition an icon.</para> <tip><para>Remember that less icons may be better, because the screen is less cluttered and therefore looks cleaner. For instance if you always cut and paste with the keyboard hotkeys, you do not need the <guiicon>Cut</guiicon>, <guiicon>Copy</guiicon> and <guiicon>Paste</guiicon> icons.</para></tip> </sect4> </sect3> <sect3 id="config-toolbars-context-menu"> <title>Toolbar Menu</title> <para>This menu allows you to change the look of the toolbars. <mousebutton>Right</mousebutton> click on the toolbar to access this menu.</para> <sect4 id="config-toolbars-text-position"> <title>Text position</title> <para>Initially, icons do not have any text assigned. You may prefer having text under each icon, or text alongside each icon. You can also have plain texts without any icons.</para> </sect4> <sect4 id="config-toolbars-toolbar-position"> <title>Toolbar position</title> <para>You can have the toolbar at the top, bottom, left or right side. If you choose Floating position, the toolbar will be displayed outside the main &korganizer; panel and you can move it around. If you choose Flat, the toolbar will collapse into a tiny rectangle. You can later click on that rectangle and the toolbar will appear again.</para> </sect4> <sect4 id="config-toolbars-icon-size"> <title>Icon size</title> <para>You can change the size of the icons. Make your choice between small, medium and large icons.</para> </sect4> </sect3> </sect2> <sect2 id="reference-windows-preferences"> <title>Preferences</title> <para>The options dialog lets you configure a number of different areas of &korganizer;.</para> <sect3 id="preferences-personal"> <title>Personal</title> <para>The personal options relate to your personal identity, and other miscellaneous things that don't fall under any of the other general categories.</para> <variablelist> <varlistentry> <term><guilabel>Your Name</guilabel></term> <listitem><para><guilabel>Your Name</guilabel> is initially set to <quote>Anonymous</quote> with an email address of <quote>nobody@nowhere</quote>. You can change your name by directly entering it here or you can use your Email Settings from &kcontrol; (see below). This name will be displayed as <guilabel>Owner</guilabel> in To-Do tasks and Events.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Email address</guilabel></term> <listitem><para><guilabel>Email address</guilabel> will be used to identify the owner of the calendar. When another person opens your calendar or events, he/she will not be able to modify it because it will be read-only.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Use Email settings from Control Center</guilabel></term> <listitem><para>Check this to use your name and email address as set in &kcontrol; (<menuchoice><guimenuitem>Network</guimenuitem> <guimenuitem>E-mail</guimenuitem></menuchoice> in &kcontrol;)</para> </listitem> </varlistentry> <varlistentry> <term><guilabel>Send copy to owner when mailing events</guilabel></term> <listitem><para>When you check the <guilabel>Send copy to owner when mailing events</guilabel>, you will get a copy of all e-mail messages that &korganizer; sends at your request to the event attendees.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Holidays</guilabel></term> <listitem><para><guilabel>Holidays</guilabel> menu defines public holidays automatically according to the chosen country. In the Date Navigator, public holidays and weekends are displayed in red color.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Auto-save calendar</guilabel></term> <listitem><para>When <guilabel>Auto-save calendar</guilabel> is checked, calendar is saved automatically when you exit &korganizer;, without asking. Furthermore, the calendar is saved periodically as you work to prevent the loss of valuable data. You can also specify the save interval in minutes.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Confirm Deletes</guilabel></term> <listitem><para>When you check <guilabel>Confirm Deletes</guilabel>, &korganizer; will ask you to confirm each deletion. If this is not checked, &korganizer; will never ask before deleting events.</para></listitem> </varlistentry> </variablelist> <!-- Mail client selection--> <!-- Auto-start Alarm Daemon --> </sect3> <sect3 id="preferences-time-and-date"> <title>Time & Date</title> <variablelist> <varlistentry> <term><guilabel>Time Zone</guilabel></term> <!-- drop down --> <listitem><para><guilabel>Time Zone</guilabel> specifies your time zone in hours offset from <acronym>UTC</acronym> (<acronym>GMT</acronym>). For the US East Coast, that means -0500 when Daylight Savings are not in effect, and -0400 when they are. &korganizer; will automatically adjust for daylight savings. </para></listitem> </varlistentry> <varlistentry> <term><guilabel>Default Event Time</guilabel></term> <!--spin box--> <listitem><para>When you choose <link linkend="entering-data-events">New Event</link> from the <link linkend="actions-new-event">Action Menu</link>, or create an event in some other manner such that &korganizer; cannot guess when you would like your event to start, &korganizer; will put this hour in the start time editor as the default value.</para></listitem> </varlistentry> <varlistentry> <!--spin box--> <term><guilabel>Default duration time of a new appointment</guilabel></term> <listitem><para>When you choose <link linkend="entering-data-events">New Event</link> from the <link linkend="actions-new-event">Action Menu</link>, or create an event in some other manner such that &korganizer; cannot guess the duration of your event, &korganizer; will use this as the default value. </para></listitem> </varlistentry> <varlistentry> <term><guilabel>Default Alarm Time</guilabel></term> <listitem><para>In <guilabel>Default Alarm Time</guilabel> you decide how long before the actual event's scheduled time will alarm activate.</para></listitem> </varlistentry> <!--working hours--> </variablelist> </sect3> <sect3 id="preferences-fonts"> <title>Fonts</title> <itemizedlist> <listitem><para>Click the <guilabel>Time Bar Font</guilabel> button to choose Font, Font style and Size for the time bar.</para></listitem> <listitem><para>Click the <guilabel>Month</guilabel> button to choose Font, Font style and Size for the Month View.</para></listitem> <listitem><para>Click the <guilabel>Agenda</guilabel> button to choose Font, Font style and Size for the Day View, Week View and Work Week View.</para></listitem> </itemizedlist> </sect3> <sect3 id="preferences-colors"> <title>Colors</title> <para>Choose the color used for holidays, for highlighting, and for specific event categories. You can choose different color for each category. Of course too many colors may be confusing, so use common sense.</para> <para>You can also choose a default event color and agenda view background color.</para> </sect3> <sect3 id="preferences-views"> <title>Views</title> <variablelist> <varlistentry> <term><guilabel>Day Begins At</guilabel></term> <listitem><para><guilabel>Day Begins At</guilabel> is the hour that &korganizer; will display at the top. You can of course scroll to an earlier hour, but the <guilabel>Day Begins At</guilabel> should be the earliest time that you use for events. It could be the time when you usually get up, or the time when you start working.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Show events that recur daily in the Date Navigator</guilabel></term> <listitem><para>If the <guilabel>Show events that recur daily in Date Navigator</guilabel> checkbox is checked, the days containing daily recurring events are shown in bold typeface in the Date Navigator.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Show events that recur weekly in the Date Navigator</guilabel></term> <listitem><para>If the <guilabel>Show events that recur weekly in Date Navigator</guilabel> checkbox is checked, the days containing weekly recurring events are shown in bold typeface in the Date Navigator.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Enable ToolTips displaying summary</guilabel></term> <listitem><para>If your summary for an event is longer than would fit in the current View, the remaining characters are not displayed. Check <guilabel>Enable ToolTips displaying summary</guilabel> if you want the full summary displayed when the mouse pointer remains over the appointment for a few seconds.</para></listitem> </varlistentry> <!--Enable Scrollbars in Month View cells--> <!--Month view uses full window--> <!--Todo View uses full window--> </variablelist> </sect3> <sect3 id="preferences-printing"> <title>Printing</title> <para>The <guilabel>Preview Program</guilabel> field tells &korganizer; what program you want to use when you choose <guimenuitem>Print Preview</guimenuitem> from the <link linkend="file-print-preview">File Menu</link>. To be able to use the <link linkend="file-print-preview"><guimenuitem>Print preview...</guimenuitem></link> feature, you need a program that can accept printing output of &korganizer; and display it on the screen. Since &korganizer; uses the &PostScript; language to talk to your printer, you need a program that understands &PostScript; and that can show it on your screen. Historically, the best results have been achieved with <application>gv</application>, but &kde;-specific program &kghostview; is quite mature and therefore is the default. You may of course specify <application>gv</application> if you wish, or any other &PostScript;-to-screen software.</para> </sect3> <sect3 id="preferences-groupscheduling"> <title>Group Scheduling</title> <variablelist> <varlistentry> <term><guilabel>Scheduler mail client</guilabel></term> <listitem><para>This field tells &korganizer; what mail-clinet you want to use groupscheduling. <guilabel>Mail Client </guilabel> uses a real client you can choose in <link linkend="preferences-personal">personal preferences</link>. With <guilabel> Dummy</guilabel> groupsheduling is disabled.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Scheduler mails should be</guilabel></term> <listitem><para> Here you can choose if the event-messages should be cached in the outbox, or should be sent immediately. </para></listitem> </varlistentry> <varlistentry> <term><guilabel>Additional email addresses</guilabel></term> <listitem><para>This tells &korganizer; what further emailaddresses you have in addition to the one set in personal preferences <link linkend="preferences-personal">personal preferences</link>. This is needed, if you are an attenddee of one event, but have another emailaddress there. </para></listitem> </varlistentry> </variablelist> </sect3> </sect2> <sect2 id="reference-windows-outgoing"> <title>Outgoing Messages</title> <para>to be written</para> </sect2> <sect2 id="reference-windows-incoming"> <title>Incoming Messages</title> <para>to be written</para> </sect2> </sect1> <!-- end 2.2.0 modifications --> <sect1 id="reference-menus"> <title>Menus</title> <para>When &korganizer; starts, the main &korganizer; window appears. The window has several components: a menubar, a toolbar, a month calendar, a main panel with the current <quote>view</quote> of events, and a tasklist. The calendar initially displays today's date.</para> <para>The menus provide access to all the common operations that can be performed with the calendar, including saving, loading, adding and deleting events, printing and other operations.</para> <sect2 id="reference-menus-file"> <title><guimenu>File</guimenu></title> <para>The <guimenu>File</guimenu> menu provides access to functions involving the entire calendar.</para> <variablelist> <varlistentry id="file-new"> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo> </shortcut> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_file_new.png" format="PNG"/></imageobject></inlinemediaobject> File</guimenu> <guimenuitem>New</guimenuitem></menuchoice></term> <listitem> <para><action>Opens another main window.</action> This window initially contains unnamed calendar. You can use the new window to:</para> <itemizedlist> <listitem><para>open the same calendar twice (click on <menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice> and choose the same calendar as in the original window)</para></listitem> <listitem><para>have two different calendars open at the same time (click on <menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice> and choose a different calendar). </para></listitem> <listitem><para>create a new calendar (click on <menuchoice><guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice> to give your new calendar a filename and to save it).</para></listitem> </itemizedlist> </listitem> </varlistentry> <varlistentry id="file-open"> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo> </shortcut> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_file_open.png" format="PNG"/></imageobject></inlinemediaobject> File</guimenu> <guimenuitem>Open</guimenuitem></menuchoice></term> <listitem><para><action>Opens a file dialog allowing you to select a new vCalendar to load.</action> If you have made changes to the current calendar, you will be given the option of saving them before loading a new one.</para></listitem> </varlistentry> <varlistentry id="file-open-recent"> <term><menuchoice> <guimenu>File</guimenu> <guimenuitem>Open Recent</guimenuitem> </menuchoice></term> <listitem><para><guimenuitem>Open Recent</guimenuitem> <action>provides a list of recently opened calendars for quick access, allowing you to bypass the file dialog entirely.</action></para></listitem> </varlistentry> <varlistentry id="file-save"> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo> </shortcut> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_file_save.png" format="PNG"/></imageobject></inlinemediaobject> File</guimenu> <guimenuitem>Save</guimenuitem></menuchoice></term> <listitem><para>When you choose <guimenuitem>Save</guimenuitem> or click the <guiicon>Save</guiicon> icon, &korganizer; <action>saves the calendar to disk, and makes sure all changes that you made will be remembered</action>. If the calendar has no name, Save will behave like <guilabel>Save As</guilabel>.</para></listitem> </varlistentry> <varlistentry id="file-save-as"> <term><menuchoice> <guimenu>File</guimenu> <guimenuitem>Save As...</guimenuitem> </menuchoice></term> <listitem><para><guilabel>Save As</guilabel> <action>displays a file dialog in which you may choose a different name for your calendar than the one currently assigned to it</action>. This is useful if you have made changes to a calendar that you want to save, but also want to keep separate from your <quote>regular</quote> calendar.</para></listitem> </varlistentry> <varlistentry id="file-close"> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo> </shortcut> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_file_close.png" format="PNG"/></imageobject></inlinemediaobject> File</guimenu> <guimenuitem>Close</guimenuitem></menuchoice></term> <listitem><para><action>Closes the current calendar. The window itself will remain open, and may be reused to open another calendar.</action></para></listitem> </varlistentry> <varlistentry id="file-print"> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo> </shortcut> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_file_print.png" format="PNG"/></imageobject></inlinemediaobject> File</guimenu> <guimenuitem>Print</guimenuitem></menuchoice></term> <listitem><para>Choose <guimenuitem>Print</guimenuitem> or click the <guilabel>Print</guilabel> icon to <action>print the current calendar</action>. You can specify the range of dates to be printed (either manually or with Calendar Widget) and the View Type (Day, Week, Month or To-Do).</para></listitem> </varlistentry> <varlistentry id="file-print-preview"> <term><menuchoice> <guimenu><inlinemediaobject><imageobject> <imagedata fileref="i_file_print_preview.png" format="PNG"/></imageobject></inlinemediaobject> File</guimenu><guimenuitem>Print Preview</guimenuitem></menuchoice></term> <listitem><para>If you choose <guimenuitem>Print Preview</guimenuitem> or click the <guiicon>Print Preview</guiicon> icon, <action>the current calendar will be printed on your screen, instead of on your printer</action>. Use this feature to check if the printout will be correct before you start printing.</para> <para>You can specify the range of dates to be printed (either manually or with Calendar Widget) and the View Type (Day, Week, Month or To-Do).</para> <para>You can choose the program that you use to preview output in the <link linkend="preferences-printing">Printing Preferences</link> dialog.</para></listitem> </varlistentry> <varlistentry id="file-print-setup"> <term><menuchoice> <guimenu>File</guimenu> <guimenuitem>Print Setup</guimenuitem> </menuchoice></term> <listitem><para><guilabel>Print Setup</guilabel> <action>brings up the print setup dialog</action>. You can set up the look of your printed output. See the section on <link linkend="preferences-printing">Printing Preferences</link> for more information.</para></listitem> </varlistentry> <varlistentry id="file-import-ical"> <term><menuchoice> <guimenu>File</guimenu> <guimenuitem>Import From Ical</guimenuitem> </menuchoice></term> <listitem><para>If you have used <application>ical</application>, a popular but older calendar program for &UNIX;, you may wish to <action>import your events, events, and to-do items</action> directly to &korganizer;. This action will read the <filename>.calendar</filename> file from your home directory and merge any entries it contains into your current calendar. If any errors or suspicious things occur during the process, you will be notified via a message box.</para></listitem> </varlistentry> <varlistentry id="file-merge"> <term><menuchoice> <guimenu>File</guimenu> <guimenuitem>Merge</guimenuitem> </menuchoice></term> <listitem><para><guilabel>Merge Calendar:</guilabel> If you have a different vCalendar file somewhere, and you would like to <action>include its contents into your own calendar</action>, choose this option. A good time to do this would be if you received a vCalendar with a few entries via e-mail, for instance.</para></listitem> </varlistentry> <varlistentry id="file-archive-old"> <term><menuchoice> <guimenu>File</guimenu> <guimenuitem>Archive Old Entries</guimenuitem> </menuchoice></term> <listitem><para><action>From time to time you should delete your old events.</action></para> <tip><para>Contemporary computers have ample storage space. However, if you synchronize your &korganizer; calendar with a limited-memory machine like the Palm device, you will find archiving useful. The performance of &korganizer; can also become worse when there are many events.</para></tip> <procedure> <step><para>Click the <guilabel>Archive Old Entries</guilabel>.</para></step> <step><para>Fill in the date in <guilabel>Events older than</guilabel> field or use the Calendar Widget to choose the date. </para></step> <step><para>If you have chosen archiving, you must also provide a filename for the archive in the <guilabel>Archive File</guilabel> field. If you want to re-use an older archive file, click on the <guilabel>Browse</guilabel> button and find an existing archive. It will be overwritten, therefore make sure that you do not need the original data or that you have a backup copy.</para></step> </procedure></listitem> </varlistentry> <varlistentry id="file-export-as-web"> <term><menuchoice> <guimenu>File</guimenu> <guimenuitem>Export as web page...</guimenuitem> </menuchoice></term> <listitem><para><action>You can export your calendar or a part of it as a HTML file, suitable for publishing on the World Wide Web.</action></para> <procedure> <step><para>Click the <guilabel>Export as web page...</guilabel>.You will get a window with three tabs: <guilabel>General</guilabel>, <guilabel>Event</guilabel>, and <guilabel>To-Do</guilabel>.</para></step> <step><para><guilabel>General</guilabel> tab:</para> <substeps> <step><para>Specify the date range that you want published. Enter dates manually or use the Calendar Widget.</para></step> <step><para>Choose the View type: <guilabel>Event List</guilabel>, <guilabel>To-Do List</guilabel> or <guilabel>Both</guilabel>.</para></step> <step><para>Specify the web output file in the <guilabel>Output file</guilabel> field. If you want to overwrite an existing web file, click on the <guibutton>Browse</guibutton> button to find it.</para></step> <step><para>Specify if you want to include categories and attendees in the exported web page.</para></step> </substeps></step> <step><para><guilabel>To-Do</guilabel> tab: specify if you want to list Due Dates, Categories, and Attendees.</para></step> </procedure></listitem> </varlistentry> <varlistentry id="file-make-active"> <term><menuchoice> <guimenu>File</guimenu> <guimenuitem>Make active</guimenuitem> </menuchoice></term> <listitem><para>If you opened more than one calendar, only one calendar can display alarms; only one calendar can be active. Click on the <guilabel>Make active</guilabel> menu item to <action>activate the current calendar window.</action></para> <para>The active calendar is loaded as default calendar when starting &korganizer;. In other words, if you work with more than one calendar, you should make your main calendar active.</para></listitem> </varlistentry> <varlistentry id="file-quit"> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </shortcut> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_file_quit.png"/></imageobject></inlinemediaobject> File</guimenu> <guimenuitem>Quit</guimenuitem> </menuchoice></term> <listitem><para>When you choose <guimenuitem>Quit</guimenuitem> or click the <guiicon>Quit</guiicon> icon, <action>the current calendar window will quit, prompting you to save if the current calendar has been modified but not yet saved.</action></para> <para>This has no effect on other calendar windows which may be opened. You have to quit each calendar window individually.</para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="reference-menus-edit"> <title>Edit</title> <para>With the <guilabel>Edit</guilabel> menu you can edit and search events and To-Do entries.</para> <para><guimenuitem>Cut</guimenuitem>, <guimenuitem>Copy</guimenuitem>, and <guimenuitem>Paste</guimenuitem> menu items behave in the same fashion as in other KDE applications. With the <guimenuitem>Find</guimenuitem> menu item you can find event and to-do entries across the current calendar.</para> <variablelist> <varlistentry id="edit-cut"> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo> </shortcut> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_cut.png" format="PNG"/></imageobject></inlinemediaobject> Edit</guimenu> <guimenuitem>Cut</guimenuitem> </menuchoice></term> <listitem><para><action>Cuts the currently selected event(s) to the clipboard, removing them from your calendar.</action></para></listitem> </varlistentry> <varlistentry id="edit-copy"> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> </shortcut> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_copy.png" format="PNG"/></imageobject></inlinemediaobject> Edit</guimenu> <guimenuitem>Copy</guimenuitem></menuchoice></term> <listitem><para><action>Copies the currently selected event(s) to the clipboard, leaving them untouched in your calendar.</action></para></listitem> </varlistentry> <varlistentry id="edit-paste"> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo> </shortcut> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_paste.png" format="PNG"/></imageobject></inlinemediaobject> Edit</guimenu> <guimenuitem>Paste</guimenuitem></menuchoice></term> <listitem><para><guimenuitem>Paste</guimenuitem> <action>inserts the contents of the clipboard into your calendar</action>. The clipboard must contain a valid vCalendar, provided either by a previous Cut/Copy operation or from a selection made outside of &korganizer;. You will be warned if the contents of the clipboard cannot be understood.</para> <tip><para>However, you can safely use <keycombo action="simul">&Ctrl; <keycap>C</keycap></keycombo> and <keycombo action="simul">&Ctrl; <keycap>V</keycap></keycombo> hotkeys to copy text data from any outside application to a &korganizer; Edit Event window and vice versa. </para></tip></listitem> </varlistentry> <varlistentry id="edit-find"> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>f</keycap></keycombo> </shortcut> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_edit_find.png" format="PNG"/></imageobject></inlinemediaobject> Edit</guimenu> <guimenuitem>Find</guimenuitem> </menuchoice></term> <listitem><para>Choose <guimenuitem>Find</guimenuitem> from the <guimenu>Edit</guimenu> or click the <guiicon>Find</guiicon> icon to <action>find an event according to it's summary description</action>. The Find will only search in the summary field.</para> <tip><para>You can use wildcards if you do not remember the exact summary. If you don't know single character of the summary, put <userinput>?</userinput> instead of the missing character. If you don't know more characters, use <userinput>*</userinput>. For instance if you know that the summary has <emphasis>work</emphasis> in the middle, you would write <userinput>*work*</userinput> in the Find dialog. &korganizer; will locate summary entries like <quote>Must go to work</quote>, <quote>Wine workshop</quote> and similar. Letter case is ignored.</para></tip> <para>The result of the Find operation is a list of events with the specified summary description. The columns shown in the list are the same as the <link linkend="view-list-view">List View</link> columns.</para> <para>This resulting list is active. You can double-click on a line to display or edit the event details. Get more information about these details in the <link linkend="entering-data-events">Entering events</link> and <link linkend="entering-data-to-do">Entering To-Do's</link> sections.</para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="reference-menus-view"> <title><guimenu>View</guimenu></title> <para>There are several different <quote>views</quote> available for displaying your list of events, including a <quote>list</quote> view, a <quote>day</quote> view, a <quote>week</quote> view, and a <quote>month</quote> view. &korganizer; is smart enough to remember in between sessions what the last active view was, and the next time it is started, it will display that view.</para> <para>In general, each view will provide a way of displaying your events and events constrained to a particular time period or style of display. Click on any event to select it for further action. <mousebutton>Right</mousebutton> click an appointment to bring up a menu with options such as <guimenuitem>edit</guimenuitem>, <guimenuitem>delete</guimenuitem>, and so on. You can also use the <guimenu>Action</guimenu> menu to perform similar operations.</para> <variablelist> <varlistentry id="view-list-view"> <term><menuchoice> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_view_list.png" format="PNG"/></imageobject></inlinemediaobject> View</guimenu><guimenuitem>List</guimenuitem></menuchoice></term> <listitem><para><action>Switch the display to the List view.</action></para> <para>This view displays all your events for the day as a list. Events are displayed one per line. The first column of the appointment will have a bell icon displayed in it if an alarm is set for the appointment. The second column will display a chasing-arrows icon if the appointment repeats multiple times. Holding the mouse over the arrows icon will bring up a tool tip with more detailed recurrence information. The third column displays start and end time information, and the fourth column gives a summary of the appointment.</para> <para>The list view is good for displaying many events on a single day in a compact fashion. It is also useful if your events are spread out over a long time period that would not be displayed completely on the screen when using one of the other views.</para></listitem> </varlistentry> <varlistentry id="view-day-view"> <term><menuchoice> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_view_day.png" format="PNG"/></imageobject></inlinemediaobject> View</guimenu><guimenuitem>Day</guimenuitem></menuchoice></term> <listitem><para><action>Switch the display to the Day view.</action></para> <para>This view presents your event for a single day, sorted chronologically. You can also see the length of each event. Time is indicated on the left side of the view. A scrollbar on the right is provided when the whole day cannot be displayed on a single screen (which is the usual case). Each rectangle in the view represents an individual appointment, and displays the appointment's start and end time and summary. A <guiicon>bell</guiicon> icon is displayed if an alarm is set for the appointment. A <guiicon>chasing-arrows</guiicon> icon is displayed if the appointment repeats multiple times. Holding the mouse over the arrows icon will bring up a tool tip with more detailed recurrence information</para> <para>Since the Day View cannot contain the whole day on most screens, you can scroll up and down to see the whole day. However there is a useful hint that tells you if there is any currently invisible event above or below your current position; it is a small down-pointing or up-pointing arrow at the bottom, respectively at the top of the main panel.</para> <para>Any event can be resized with your mouse. Simply move the mouse pointer near the top or bottom edge of the event, and drag the edge up or down. This way you can visually modify the starting and ending time of your event. This also works in the Week and Work Week views. In other words, it is possible to change start and end times with the mouse by just moving the upper or lower border of the event to the new time.</para> <para>Any event can be rescheduled with your mouse. Move the mouse pointer over the event, and drag it to a new time location. This also works in the Week and Work Week views.</para> <para> Events can be moved to other, presently non-visible dates. Move the mouse pointer over the event, and drag it to the Date Navigator on the left side.</para> <tip><para>There is a useful shortcut for adding events: double-click on any open region of time, and &korganizer; will automatically create an event with default duration (which is customizable in the preferences dialog). You can immediately edit the description. The events <quote>snap</quote> to half-hour increments, rounding off to the closest half hour from where you clicked.</para></tip> </listitem> </varlistentry> <varlistentry id="view-workweek-view"> <term><menuchoice> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_view_work_week.png" format="PNG"/></imageobject></inlinemediaobject> View</guimenu><guimenuitem>Work Week</guimenuitem></menuchoice></term> <listitem><para><action>Switch the display to the Work Week view.</action></para> <para>This is the same as the week view, except only the working days of the week are shown.</para></listitem> </varlistentry> <varlistentry id="view-week-view"> <term><menuchoice> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_view_week.png" format="PNG"/></imageobject></inlinemediaobject> View</guimenu> <guimenuitem>Week</guimenuitem></menuchoice></term> <listitem><para><action>Switch the display to the Week view.</action></para> <para>The week view provides a view similar to the day view. Events for seven days are shown next to each other. All of the functions available for the day view are available in the week view, too. See the <link linkend="view-day-view">Day View section</link> for further information.</para></listitem> </varlistentry> <varlistentry id="view-month-view"> <term><menuchoice> <guimenu> View</guimenu> <guimenuitem>Month</guimenuitem> </menuchoice></term> <listitem><para><action>Switch the display to the Month view.</action></para> <para>The month view shows all the events for the current month in a familar calendar layout. Each day contains all of the events that can fit in the area provided (maximizing the window will enable you to see more appointments). Information on repeating and alarm status is indicated through <guiicon>bell</guiicon> and <guiicon>chasing arrows</guiicon> icons, just like in other views.</para> <para>You can navigate inside the month view using a set of buttons along the right side of the screen. By pressing the appropriate upwards-facing button, you can navigate to the past by week, month, or even year. The downwards-facing buttons will navigate to the future.</para></listitem> </varlistentry> <varlistentry id="view-todo-view"> <term><menuchoice> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_view_todo_list.png" format="PNG"/></imageobject></inlinemediaobject> View</guimenu> <guimenuitem>To-do list</guimenuitem></menuchoice></term> <listitem><para><action>Switch the display to the To-Do view.</action></para> <para>The To-Do list provides a place for you to jot down quick (or long-term) notes to yourself about things that you need to do. The to-do list always appears right below the Date Navigator. You can also display it in the main panel if you click on the <guilabel>To-Do View</guilabel> icon or if you choose <menuchoice><guimenu>View</guimenu><guimenuitem>To-Do list</guimenuitem></menuchoice>.</para> <para>You can give your to-do task a <quote>date due</quote>, in other words a date when the to-do should be finished. </para> <para>You can also assign priorities to to-do events, and they will appear sorted in order of priority. The lower the number, the higher the priority, except that zero (0) is defined as <quote>no priority.</quote></para> <para>To make a new to-do entry, right click in the to-do box. You will get a menu with the option to create a new entry. If you clicked on an already existing to-do, you will get more choices: you can Show the summary, Edit the task details, Delete the task altogether, or you can create a sub-todo. You could for example make a large to-do task like building a house, and make sub-tasks like choosing the right building site, hiring an architect, hiring workers and finally arranging a party for your friends.</para> <para>When you choose <guilabel>New Todo</guilabel>, a new to-do will be created and you will be able to enter all neccessary <link linkend="entering-data-to-do">information</link>.</para> <para>Click on any to-do task in the list to highlight it. If you click on the thick-line box on the left of the task description, you will change the <quote>completed</quote> status of the task. If you double-click the task description, you will be able to edit all the details of this to-do task.</para> <para>You may also pick <guilabel>Purge Completed</guilabel> from the <mousebutton>right</mousebutton> mouse button menu to delete all to-do entries that you have marked completed. This is handy for quick cleanup.</para> <para>To-do tasks can also dragged around with the mouse to rearrange the hierarchy or to exchange to-do tasks with other calendar windows. You can also read an <link linkend="other-features-drag-and-drop">overview</link> of all available drag-and-drop operations.</para></listitem> </varlistentry> <varlistentry id="view-update"> <term><menuchoice> <guimenu>View</guimenu> <guimenuitem>Update</guimenuitem> </menuchoice></term> <listitem><para> <action>Updates or refreshes the currently displayed view.</action> </para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="reference-menus-go"> <title><guimenu>Go</guimenu></title> <variablelist> <varlistentry id="go-previous-day"> <term><menuchoice> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_go_backward.png" format="PNG"/></imageobject></inlinemediaobject> Go</guimenu><guimenuitem>Previous Day</guimenuitem></menuchoice></term> <listitem><para><action>Go to the previous day.</action></para></listitem> </varlistentry> <varlistentry id="go-next-day"> <term><menuchoice> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_go_forward.png" format="PNG"/></imageobject></inlinemediaobject> Go</guimenu><guimenuitem>Next Day</guimenuitem></menuchoice></term> <listitem><para><action>Go to the next day.</action></para></listitem> </varlistentry> <varlistentry id="go-goto-today"> <term><menuchoice> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_go_to_today.png" format="PNG"/></imageobject></inlinemediaobject> Go</guimenu><guimenuitem>Go to Today</guimenuitem></menuchoice></term> <listitem><para><action>Go to today.</action></para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="reference-menus-actions"> <title><guimenu>Actions</guimenu></title> <variablelist> <varlistentry id="actions-new-event"> <term><menuchoice> <guimenu>Actions</guimenu> <guimenuitem>New Event</guimenuitem> </menuchoice></term> <listitem><para>Choose <guilabel>New Event</guilabel> to <action>start writing a new event</action>. Initially the appointment window will have current time and date.</para> <para>Read detailed description of the event window in <link linkend="entering-data-events">Entering Events</link> section.</para></listitem> </varlistentry> <varlistentry id="actions-new-todo"> <term><menuchoice> <guimenu>Actions</guimenu> <guimenuitem>New To-do</guimenuitem> </menuchoice></term> <listitem><para>Choose <guilabel>New To-Do</guilabel> to <action>start writing a new To-Do task</action>. Initially the task has no Due date, but you can specify one.</para> <para>Read detailed description of the event window in <link linkend="entering-data-events">Entering Events</link> section.</para> <para>To-Do screen is quite similar to the event screen, except there is no recurrence tab window. To-Do tasks are supposed to be one-time only.</para></listitem> </varlistentry> <varlistentry id="actions-delete-event"> <term><menuchoice> <guimenu>Actions</guimenu> <guimenuitem>Delete Event</guimenuitem> </menuchoice></term> <listitem><para>Choose <guilabel>Delete Event</guilabel> to <action>remove the currently selected event or To-Do task.</action> You will be asked for confirmation.</para> <para>However, if the <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Preferences</guimenuitem> <guimenuitem>Personal</guimenuitem><guimenuitem>Confirm Deletes</guimenuitem></menuchoice> checkbox is <emphasis>not</emphasis> checked, you will not be prompted for confirmation, and the event will be deleted immediately.</para></listitem> </varlistentry> <varlistentry id="actions-mail-event"> <term><menuchoice> <guimenu>Actions</guimenu> <guimenuitem>Mail Event</guimenuitem> </menuchoice></term> <listitem><para>Choose <guilabel>Mail Event</guilabel> to <action>mail the currently selected event to it's attendees.</action></para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="reference-menus-schedule"> <title><guimenu>Schedule</guimenu></title> <variablelist> <varlistentry id="schedule-outgoing"> <term><menuchoice> <guimenu>Schedule</guimenu> <guimenuitem>Outgoing Messages...</guimenuitem> </menuchoice></term> <listitem><para>Open the outbox-dialog.</para></listitem> </varlistentry> <varlistentry id="schedule-incoming"> <term><menuchoice> <guimenu>Schedule</guimenu> <guimenuitem>Incoming Messages...</guimenuitem> </menuchoice></term> <listitem><para>Open the inbox-dialog.</para></listitem> </varlistentry> <varlistentry id="schedule-publish"> <term><menuchoice> <guimenu>Schedule</guimenu> <guimenuitem>Publish</guimenuitem> </menuchoice></term> <listitem><para>Publish an event.</para></listitem> </varlistentry> <varlistentry id="schedule-request"> <term><menuchoice> <guimenu>Schedule</guimenu> <guimenuitem>Request</guimenuitem> </menuchoice></term> <listitem><para>Send the marked event as a group-event to the attendees.</para> </listitem> </varlistentry> <varlistentry id="schedule-refresh"> <term><menuchoice> <guimenu>Schedule</guimenu> <guimenuitem>Refresh</guimenuitem> </menuchoice></term> <listitem><para>Get the latest version of the active event from the event's organizer.</para></listitem> </varlistentry> <varlistentry id="schedule-cancel"> <term><menuchoice> <guimenu>Schedule</guimenu> <guimenuitem>Cancel</guimenuitem> </menuchoice></term> <listitem><para>Cancel the groupscheduling-event.</para></listitem> </varlistentry> <varlistentry id="schedule-reply"> <term><menuchoice> <guimenu>Schedule</guimenu> <guimenuitem>Reply</guimenuitem> </menuchoice></term> <listitem><para>Answer to an event-request.</para></listitem> </varlistentry> <varlistentry id="schedule-counter"> <term><menuchoice> <guimenu>Schedule</guimenu> <guimenuitem>Counter</guimenuitem> </menuchoice></term> <listitem><para>Answer to an event-request an make a proposal for new date/time. </para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="reference-menus-settings"> <title><guimenu>Settings</guimenu></title> <variablelist> <varlistentry id="settings-show-toolbar"> <term><menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Show Toolbar</guimenuitem> </menuchoice></term> <listitem><para><action>Click on this to enable or disable the toolbar.</action></para></listitem> </varlistentry> <varlistentry id="settings-configure-toolbars"> <term><menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Configure Toolbars...</guimenuitem> </menuchoice></term> <listitem><para>Click on this to display the <link linkend="reference-windows-config-toolbars">Toolbar Configuration Window</link>.</para></listitem> </varlistentry> <varlistentry id="settings-preferences"> <term><menuchoice> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_settings_prefs.png" format="PNG"/></imageobject></inlinemediaobject> Settings</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice></term> <listitem><para>Choose <menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Preferences</guimenuitem> </menuchoice> or click the <guiicon>Preferences</guiicon> icon to display <link linkend="reference-windows-preferences">Preferences window</link>.</para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="reference-menus-help"> <title><guimenu>Help</guimenu></title> &help.menu.documentation; </sect2> </sect1> <sect1 id="reference-hotkey"> <title>HotKeys</title> <para>This is a reference to all hotkeys and their corresponding description in the handbook.</para> <sect2 id="reference-hotkey-sortalpha"> <title>Hotkeys sorted alphabetically</title> <informaltable> <tgroup cols="2"> <colspec colname="hotkey"/> <colspec colname="desc"/> <thead> <row> <entry>Hotkey</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry><keycombo action="simul">&Ctrl; <keycap>C</keycap> </keycombo></entry> <entry><link linkend="edit-copy"><menuchoice><guimenu>Edit</guimenu> <guimenuitem>Copy</guimenuitem></menuchoice></link> equivalent; copy the selection to clipboard.</entry> </row> <row> <entry><keycombo action="simul">&Ctrl; <keycap>F</keycap></keycombo></entry> <entry><link linkend="edit-find"><menuchoice><guimenu>Edit</guimenu> <guimenuitem>Find</guimenuitem></menuchoice></link> equivalent; Find data in current calendar.</entry> </row> <row> <entry><keycap>F1</keycap></entry> <entry><menuchoice><guimenu>Help</guimenu> <guimenuitem>Contents</guimenuitem></menuchoice> equivalent; help for &korganizer;.</entry> </row> <row> <entry><keycombo action="simul">&Ctrl; <keycap>N</keycap></keycombo></entry> <entry><link linkend="file-new"><menuchoice><guimenu>File</guimenu> <guimenuitem>New</guimenuitem></menuchoice></link> equivalent; create and open new calendar.</entry> </row> <row> <entry><keycombo action="simul">&Ctrl; <keycap>O</keycap></keycombo></entry> <entry><link linkend="file-open"><menuchoice><guimenu>File</guimenu> <guimenuitem>Open</guimenuitem></menuchoice></link> equivalent; open a calendar file in the current window.</entry> </row> <row> <entry><keycombo action="simul">&Ctrl; <keycap>P</keycap></keycombo></entry> <entry><link linkend="file-print"><menuchoice><guimenu>File</guimenu> <guimenuitem>Print</guimenuitem></menuchoice></link> equivalent; print current calendar.</entry> </row> <row> <entry><keycombo action="simul">&Ctrl; <keycap>Q</keycap></keycombo></entry> <entry><link linkend="file-quit"><menuchoice><guimenu>File</guimenu> <guimenuitem>Quit</guimenuitem></menuchoice></link> equivalent; quit current calendar. </entry> </row> <row> <entry><keycombo action="simul">&Ctrl; <keycap>S</keycap></keycombo></entry> <entry><link linkend="file-save"><menuchoice><guimenu>File</guimenu> <guimenuitem>Save</guimenuitem></menuchoice></link> equivalent; save current calendar.</entry> </row> <row> <entry><keycombo action="simul">&Ctrl; <keycap>V</keycap></keycombo></entry> <entry><link linkend="edit-paste"><menuchoice><guimenu>Edit</guimenu> <guimenuitem>Paste</guimenuitem></menuchoice></link> equivalent; paste data from clipboard.</entry> </row> <row> <entry><keycombo action="simul">&Ctrl; <keycap>W</keycap></keycombo></entry> <entry><link linkend="file-close"><menuchoice><guimenu>File</guimenu> <guimenuitem>Close</guimenuitem></menuchoice></link> equivalent; close current calendar.</entry> </row> <row> <entry><keycombo action="simul">&Ctrl; <keycap>X</keycap></keycombo></entry> <entry><link linkend="edit-cut"><menuchoice><guimenu>Edit</guimenu> <guimenuitem>Cut</guimenuitem></menuchoice></link> equivalent; cut the selection to the clipboard.</entry> </row> </tbody> </tgroup> </informaltable> </sect2> <sect2 id="reference-hotkey-sortbyfunc"> <title>Hotkeys sorted by function</title> <informaltable> <tgroup cols="2"> <colspec colname="desc"/> <colspec colname="hotkey"/> <thead> <row> <entry>Description</entry> <entry>Hotkey</entry> </row> </thead> <tbody> <row> <entry><emphasis>Close:</emphasis> <link linkend="file-close"> <menuchoice> <guimenu>File</guimenu> <guimenuitem>Close</guimenuitem></menuchoice></link> equivalent; close current calendar.</entry> <entry><keycombo action="simul">&Ctrl; <keycap>W</keycap></keycombo></entry> </row> <row> <entry><emphasis>Copy:</emphasis> <link linkend="edit-copy"> <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Copy</guimenuitem></menuchoice> </link> equivalent; copy the selection to clipboard.</entry> <entry><keycombo action="simul">&Ctrl; <keycap>C</keycap></keycombo></entry> </row> <row> <entry><emphasis>Cut:</emphasis> <link linkend="edit-cut"> <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Cut</guimenuitem></menuchoice> </link> equivalent; cut the selection to the clipboard.</entry> <entry><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></entry> </row> <row> <entry><emphasis>Find:</emphasis> <link linkend="edit-find"> <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Find</guimenuitem></menuchoice></link> equivalent; Find data in current calendar.</entry> <entry><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></entry> </row> <row> <entry><emphasis>Help:</emphasis> <menuchoice> <guimenu>Help</guimenu> <guimenuitem>Contents</guimenuitem></menuchoice> equivalent; help for &korganizer;.</entry> <entry><keycap>F1</keycap></entry> </row> <row> <entry><emphasis>New:</emphasis> <link linkend="file-new"> <menuchoice> <guimenu>File</guimenu> <guimenuitem>New</guimenuitem></menuchoice></link> equivalent; create and open new calendar.</entry> <entry><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></entry> </row> <row> <entry><emphasis>Open:</emphasis> <link linkend="file-open"> <menuchoice> <guimenu>File</guimenu> <guimenuitem>Open</guimenuitem></menuchoice></link> equivalent; open a calendar file in the current window.</entry> <entry><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></entry> </row> <row> <entry><emphasis>Paste:</emphasis> <link linkend="edit-paste"> <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Paste</guimenuitem></menuchoice></link> equivalent; paste data from clipboard.</entry> <entry><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></entry> </row> <row> <entry><emphasis>Print:</emphasis> <link linkend="file-print"> <menuchoice> <guimenu>File</guimenu> <guimenuitem>Print</guimenuitem> </menuchoice> </link> equivalent; print current calendar.</entry> <entry><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></entry> </row> <row> <entry><emphasis>Quit:</emphasis> <link linkend="file-quit"> <menuchoice> <guimenu>File</guimenu> <guimenuitem>Quit</guimenuitem></menuchoice></link> equivalent; quit current calendar. </entry> <entry><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></entry> </row> <row> <entry><emphasis>Save:</emphasis> <link linkend="file-save"> <menuchoice> <guimenu>File</guimenu> <guimenuitem>Save</guimenuitem></menuchoice></link> equivalent; save current calendar.</entry> <entry><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></entry> </row> </tbody> </tgroup> </informaltable> </sect2> </sect1> <sect1 id="reference-action-buttons"> <title>Action Buttons</title> <para>Many windows contain buttons <guibutton>Default</guibutton>, <guibutton>Delete</guibutton>, <guibutton>OK</guibutton>, <guibutton>Apply</guibutton>, and <guibutton>Cancel</guibutton>. With these buttons you will decide whether the data that you entered into the window will be saved or forgotten.</para> <variablelist> <varlistentry> <term><guibutton>Default</guibutton></term> <listitem><para>If you click the <guibutton>Default</guibutton> button, changes you have made will be forgotten, and all choices will be returned to their default values.</para></listitem> </varlistentry> <varlistentry> <term><guibutton>Delete</guibutton></term> <listitem><para>Click on <guibutton>Delete</guibutton> to completely remove the event or event that you are editing from the calendar.</para></listitem> </varlistentry> <varlistentry> <term><guibutton>OK</guibutton></term> <listitem><para>When you click the <guibutton>OK</guibutton> button, your changes will be remembered and &korganizer; will close the window.</para></listitem> </varlistentry> <varlistentry> <term><guibutton>Apply</guibutton></term> <listitem><para>When you click the <guibutton>Apply</guibutton> button, your changes will be remembered, and the window will remain onscreen for further editing.</para></listitem> </varlistentry> <varlistentry> <term><guibutton>Cancel</guibutton></term> <listitem><para>If you click the <guibutton>Cancel</guibutton> button, your editing will be forgotten, and &korganizer; will close the window.</para></listitem> </varlistentry> </variablelist> </sect1> <sect1 id="vcalendar-format"> <title>vCalendar Format</title> <para>&korganizer; is the first free <abbrev>PIM</abbrev> for &UNIX; which implements the vCalendar protocol for personal data interchange. This vendor-independent, open standard allows different programs and devices to share/synchronize event and calendar information without proprietary standards. The data is stored in <acronym>ASCII</acronym> and is easily human-readable. While some &Windows; programs have implemented a limited import/export ability from their native formats to vCalendar, &korganizer;'s native file format on disk is vCalendar, so it bypasses this middle-step entirely. It also allows you to easily access your data without the program itself, in the spirit of other &UNIX; programs. </para> </sect1> </chapter> <chapter id="other-features"> <title>Other Features</title> <para>In this chapter, you'll learn other useful features of &korganizer;: the parameters you can specify on the command line (when invoking &korganizer; from a shell), what tricks you can do with a click of your mouse, what interaction between &korganizer; and &konqueror; is possible.</para> <para>You'll also learn about merging and importing data, and about synchronizing with your &PalmPilot; or compatible handheld computer.</para> <sect1 id="other-features-commandline-options"> <title>Command Line</title> <para>While &korganizer; supports the full score of options that are common to all &kde; programs, it also supports two options of its own: it can list the events for the current day, and it can show the list of events for a specified number of days.</para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>Option</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry><option>--help</option></entry> <entry>Shows a brief options help text.</entry> </row> <row> <entry><option>--help-qt</option></entry> <entry>Shows numerous generic Qt-specific options.</entry> </row> <row> <entry><option>--help-kde</option></entry> <entry>Shows numerous generic KDE-specific options.</entry> </row> <row> <entry><option>--author</option></entry> <entry>Shows the names and email addresses of &korganizer; authors.</entry> </row> <row> <entry><option>-V</option>, <option>--version</option></entry> <entry>Shows the running versions of the Qt library , &kde; and &korganizer;.</entry> </row> <row> <entry><option>-l</option>, <option>--list</option></entry> <entry>Lists the events for the current day.</entry> </row> <row> <entry><option>-s</option>, <option>--show</option> <parameter>numdays</parameter></entry> <entry>Shows the list of events for a specified number of days</entry> </row> </tbody> </tgroup> </informaltable> </sect1> <sect1 id="other-features-drag-and-drop"> <title>Drag and Drop Operations</title> <para>&korganizer; can be easily controlled with your mouse. The supported drag-and-drop operations are detailed below.</para> <itemizedlist> <listitem><para>Any event can be resized with your mouse. Simply move the mouse pointer near the top or bottom edge of the event, and drag the edge up or down. This way you can visually modify the starting and ending time of your appointment. This works in the Day, Week and Work Week views.</para></listitem> <listitem><para>Any event can be rescheduled with your mouse. Move the mouse pointer over the event, and drag it to a new time location. This works in the Day, Week and Work Week views.</para></listitem> <listitem><para>Events can be copied to other, presently non-visible dates. Move the mouse pointer over the event, and drag it to the Date Navigator on the left side of the current calendar, or to the Date Navigator of a different calendar.</para> <tip><para>However, you cannot drag from agenda view in one calendar to agenda view in other calendar.</para></tip></listitem> <listitem><para>Toolbars can be dragged on the screen. Move the mouse pointer over the tollbar's handle, and drag it to a new location on your screen.</para></listitem> </itemizedlist> </sect1> <sect1 id="other-features-konqueror-interaction"> <title>&konqueror; interaction</title> <para>&konqueror; recognizes the vCalendar format used by &korganizer;. If you use &konqueror; to navigate to your calendar, it will be displayed <emphasis>inside</emphasis> &konqueror; as a live object. You will be able to perform most operations with your calendar inside &konqueror;; you will not need to start &korganizer;. In technical jargon, this is described as <quote>embedding vCalendar as KPart inside &konqueror;</quote>.</para> </sect1> <sect1 id="other-features-merging-data"> <title>Merging Data</title> <para>You can merge data from different calendar. Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Merge Calendar...</guimenuitem></menuchoice> and find the vCalendar file that you want to merge with the current calendar.</para> </sect1> <sect1 id="other-features-import"> <title>Import</title> <para>You can import calendar data from the classic scheduling program <application>Ical</application>. The <application>Ical</application> files must reside in your home directory. Choose <menuchoice> <guimenu>File</guimenu> <guimenuitem>Import from Ical</guimenuitem></menuchoice> to carry out this task.</para> </sect1> <sect1 id="other-features-palm-sync"> <title>Palm Synchronization</title> <para>### to be written... ###</para> <para>See the <link linkend="faq">&FAQ;</link> for one of the most common &PalmPilot; syncing problems.</para> </sect1> </chapter> <chapter id="faq"> <title>Questions and Answers</title> <qandaset id="faq-questions"> <qandaentry> <question> <para>Can I import my old <application>Ical</application> data?</para> </question> <answer><para>Sure! Follow the instructions in <link linkend="file-import-ical">Import From Ical section</link>.</para> </answer> </qandaentry> <qandaentry> <question> <para>Can I import data from &Microsoft; <application>Outlook</application>?</para> </question> <answer><para>Yes you can, but you must first tell <application>Outlook</application> to export it's data to vCalendar format. Then you must copy this data to your home directory, click <menuchoice><guimenu>File</guimenu> <guimenuitem>Open</guimenuitem> </menuchoice>, navigate to the file and double-click it.</para> </answer> </qandaentry> <qandaentry> <question><para>I'm trying to sync &korganizer; with my &PalmPilot;, but nothing happens. What else do I need to do?</para> </question> <answer><para> <itemizedlist> <listitem><para>Make sure no form of &korganizer; is running: neither &korganizer; itself nor the alarm daemon in the system tray. </para> </listitem> <listitem><para>Make sure the versions of the &kpilot; datebook conduit and &korganizer; are compatible.</para> </listitem> </itemizedlist> </para> </answer> </qandaentry> <qandaentry> <question> <para>Can I use freebusy-time with &korganizer;?</para> </question> <answer><para>Unfortunately this is not implemented yet, but planned for one of the next releases.</para> </answer> </qandaentry> </qandaset> </chapter> <chapter id="credits"> <title>Credits and License</title> <para>&korganizer;</para> <para>Program copyright 2000, The &kde; Developers</para> <para>Contributors:</para> <itemizedlist> <listitem><para>Cornelius Schumacher <email>schumacher@kde.org</email></para> </listitem> <listitem><para>Preston Brown <email>pbrown@kde.org</email></para> </listitem> </itemizedlist> <para>Documentation copyright 2000 Milos Prudek</para> <para>Documentation copyright 2001 Paul E. Ahlquist, Jr <email>pea@ahlquist.org</email></para> <!-- TRANS:CREDIT_FOR_TRANSLATORS --> <para>&korganizer; homepage is at <ulink url="http://devel-home.kde.org/~korganiz">http://devel-home.kde.org/~korganiz</ulink></para> &underFDL; &underGPL; </chapter> <appendix id="installation"> <title>Installation</title> <sect1 id="getting-korg"> <title>How to obtain &korganizer;</title> &install.intro.documentation; <para>Click the <guisubmenu>Applications</guisubmenu> menu of the <guimenu>main</guimenu> menu to see if &korganizer; is already installed on your system. If &korganizer; is not there, either it is not installed, or perhaps the administrator of your system has moved it to some other place.</para> <para>&korganizer; homepage is at <ulink url="http://devel-home.kde.org/~korganiz">http://devel-home.kde.org/~korganiz</ulink> </para> </sect1> <sect1 id="requirements"> <title>Requirements</title> <para>&korganizer; requires &kde; 2.0. It requires roughly 2MB of space in your &kde; system directory. Your calendars will require additional space in your home directory. Very large calendars slow down &korganizer; operation, therefore periodic cleanup is advisable.</para> <para>&korganizer; needs about 5 Megabytes of memory to run, but this may vary depending on your platform and the size of your calendar(s).</para> <para>All required libraries are part of standard &kde; libraries (kdelibs). &kde; base package (kdebase) must also be installed to change localisation preferences like date and time formats. &korganizer; itself is in the kdepim package. All packages can be found on <ulink url="http://www.kde.org">&kde; home page.</ulink>.</para> <para>The &korganizer; homepage is at <ulink url="http://devel-home.kde.org/~korganiz">http://devel-home.kde.org/~korganiz</ulink> </para> </sect1> <sect1 id="compilation"> <title>Compilation and Installation</title> <para>If &korganizer; is not installed and if you are the administrator of your system, your best bet is to use a precompiled binary file. </para> <itemizedlist> <listitem><para>If your system understands rpm binary package format, you should get a file <filename>kdepim-2.2.i386.rpm</filename> or similar. The correct installation command is: <userinput><command>rpm</command> <option>-i</option> <replaceable>kdepim-2.2.i386.rpm</replaceable></userinput>, and the correct upgrade command is: <userinput><command>rpm</command> <option>-U</option> <replaceable>kdepim2.i386.rpm</replaceable></userinput></para></listitem> <listitem><para>If your system uses different binary package format, you need to read the instructions that came with your system.</para></listitem> <listitem><para>If you cannot obtain precompiled binary package, you have to compile &korganizer; yourself from a source file.</para> &install.compile.documentation; </listitem> </itemizedlist> </sect1> <sect1 id="groupscheduling-setup"> <title>Setting up Groupscheduling</title> <para>To make groupscheduling work with &korganizer; you need to apply a filter to your mail-client. If you use <application>kmail</application> you have to make a filter, that <emphasis>pipes</emphasis> every email through a skript called <emphasis>korganizerIn</emphasis>, which you should find in the same directory, as the korganizer binary is. </para> </sect1> </appendix> <glossary id="glossary"> <title>Glossary</title> <glossentry id="gloss-calendar-widget"> <glossterm>Calendar Widget</glossterm> <glossdef> <para>A tool for choosing the date inside certain entry windows, like event editing window. It is displayed as a small button to the right of the date field. When you click the button, you will see a month calendar. Use the arrows to go to a desired date, or click on the month name or year number to go directly to the desired month or year.</para> </glossdef> </glossentry> <glossentry id="gloss-date-navigator"> <glossterm>Date Navigator</glossterm> <glossdef> <para>The calendar that is in the upper-left corner of the &korganizer; window. It is the main way provided to navigate among dates, and to select from them. The single-arrow icons move forwards and backwards in time by increments of a month, while the double-arrows allow moving by years at a time. Today's date will be outlined with a small box. Dates which have events scheduled on them will be bold. If you want to select a date, simply click on it. Hold down the Control key and click the dates if you wish to select multiple neighbor dates at once. The dates will be displayed in the main panel.</para> <para>Recurring events are not always displayed. You can forbid the display of recurring appointments in the Date Navigator. Get more information in the <link linkend="preferences-views">Views chapter</link>.</para> </glossdef> </glossentry> <glossentry id="gloss-due-date"> <glossterm>Due Date</glossterm> <glossdef> <para>A due date is simply the date when your task must be finished. For instance, if your To-Do task is that you must return your books to the library by 16th November, that date is called <quote>the To-Do task due date</quote></para> </glossdef> </glossentry> <!--<glossentry id="gloss-group-scheduling"> <glossterm>Group scheduling features</glossterm> <glossdef> <para>These features are planned for the future versions of &korganizer;. Group scheduling will facilitate member roles (attendee, owner, organizer), time conflict resolution, event reminder distribution, response collection and evaluation. In other words, you will be able to appoint attendees, invite them automatically, and see who accepted or refused attending the appointment.</para> <para>Currently, group scheduling features are not working. However, hooks exist in the calendar data structures for these features. <guilabel>Private</guilabel> checkbox, <guilabel>Require response</guilabel> checkbox and <guilabel>E-mail</guilabel> field will then be fully employed. These controls are described in more detail in <link linkend="entering-data">Entering Data</link> chapter, in the <link linkend="reference-windows-attendees">Attendees section</link> of Windows reference, and in the <link linkend="preferences-personal">Personal Preferences</link> section.</para> </glossdef> </glossentry> --> <glossentry id="gloss-main-panel"> <glossterm>Main panel</glossterm> <glossdef> <para>Normally the largest part of the screen, to the right of the Date Navigator. It displays the View of the day, workdays, week or month, the List View or the To-Do View.</para> <para>The right mouse button can be used in the List view and To-Do view only. It displays a local menu. The left mouse button can be used in any view.</para> </glossdef> </glossentry> </glossary> &documentation.index; </book> <!-- Local Variables: mode: sgml sgml-minimize-attributes:nil sgml-general-insert-case:lower sgml-indent-step:0 sgml-indent-data:nil End: // vim:ts=2:sw=2:tw=78:noet -->