Author: juha
Date: 2008-02-26 15:16:10 +0000 (Tue, 26 Feb 2008)
New Revision: 26644

Modified:
   xfcalendar/trunk/doc/C/orage.html
   xfcalendar/trunk/doc/C/orage.xml
Log:
added info for new file location


Modified: xfcalendar/trunk/doc/C/orage.html
===================================================================
--- xfcalendar/trunk/doc/C/orage.html   2008-02-26 14:24:13 UTC (rev 26643)
+++ xfcalendar/trunk/doc/C/orage.html   2008-02-26 15:16:10 UTC (rev 26644)
@@ -1,4 +1,4 @@
-<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.68.1"><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.
+<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>
     Orage is a time-managing application of the
@@ -9,33 +9,27 @@
     It also provides an easy way to archive and manage your old appointments.
   </p></div><p>�</p><div class="sect1" lang="en"><div 
class="titlepage"><div><div><h2 class="title" style="clear: both"><a 
name="orage-getting-started"></a>Getting started</h2></div></div></div><p>
     Orage is started by typing <strong 
class="application"><code>orage</code></strong> on the command line or in the 
run
-    application window. You can also start it by clicking on the item <strong 
class="application"><code>orage</code></strong>
-    in the submenu "Office" from the desktop menu.
-    Another handy way of starting <strong 
class="application"><code>orage</code></strong> is to click button 1 on 
orageclock
-    panel plugin. But usually Orage is started automatically as part of Xfce
-    startup.
+    application window. The command line accepts some optins like -v, which
+    tells the version and -h, which shows short usage help. You can also start
+    <strong class="application"><code>orage</code></strong> by clicking on the 
item <strong class="application"><code>orage</code></strong> in the submenu 
"Office" from the
+    desktop menu. Another handy way of starting <strong 
class="application"><code>orage</code></strong> is to click button 1 on
+    orageclock panel plugin. But usually <strong 
class="application"><code>orage</code></strong> is started automatically as
+    part of Xfce startup.
   </p><p>
     The first thing you should do is to adjust your 
     <a href="#orage-preferences-window" title="The preferences 
window">preferences</a>. 
     Before adding any appointments, it is strongly recommended to set your
     local <a href="#preferences-main-tab" title="The main tab">timezone</a>.
-  </p><div class="figure"><a name="desktop-menuitem-fig"></a><p 
class="title"><b>Figure�1.�Orage menu item in the desktop menu</b></p><div 
class="screenshot"><div class="mediaobject"><img 
src="images/orage_desktop_menuitem.png" alt='
-            For starting orage from the desktop menu: "Office" and then click
-            on "Orage".
-          '></div></div></div><p>
+  </p><div class="figure"><a name="desktop-menuitem-fig"></a><p 
class="title"><b>Figure�1.�Orage menu item in the desktop menu</b></p><div 
class="figure-contents"><div class="screenshot"><div class="mediaobject"><img 
src="images/orage_desktop_menuitem.png" alt='For starting orage from the 
desktop menu: "Office" and then click on "Orage".'></div></div></div></div><br 
class="figure-break"><p>
     When you run <strong class="application"><code>orage</code></strong>, you 
will first see the calendar window appearing.
-  </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 
class="title" style="clear: both"><a name="orage-calendar-window"></a>The 
calendar window</h2></div></div></div><div class="figure"><a 
name="default-calendar-fig"></a><p class="title"><b>Figure�2.�Default Calendar 
window</b></p><div class="screenshot"><div class="mediaobject"><img 
src="images/default_calendar.png" alt="
-            The calendar window.
-          "></div></div></div><p>
+  </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 
class="title" style="clear: both"><a name="orage-calendar-window"></a>The 
calendar window</h2></div></div></div><div class="figure"><a 
name="default-calendar-fig"></a><p class="title"><b>Figure�2.�Default Calendar 
window</b></p><div class="figure-contents"><div class="screenshot"><div 
class="mediaobject"><img src="images/default_calendar.png" alt="The calendar 
window."></div></div></div></div><br class="figure-break"><p>
     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.
   </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="screenshot"><div 
