packages icon
astime is an analogue clock utility for X Windows.
Copyright (c) 1998-2000  Albert "Tigr" Dorofeev <albert@tigr.net>
Copyright (c) 1999 William Kostis <kostis@ee.cornell.edu>
For the updates check http://www.tigr.net/afterstep/

Description:
============

This is an AfterStep look & feel analog clock for X Windows.

Why do we need a yet another clock? Hmmm... It's simple.
I could not find a clock that I could customize to my Wharf
in a decent way. I got frustrated and so I wrote one.

I wear an analogue watch and I am not at all used to reading
the digital watches and clocks. It takes only a glance on
the analogue watch to know what the time is and it takes a while
to read the digital watch. There is a beautiful "asclock"
for those who like digital watches. I needed an analogue clock.

The tool shows a usual analogue clock dial almost in the center.
Actually, I tried first to make one that would be right in the center 
but couldn't. It's pretty hard when you have 54x54 background.
So, I gave up and decided that I will have it "intentionally"
moved away from the center. The top left corner contains the
day-of-week indicator. The bottom line is used to display
the current date.

The date and day-of-the-week displays may be switched off with
a command-line option. Then the clock occupies the whole view.
The X11 '-geometry' option allows you to set the size to any
other size rather than "standard" AfterStep 54x54.

The program may be used directly or in the Afterstep "wharf". It also 
supports the WindowMaker docker (-withdrawn option). It may be used 
in all other window managers as well. It runs well as an icon.

Khe... allow me to introduce a few major changes here. William
Kostis <kostis@ee.cornell.edu> is a co-developer (version 2.0) and he
immediately came up with a completely new look. astime could
already run in a bigger window than 54x54 before and he uses
it outside of Wharf (not that he has one running good ol' fvwm2).
So he decided to add fancy rendering for the clock hands and
a few options to be able to customize it properly. The new options
look much better for bigger size window due to the small details that
become indistinguishable in the little 54x54 standard window.

I am not sure anymore how I should describe the clock then. Its
look ranges now from that original "AfterStep-ish" look all the
way through the color spectrum to the good ol' xclock. Well,
whatever. Check it out for yourself. Make the window bigger
(use -geometry) and experiment.

You may want to have a look in the CHANGES file for the history of updates.

Credits:
========

Great many thanks to authors of all those clocks that I played with.

There may be some other people's code carried over from asapm. See 
asapm's README for detailed credits.

Thanks to Jakob Henriksson <jakobh@mail.bip.net> for the '-exe'
switch code.
Thanks to Bill Davidson <bill@kayhay.com> for the "PI" patch.
Thanks to Janne Korkkula <jannek@cc.hut.fi> for the "noborder" patch.
Thanks to Brian Lindholm <lindhobr@vasale01misge.salem.ge.com> for a patch.

Distribution:
=============

The application and the source code are under GPL. See LICENSE 
file for details.

Naturally, I would like to hear of all changes and improvements 
made to this utility.

Enjoy and may the source be with you,
Albert "Tigr"