
TWCLOCK VER 1.3 README

NEW:

  No new features in this version.  Some logic was changed to 
keep up with the current Linux versions.  Since Lesstif is 
typically included on Linux CDs, the static executable was
removed.  You will need the development version Lesstif 0.91 
or newer to compile.

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 programable
via the resource file.

  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 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.  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.
There are also two labels - one for date and time, and one that you
can display whatever you want, like your call.

  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.  Control-L and Control-G should do the same thing
as pushing the "Local" and "GMT" menu buttons, but Lesstif does NOT
handle this yet.

  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.


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 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:

1  Run the make command to compile twpsk.
   
      make

   The output should look something like this:
       % make
       gcc  -Wall -O2 -I/usr/X11R6/include    -c twclock.c -o twclock.o
       gcc  -Wall -O2 -I/usr/X11R6/include    -c twclockWids.c -o twclockWids.o
       gcc  -Wall -O2 -I/usr/X11R6/include    -c twclockCB.c -o twclockCB.o
       gcc  -Wall -O2 -I/usr/X11R6/include   twclock.o twclockWids.o twclockCB.o
             -o twclock -L/usr/X11R6/lib -lXm -lXt -lX11 -lXext -lXpm 


   If there are error messages like:     Xm/Form.h: No such file
   then Lesstif may not be installed or installed someplace other than
   where I think it is!


2  Then, as root, run install twpsk command.

      make install

   The output should look something like:

      % make install
      install -d /usr/local/bin
      install twclock /usr/local/bin
      cp Twclock /usr/X11R6/lib/X11/app-defaults
   

   This copied the twclock to /usr/local/bin and copied  the
   resource file, Twpsk, to /usr/lib/X11/app-defaults.  You should be
   able to run the program now.  However, you will want to edit the
   resource file.
 

3  Edit Twpsk.  The "make install" put a copy of the resource file (Twclock)
   in /usr/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 resources directory.

   
   And then, edit the 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.


Got any problems, comments, suggestions, etc?

My email is: ted@bluestone.com

73,
Ted - WA0EIR


*********************************************************************
GOT LESSTIF PROBLEMS?

  If you are not sure if Lesstif is installed, try this command

     find / -name Form.h -print 2>/dev/null

  and see if Form.h was found.  Xaw/Form.h and Xaw3d/Form.h are
  NOT what you need.

  Here is where they were found on my Red Hat system.

     /usr/X11R6/LessTif/Motif2.0/include/Xm/Form.h
     /usr/X11R6/LessTif/Motif1.2/include/Xm/Form.h

  If Xm/Form.h is not found, then you need to install Lesstif.  You can
  get it off the web at www.lesstit.org.  Be sure to get the development
  version.

  If they are found, then they may be installed someplace where "make"
  is not looking, and LIBS and HDIRS in the makefile needs to be changed.  

