Author: juha
Date: 2008-05-23 13:13:37 +0000 (Fri, 23 May 2008)
New Revision: 26982

Modified:
   xfcalendar/trunk/doc/C/images/default_calendar.png
   xfcalendar/trunk/doc/C/images/orage_appointment.png
   xfcalendar/trunk/doc/C/images/orage_appointment_alarm.png
   xfcalendar/trunk/doc/C/images/orage_preferences_display.png
   xfcalendar/trunk/doc/C/images/orage_preferences_extra.png
   xfcalendar/trunk/doc/C/orage.html
   xfcalendar/trunk/doc/C/orage.xml
Log:
Documentation update. Now ready for production.


Modified: xfcalendar/trunk/doc/C/images/default_calendar.png
===================================================================
(Binary files differ)

Modified: xfcalendar/trunk/doc/C/images/orage_appointment.png
===================================================================
(Binary files differ)

Modified: xfcalendar/trunk/doc/C/images/orage_appointment_alarm.png
===================================================================
(Binary files differ)

Modified: xfcalendar/trunk/doc/C/images/orage_preferences_display.png
===================================================================
(Binary files differ)

Modified: xfcalendar/trunk/doc/C/images/orage_preferences_extra.png
===================================================================
(Binary files differ)

Modified: xfcalendar/trunk/doc/C/orage.html
===================================================================
--- xfcalendar/trunk/doc/C/orage.html   2008-05-22 15:04:01 UTC (rev 26981)
+++ xfcalendar/trunk/doc/C/orage.html   2008-05-23 13:13:37 UTC (rev 26982)
@@ -1,6 +1,6 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; 
charset=ISO-8859-1"><title>Orage</title><link rel="stylesheet" 
href="../xfce.css" type="text/css"><meta name="generator" content="DocBook XSL 
Stylesheets V1.72.0"><link rel="start" href="#orage" title="Orage"><link 
rel="next" href="#orage-intro" title="Introduction"></head><body 
bgcolor="white" text="black" link="#0000FF" vlink="#840084" 
alink="#0000FF"><div class="article" lang="en"><div 
class="titlepage"><div><div><h1 class="title"><a 
name="orage"></a>Orage</h1></div><div><div class="authorgroup"><div 
class="author"><h3 class="author"><span class="firstname">Juha</span> <span 
class="surname">Kautto</span></h3><div class="affiliation"><div 
class="address"><p><code class="email">&lt;<a href="mailto:[EMAIL 
PROTECTED]">[EMAIL PROTECTED]</a>&gt;</code></p></div></div></div><div 
class="author"><h3 class="author"><span class="firstname">Mickael</span> <span 
class="surname">Graf</span></h3><div class="affiliation"><div class=
 "address"><p><code class="email">&lt;<a href="mailto:[EMAIL PROTECTED]">[EMAIL 
PROTECTED]</a>&gt;</code></p></div></div></div><div class="author"><h3 
class="author"><span class="firstname">Benedikt</span> <span 
class="surname">Meurer</span></h3><div class="affiliation"><div 
class="address"><p><code class="email">&lt;<a href="mailto:[EMAIL 
PROTECTED]">[EMAIL 
PROTECTED]</a>&gt;</code></p></div></div></div></div></div><div><span 
xmlns="http://www.w3.org/TR/xhtml1/transitional"; class="releaseinfo">This 
manual describes <strong xmlns="" 
class="application"><code>orage</code></strong> version 4.5.12.
-    Last updated: January 2008
-  <br></br></span></div><div><p class="copyright">Copyright � 2006-2008 Juha 
Kautto</p></div></div><hr></div><div class="toc"><p><b>Table of 
Contents</b></p><dl><dt><span class="sect1"><a 
href="#orage-intro">Introduction</a></span></dt><dt><span class="sect1"><a 
href="#orage-getting-started">Getting started</a></span></dt><dt><span 
class="sect1"><a href="#orage-calendar-window">The calendar 
window</a></span></dt><dd><dl><dt><span class="sect2"><a 
href="#calendar-menu-bar">The menu bar</a></span></dt><dt><span 
class="sect2"><a href="#calendar-window">The calendar</a></span></dt><dt><span 
class="sect2"><a href="#calendar-todo-window">The TODO 
list</a></span></dt></dl></dd><dt><span class="sect1"><a 
href="#orage-eventlist-window">The event list 
window</a></span></dt><dd><dl><dt><span class="sect2"><a 
href="#event%20list-action-bar">The button bar</a></span></dt><dt><span 
class="sect2"><a href="#eventlist-tabs">The tabs</a></span></dt><dt><span 
class="sect2"><a href="#eventlist-
 appointments">The appointment list</a></span></dt></dl></dd><dt><span 
