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