class="mediaobject"><img src="images/orage_calendar_file_menu.png" alt="
-                The File menu in the calendar window.
-              "></div></div></div><p>
+    </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>
         The file menu contains four items:
       </p><div class="itemizedlist"><ul type="disc"><li>
           New: start an 
@@ -51,14 +45,10 @@
           background;
         </li><li>
           Quit: end Orage;
-        </li></ul></div></div><div class="sect3" lang="en"><div 
class="titlepage"><div><div><h4 class="title"><a 
name="calendar-edit-menu"></a>The Edit menu</h4></div></div></div><div 
class="figure"><a name="calendar-edit-menu-fig"></a><p 
class="title"><b>Figure�4.�Edit menu in the calendar window</b></p><div 
class="screenshot"><div class="mediaobject"><img 
src="images/orage_calendar_edit_menu.png" alt="
-                The Edit menu in the calendar window.
-              "></div></div></div><p>
+        </li></ul></div></div><div class="sect3" lang="en"><div 
class="titlepage"><div><div><h4 class="title"><a 
name="calendar-edit-menu"></a>The Edit menu</h4></div></div></div><div 
class="figure"><a name="calendar-edit-menu-fig"></a><p 
class="title"><b>Figure�4.�Edit menu in the calendar window</b></p><div 
class="figure-contents"><div class="screenshot"><div class="mediaobject"><img 
src="images/orage_calendar_edit_menu.png" alt="The Edit menu in the calendar 
window."></div></div></div></div><br class="figure-break"><p>
         The Edit menu gives you access to the settings window, which will be
         explained later.
-      </p></div><div class="sect3" lang="en"><div 
class="titlepage"><div><div><h4 class="title"><a 
name="calendar-view-menu"></a>The View menu</h4></div></div></div><div 
class="figure"><a name="calendar-view-menu-fig"></a><p 
class="title"><b>Figure�5.�View menu in the calendar window</b></p><div 
class="screenshot"><div class="mediaobject"><img 
src="images/orage_calendar_view_menu.png" alt="
-                The View menu in the calendar window.
-              "></div></div></div><p>
+      </p></div><div class="sect3" lang="en"><div 
class="titlepage"><div><div><h4 class="title"><a 
name="calendar-view-menu"></a>The View menu</h4></div></div></div><div 
class="figure"><a name="calendar-view-menu-fig"></a><p 
class="title"><b>Figure�5.�View menu in the calendar window</b></p><div 
class="figure-contents"><div class="screenshot"><div class="mediaobject"><img 
src="images/orage_calendar_view_menu.png" alt="The View menu in the calendar 
window."></div></div></div></div><br class="figure-break"><p>
         The View menu has three choices:
       </p><div class="itemizedlist"><ul type="disc"><li>
           View selected date: show the event list of currently selected date;
@@ -66,9 +56,7 @@
           View selected week: show the day window starting from current day;
         </li><li>
           Select today: set calendar's selected day to be today;
-        </li></ul></div></div><div class="sect3" lang="en"><div 
class="titlepage"><div><div><h4 class="title"><a 
name="calendar-help-menu"></a>The Help menu</h4></div></div></div><div 
class="figure"><a name="calendar-help-menu-fig"></a><p 
class="title"><b>Figure�6.�Help menu in the calendar window</b></p><div 
class="screenshot"><div class="mediaobject"><img 
src="images/orage_calendar_help_menu.png" alt="
-                The Help menu in the calendar window.
-              "></div></div></div><p>
+        </li></ul></div></div><div class="sect3" lang="en"><div 
class="titlepage"><div><div><h4 class="title"><a 
name="calendar-help-menu"></a>The Help menu</h4></div></div></div><div 
class="figure"><a name="calendar-help-menu-fig"></a><p 
class="title"><b>Figure�6.�Help menu in the calendar window</b></p><div 
class="figure-contents"><div class="screenshot"><div class="mediaobject"><img 
src="images/orage_calendar_help_menu.png" alt="The Help menu in the calendar 
window."></div></div></div></div><br class="figure-break"><p>
         The Help menu has also two choices:
       </p><div class="itemizedlist"><ul type="disc"><li>
           Help: show this help file;
