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_it.html | 76 ++++++++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 71 insertions(+), 5 deletions(-)

(limited to 'doc/manual_it.html')

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>
 
-- 
cgit v1.2.3-70-g09d2