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

