
TWCLOCK VER 2.1 README


NEW to 2.1

Modified makefile for static compile.


NEW to 2.0:

  This major release has been modified to run using the openMotif
toolkit.  Control keys (ex. Ctrl-G for GMT time) are now functional.

  Previous 1.x versions were written for lessTif.  The program may
compile and run if you use lessTif, but some windows and functions
may not look and work exactly right.

  Another button, Set Timer, was added to the pop up menu.  Pressing
this button (or Ctrl-S) opens a window where you can set the alarm time.
The alarm time can be set from 0 seconds (?) to 9999 minutes and 9999
seconds, or about 7.5 days.


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.

  An ID timer is also included.  An alarm will notify you when it
is time for a station ID.  The time between ID's is set via the
resource file (Twclock).  It can also be set at runtime via the popup
menu.

  Local or GMT time can be displayed.  In addition, the current
time at some point on the globe can be displayed by using the time
zone information contained in the files located under the directory
/usr/lib/zoneinfo or /usr/share/zoneinfo.  A file selection box
allows you to pick the region 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.  This
only changes TZ for the clock process - other processes are unaffected


USER INTERFACE:

  The interface has two functions, a Clock and an ID timer.

Clock Operation:

  The GUI uses scale widgets to display hours, minutes, and seconds.
The button at the top is used to start and stop the alarm timer.
When the time expires, the button can be made to flash and/or the PC
speaker will beep.  See the notes in the resource file, Twclock,
for controlling these features.  

  There is only this one "undocumented" popup menu (via the right
mouse button).  Two of the menu buttons, "Local" and "GMT" set the
clock to that time.  Ctrl-L and Ctrl-G do the same thing as pushing the
"Local" and "GMT" menu buttons.

  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 unchanged.

  The fourth button is the Set Timer button.  This button (or Ctrl-S)
pops up a window where you can set the time for the alarm.

ID Timer Operation:

  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 will beep, or both.  Press
the button to turn the alarm off.  Press it again to start another timeout.

  The alarm is controlled 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.

  The alarm time delay can also be set at runtime.  The Set Timer button
on the pop up menu (or Control-S) brings up a window where you can set
the delay from 0 (?) to 9999 minutes and 9999 seconds.


INSTALLATION:

1  Run the make command to compile -
   
      make

2  Then, as root, run the command - 

      make install

3  Edit Twclock -

   The "make install" put a copy of the resource file (Twclock)
   in /usr/X11R6/lib/X11/app-defaults, one of many places where X looks for
   resource files.  You will want to make changes to Twclock to tailor it
   to your needs.

   The easiest way is to edit the copy of Twclock just installed in
   /usr/lib/X11/app-defaults.  But, you must be root!

   You can also:

      copy Twclock to your home directory.   -OR-

      cat it to the end of your .Xdefaults file.  -OR-

      use XAPPLRESDIR and copy Twpsk to your own resources directory.

      See the X manual pages for more information
   
   Now edit the new copy of Twclock (root is not needed).  There are
   comments (lines beginning with an !) in Twclock explaining the values.
   After you change the values, restart the program to have them take effect.

   Finally, add "twpsk&" to your start up script so the program will be
   started automatically for you.  The program has been installed in
   /usr/local/bin, so make sure that /usr/local/bin is in your PATH.  




   Got any problems, comments, suggestions, etc?

   My email is: wa0eir@comcast.net

   73,
   Ted - WA0EIR

