From 6ce12bfedf635cf5315aa854bae76a0d509bb786 Mon Sep 17 00:00:00 2001
From: Frederic Culot <calcurse@culot.org>
Date: Sun, 21 Sep 2008 14:08:59 +0000
Subject: manpage, manuals and translations updated for 2.3_beta

---
 doc/manual_de.html | 103 +++++++++++++++++++++++++++++++++++++++++++++++++----
 doc/manual_en.html |  73 +++++++++++++++++++++++++++++++++----
 doc/manual_es.html |  77 +++++++++++++++++++++++++++++++++++----
 doc/manual_fr.html |  75 +++++++++++++++++++++++++++++++++++---
 doc/manual_it.html |  76 ++++++++++++++++++++++++++++++++++++---
 doc/manual_nl.html |  77 +++++++++++++++++++++++++++++++++++----
 6 files changed, 447 insertions(+), 34 deletions(-)

(limited to 'doc')
diff --git a/doc/manual_de.html b/doc/manual_de.html
index 2c56961..90790c5 100755
--- a/doc/manual_de.html
+++ b/doc/manual_de.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <!--
 /*
- *	$calcurse: manual_de.html,v 1.19 2008/08/11 18:08:45 culot Exp $
+ *	$calcurse: manual_de.html,v 1.20 2008/09/21 14:08:59 culot Exp $
  *
  * Calcurse - text-based organizer
  * Copyright (c) 2004-2008 Frederic Culot
@@ -86,7 +86,12 @@ well as the way one can contribute to <code>calcurse</code> development.
 	    <li><a href="#basics_interface_interactive">4.2.2 Interaktiver Modus</a></li>
 	</ul></li>
 	<li><a href="#basics_files">4.3 <code>calcurse</code> Dateien</a></li>
-	<li><a href="#basics_help">4.4 Onlinehilfe</a></li>
+        <li><a href="#basics_import_export"><span class="todo">4.4 Import/Export capabilities</span></a>
+        <ul>
+            <li><a href="#basics_import"><span class="todo">4.4.1 Import</span></a></li>
+            <li><a href="#basics_export"><span class="todo">4.4.2 Export</span></a></li>
+        </ul></li>
+	<li><a href="#basics_help">4.5 Onlinehilfe</a></li>
     </ul></li>
     <li><a href="#options">5. Optionen</a>
     <ul>
@@ -233,7 +238,7 @@ laden:</p>
 <h2>3.2 Installationsprozess<a name="install_process"></a></h2>
 <p>
 Als erstes m&uuml;ssen die Dateien entpackt werden:</p>
-<pre>tar zxvf calcurse-2.2.tar.gz</pre>
+<pre>tar zxvf calcurse-2.3.tar.gz</pre>
 <p>
 Ist diese Voraussetzung erf&uuml;llt und das Archiv entpackt,
 sind nur noch die drei &uuml;blichen Schritte erforderlich:</p>
@@ -291,6 +296,12 @@ Es werden sowohl kurze als auch lange Optionsangaben unterst&uuml;tzt.</p>
     <dt><code>-h, --help</code></dt>
     <dd>Gibt eine Hilfe zu den unterst&uuml;tzten Optionen aus.
     </dd>
+    <dt><code>-i &lt;file&gt;, --import &lt;file&gt;</code></dt>
+    <dd>
+    <div class="todo">
+    Import the icalendar data contained in <code>file</code>.
+    </div>
+    </dd>
     <dt><code>-n, --next</code></dt>
     <dd>Gibt den Termin aus, der innerhalb der kommenden 24 Stunden als 
     n&auml;chstes stattfindet.
@@ -550,7 +561,87 @@ $HOME/.calcurse/
         <dd>Datei enth&auml;lt die todo-Liste.</dd>
 </dl>
 
-<h2>4.4 Online Hilfe<a name="basics_help"></a></h2>
+<h2>4.3 <code>calcurse</code> files<a name="basics_files"></a></h2>
+<p>
+        The following structure is created in your <code>$HOME</code>  
+	directory (or in the directory you specified with  the  -D  option)
+        the first time <code>calcurse</code> is run :</p>
+	<pre>
+$HOME/.calcurse/
+           |___notes/
+           |___conf
+           |___apts
+           |___todo
+        </pre>
+	<dl class="compact">
+		<dt><code>notes/</code>:</dt>
+		<dd>this subdirectory contains descriptions of the notes 
+		which are attached to appointments, events or todos. One text file is
+		created per note, whose name is built using mkstemp(3) and should be
+		unique, but with no relation with the corresponding item's description.</dd>
+		<dt><code>conf</code>:</dt>
+	        <dd>this file contains the user configuration</dd>
+		<dt><code>apts</code>:</dt>
+	        <dd>this file contains  all  of the events and user's appointments</dd>
+		<dt><code>todo</code>:</dt>
+	        <dd>this file contains the todo list</dd>
+	</dl>
+
+<div class="todo">
+<h2>4.4 Import/Export capabilities<a name="basics_import_export"></a></h2>
+<p>
+        The import and export capabilities offered by <code>calcurse</code>
+        are described below.
+</p>
+
+<h3>4.4.1 Import<a name="basics_import"></a></h3>
+<p>
+        Data in icalendar format as described in the rfc2445 specification
+        (see <a href="#links_others">links</a> section below) can be imported
+        into calcurse. Calcurse ical parser is based on version 2.0 of this 
+        specification, but for now on, only a subset of it is supported.
+</p>
+<p>
+        The following icalendar properties are handled by calcurse:
+        <ul>
+            <li><code>VTODO</code> items:<br>
+            "PRIORITY", "VALARM", "SUMMARY", "DESCRIPTION"</li>
+            <li><code>VEVENT</code> items:<br>
+            "DTSTART", "DTEND", "DURATION", "RRULE", "EXDATE", "VALARM", "SUMMARY",
+            "DESCRIPTION"</li>
+        </ul>
+</p>
+<p>
+        The icalendar "DESCRIPTION" property will be converted into calcurse format
+        by adding a note to the item. If a "VALARM" property is found, the item
+        will be flagged as important and the user will get a notification (this is
+        only applicable to appointments).
+</p>
+<p>
+        Here are the properties that are not implemented:
+        <ul>
+            <li>negative time durations are not taken into account (item is skipped)</li>
+            <li>some recurence frequences are not recognize:<br>
+            "SECONDLY" / "MINUTELY" / "HOURLY"</li>
+            <li>some recurrence keywords are not recognized 
+            (all those starting with 'BY'):<br>
+            "BYSECOND" / "BYMINUTE" / "BYHOUR" / "BYDAY" / "BYMONTHDAY"<br>
+            "BYYEARDAY" / "BYWEEKNO" / "BYMONTH" / "BYSETPOS"<br>
+            plus "WKST"</li>
+            <li>the recurrence exception keyword "EXRULE" is not recognized</li>
+            <li>timezones are not taken into account</li>
+        </ul>
+</p>
+
+<h3>4.4.2 Export<a name="basics_export"></a></h3>
+<p>
+        Two possible export formats are available: <code>ical</code> and 
+        <code>pcal</code> (see section <a href="#links_others">Links</a> below
+        to find out about those formats). 
+</p>
+</div>
+
+<h2>4.5 Online Hilfe<a name="basics_help"></a></h2>
 <p>
 Das integrierte Hilfe-System kann jederzeit mit '?' aufgerufen
 werden. Informationen &uuml;ber bestimmte Befehle k&ouml;nnen mit der
@@ -1024,10 +1115,10 @@ Und zuletzt, vielen vielen Dank an alle <code>calcurse</code>
 Benutzer, die mir Ihr Feedback mitgeteilt haben.</p>
 
 <div class="footer">
-	Copyright (c) 2004-2008 Fr&eacute;d&eacute;ric Culot<br>
+	Copyright (c) 2004-2008 Frédéric Culot<br>
 	German translation by Michael Schulz
 	<code>&lt;bloodshower .at. web .dot. de&gt;</code>, and Chris.<br>
-	Calcurse version 2.2 - Last change: August 11, 2008<br>
+	Calcurse version 2.3 - Last change: September 21, 2008<br>
 </div>
 </div>
 
diff --git a/doc/manual_en.html b/doc/manual_en.html
index 8daaf36..62598d7 100755
--- a/doc/manual_en.html
+++ b/doc/manual_en.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <!--
 /*
- *	$calcurse: manual_en.html,v 1.19 2008/08/11 18:08:45 culot Exp $
+ *	$calcurse: manual_en.html,v 1.20 2008/09/21 14:08:59 culot Exp $
  *
  * Calcurse - text-based organizer
  * Copyright (c) 2004-2008 Frederic Culot
@@ -83,7 +83,12 @@ well as the way one can contribute to <code>calcurse</code> development.
 	    <li><a href="#basics_interface_interactive">4.2.2 Interactive mode</a></li>
 	</ul></li>
 	<li><a href="#basics_files">4.3 <code>calcurse</code> files</a></li>
-	<li><a href="#basics_help">4.4 Online help</a></li>
+        <li><a href="#basics_import_export">4.4 Import/Export capabilities</a>
+        <ul>
+            <li><a href="#basics_import">4.4.1 Import</a></li>
+            <li><a href="#basics_export">4.4.2 Export</a></li>
+        </ul></li>
+	<li><a href="#basics_help">4.5 Online help</a></li>
     </ul></li>
     <li><a href="#options">5. Options</a>
     <ul>
@@ -231,7 +236,7 @@ All of the commands are documented within an online help system.
 <h2>3.2 Install process<a name="install_process"></a></h2>
 <p>
 	First you need to gunzip and untar the source archive:</p>
-	<pre>tar zxvf calcurse-2.2.tar.gz</pre>
+	<pre>tar zxvf calcurse-2.3.tar.gz</pre>
 <p>
   	Once you meet the requirements and have extracted the archive, 
 	the install process is quite simple, and follows the standard 
@@ -300,6 +305,10 @@ All of the commands are documented within an online help system.
 	    <dd>
 	    Print  a  short  help  text  describing  the  supported
 	    command-line options, and exit.</dd>
+            <dt><code>-i &lt;file&gt;, --import &lt;file&gt;</code></dt>
+            <dd>
+            Import the icalendar data contained in <code>file</code>.
+            </dd>
 	    <dt><code>-n, --next</code></dt>
 	    <dd>
 	    Print the next appointment within upcoming 24 hours and exit.
@@ -559,7 +568,59 @@ $HOME/.calcurse/
 	        <dd>this file contains the todo list</dd>
 	</dl>
 
-<h2>4.4 Online help<a name="basics_help"></a></h2>
+<h2>4.4 Import/Export capabilities<a name="basics_import_export"></a></h2>
+<p>
+        The import and export capabilities offered by <code>calcurse</code>
+        are described below.
+</p>
+
+<h3>4.4.1 Import<a name="basics_import"></a></h3>
+<p>
+        Data in icalendar format as described in the rfc2445 specification
+        (see <a href="#links_others">links</a> section below) can be imported
+        into calcurse. Calcurse ical parser is based on version 2.0 of this 
+        specification, but for now on, only a subset of it is supported.
+</p>
+<p>
+        The following icalendar properties are handled by calcurse:
+        <ul>
+            <li><code>VTODO</code> items:<br>
+            "PRIORITY", "VALARM", "SUMMARY", "DESCRIPTION"</li>
+            <li><code>VEVENT</code> items:<br>
+            "DTSTART", "DTEND", "DURATION", "RRULE", "EXDATE", "VALARM", "SUMMARY",
+            "DESCRIPTION"</li>
+        </ul>
+</p>
+<p>
+        The icalendar "DESCRIPTION" property will be converted into calcurse format
+        by adding a note to the item. If a "VALARM" property is found, the item
+        will be flagged as important and the user will get a notification (this is
+        only applicable to appointments).
+</p>
+<p>
+        Here are the properties that are not implemented:
+        <ul>
+            <li>negative time durations are not taken into account (item is skipped)</li>
+            <li>some recurence frequences are not recognize:<br>
+            "SECONDLY" / "MINUTELY" / "HOURLY"</li>
+            <li>some recurrence keywords are not recognized 
+            (all those starting with 'BY'):<br>
+            "BYSECOND" / "BYMINUTE" / "BYHOUR" / "BYDAY" / "BYMONTHDAY"<br>
+            "BYYEARDAY" / "BYWEEKNO" / "BYMONTH" / "BYSETPOS"<br>
+            plus "WKST"</li>
+            <li>the recurrence exception keyword "EXRULE" is not recognized</li>
+            <li>timezones are not taken into account</li>
+        </ul>
+</p>
+
+<h3>4.4.2 Export<a name="basics_export"></a></h3>
+<p>
+        Two possible export formats are available: <code>ical</code> and 
+        <code>pcal</code> (see section <a href="#links_others">Links</a> below
+        to find out about those formats). 
+</p>
+
+<h2>4.5 Online help<a name="basics_help"></a></h2>
 <p>
         At any time, the built-in help  system  can  be  invoked  by
         pressing the '?'  key. Once viewing the help screens,
@@ -1064,8 +1125,8 @@ msgid ""
         users who sent me their feedback.</p>
 
 <div class="footer">
-	Copyright (c) 2004-2008 Fr&eacute;d&eacute;ric Culot<br>
-	Calcurse version 2.2 - Last change: August 11, 2008<br>
+	Copyright (c) 2004-2008 Frédéric Culot<br>
+	Calcurse version 2.3 - Last change: September 21, 2008<br>
 </div>
 </div>
 
diff --git a/doc/manual_es.html b/doc/manual_es.html
index 0b46ac5..2624051 100755
--- a/doc/manual_es.html
+++ b/doc/manual_es.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <!--
 /*
- *	$calcurse: manual_es.html,v 1.16 2008/08/11 18:08:45 culot Exp $
+ *	$calcurse: manual_es.html,v 1.17 2008/09/21 14:08:59 culot Exp $
  *
  * Calcurse - text-based organizer
  * Copyright (c) 2004-2008 Frederic Culot
@@ -86,7 +86,12 @@ well as the way one can contribute to <code>calcurse</code> development.
 	    <li><a href="#basics_interface_interactive">4.2.2 Modo interactivo</a></li>
 	</ul></li>
 	<li><a href="#basics_files">4.3 Archivos de <code>calcurse</code></a></li>
-	<li><a href="#basics_help">4.4 Ayuda en linea</a></li>
+        <li><a href="#basics_import_export"><span class="todo">4.4 Import/Export capabilities</span></a>
+        <ul>
+            <li><a href="#basics_import"><span class="todo">4.4.1 Import</span></a></li>
+            <li><a href="#basics_export"><span class="todo">4.4.2 Export</span></a></li>
+        </ul></li>
+	<li><a href="#basics_help">4.5 Ayuda en linea</a></li>
     </ul></li>
     <li><a href="#options">5. Opciones</a>
     <ul>
@@ -231,7 +236,7 @@ well as the way one can contribute to <code>calcurse</code> development.
 <h2>3.2 Proceso de instalación<a name="install_process"></a></h2>
 <p>
 	Primero necesitas descomprimir ( gunzip  y  untar) el archivo fuente:</p>
-	<pre>tar zxvf calcurse-2.2.tar.gz</pre>
+	<pre>tar zxvf calcurse-2.3.tar.gz</pre>
 <p>
   	Una vez has resuelto los requisitos y has extraído el archivo, 
 	el proceso de instalación es muy simple y sigue los tres pasos habituales:
@@ -299,6 +304,12 @@ well as the way one can contribute to <code>calcurse</code> development.
 	    Imprime un breve texto de ayuda describiendo las opciones soportadas en la
 	    linea de comando y sale.
 	    </dd>
+            <dt><code>-i &lt;file&gt;, --import &lt;file&gt;</code></dt>
+            <dd>
+            <div class="todo">
+            Import the icalendar data contained in <code>file</code>.
+            </div>
+            </dd>
 	    <dt><code>-n, --next</code></dt>
 	    <dd>
 	    Imprime las citas para las próximas 24 horas y sale.
@@ -562,7 +573,61 @@ $HOME/.calcurse/
 		<dd>contiene la lista de tareas pendientes.</dd>
 	</dl>
 
-<h2>4.4 Ayuda en linea<a name="basics_help"></a></h2>
+<div class="todo">
+<h2>4.4 Import/Export capabilities<a name="basics_import_export"></a></h2>
+<p>
+        The import and export capabilities offered by <code>calcurse</code>
+        are described below.
+</p>
+
+<h3>4.4.1 Import<a name="basics_import"></a></h3>
+<p>
+        Data in icalendar format as described in the rfc2445 specification
+        (see <a href="#links_others">links</a> section below) can be imported
+        into calcurse. Calcurse ical parser is based on version 2.0 of this 
+        specification, but for now on, only a subset of it is supported.
+</p>
+<p>
+        The following icalendar properties are handled by calcurse:
+        <ul>
+            <li><code>VTODO</code> items:<br>
+            "PRIORITY", "VALARM", "SUMMARY", "DESCRIPTION"</li>
+            <li><code>VEVENT</code> items:<br>
+            "DTSTART", "DTEND", "DURATION", "RRULE", "EXDATE", "VALARM", "SUMMARY",
+            "DESCRIPTION"</li>
+        </ul>
+</p>
+<p>
+        The icalendar "DESCRIPTION" property will be converted into calcurse format
+        by adding a note to the item. If a "VALARM" property is found, the item
+        will be flagged as important and the user will get a notification (this is
+        only applicable to appointments).
+</p>
+<p>
+        Here are the properties that are not implemented:
+        <ul>
+            <li>negative time durations are not taken into account (item is skipped)</li>
+            <li>some recurence frequences are not recognize:<br>
+            "SECONDLY" / "MINUTELY" / "HOURLY"</li>
+            <li>some recurrence keywords are not recognized 
+            (all those starting with 'BY'):<br>
+            "BYSECOND" / "BYMINUTE" / "BYHOUR" / "BYDAY" / "BYMONTHDAY"<br>
+            "BYYEARDAY" / "BYWEEKNO" / "BYMONTH" / "BYSETPOS"<br>
+            plus "WKST"</li>
+            <li>the recurrence exception keyword "EXRULE" is not recognized</li>
+            <li>timezones are not taken into account</li>
+        </ul>
+</p>
+
+<h3>4.4.2 Export<a name="basics_export"></a></h3>
+<p>
+        Two possible export formats are available: <code>ical</code> and 
+        <code>pcal</code> (see section <a href="#links_others">Links</a> below
+        to find out about those formats). 
+</p>
+</div>
+
+<h2>4.5 Ayuda en linea<a name="basics_help"></a></h2>
 <p>
         En cualquier momento, puedes consultar el sistema de ayuda integrado 
         presionando la tecla '?'. Una vez en la pantalla de ayuda,
@@ -1042,10 +1107,10 @@ msgid ""
         que me han enviado sus comentarios.</p>
 
 <div class="footer">
-	Copyright (c) 2004-2008 Fr&eacute;d&eacute;ric Culot<br>
+	Copyright (c) 2004-2008 Frédéric Culot<br>
 	Traducido al Español por José López
 	<code>&lt;testinground .at. gmail .dot. com&gt;</code><br>
-	Calcurse version 2.2 - Last change: August 11, 2008<br>
+	Calcurse version 2.3 - Last change: September 21, 2008<br>
 </div>
 </div>
 
diff --git a/doc/manual_fr.html b/doc/manual_fr.html
index 00d019a..a1cea1e 100755
--- a/doc/manual_fr.html
+++ b/doc/manual_fr.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <!--
 /*
- *	$calcurse: manual_fr.html,v 1.20 2008/08/11 18:08:45 culot Exp $
+ *	$calcurse: manual_fr.html,v 1.21 2008/09/21 14:08:59 culot Exp $
  *
  * Calcurse - text-based organizer
  * Copyright (c) 2004-2008 Frederic Culot
@@ -86,7 +86,12 @@ pour faire remonter les bogues et pour contribuer au d
 	    <li><a href="#basics_interface_interactive">4.2.2 Mode Interactif</a></li>
 	</ul></li>
 	<li><a href="#basics_files">4.3 Fichiers</a></li>
-	<li><a href="#basics_help">4.4 Aide en ligne</a></li>
+        <li><a href="#basics_import_export">4.4 Fonctions d'import/export</a>
+        <ul>
+            <li><a href="#basics_import">4.4.1 Import</a></li>
+            <li><a href="#basics_export">4.4.2 Export</a></li>
+        </ul></li>
+	<li><a href="#basics_help">4.5 Aide en ligne</a></li>
     </ul></li>
     <li><a href="#options">5. Options</a>
     <ul>
@@ -259,7 +264,7 @@ disponibles.
 <p>
         Vous devez tout d'abord décompresser l'archive source de la
         manière suivante :</p>
-	<pre>tar zxvf calcurse-2.2.tar.gz</pre>
+	<pre>tar zxvf calcurse-2.3.tar.gz</pre>
 <p>
         Une fois que vous remplissez tous les pré-requis nécessaires à
         l'installation, le processus de compilation est simple et suit
@@ -331,6 +336,11 @@ disponibles.
 	<dd>
 	Affiche l'aide décrivant les options en ligne de commande,
 	puis quitte.</dd>
+        <dt><code>-i &lt;file&gt;, --import &lt;file&gt;</code></dt>
+        <dd>
+        Importe les données au format icalendar contenues dans le fichier 
+        <code>file</code>.
+        </dd>
 	<dt><code>-n, --next</code></dt>
 	<dd>
 	Affiche le rendez-vous suivant dans les prochaines 24 heures, puis
@@ -612,7 +622,62 @@ $HOME/.calcurse/
 		<dd>ce fichier contient la liste des tâches à effectuer</dd>
 	</dl>
 
-<h2>4.4 Aide en ligne<a name="basics_help"></a></h2>
+<h2>4.4 Fonctions d'import/export<a name="basics_import_export"></a></h2>
+<p>
+        Les possibilités offertes par <code>calcurse</code> pour importer et exporter
+        des données sont décrites ci-dessous.
+</p>
+
+<h3>4.4.1 Import<a name="basics_import"></a></h3>
+<p>
+        Les données au format icalendar tel que décrit dans la spécification
+        rfc2445 (voir la section <a href="#links_others">liens</a> ci-dessous)
+        peuvent être importées dans calcurse. L'import ical de calcurse est basé
+        sur la version 2.0 de la norme rfc2445, mais pour le moment, seul un
+        sous-ensemble de cette spécification a été implémenté.
+</p>
+<p>
+        Les propriétés suivantes sont gérées par calcurse:
+        <ul>
+            <li>éléments <code>VTODO</code>:<br>
+            "PRIORITY", "VALARM", "SUMMARY", "DESCRIPTION"</li>
+            <li>éléments <code>VEVENT</code>:<br>
+            "DTSTART", "DTEND", "DURATION", "RRULE", "EXDATE", "VALARM", "SUMMARY",
+            "DESCRIPTION"</li>
+        </ul>
+</p>
+<p>
+        La propriété "DESCRIPTION" du format icalendar sera convertie dans calcurse
+        en ajoutant une note à l'élément. Si une propriété "VALARM" est trouvée,
+        l'élément sera marqué comme étant important et l'utilisateur recevra une
+        notification (ceci ne fonctionne que pour les rendez-vous).
+</p>
+<p>
+        Voici la liste des propriétés qui ne sont pas encore implémentées:
+        <ul>
+            <li>les durées négatives ne sont pas prises en compte (l'élément n'est
+            pas importé)</li>
+            <li>certaines fréquences de répétition ne sont pas reconnues:<br>      
+            "SECONDLY" / "MINUTELY" / "HOURLY"</li>
+            <li>Certains mots-clés liés aux répétitions ne sont pas reconnus
+            (ceux commençant par 'BY'):<br>
+            "BYSECOND" / "BYMINUTE" / "BYHOUR" / "BYDAY" / "BYMONTHDAY"<br>
+            "BYYEARDAY" / "BYWEEKNO" / "BYMONTH" / "BYSETPOS"<br>
+            plus "WKST"</li>
+            <li>le mot-clé "EXRULE" n'est pas reconnu</li>
+            <li>les fuseaux horaires ne sont pas pris en compte</li>
+        </ul>
+</p>
+
+<h3>4.4.2 Export<a name="basics_export"></a></h3>
+<p>
+        Deux formats peuvent êtres utilisés pour l'export des données:
+        <code>ical</code> et <code>pcal</code> (voir la section
+        <a href="#links_others">Liens</a> ci-dessous pour avoir plus d'informations
+        concernant ces formats).
+</p>
+
+<h2>4.5 Aide en ligne<a name="basics_help"></a></h2>
 <p>
         A n'importe quel moment, le système d'aide en ligne peut être
         appelé en pressant la touche '?'. Une fois rentré dans l'aide,
@@ -1211,7 +1276,7 @@ msgid ""
 
 <div class="footer">
 	Copyright (c) 2004-2008 Frédéric Culot<br>
-	Calcurse version 2.2 - Dernière modification: 11 Aout 2008<br>
+	Calcurse version 2.3 - Dernière modification: 21 Septembre 2008<br>
 </div>
 </div>
 
diff --git a/doc/manual_it.html b/doc/manual_it.html
index 8ae2833..872d5f4 100755
--- a/doc/manual_it.html
+++ b/doc/manual_it.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <!--
 /*
- * $calcurse: manual_it.html,v 1.5 2008/08/11 18:08:45 culot Exp $
+ * $calcurse: manual_it.html,v 1.6 2008/09/21 14:08:59 culot Exp $
  *
  * Calcurse - text-based organizer
  * Copyright (c) 2004-2008 Frederic Culot
@@ -85,7 +85,12 @@ partecipare allo sviluppo di calcurse.
 	    <li><a href="#basics_interface_interactive">4.2.2 Modo interattivo</a></li>
 	</ul></li>
 	<li><a href="#basics_files">4.3 Files di <code>calcurse</code></a></li>
-	<li><a href="#basics_help">4.4 Aiuto in linea</a></li>
+        <li><a href="#basics_import_export"><span class="todo">4.4 Import/Export capabilities</span></a>
+        <ul>
+            <li><a href="#basics_import"><span class="todo">4.4.1 Import</span></a></li>
+            <li><a href="#basics_export"><span class="todo">4.4.2 Export</span></a></li>
+        </ul></li>
+	<li><a href="#basics_help">4.5 Aiuto in linea</a></li>
     </ul></li>
     <li><a href="#options">5. Opzioni</a>
     <ul>
@@ -247,7 +252,7 @@ caratteristiche<a name="overview_features"></a></h2>
   Innanzitutto Ã¨ necessario scompattare l'archivio contenente i
   sorgenti:
 </p>
-	<pre>tar zxvf calcurse-2.2.tar.gz</pre>
+	<pre>tar zxvf calcurse-2.3.tar.gz</pre>
 <p>
   Una volta verificati i requisiti e scompattato l'archivio la
   procedura d'installazione Ã¨ piuttosto semplice visto che segue i tre
@@ -326,6 +331,13 @@ caratteristiche<a name="overview_features"></a></h2>
       Stampa la versione breve del testo che descrive le opzioni della
       riga di comando ed esce.</dd>
 
+    <dt><code>-i &lt;file&gt;, --import &lt;file&gt;</code></dt>
+    <dd>
+    <div class="todo">
+    Import the icalendar data contained in <code>file</code>.
+    </div>
+    </dd>
+
     <dt><code>-n, --next</code></dt>
     <dd>
       Stampa il prossimo appuntamento nelle successive 24 ore ed esce.
@@ -617,7 +629,61 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
   <dd>questo file contiene l'elenco delle attivitÃ </dd>
 </dl>
 
-<h2>4.4 Aiuto in linea<a name="basics_help"></a></h2>
+<div class="todo">
+<h2>4.4 Import/Export capabilities<a name="basics_import_export"></a></h2>
+<p>
+        The import and export capabilities offered by <code>calcurse</code>
+        are described below.
+</p>
+
+<h3>4.4.1 Import<a name="basics_import"></a></h3>
+<p>
+        Data in icalendar format as described in the rfc2445 specification
+        (see <a href="#links_others">links</a> section below) can be imported
+        into calcurse. Calcurse ical parser is based on version 2.0 of this 
+        specification, but for now on, only a subset of it is supported.
+</p>
+<p>
+        The following icalendar properties are handled by calcurse:
+        <ul>
+            <li><code>VTODO</code> items:<br>
+            "PRIORITY", "VALARM", "SUMMARY", "DESCRIPTION"</li>
+            <li><code>VEVENT</code> items:<br>
+            "DTSTART", "DTEND", "DURATION", "RRULE", "EXDATE", "VALARM", "SUMMARY",
+            "DESCRIPTION"</li>
+        </ul>
+</p>
+<p>
+        The icalendar "DESCRIPTION" property will be converted into calcurse format
+        by adding a note to the item. If a "VALARM" property is found, the item
+        will be flagged as important and the user will get a notification (this is
+        only applicable to appointments).
+</p>
+<p>
+        Here are the properties that are not implemented:
+        <ul>
+            <li>negative time durations are not taken into account (item is skipped)</li>
+            <li>some recurence frequences are not recognize:<br>
+            "SECONDLY" / "MINUTELY" / "HOURLY"</li>
+            <li>some recurrence keywords are not recognized 
+            (all those starting with 'BY'):<br>
+            "BYSECOND" / "BYMINUTE" / "BYHOUR" / "BYDAY" / "BYMONTHDAY"<br>
+            "BYYEARDAY" / "BYWEEKNO" / "BYMONTH" / "BYSETPOS"<br>
+            plus "WKST"</li>
+            <li>the recurrence exception keyword "EXRULE" is not recognized</li>
+            <li>timezones are not taken into account</li>
+        </ul>
+</p>
+
+<h3>4.4.2 Export<a name="basics_export"></a></h3>
+<p>
+        Two possible export formats are available: <code>ical</code> and 
+        <code>pcal</code> (see section <a href="#links_others">Links</a> below
+        to find out about those formats). 
+</p>
+</div>
+
+<h2>4.5 Aiuto in linea<a name="basics_help"></a></h2>
 <p>
   In ogni momento Ã¨ possibile richiedere il sistema dell'aiuto in
   linea premendo il tasto '?': una volta avviato si possono richiedere
@@ -1287,7 +1353,7 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
 
 <div class="footer">
   Copyright (c) 2004-2008 Fr&eacute;d&eacute;ric Culot<br>
-  Calcurse version 2.2 - Last change: August 11, 2008<br>
+  Calcurse version 2.3 - Last change: September 21, 2008<br>
 </div>
 </div>
 
diff --git a/doc/manual_nl.html b/doc/manual_nl.html
index d4ed79c..f205789 100755
--- a/doc/manual_nl.html
+++ b/doc/manual_nl.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//NL">
 <!--
 /*
- *	$calcurse: manual_nl.html,v 1.11 2008/08/11 18:08:45 culot Exp $
+ *	$calcurse: manual_nl.html,v 1.12 2008/09/21 14:08:59 culot Exp $
  *
  * Calcurse - text-based organizer
  * Copyright (c) 2004-2008 Frederic Culot
@@ -84,7 +84,12 @@ besproken. Als laatste wordt zowel de procedure van het melden van fouten in
 	    <li><a href="#basics_interface_interactive">4.2.2 Interactieve modus</a></li>
 	</ul></li>
 	<li><a href="#basics_files">4.3 <code>calcurse</code> bestanden</a></li>
-	<li><a href="#basics_help">4.4 Online hulp</a></li>
+        <li><a href="#basics_import_export"><span class="todo">4.4 Import/Export capabilities</span></a>
+        <ul>
+            <li><a href="#basics_import"><span class="todo">4.4.1 Import</span></a></li>
+            <li><a href="#basics_export"><span class="todo">4.4.2 Export</span></a></li>
+        </ul></li>
+	<li><a href="#basics_help">4.5 Online hulp</a></li>
     </ul></li>
     <li><a href="#options">5. Opties</a>
     <ul>
@@ -230,7 +235,7 @@ besproken. Als laatste wordt zowel de procedure van het melden van fouten in
 <p>
 	Als eerste moet het volgende archief uitgepakt worden met gunzip en
 	untar:</p>
-	<pre>tar zxvf calcurse-2.2.tar.gz</pre>
+	<pre>tar zxvf calcurse-2.3.tar.gz</pre>
 <p>
 	Zodra de benodigde pakketten ge&iuml;nstalleerd zijn en het archief
 	uitgepakt is, is de installatieprocedure vrij simpel, via de
@@ -298,6 +303,12 @@ besproken. Als laatste wordt zowel de procedure van het melden van fouten in
 	    Geeft een korte hulptekst weer, met de ondersteunde
 	    commandoregel-opties en verlaat het programma.
 	    </dd>
+            <dt><code>-i &lt;file&gt;, --import &lt;file&gt;</code></dt>
+            <dd>
+            <div class="todo">
+            Import the icalendar data contained in <code>file</code>.
+            </div>
+            </dd>
 	    <dt><code>-n, --next</code></dt>
 	    <dd>
 	    Geeft de eerstvolgende afspraak weer die binnen 24 uur valt en verlaat
@@ -568,7 +579,61 @@ $HOME/.calcurse/
 		<dd>bevat de takenlijst.</dd>
 	</dl>
 
-<h2>4.4 Online hulp<a name="basics_help"></a></h2>
+<div class="todo">
+<h2>4.4 Import/Export capabilities<a name="basics_import_export"></a></h2>
+<p>
+        The import and export capabilities offered by <code>calcurse</code>
+        are described below.
+</p>
+
+<h3>4.4.1 Import<a name="basics_import"></a></h3>
+<p>
+        Data in icalendar format as described in the rfc2445 specification
+        (see <a href="#links_others">links</a> section below) can be imported
+        into calcurse. Calcurse ical parser is based on version 2.0 of this 
+        specification, but for now on, only a subset of it is supported.
+</p>
+<p>
+        The following icalendar properties are handled by calcurse:
+        <ul>
+            <li><code>VTODO</code> items:<br>
+            "PRIORITY", "VALARM", "SUMMARY", "DESCRIPTION"</li>
+            <li><code>VEVENT</code> items:<br>
+            "DTSTART", "DTEND", "DURATION", "RRULE", "EXDATE", "VALARM", "SUMMARY",
+            "DESCRIPTION"</li>
+        </ul>
+</p>
+<p>
+        The icalendar "DESCRIPTION" property will be converted into calcurse format
+        by adding a note to the item. If a "VALARM" property is found, the item
+        will be flagged as important and the user will get a notification (this is
+        only applicable to appointments).
+</p>
+<p>
+        Here are the properties that are not implemented:
+        <ul>
+            <li>negative time durations are not taken into account (item is skipped)</li>
+            <li>some recurence frequences are not recognize:<br>
+            "SECONDLY" / "MINUTELY" / "HOURLY"</li>
+            <li>some recurrence keywords are not recognized 
+            (all those starting with 'BY'):<br>
+            "BYSECOND" / "BYMINUTE" / "BYHOUR" / "BYDAY" / "BYMONTHDAY"<br>
+            "BYYEARDAY" / "BYWEEKNO" / "BYMONTH" / "BYSETPOS"<br>
+            plus "WKST"</li>
+            <li>the recurrence exception keyword "EXRULE" is not recognized</li>
+            <li>timezones are not taken into account</li>
+        </ul>
+</p>
+
+<h3>4.4.2 Export<a name="basics_export"></a></h3>
+<p>
+        Two possible export formats are available: <code>ical</code> and 
+        <code>pcal</code> (see section <a href="#links_others">Links</a> below
+        to find out about those formats). 
+</p>
+</div>
+
+<h2>4.5 Online hulp<a name="basics_help"></a></h2>
 <p>
 	De ingebouwde hulp kan waar nodig aangeroepen worden door middel van
 	de '?' toets. Tijdens het gebruik van de hulpschermen kan een
@@ -1066,8 +1131,8 @@ msgid ""
 	kritiek stuurden.</p>
 
 <div class="footer">
-	Copyright (c) 2004-2008 Fr&eacute;d&eacute;ric Culot<br>
-	Calcurse version 2.2 - Last change: August 11, 2008<br>
+	Copyright (c) 2004-2008 Frédéric Culot<br>
+	Calcurse version 2.3 - Last change: September 21, 2008<br>
 </div>
 </div>
 
-- 
cgit v1.2.3