class="sect1"><a href="#orage-daylist-window">The day list 
window</a></span></dt><dd><dl><dt><span class="sect2"><a 
href="#daylist-action-bar">The button bar</a></span></dt><dt><span 
class="sect2"><a href="#daylist-parameters">The 
parameters</a></span></dt><dt><span class="sect2"><a href="#daylist-list">The 
day list</a></span></dt></dl></dd><dt><span class="sect1"><a 
href="#orage-appointment-window">The appointment 
window</a></span></dt><dd><dl><dt><span class="sect2"><a 
href="#appointment-action-bar">The button bar</a></span></dt><dt><span 
class="sect2"><a href="#appointment-general-tab">The general 
tab</a></span></dt><dt><span class="sect2"><a href="#appointment-alarm-tab">The 
alarm tab</a></span></dt><dt><span class="sect2"><a 
href="#appointment-recurrence-tab">The recurrence 
tab</a></span></dt></dl></dd><dt><span class="sect1"><a 
href="#orage-exchangedata-window">The exchange data window</a></span></dt
 ><dd><dl><dt><span class="sect2"><a href="#exchange-impexp-tab">The import 
 >export tab</a></span></dt><dt><span class="sect2"><a 
 >href="#exchange-oragefiles-tab">The orage files tab</a></span></dt><dt><span 
 >class="sect2"><a href="#exchange-foreign-tab">The foreign files 
 >tab</a></span></dt></dl></dd><dt><span class="sect1"><a 
 >href="#orage-preferences-window">The preferences 
 >window</a></span></dt><dd><dl><dt><span class="sect2"><a 
 >href="#preferences-main-tab">The main tab</a></span></dt><dt><span 
 >class="sect2"><a href="#preferences-display-tab">The display 
 >tab</a></span></dt><dt><span class="sect2"><a 
 >href="#preferences-extra-tab">The extra 
 >tab</a></span></dt></dl></dd><dt><span class="sect1"><a 
 >href="#orage-undocumented">Undocumented Features</a></span></dt><dt><span 
 >class="sect1"><a href="#orage-faq">Frequently Asked 
 >Questions</a></span></dt></dl></div><p>�</p><div class="sect1" lang="en"><div 
 >class="titlepage"><div><div><h2 class="title" style="clear: both"><a 
 >name="orage-int
 ro"></a>Introduction</h2></div></div></div><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; 
