1TZ_CONVERT(1) TZ_CONVERT(1)
2
6 tz_convert - Timezone converter from operating system tz format into
7 libical format used by Orage and several other calander tools.
8
10 tz_convert [OPTION...] [INFILE]
11
13 tz_convert is a command line tool, which can be used to convert
14 timezone data from so called tz binary format, usually used in
15 operating systems, to libical format, used by several calenders like
16 Orage.
17 There are several options available to only convert certain files or
19 files in certain directory. Or only convert part of the file and ignore
20 for example old data. It is also possible to add new timezone files,
21 which are based on old timezone data.
22 There are tools, which generate ical timezones data from tz source
24 database, but those are often not available for normal users and are
25 difficult to use. So often libical timezones are not upto date.
26 tz_convert reads directly the binary tz data and makes it possible to
27 keep libical timezones up to date. The tool is mainly meant to be used
28 by distro maintainers, but it should be easy and clear enough for all
29 users.
30
32 tz timezone files often can be found in directory /usr/share/zoneinfo.
33 For example Europe/Helsinki. libical timezone files needs to be where
34 you calendar can find them. For Xfce and Orage systems they are located
35 under your Xfce directory in share/orage/libical/zoneinfo. For example
36 Europe/Helsinki.ics. (use locate to find them.)
37
39 -V, --version
40 Print version information and exit.
41 -?, --help
43 Show this help message and exit.
44 --usage
46 Show short usage summary.
47 -i, --infile
49 tz file name from operating system to convert from. If this is
50 directory, all files in it are processed. Default is
51 /usr/share/zoneinfo
52 -o, --outfile
54 ical timezone file name to be written. This can not be directory.
55 It is meant to be used together with timezone parameter. This is
56 very seldom used. Default is timezone/infile.ics
57 -m, --message
59 debug message level. How much exra information is shown. 0 is least
60 and 10 is highest (1=default). May give usefull information when
61 things do not work as expected.
62 -l, --limit
64 limit processing to newer than this year. Often there is a lot of
65 old data available, which is not needed in normal day to day work
66 and skipping unused years helps to improve performance. Default is
67 to ignore older than year 1970 time changes.
68 -t, --timezone
70 timezone name to be used in the actual file. Normally file name is
71 the same as timezone name, but if you want to create your own
72 timezone, you need new file name, which contains some known
73 timezone name. This is used together with outfile parameter.
74 -r, --norecursive
76 process only main directory, instead of all subdirectories. 0 =
77 recursive 1 = only main directory (0=default).
78 -c, --exclude count
80 number of excluded directories. 5 = default (You only need this if
81 you have more than 5 excluded directories). This is used together
82 with exclude parameter.
83 -x, --exclude
85 do not process this directory, skip it. You can give several
86 directories with separate parameters. By default directories right
87 and posix are excluded, but if you use this parameter, you have to
88 specify those also. You need to use exclude count if you have more
89 than 5 exclude directories.
90 -u, --norrule
92 do not use RRULE ical repeating rule, but use RDATE instead. Not
93 all calendars are able to understand RRULE correctly with
94 timezones. (Orage should work fine with RRULE). 0 = use RRULE 1 =
95 do not use RRULE (0=default).
96
98 Please report any bugs and enhancement requests to
99 http://bugzilla.xfce.org/. Note that tz_convert is part of orage so
100 bugs are reported against orage and component tz_convert. Usage related
101 questions can be sent to xfce@xfce.org email list.
102
104 http://www.xfce.org/projects/orage/
105
107 tz_convert was written by Juha Kautto <juha@xfce.org>.
108 This manual page was written by Juha Kautto <juha@xfce.org>.
110 05/28/2009 TZ_CONVERT(1)