
tm -- TimeMaster (1.2) : external command / by Jeff Hansen

syntax:  tm [-c] [-a] [-b] [-s] [-m month] [-d day] [-y year]
            [-h hour] [-n minute]

ex:      tm
         tm -c
         tm -a
         tm -m1 -d20 -y1990 -h14 -n50 -s
         ld -m10 -d26 -y2000

TimeMaster is a command that will allow you to set the date and time of
your Applied Engineering TimeMaster II H.O. clock card, with additional
time/date utilities.

If given with no options, the current date and time are displayed.

options:

-c   Clock display. This option will continuously display the date and
     time in a window, updated every second.  If additional options are
     given on the command line, they will be ignored.  Press <Esc> to quit.

-s   Set clock.  This option is needed to actually set the clock with the
     values supplied on the command line.  Exceptions are the -a and -b
     parameters, which will automatically assume that you want the clock
     set.  If given with no other parameters, the -s option WILL reset the
     clock (to its current values).  Note that the TimeMaster card always
     (re)sets the seconds to zero.

-a   Ahead 1 hour.  This will set the TimeMaster one hour ahead of the
     current time.  Use this in the spring, when going to daylight
     savings time.   So as to not lose any time due to the seconds being
     reset, the program will wait until the seconds value reaches zero,
     before resetting the time.  This may result in up to a 59 second wait
     before the clock is set, and you are returned to the command
     line--thus be patient.

-b   Back 1 hour.  This will set the TimeMaster back one hour from the
     current time.  Use this in the fall, when changing back to standard
     time.  Information regarding to the -a option also applies.  If
     both the -a and -b options are entered on the command line, the -a
     (ahead) takes precedence.  If any of the parameters which set the
     specific clock registers (-m, -d, -y, -h, -n) appear with either the
     -a or -b option, they will be ignored.

-m   Set month. (1-12)

-d   Set date. (1-31)  TimeMaster knows the last days of the month, and will
     inform you if you have entered an invalid date.  It will calculate the
     day of the week automatically (important for ProDOS).

-y   Set year. (1984-2083)  Leap years will be correctly accounted for when
     determining the last day of the month (February 29th) and the day of
     the week.

-h   Set hour. (0-23)  TimeMaster uses 24 hour format--sorry you civilian
     types!

-n   Set minute. (0-59)

     Any value not supplied on the command line will be taken from the
     current setting of the clock.  Thus you will only need the use the -n
     (and -s) parameters if you are just correcting the time.  By using the
     command without the -s option, you can check dates without actually
     (re)setting the clock.  Thus you can find out what day Christmas is on
     this year, or what your birthday is in the year 2000.

     When used WITH the -s option, the text "Date/Time set to:" will be
     displayed, while without the -s option, "Date/Time:" will be
     displayed.  The first line printed is the current date and time
     setting of the clock, and the second line is the time which the clock
     will be (or has been) set to.
