diff options
| author | Frederic Culot <calcurse@culot.org> | 2008-09-21 14:08:59 +0000 |
|---|---|---|
| committer | Frederic Culot <calcurse@culot.org> | 2008-09-21 14:08:59 +0000 |
| commit | 6ce12bfedf635cf5315aa854bae76a0d509bb786 (patch) | |
| tree | 38a0dbfd28fa974332a24dcf4e164656e5948484 /doc | |
| parent | 7ddfcccee0ea83626a3b1a897523e55fbf128774 (diff) | |
| download | calcurse-6ce12bfedf635cf5315aa854bae76a0d509bb786.zip | |
manpage, manuals and translations updated for 2.3_beta
Diffstat (limited to 'doc')
| -rwxr-xr-x | doc/manual_de.html | 103 | ||||
| -rwxr-xr-x | doc/manual_en.html | 73 | ||||
| -rwxr-xr-x | doc/manual_es.html | 77 | ||||
| -rwxr-xr-x | doc/manual_fr.html | 75 | ||||
| -rwxr-xr-x | doc/manual_it.html | 76 | ||||
| -rwxr-xr-x | doc/manual_nl.html | 77 |
6 files changed, 447 insertions, 34 deletions
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éveloppement de <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> |