@@ -90,9 +78,7 @@
       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><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="screenshot"><div class="mediaobject"><img 
src="images/orage_eventlist.png" alt="
-            The event list window.
-          "></div></div></div><p>
+    </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
     heading in your locale format).
@@ -220,9 +206,7 @@
         Title: the heading of the appointment. Note that the whole title is
         shown, so you may want to avoid using too long titles to keep the view
         cleaner.
-      </li></ul></div></div></div><div class="sect1" lang="en"><div 
class="titlepage"><div><div><h2 class="title" style="clear: both"><a 
name="orage-daylist-window"></a>The day list window</h2></div></div></div><div 
class="figure"><a name="orage-daylist-fig"></a><p 
class="title"><b>Figure�8.�Orage day list window</b></p><div 
class="screenshot"><div class="mediaobject"><img src="images/orage_daylist.png" 
alt="
-            The day list window.
-          "></div></div></div><p>
+      </li></ul></div></div></div><div class="sect1" lang="en"><div 
class="titlepage"><div><div><h2 class="title" style="clear: both"><a 
name="orage-daylist-window"></a>The day list window</h2></div></div></div><div 
class="figure"><a name="orage-daylist-fig"></a><p 
class="title"><b>Figure�8.�Orage day list window</b></p><div 
class="figure-contents"><div class="screenshot"><div class="mediaobject"><img 
src="images/orage_daylist.png" alt="The day list 
window."></div></div></div></div><br class="figure-break"><p>
     The day list window shows all events that you have reserved for the
     next days. Default is to show 7 days, but you can change that and see
     up to 40 days at once.
@@ -254,7 +238,7 @@
       <a href="#orage-eventlist-window" title="The event list window">event 
list window</a>
       for that day. First line contains full day events when defined. The other
       lines contain events that you have scheduled. Each event has tooltip
-      which include appointments details. You can update the event by double
+      which include appointment details. You can update the event by double
       clicking it. Events are placed on the start time row and even if the 
       length is several hours, the event is only visible on single row. If
       the event is taking time (availability=Busy), there is vertical line
@@ -285,9 +269,7 @@
       </li><li>
         Delete: remove current appointment permanently from orage
         system.
-      </li></ul></div></div><div class="sect2" lang="en"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="appointment-general-tab"></a>The general tab</h3></div></div></div><div 
class="figure"><a name="orage-appointment-fig"></a><p 
class="title"><b>Figure�9.�Orage appointment window - general tab</b></p><div 
class="screenshot"><div class="mediaobject"><img 
src="images/orage_appointment.png" alt="
-              The appointment window.
-            "></div></div></div><p>
+      </li></ul></div></div><div class="sect2" lang="en"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="appointment-general-tab"></a>The general tab</h3></div></div></div><div 
class="figure"><a name="orage-appointment-fig"></a><p 
class="title"><b>Figure�9.�Orage appointment window - general tab</b></p><div 
class="figure-contents"><div class="screenshot"><div class="mediaobject"><img 
src="images/orage_appointment.png" alt="The appointment 
window."></div></div></div></div><br class="figure-break"><p>
       In this tab, you define the contents of the appointment.
     </p><div class="variablelist"><dl><dt><span 
class="term">Type</span></dt><dd><p>
             Orage can handle three types of appointments: 
@@ -379,9 +361,7 @@
             Free format text, where you can and should explain more
             the appointment. It is shown in the alarm window. Scrollbars
             appear when needed.