charset=ISO-8859-1"><title>Orage</title><link rel="stylesheet" 
href="../xfce.css" type="text/css"><meta name="generator" content="DocBook XSL 
Stylesheets V1.72.0"><link rel="start" href="#orage" title="Orage"><link 
rel="next" href="#orage-intro" title="Introduction"></head><body 
bgcolor="white" text="black" link="#0000FF" vlink="#840084" 
alink="#0000FF"><div class="article" lang="en"><div 
class="titlepage"><div><div><h1 class="title"><a 
name="orage"></a>Orage</h1></div><div><div class="authorgroup"><div 
class="author"><h3 class="author"><span class="firstname">Juha</span> <span 
class="surname">Kautto</span></h3><div class="affiliation"><div 
class="address"><p><code class="email">&lt;<a href="mailto:[EMAIL 
PROTECTED]">[EMAIL PROTECTED]</a>&gt;</code></p></div></div></div><div 
class="author"><h3 class="author"><span class="firstname">Mickael</span> <span 
class="surname">Graf</span></h3><div class="affiliation"><div class=
 "address"><p><code class="email">&lt;<a href="mailto:[EMAIL PROTECTED]">[EMAIL 
PROTECTED]</a>&gt;</code></p></div></div></div><div class="author"><h3 
class="author"><span class="firstname">Benedikt</span> <span 
class="surname">Meurer</span></h3><div class="affiliation"><div 
class="address"><p><code class="email">&lt;<a href="mailto:[EMAIL 
PROTECTED]">[EMAIL 
PROTECTED]</a>&gt;</code></p></div></div></div></div></div><div><span 
xmlns="http://www.w3.org/TR/xhtml1/transitional"; class="releaseinfo">This 
manual describes <strong xmlns="" 
class="application"><code>orage</code></strong> version 4.5.13.
+    Last updated: May 2008
+  <br></br></span></div><div><p class="copyright">Copyright � 2006-2008 Juha 
Kautto</p></div></div><hr></div><div class="toc"><p><b>Table of 
Contents</b></p><dl><dt><span class="sect1"><a 
href="#orage-intro">Introduction</a></span></dt><dt><span class="sect1"><a 
href="#orage-getting-started">Getting started</a></span></dt><dt><span 
class="sect1"><a href="#orage-calendar-window">The calendar 
window</a></span></dt><dd><dl><dt><span class="sect2"><a 
href="#calendar-menu-bar">The menu bar</a></span></dt><dt><span 
class="sect2"><a href="#calendar-window">The calendar</a></span></dt><dt><span 
class="sect2"><a href="#calendar-todo-window">The TODO 
list</a></span></dt><dt><span class="sect2"><a 
href="#calendar-events-window">The EVENT 
list</a></span></dt></dl></dd><dt><span class="sect1"><a 
href="#orage-eventlist-window">The event list 
window</a></span></dt><dd><dl><dt><span class="sect2"><a 
href="#event%20list-action-bar">The button bar</a></span></dt><dt><span 
class="sect2"><a hre
 f="#eventlist-tabs">The tabs</a></span></dt><dt><span class="sect2"><a 
href="#eventlist-appointments">The appointment 
list</a></span></dt></dl></dd><dt><span class="sect1"><a 
href="#orage-daylist-window">The day list 
window</a></span></dt><dd><dl><dt><span class="sect2"><a 
href="#daylist-action-bar">The button bar</a></span></dt><dt><span 
class="sect2"><a href="#daylist-parameters">The 
parameters</a></span></dt><dt><span class="sect2"><a href="#daylist-list">The 
day list</a></span></dt></dl></dd><dt><span class="sect1"><a 
href="#orage-appointment-window">The appointment 
window</a></span></dt><dd><dl><dt><span class="sect2"><a 
href="#appointment-action-bar">The button bar</a></span></dt><dt><span 
class="sect2"><a href="#appointment-general-tab">The general 
tab</a></span></dt><dt><span class="sect2"><a href="#appointment-alarm-tab">The 
alarm tab</a></span></dt><dt><span class="sect2"><a 
href="#appointment-recurrence-tab">The recurrence 
tab</a></span></dt></dl></dd><dt><span cl
 ass="sect1"><a href="#orage-exchangedata-window">The exchange data 
window</a></span></dt><dd><dl><dt><span class="sect2"><a 
href="#exchange-impexp-tab">The import export tab</a></span></dt><dt><span 
class="sect2"><a href="#exchange-oragefiles-tab">The orage files 
tab</a></span></dt><dt><span class="sect2"><a href="#exchange-foreign-tab">The 
foreign files tab</a></span></dt></dl></dd><dt><span class="sect1"><a 
href="#orage-preferences-window">The preferences 
window</a></span></dt><dd><dl><dt><span class="sect2"><a 
href="#preferences-main-tab">The main tab</a></span></dt><dt><span 
class="sect2"><a href="#preferences-display-tab">The display 
tab</a></span></dt><dt><span class="sect2"><a href="#preferences-extra-tab">The 
extra tab</a></span></dt></dl></dd><dt><span class="sect1"><a 
href="#orage-undocumented">Undocumented Features</a></span></dt><dt><span 
class="sect1"><a href="#orage-faq">Frequently Asked 
Questions</a></span></dt></dl></div><p>�</p><div class="sect1" lang="en"><
 div class="titlepage"><div><div><h2 class="title" style="clear: both"><a 
name="orage-intro"></a>Introduction</h2></div></div></div><p>
     Orage is a time-managing application of the
     <a href="http://www.xfce.org"; target="_top">Xfce 4 Desktop Environment
     </a>. It includes a calendar window, list of events and day view.
@@ -26,7 +26,8 @@
     The calendar window provides you a menu bar giving access to different
     functions. 
     Below that is a standard calendar showing the month, the year, day names 
