DtMail translations and improvements of vcal2xampia.awk
[oweals/cde.git] / cde / contrib / vcal2xapia / README
1 The AWK script converts .vcs files into XAPIA format files that can then
2 be dragged and dropped on the Calendar icon of the front panel to
3 insert an appointment in the CDE calendar.
4
5 Initial version:
6
7 The program has some limitations. For the moment, it ignores ToDo items
8 and only converts appointment items. Also, it has to convert 
9 appointments that extend on more than a single day (such as holidays) 
10 into daily repeats
11 and to transform "UNTIL=" repetitions into a number of repetition.
12 This is done by using an average duration of 30.44 days for a month
13 and 365.25 days for a year instead of using the correct duration for
14 leap years and for months. So the duration of an appointment can
15 be sometimes calculated incorrectly.
16 Appointments in the local time are not handled very well. The script
17 assumes that the local time is UTC+1.
18
19 It is released under MIT license.
20       http://opensource.org/licenses/MIT
21
22 Better programs (in Perl) to interact with dtcm by Adam Stein are available at:
23 http://www.csh.rit.edu/~adam/Progs/programs.html
24 They require to install the Calendar-CSA-0.8.tar.gz Perl libraries from CPAN.
25
26
27 Christian PĂ©lissier  has posted a dtksh program in a french
28 email list on Solaris x86 that also does the vcal to XAPIA
29 conversion. His message is archived here:
30 http://www.mail-archive.com/solaris_fr@x86.sun.com/msg02388.html
31
32 Version 2.2.4:
33
34 - improvements to the script to handle repeating appointments.
35   The script supports appointments that repeat every N week/month/days.
36 - easter.awk: script that creates appointments for (Roman Catholic)
37   Easter, Ascension Day and Whit Sunday.
38
39 Current version:
40
41 - added support for ToDo items.
42 - added support for numeric timezones (TZ:+NN or TZ:-NN).
43