timers, version 1.2, 1 June 1996

Latest features:

   * Countdown timers that display an alarm message.
   * Now works in Tk 4.0.

The timers home page is at http://www.best.com/~ken/software/timers/.

Timers is a set of stopwatches for timing projects and other things. It is
written in tcl/tk and requires Extended Tcl (TclX) for its clock functions.

General Description
===================

Create as many stopwatches as you want. Each has its own stop/go buttons.

Elapsed time is maintained even when your computer is switched off.

This program is licensed under GNU General Public License. See the file
COPYING for details.

Other Features
===================

   * Each stopwatch has a customizable text label.
   * Time can be displayed in colon format, "HH:MM:SS", or in decimal
     format, "HH.hhhhh". Time can be converted between these two formats by
     pressing the colon/period button.
   * The time can be updated by adding or subtracting minutes or hours using
     the quick arrow buttons or the menu.
   * Stopwatches can be created, destroyed, or hidden from view.
   * For a countdown timer, enter a negative value in the time field. A
     dialog box will pop up when the time reaches zero.

Installation
===================

  1. Make sure you have installed Extended Tcl (TclX). You'll get the
     following error message if you don't.

        invalid command name "getclock"

  2. Get the source file, timers, and the bitmaps for the up and down
     buttons, timers-up.xbm and timers-dn.xbm. These files can also be
     extracted from timers-1.1.tar.gz. Place these three files somewhere in
     your path, such as /usr/local/bin.
  3. make it executable (chmod 755 timers)
  4. run it:

       timers

     You can specify an alternate data file on the command line, e.g.,

       timers ~/.timers2

Limitations
===================

The timers program stores information in a data file (.timers in your home
directory by default). Only one program should be running per data file.
Otherwise, the information in the file will become corrupted.

----------------------------------------------------------------------------
W. Ken Neighbors III, ken@best.com