-          </p></dd></dl></div></div><div class="sect2" lang="en"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="appointment-alarm-tab"></a>The alarm tab</h3></div></div></div><div 
class="figure"><a name="orage-appointment-alarm-fig"></a><p 
class="title"><b>Figure�10.�Orage appointment window - alarm tab</b></p><div 
class="screenshot"><div class="mediaobject"><img 
src="images/orage_appointment_alarm.png" alt="
-              The appointment alarm tab.
-            "></div></div></div><p>
+          </p></dd></dl></div></div><div class="sect2" lang="en"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="appointment-alarm-tab"></a>The alarm tab</h3></div></div></div><div 
class="figure"><a name="orage-appointment-alarm-fig"></a><p 
class="title"><b>Figure�10.�Orage appointment window - alarm tab</b></p><div 
class="figure-contents"><div class="screenshot"><div class="mediaobject"><img 
src="images/orage_appointment_alarm.png" alt="The appointment alarm 
tab."></div></div></div></div><br class="figure-break"><p>
       In this tab, you define the alarm for the appointment. <strong 
class="application"><code>orage</code></strong> supports 
       three kinds of alarms: window, sound and procedure, but they all happen
       at the same time. It is possible to define only one alarm time for each
@@ -439,9 +419,7 @@
             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></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="screenshot"><div class="mediaobject"><img 
src="images/orage_appointment_recurrence.png" alt="
-              The appointment recurrence tab.
-            "></div></div></div><p>
+          </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
       of creating a new appointment for each event. Note that <strong 
class="application"><code>orage</code></strong> does not 
@@ -521,9 +499,7 @@
     files as they are (foreign). It is also possible to export appointments
     from <strong class="application"><code>orage</code></strong> to operating 
system files and change the names of <strong 
class="application"><code>orage</code></strong> data
     files.
-  </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 
class="title"><a name="exchange-impexp-tab"></a>The import export 
tab</h3></div></div></div><div class="figure"><a 
name="orage-exchange-impexp-fig"></a><p class="title"><b>Figure�12.�Orage 
exchange window - import/export tab</b></p><div class="screenshot"><div 
class="mediaobject"><img src="images/orage_exchange_impexp.png" alt="
-              The exchange data import export tab.
-            "></div></div></div><div class="variablelist"><dl><dt><span 
class="term">Import</span></dt><dd><p>
+  </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 
class="title"><a name="exchange-impexp-tab"></a>The import export 
tab</h3></div></div></div><div class="figure"><a 
name="orage-exchange-impexp-fig"></a><p class="title"><b>Figure�12.�Orage 
exchange window - import/export tab</b></p><div class="figure-contents"><div 
class="screenshot"><div class="mediaobject"><img 
src="images/orage_exchange_impexp.png" alt="The exchange data import export 
tab."></div></div></div></div><br class="figure-break"><div 
class="variablelist"><dl><dt><span class="term">Import</span></dt><dd><p>
             Enter the name of the file which you want to copy into <strong 
class="application"><code>orage</code></strong>.
             You can do several files in a row by separating names with comma.
             After you hae the file name in place, press Save and <strong 
class="application"><code>orage</code></strong> reads
@@ -546,9 +522,7 @@
             <strong class="application"><code>orage</code></strong> file or 
force archiving. It is good idea to revert archive
             if you do exports since export does not look data from archive
             file.
-          </p></dd></dl></div></div><div class="sect2" lang="en"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="exchange-oragefiles-tab"></a>The orage files 
tab</h3></div></div></div><div class="figure"><a 
name="orage-exchange-oragefiles-fig"></a><p class="title"><b>Figure�13.�Orage 
exchange window - orage files tab</b></p><div class="screenshot"><div 
class="mediaobject"><img src="images/orage_exchange_oragefiles.png" alt="
-              The exchange data orage files tab.
-            "></div></div></div><div class="variablelist"><dl><dt><span 
class="term">Orage files</span></dt><dd><p>
+          </p></dd></dl></div></div><div class="sect2" lang="en"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="exchange-oragefiles-tab"></a>The orage files 
tab</h3></div></div></div><div class="figure"><a 
name="orage-exchange-oragefiles-fig"></a><p class="title"><b>Figure�13.�Orage 
exchange window - orage files tab</b></p><div class="figure-contents"><div 
class="screenshot"><div class="mediaobject"><img 
src="images/orage_exchange_oragefiles.png" alt="The exchange data orage files 
tab."></div></div></div></div><br class="figure-break"><div 
class="variablelist"><dl><dt><span class="term">Orage files</span></dt><dd><p>
             It is possible to relocate and rename both active <strong 
