
TWCLOCK VER 1.3 README

DESCRIPTION:

  This is a clock program which will prove to be very helpful
for ham operators.  It is implemented with Motif widgets, and 
will displays the current time in major cities around the world.  
A statically linked version is included so Motif is not required.

An ID timer is also included.  An alarm will notify you when it
is time to ID.  The time between ID's is adjustable.

  The current time at some point on the globe is determined using
the time zone information contained in the files located under the
directory /usr/lib/zoneinfo.  A file selection box allows you to
pick the area and city of interest, and the environment variable
TZ is set to the pathname for that time zone file.  The clock will
then display the current time for the selected location.  Don't 
worry, this only changes TZ for the clock process - other processes
are unaffected


CHANGES IN THIS VERSION

The icon pixmap is now compiled into the program, so the xpm file
does not need to be moved.

The resource file was expanded to get more colors in the interface.
The default colors a green and tan.  Remember your old Heath Kit rig?

Added an ID timer.  When the button on the top of the interface is pressed
in, a timer is started.  The button will blink and the PC speaker beeps when
the time has expired.   

USER INTERFACE:

   The GUI uses scale widgets to display hours, minutes, and seconds.
There are also two labels - one for date and time zone info, and one
that you can display whatever, like your call.

   Very few properties were hard coded.  This way you can set widget
properties (colors, fonts, labels, etc.) as you like in the resource
file (Twclock) without recompiling.  This is essential for the those
using the static version.

   There are no pulldown menus.  I guess I misplaced my Motif Style
Guide.  There is only this one UNDOCUMENTED popup menu (via mouse
button 3).  Two of the menu buttons, "Local" and "GMT" set the clock
to that time.  Control-L and Control-G will do the same without popping
up the menu.

   The third menu button, "Others:" (or Control-O), pops up a file
selection box dialog that allows you to select an area and city. Then,
the OK button will set the clock to the selected zone.  The Cancel
button can be pressed at any time to popdown the dialog, leaving the
time unchange.

The ID timer uses the button at the top of the interface.  Pushing it in
starts the timer.  When the time expires, the alarm goes off.  The button
will blink a different color, or the PC speaker beep, or both.  Press the
button to turn the alarm off.  Press it again to start another timeout.

The alarm is controled by values you set in the resource file, Twclock.  You
can set the delay time in minutes and seconds, the color the button blinks,
and what kind of alarm you want (blink, beep, or both).  See comments in
Twclock for more info.

INSTALLATION:

You may need root privileges for some of these steps, depending on
where you want to copy the files. If you do not have Motif/LessTif
libraries, you will have to install the STATIC version.  The pathnames
below are correct for my system.  Your's may vary.

To install the STATIC version, start with step 1.
To install the DYNAMIC version, start with step 2.
To compile and install your own runtime version, start with step 3.

1.  To install the STATIC version, copy twclock.static to some directory
in your PATH ($HOME/bin, /usr/local/bin) and rename it twclock.
Skip to step 4.

2.  To install the DYNAMIC version, copy twclock to some directory
in your PATH ($HOME/bin, /usr/local/bin).
Skip to step 4.

3.  To compile your own version, take a look at the makefile and
modify as needed for your system.  You may have to change LIBDIR if
your libs are someplace else.  Then, execute the command "make"
to build the executable.  Copy twclock to some directory in your
PATH ($HOME/bin, /usr/local/bin).

4.  Copy the resource file (Twclock) to your resources directory -OR-
the system level app-defaults directory (/usr/X11R6/lib/X11/app-defaults) -OR-
cat it to the end of your .Xdefaults file.

5.  Then, edit the copy of Twclock to fit your needs.  There are
comments (lines beginning with an !) in Twclock explaining the firstr
three values.  After you change the values, restart the program to have
them take effect.

Some other things you can play with in Twclock are the x and y values
to position the clock at startup, foreground/background colors of the
widgets and the fonts to be used. 


ZONEINFO:

All of the time zone info, including daylight time, comes from the
files under /usr/lib/zoneinfo. On Sun OS 4.x it is somewhat limited
compared to Linux (Thanks to Linus et al). On my Red Hat distribution
it seems to be very comprehensive.

I'd like to hear about your results, comments, suggestions, or bugs!
Let me know what you think.

pls QSL to -

  ted@bluestone.com


73 and enjoy,  

Ted - WA0EIR