-    and week numbers. At the bottom there is small window showing active TODOs.
+    and week numbers. At the bottom there is small window showing active 
+    TODOs and EVENTs on the selected day. (Empty parts are not shown.)
   </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 
class="title"><a name="calendar-menu-bar"></a>The menu 
bar</h3></div></div></div><p>
       The menubar contains four menus: File, Edit, View and Help.
     </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 
class="title"><a name="calendar-file-menu"></a>The File 
menu</h4></div></div></div><div class="figure"><a 
name="calendar-file-menu-fig"></a><p class="title"><b>Figure�3.�File menu in 
the calendar window</b></p><div class="figure-contents"><div 
class="screenshot"><div class="mediaobject"><img 
src="images/orage_calendar_file_menu.png" alt="The File menu in the calendar 
window."></div></div></div></div><br class="figure-break"><p>
@@ -78,6 +79,10 @@
       before the due time passes). And black means a future TODO.
       You can edit TODOs by double clicking the row. All rows have tooltips,
       which show more details about the TODO.
+    </p></div><div class="sect2" lang="en"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="calendar-events-window"></a>The EVENT list</h3></div></div></div><p>
+      Below the TODO list you see your events from the selected date.
+      Check the tooltip for more details of the event. Also events can be 
+      edited by double clikcing them.
     </p></div></div><div class="sect1" lang="en"><div 
class="titlepage"><div><div><h2 class="title" style="clear: both"><a 
name="orage-eventlist-window"></a>The event list 
window</h2></div></div></div><div class="figure"><a 
name="orage-eventlist-fig"></a><p class="title"><b>Figure�7.�Orage event list 
window</b></p><div class="figure-contents"><div class="screenshot"><div 
class="mediaobject"><img src="images/orage_eventlist.png" alt="The event list 
window."></div></div></div></div><br class="figure-break"><p>
     The event list (or appointment list as it is also called) window shows all
     activites that you have reserved for the day (date is shown in the window
@@ -161,9 +166,11 @@
         When the event has passed, it is overstriked. Currently active 
         events are shown with blue colour and future events are bold. 
       </li><li>
-        Flags: gives information about the appointment. (Note that the
-        explanations are visible as a hint when you move your cursor into the
-        appointment list.) There are five flags in order:
+        Flags: gives information about the appointment. If your appointment
+        has a category which has been associated with a clour, flags field has
+        that colour background. (Note that the explanations are visible as
+        a hint when you move your cursor into the appointment list.)
+        There are five flags in order:
         <div class="itemizedlist"><ul type="circle"><li>
             Alarm: what kind of action happens when alarm time passes.
             <span><strong class="keycap">n</strong></span> means no alarm has 
been defined.
@@ -357,6 +364,11 @@
             By selecting the Done box you mark this todo as done. The completed
             time can then be set. Format is similar to other times (like 
             Start). Only todos have completed time.
+          </p></dd><dt><span class="term">Categories</span></dt><dd><p>
+            Free format text, which you can use to categorize your appointment.
+            It is also possible to create a list of categories and associate
+            those to colours. You can then pick one of those and get your
+            appointment to be show with that colour in the event list window.
           </p></dd><dt><span class="term">Note</span></dt><dd><p>
             Free format text, where you can and should explain more
             the appointment. It is shown in the alarm window. Scrollbars
@@ -419,6 +431,10 @@
             This makes it possible to use external alarms. You can run any
             operating system command or script. Common use for this is sending
             email.
+          </p></dd><dt><span class="term">Default alarm</span></dt><dd><p>
+            You can either set alarm back to default options or you can store
+            current settings to be default alarm for all new appointments.
+            There is only one default alarm, which applies to all appointments.
           </p></dd></dl></div></div><div class="sect2" lang="en"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="appointment-recurrence-tab"></a>The recurrence 
tab</h3></div></div></div><div class="figure"><a 
name="orage-appointment-recurrence-fig"></a><p 
class="title"><b>Figure�11.�Orage appointment window - recurrence 
tab</b></p><div class="figure-contents"><div class="screenshot"><div 
class="mediaobject"><img src="images/orage_appointment_recurrence.png" alt="The 
appointment recurrence tab."></div></div></div></div><br 
class="figure-break"><p>
       In this tab you can define repeating appointments. Often it makes
       sense that the same appointment happens every day or every month instead
@@ -607,6 +623,10 @@
           </p></dd><dt><span class="term">Show menu</span></dt><dd><p>
             By unselecting this you can leave out the menubar in the top of
             the calendar window.
+          </p></dd><dt><span class="term">Show todo list</span></dt><dd><p>
+            You can hide TODO list in the main calendar by deselecting this.
+          </p></dd><dt><span class="term">Show event list</span></dt><dd><p>
+            You can hide EVENT list in the main calendar by deselecting this.
           </p></dd><dt><span class="term">Set sticked</span></dt><dd><p>
             Show calendar window on all workspaces by selecting this.
           </p></dd><dt><span class="term">Set on top</span></dt><dd><p>
@@ -633,11 +653,6 @@
             plugin). Default value is off, which means that previously
             selected day will remain selected. Crossing this causes
             current date always being selected.