class="application"><code>orage</code></strong> file
             and the passive archive file. Pressing save does the actual action.
             There are 3 options for these actions:
@@ -566,9 +540,7 @@
                 internal rename described above. Note that the original file
                 does not exist in the original place anymore after this change.
               </li></ul></div><p>
-          </p></dd></dl></div></div><div class="sect2" lang="en"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="exchange-foreign-tab"></a>The foreign files 
tab</h3></div></div></div><div class="figure"><a 
name="orage-exchange-foreign-fig"></a><p class="title"><b>Figure�14.�Orage 
exchange window - foreign files tab</b></p><div class="screenshot"><div 
class="mediaobject"><img src="images/orage_exchange_foreign.png" alt="
-              The exchange data foreign files tab.
-            "></div></div></div><div class="variablelist"><dl><dt><span 
class="term">Foreign files</span></dt><dd><p>
+          </p></dd></dl></div></div><div class="sect2" lang="en"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="exchange-foreign-tab"></a>The foreign files 
tab</h3></div></div></div><div class="figure"><a 
name="orage-exchange-foreign-fig"></a><p class="title"><b>Figure�14.�Orage 
exchange window - foreign files tab</b></p><div class="figure-contents"><div 
class="screenshot"><div class="mediaobject"><img 
src="images/orage_exchange_foreign.png" alt="The exchange data foreign files 
tab."></div></div></div></div><br class="figure-break"><div 
class="variablelist"><dl><dt><span class="term">Foreign files</span></dt><dd><p>
             <strong class="application"><code>orage</code></strong> can 
include and maintain other than its main data file.
             It is possible to add (and remove) so called foreign files. They
             behave similarly than base data file, but they remain isolated, 
@@ -588,9 +560,7 @@
     You can define for example several display options, how old appointments
     should be archived and what is the play command to be used for playing
     sound alarms and also you can set the local timezone for <strong 
class="application"><code>orage</code></strong>.
-  </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 
class="title"><a name="preferences-main-tab"></a>The main 
tab</h3></div></div></div><div class="figure"><a 
name="orage-preferences-main-fig"></a><p class="title"><b>Figure�15.�Orage 
preferences window - main tab</b></p><div class="screenshot"><div 
class="mediaobject"><img src="images/orage_preferences_main.png" alt="
-              The preferences main tab.
-            "></div></div></div><div class="variablelist"><dl><dt><span 
class="term">Timezone</span></dt><dd><p>
+  </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 
class="title"><a name="preferences-main-tab"></a>The main 
tab</h3></div></div></div><div class="figure"><a 
name="orage-preferences-main-fig"></a><p class="title"><b>Figure�15.�Orage 
preferences window - main tab</b></p><div class="figure-contents"><div 
class="screenshot"><div class="mediaobject"><img 
src="images/orage_preferences_main.png" alt="The preferences main 
tab."></div></div></div></div><br class="figure-break"><div 
class="variablelist"><dl><dt><span class="term">Timezone</span></dt><dd><p>
             You should always set the default timezone for <strong 
class="application"><code>orage</code></strong>. It is
             possible to use also floating times, but then all times should be
             in floating form. It is a bad idea to mix floating and timezone
@@ -627,9 +597,7 @@
             <strong class="application"><code>orage</code></strong> really 
only starts this program and gives it
             <a href="#appointment-alarm-tab" title="The alarm tab">the sound 
file</a>
             as parameter. But this is not the intention of this feature.
