File: xchrono/README
Xchrono is a multi-timezone, multi-face clock program for X Windows.
It has been tested on a Sun 3 and an HP9000s300.
STARTUP
-------
Several cities have been compiled into xchrono, and can be invoked with
command-line arguments, xchrono -help gives:
Usage: xchrono [-analog] [-bw <pixels>] [-digital]
[-fg <color>] [-bg <color>] [-hd <color>]
[-hl <color>] [-bd <color>]
[-fn <font_name>] [-help] [-padding <pixels>]
[-rv] [-update <seconds>] [-display displayname]
[-geometry geom]
[-width clockWidth] [-height clockHeight] [-local localName]
[-boston] [-newyork] [-chicago] [-denver] [-la]
[-hawaii] [-tokyo] [-sydney] [-london]
[-paris] [-frankfurt] [-rio]
OK, OK, Hawaii isn't a city, but you get the point. The timezones used
are taken from tztab in the SYSV case, and from /usr/lib/zoneinfo
otherwise, and as such may or may not be correct (the TZ variable
definitions or the city->timezone mappings).
The -local <localName> option causes a clock labeled with <localName>
using the value of TZ at startup as it's timezone.
In addition, a GMT clock always appears.
X DEFAULTS
----------
This set of X defaults looks fun on my Sun 3/60:
xchrono.width: 802
xchrono.height: 270
xchrono.x: 20
xchrono.y: 40
xchrono.clockWidth: 125
xchrono.clockHeight: 125
xchrono*font: ncenr12
xchrono*labelFont: ncenb14
xchrono*foreground: black
xchrono*background: white
xchrono.clockBox.background: blue
xchrono.clockBox.forceBars: on
xchrono.clockBox.useLeft: on
xchrono.clockBox.useRight: on
xchrono*hands: green
xchrono*highlight: black
xchrono*borderColor: red
xchrono*borderWidth: 2
xchrono.boston: on
xchrono.newyork: on
xchrono.chicago: on
xchrono.denver: on
xchrono.la: on
xchrono.hawaii: on
xchrono.tokyo: on
xchrono.sydney: on
xchrono.london: on
xchrono.paris: on
xchrono.frankfurt: on
Note that xchrono is an instance of an XClock application, so that
class defaults (e.g. XClock*foreground) will apply to xchrono.
COMPILATION
-----------
% set topDir = <where you installed X> ## default is /
% $topDir/usr/bin/X11/imake -I$topDir/usr/lib/X11/config
% make
IMPLEMENTAION
-------------
Xchrono is yet another blatent hack of xclock. I modified the athena
Clock widget to allow for one timer callback to update all instances
of Clock widgets in a process. The class part of the clock widget
maintains a list of all instances of Clock.
The main window of xchrono is just a Box widget with an instance of
Clock for every desired timezone.
This is a hack. Hopefully it will inspire someone with more time and/or
motivation to do it right (and include nice things like a dialog box
to do dynamic configuration, etc...).
I think Ansi has something to say about implementing timezones, but
for now I just hacked in support for tztab (SYSV) and zoneinfo (BSD).
Good enough for now.
WARRANTY
--------
Yeah, right. :-)
Enjoy,
Nick Bender nick%bischeops@uunet.uu.net
|
