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ü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üllt und das Archiv entpackt,
sind nur noch die drei üblichen Schritte erforderlich:</p>
@@ -291,6 +296,12 @@ Es werden sowohl kurze als auch lange Optionsangaben unterstützt.</p>
<dt><code>-h, --help</code></dt>
<dd>Gibt eine Hilfe zu den unterstützten Optionen aus.
</dd>
+ <dt><code>-i <file>, --import <file></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ächstes stattfindet.
@@ -550,7 +561,87 @@ $HOME/.calcurse/
<dd>Datei enthä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 über bestimmte Befehle kö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édéric Culot<br>
+ Copyright (c) 2004-2008 Fr�d�ric Culot<br>
German translation by Michael Schulz
<code><bloodshower .at. web .dot. de></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 <file>, --import <file></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édé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 <file>, --import <file></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édéric Culot<br>
+ Copyright (c) 2004-2008 Fr�d�ric Culot<br>
Traducido al Espa�ol por Jos� L�pez
<code><testinground .at. gmail .dot. com></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 <file>, --import <file></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 <file>, --import <file></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édé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ï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 <file>, --import <file></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édé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-70-g09d2