-          </p></dd></dl></div></div><div class="sect2" lang="en"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="preferences-display-tab"></a>The display tab</h3></div></div></div><div 
class="figure"><a name="orage-preferences-display-fig"></a><p 
class="title"><b>Figure�16.�Orage preferences window - display tab</b></p><div 
class="screenshot"><div class="mediaobject"><img 
src="images/orage_preferences_display.png" alt="
-              The preferences display tab.
-            "></div></div></div><p>
+          </p></dd></dl></div></div><div class="sect2" lang="en"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="preferences-display-tab"></a>The display tab</h3></div></div></div><div 
class="figure"><a name="orage-preferences-display-fig"></a><p 
class="title"><b>Figure�16.�Orage preferences window - display tab</b></p><div 
class="figure-contents"><div class="screenshot"><div class="mediaobject"><img 
src="images/orage_preferences_display.png" alt="The preferences display 
tab."></div></div></div></div><br class="figure-break"><p>
       In this tab you can define visibility options for the 
       <a href="#orage-calendar-window" title="The calendar window">main 
window</a> of <strong class="application"><code>orage</code></strong>.
     </p><div class="variablelist"><dl><dt><span class="term">Show 
borders</span></dt><dd><p>
@@ -658,9 +626,7 @@
           </p></dd><dt><span class="term">Calendar start</span></dt><dd><p>
             It is possible to define that <strong 
class="application"><code>orage</code></strong> starts in the background or
             as minimized. This option only affects the start of <strong 
class="application"><code>orage</code></strong>.
-          </p></dd></dl></div></div><div class="sect2" lang="en"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="preferences-extra-tab"></a>The extra tab</h3></div></div></div><div 
class="figure"><a name="orage-preferences-extra-fig"></a><p 
class="title"><b>Figure�17.�Orage preferences window - extra tab</b></p><div 
class="screenshot"><div class="mediaobject"><img 
src="images/orage_preferences_extra.png" alt="
-              The preferences extra tab.
-            "></div></div></div><div class="variablelist"><dl><dt><span 
class="term">Select always today</span></dt><dd><p>
+          </p></dd></dl></div></div><div class="sect2" lang="en"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="preferences-extra-tab"></a>The extra tab</h3></div></div></div><div 
class="figure"><a name="orage-preferences-extra-fig"></a><p 
class="title"><b>Figure�17.�Orage preferences window - extra tab</b></p><div 
class="figure-contents"><div class="screenshot"><div class="mediaobject"><img 
src="images/orage_preferences_extra.png" alt="The preferences extra 
tab."></div></div></div></div><br class="figure-break"><div 
class="variablelist"><dl><dt><span class="term">Select always 
today</span></dt><dd><p>
             Controls which day is selected after <strong 
class="application"><code>orage</code></strong> main
         <a href="#orage-calendar-window" title="The calendar window">calendar 