-          </p></dd><dt><span class="term">Ical week start 
day</span></dt><dd><p>
-            Defines what is the first day of week in libical. Note, that 
-            it is <span class="emphasis"><em>only</em></span> used in weekly 
repeating
-            appointments. It will <span class="emphasis"><em>not</em></span> 
change the
-            calendar view anyway.
           </p></dd><dt><span class="term">Dynamic icon size</span></dt><dd><p>
             Setting these X and Y sizes to nonzero causes <strong 
class="application"><code>orage</code></strong> to use dynamic
             icon in taskbar (if you have taskbar and you have selected to use
@@ -684,22 +699,30 @@
           200-299 = Critical warning
         </li><li>
           300-    = Error (these cause <strong 
class="application"><code>orage</code></strong> to abort)
-        </li></ul></div></li></ul></div></div><div class="sect1" 
lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: 
both"><a name="orage-faq"></a>Frequently Asked 
Questions</h2></div></div></div><p>
+        </li></ul></div></li><li><p>
+        Ical week start day: Defines what is the first day of week in libical.
+        Note, that 
+        it is <span class="emphasis"><em>only</em></span> used in weekly 
repeating
+        appointments. It will <span class="emphasis"><em>not</em></span> 
change the
+        calendar view anyway. <strong 
class="application"><code>orage</code></strong> tries is best to find this 
setting 
+        automatically, but if your weekly repeating appointments seem to be
+        wrong, you can try to set this. 0 = Monday, 1 = Tuesday...
+      </p></li></ul></div></div><div class="sect1" lang="en"><div 
class="titlepage"><div><div><h2 class="title" style="clear: both"><a 
name="orage-faq"></a>Frequently Asked Questions</h2></div></div></div><p>
     Some common questions and answers.
-  </p><tr class="qandadiv"><td align="left" valign="top" colspan="2"><h4 
class="title"><a name="id2554369"></a>1. Frequently Asked 
Questions</h4></td></tr><tr class="toc"><td align="left" valign="top" 
colspan="2"><dl><dt>1.1. <a href="#id2554374">
+  </p><tr class="qandadiv"><td align="left" valign="top" colspan="2"><h4 
class="title"><a name="id2554329"></a>1. Frequently Asked 
Questions</h4></td></tr><tr class="toc"><td align="left" valign="top" 
colspan="2"><dl><dt>1.1. <a href="#id2554334">
           Why does my week start on Saturday?
-        </a></dt><dt>1.2. <a href="#id2554472">
+        </a></dt><dt>1.2. <a href="#id2554433">
           How can I insert my ical file into orage?
-        </a></dt><dt>1.3. <a href="#id2554513">
+        </a></dt><dt>1.3. <a href="#id2554473">
           How can skip my repeating appointment from happening during some 
           period of time?
-        </a></dt><dt>1.4. <a href="#id2554545">
+        </a></dt><dt>1.4. <a href="#id2554506">
           I have found a bug in orage or would like to see a new feature. How
           can I inform that to the developers?
-        </a></dt><dt>1.5. <a href="#id2554598">
+        </a></dt><dt>1.5. <a href="#id2554559">
           I upgraded to Orage 4.5 from Orage 4.4 and now my old appointments 
           are missing. Are they permanetly lost?
-        </a></dt></dl></td></tr><tr class="question"><td align="left" 
valign="top"><a name="id2554374"></a><a 
name="id2554376"></a><b>1.1.</b></td><td align="left" valign="top"><p>
+        </a></dt></dl></td></tr><tr class="question"><td align="left" 
valign="top"><a name="id2554334"></a><a 
name="id2554336"></a><b>1.1.</b></td><td align="left" valign="top"><p>
           Why does my week start on Saturday?
         </p></td></tr><tr class="answer"><td align="left" 
valign="top"></td><td align="left" valign="top"><p>
           This really is a problem in your distro. You can check how your
@@ -725,7 +748,7 @@
           After that you can check what the setting is: 
           <span><strong class="command">grep first_weekday 
fi_FI</strong></span> and change that if it is
           wrong and after that you need to recompile your locale database.
-        </p></td></tr><tr class="question"><td align="left" valign="top"><a 
name="id2554472"></a><a name="id2554474"></a><b>1.2.</b></td><td align="left" 
valign="top"><p>
+        </p></td></tr><tr class="question"><td align="left" valign="top"><a 
name="id2554433"></a><a name="id2554435"></a><b>1.2.</b></td><td align="left" 
valign="top"><p>
           How can I insert my ical file into <strong 
class="application"><code>orage</code></strong>?
         </p></td></tr><tr class="answer"><td align="left" 
valign="top"></td><td align="left" valign="top"><p>
           You can do this with so called foreig files. Add your file as
@@ -733,7 +756,7 @@
           and <strong class="application"><code>orage</code></strong> includes 
the appointmemts (After this you can not tell
           the difference anymore, so you can not easily move them back to
           where they came form.)
-        </p></td></tr><tr class="question"><td align="left" valign="top"><a 
name="id2554513"></a><a name="id2554515"></a><b>1.3.</b></td><td align="left" 
valign="top"><p>
+        </p></td></tr><tr class="question"><td align="left" valign="top"><a 
name="id2554473"></a><a name="id2554475"></a><b>1.3.</b></td><td align="left" 
valign="top"><p>
           How can skip my repeating appointment from happening during some 
           period of time?
         </p></td></tr><tr class="answer"><td align="left" 
valign="top"></td><td align="left" valign="top"><p>
@@ -744,7 +767,7 @@
           feature, but unfortunately <strong 
class="application"><code>orage</code></strong> does not include that feature.
           The easiest way probably is to end those appointment with end date
           and then after the holiday remove the end date again.
-        </p></td></tr><tr class="question"><td align="left" valign="top"><a 
name="id2554545"></a><a name="id2554548"></a><b>1.4.</b></td><td align="left" 
valign="top"><p>
+        </p></td></tr><tr class="question"><td align="left" valign="top"><a 
name="id2554506"></a><a name="id2554508"></a><b>1.4.</b></td><td align="left" 
valign="top"><p>
           I have found a bug in <strong 
class="application"><code>orage</code></strong> or would like to see a new 
feature. How
           can I inform that to the developers?
         </p></td></tr><tr class="answer"><td align="left" 
valign="top"></td><td align="left" valign="top"><p>
@@ -756,7 +779,7 @@
           to include your full <strong 
class="application"><code>orage</code></strong> version (preferable the results 
from
           <span><strong class="command">orage -v</strong></span> or look the 
version from the about
           window).
-        </p></td></tr><tr class="question"><td align="left" valign="top"><a 
name="id2554598"></a><a name="id2554600"></a><b>1.5.</b></td><td align="left" 
valign="top"><p>
+        </p></td></tr><tr class="question"><td align="left" valign="top"><a 
name="id2554559"></a><a name="id2554561"></a><b>1.5.</b></td><td align="left" 
valign="top"><p>
           I upgraded to Orage 4.5 from Orage 4.4 and now my old appointments 
           are missing. Are they permanetly lost?
         </p></td></tr><tr class="answer"><td align="left" 
valign="top"></td><td align="left" valign="top"><p>

Modified: xfcalendar/trunk/doc/C/orage.xml
===================================================================
--- xfcalendar/trunk/doc/C/orage.xml    2008-05-22 15:04:01 UTC (rev 26981)
+++ xfcalendar/trunk/doc/C/orage.xml    2008-05-23 13:13:37 UTC (rev 26982)
@@ -1,9 +1,9 @@
 <?xml version='1.0'?> 
 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
           "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"; [
-  <!ENTITY manrevision "1.4"> 
-  <!ENTITY date "January 2008"> 
-  <!ENTITY appversion "4.5.12"> 
+  <!ENTITY manrevision "1.5"> 
+  <!ENTITY date "May 2008"> 
+  <!ENTITY appversion "4.5.13"> 
   <!ENTITY app "<application>orage</application>">
 ]>
 
@@ -178,7 +178,8 @@
     The calendar window provides you a menu bar giving access to different
     functions. 
     Below that is a standard calendar showing the month, the year, day names 
-    and week numbers. At the bottom there is small window showing active TODOs.
+    and week numbers. At the bottom there is small window showing active 
+    TODOs and EVENTs on the selected day. (Empty parts are not shown.)
   </para>
 
   <sect2 id="calendar-menu-bar">
@@ -345,6 +346,15 @@
       which show more details about the TODO.
     </para>
   </sect2>
+
+  <sect2 id="calendar-events-window">
+    <title>The EVENT list</title>
+    <para>
+      Below the TODO list you see your events from the selected date.
+      Check the tooltip for more details of the event. Also events can be 
+      edited by double clikcing them.
+    </para>
+  </sect2>
 </sect1>
 
 <sect1 id="orage-eventlist-window">
@@ -482,9 +492,11 @@
         events are shown with blue colour and future events are bold. 
       </listitem>
       <listitem>
-        Flags: gives information about the appointment. (Note that the
-        explanations are visible as a hint when you move your cursor into the
-        appointment list.) There are five flags in order:
+        Flags: gives information about the appointment. If your appointment
+        has a category which has been associated with a clour, flags field has
+        that colour background. (Note that the explanations are visible as
+        a hint when you move your cursor into the appointment list.)
+        There are five flags in order:
         <itemizedlist>
           <listitem>
             Alarm: what kind of action happens when alarm time passes.
@@ -836,6 +848,17 @@
         </listitem>
       </varlistentry>
       <varlistentry>
+        <term>Categories</term>
+        <listitem>
+          <para>
+            Free format text, which you can use to categorize your appointment.
+            It is also possible to create a list of categories and associate
+            those to colours. You can then pick one of those and get your
+            appointment to be show with that colour in the event list window.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
         <term>Note</term>
         <listitem>
           <para>
@@ -958,6 +981,16 @@
           </para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>Default alarm</term>
+        <listitem>
+          <para>
+            You can either set alarm back to default options or you can store
+            current settings to be default alarm for all new appointments.
+            There is only one default alarm, which applies to all appointments.
+          </para>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </sect2>
 
@@ -1398,6 +1431,22 @@
         </listitem>
       </varlistentry>
       <varlistentry>
+        <term>Show todo list</term>
+        <listitem>
+          <para>
+            You can hide TODO list in the main calendar by deselecting this.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Show event list</term>
+        <listitem>
+          <para>
+            You can hide EVENT list in the main calendar by deselecting this.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
         <term>Set sticked</term>
         <listitem>
           <para>
@@ -1488,17 +1537,6 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Ical week start day</term>
-        <listitem>
-          <para>
-            Defines what is the first day of week in libical. Note, that 
-            it is <emphasis>only</emphasis> used in weekly repeating
-            appointments. It will <emphasis>not</emphasis> change the
-            calendar view anyway.
-          </para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
         <term>Dynamic icon size</term>
         <listitem>
           <para>
@@ -1572,9 +1610,19 @@
         <listitem>
           300-    = Error (these cause &app; to abort)
         </listitem>
-
       </itemizedlist>
     </listitem>
+    <listitem>
+      <para>
+        Ical week start day: Defines what is the first day of week in libical.
+        Note, that 
+        it is <emphasis>only</emphasis> used in weekly repeating
+        appointments. It will <emphasis>not</emphasis> change the
+        calendar view anyway. &app; tries is best to find this setting 
+        automatically, but if your weekly repeating appointments seem to be
+        wrong, you can try to set this. 0 = Monday, 1 = Tuesday...
+      </para>
+    </listitem>
   </itemizedlist>
 </sect1>
 

_______________________________________________
Xfce4-commits mailing list
Xfce4-commits@xfce.org
http://foo-projects.org/mailman/listinfo/xfce4-commits

Reply via email to