intclock is an international (i.e. multi-timezone) clock which can be run
in a window or in a terminal.

The following command line lists all the options:

% intclock --help

However, normally you just run the program without options:

% intclock

Initially, just the time in the local timezone will then be shown.
A right click with the mouse shows a menu: "Preferences" leads to a
configuration window where the timezones can be selected, together with some
options.

The selected timezones and options are saved in the file $HOME/.intclock
between runs of the program.

If you would like to run intclock in a different language than your standard
language setting, you can run it e.g. like this (the example is for the Dutch
language):

  LANG=nl_BE.UTF-8 intclock

The value for LANG should be a valid locale: see the output of 'locale -a'
for all of them.

Note:
----
This program is actually based on Jens-Ulrik Petersen's hsclock (which can be
found on http://www.haskell.org/~petersen/haskell/hsclock).

I wanted to do some extensions to that program, mostly a configuration window,
but I don't know anything about Haskell, in which hsclock is written, so I
ported it to Perl instead.

Note that intclock 1.x allowed to provide the timezones on the command line:
this has been removed in favor of an all-graphical configuration.

Requirements:
------------
- perl 5 or higher
- either the Gtk2 (preferred) or the Gtk perl module
- the Data::Dumper perl module
- the Time::HiRes perl module
- the Locale::Maketext perl module

Installation:
------------
Execute, in this directory:

  perl Makefile.PL
  make
  make install

For 'make install', you need to have the right permissions to
write to the target directory.

Notes:

- The default installation path is /usr, i.e. the script
  will then come in /usr/bin.  This can be overridden via the
  PREFIX option to 'perl Makefile.PL', e.g. 'PREFIX=/usr/local'

- 'make clean' will remove the files that are made, but will
  not remove configuration files.

- 'make distclean' will clean up the distribution, removing all
  temporary files and configuration files.

Bug reports:
-----------
Bugs should be reported to <Peter.Verthez@advalvas.be>.  Please include the
version of intclock that you use.  You can find this by executing
"intclock --version". Better yet: only report bugs on the latest version
of intclock...