window</a> is hidden
             and comes visible again (for example by clicking orageclock panel
@@ -720,19 +686,22 @@
           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>
     Some common questions and answers.
-  </p><tr class="qandadiv"><td align="left" valign="top" colspan="2"><a 
name="id2516060"></a><h4 class="title"><a name="id2516060"></a>1. Frequently 
Asked Questions</h4></td></tr><tr class="toc" colspan="2"><td align="left" 
valign="top" colspan="2"><dl><dt>1.1. <a href="#id2516065">
+  </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">
           Why does my week start on Saturday?
-        </a></dt><dt>1.2. <a href="#id2516164">
+        </a></dt><dt>1.2. <a href="#id2554472">
           How can I insert my ical file into orage?
-        </a></dt><dt>1.3. <a href="#id2516204">
+        </a></dt><dt>1.3. <a href="#id2554513">
           How can skip my repeating appointment from happening during some 
           period of time?
-        </a></dt><dt>1.4. <a href="#id2516237">
+        </a></dt><dt>1.4. <a href="#id2554545">
           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></dl></td></tr><tr class="question"><td align="left" 
valign="top"><a name="id2516065"></a><a 
name="id2516067"></a><b>1.1.</b></td><td align="left" valign="top"><p>
+        </a></dt><dt>1.5. <a href="#id2554598">
+          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>
           Why does my week start on Saturday?
-        </p></td></tr><tr class="answer"><td align="left" 
valign="top"><b></b></td><td align="left" valign="top"><p>
+        </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
           operating system reports these to GTK+ and hence to <strong 
class="application"><code>orage</code></strong>, which
           uses strictly gtk calendar widget and does not tune these settings
@@ -756,18 +725,18 @@
           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="id2516164"></a><a name="id2516166"></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="id2554472"></a><a name="id2554474"></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"><b></b></td><td align="left" valign="top"><p>
+        </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
           a foreign file and <strong 
class="application"><code>orage</code></strong> will use it. Or you can import 
the file
           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="id2516204"></a><a name="id2516206"></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="id2554513"></a><a name="id2554515"></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"><b></b></td><td align="left" valign="top"><p>
+        </p></td></tr><tr class="answer"><td align="left" 
valign="top"></td><td align="left" valign="top"><p>
           This is common requirement. You may for example have work related
           meetings happening every week and when you are on holiday you would
           not like to get alarmed by those nor would you like to see those.
@@ -775,13 +744,31 @@
           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="id2516237"></a><a name="id2516239"></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="id2554545"></a><a name="id2554548"></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"><b></b></td><td align="left" valign="top"><p>
+        </p></td></tr><tr class="answer"><td align="left" 
valign="top"></td><td align="left" valign="top"><p>
           You should file a bug into
           <a href="http://bugzilla.xfce.org/"; target="_top">Xfce bugzilla
           </a>
           or send an email to 
-          <code class="email">&lt;<a href="mailto:[EMAIL PROTECTED]">[EMAIL 
PROTECTED]</a>&gt;</code> Xfce development.
+          <code class="email">&lt;<a href="mailto:[EMAIL PROTECTED]">[EMAIL 
PROTECTED]</a>&gt;</code> Xfce development. Please, remember
+          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>
+          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>
+          <strong class="application"><code>orage</code></strong> 4.5 uses 
different default location for appointments than
+          the previous version. And there is no automatic upgrade partly
+          because it is safer to leave the old data as it is in case you need
+          revert back. <strong class="application"><code>orage</code></strong> 
4.5 appointments are not compatible with older 
+          <strong class="application"><code>orage</code></strong>. You can 
however copy your old file to the new place or export
+          its contents. You can do that either manually from operating system
+          (make sure <strong class="application"><code>orage</code></strong> 
is not running) or using the interface menus.
+          Old default location is 
+          ~/.config/xfce4/orage/orage.ics
+          and new location is
+          ~/.local/share/orage/orage.ics
         </p></td></tr></div></div></body></html>

Modified: xfcalendar/trunk/doc/C/orage.xml
===================================================================
--- xfcalendar/trunk/doc/C/orage.xml    2008-02-26 14:24:13 UTC (rev 26643)
+++ xfcalendar/trunk/doc/C/orage.xml    2008-02-26 15:16:10 UTC (rev 26644)
@@ -1677,6 +1677,29 @@
         </para>
       </answer>
     </qandaentry>
+    <qandaentry>
+      <question>
+        <para>
+          I upgraded to Orage 4.5 from Orage 4.4 and now my old appointments 
+          are missing. Are they permanetly lost?
+        </para>
+      </question>
+      <answer>
+        <para>
+          &app; 4.5 uses different default location for appointments than
+          the previous version. And there is no automatic upgrade partly
+          because it is safer to leave the old data as it is in case you need
+          revert back. &app; 4.5 appointments are not compatible with older 
+          &app;. You can however copy your old file to the new place or export
+          its contents. You can do that either manually from operating system
+          (make sure &app; is not running) or using the interface menus.
+          Old default location is 
+          ~/.config/xfce4/orage/orage.ics
+          and new location is
+          ~/.local/share/orage/orage.ics
+        </para>
+      </answer>
+    </qandaentry>
   </qandadiv>
 </sect1>
 <!--

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

Reply via email to