Subject  : Chronometer v2.9 hp48 SX/GX library in Sys-RPL.
Keywords : stopwatch, countdown, world time...
Bytes    : 2705.5 bytes
Checksum : # FF3Bh
Flags    : -41 (systemflag: European time format)
Author   : Tom van Migem -- tw45639@vub.ac.be (expires soon)

BEGIN CHRONOJ.DOC
------------------------------------------------------------------------------

Saluut all !

As the title suggests, this library is a Chronometer-style set of commands
written in very fast internal, comprising of the most necessary routines
for keeping track of time. It is also short in size which appeals to me and
hopefully to you as well. Show me a wristwatch that can take the SINE of a
laptime, and I'll ... I don't know.

All of the commands in the lib can be used in any programs you may compile,
and the necessary lib parameters (see next) are *NOT* installed automatically
on warmstart, thus saving you unnecessary waste of space (ahem).

Comments : Library parameters are stored in a Hidden list known as 'CrDat'
comprising of a hex-string. Other variables include 'ZLIST' (a list of
strings and reals used in the World feature) and 'ZONE' (timezone).
Seriously improved and debugged version.
Lastly, time calculations are made from a reference time in CrDat,
so don't get it into your head that your HP is wasting batteries by having
the chronometer started. Only running display (Run) requires constant work!

Here are the descriptions :

1. Timer :      A stopwatch with start time, # of laps and "split" display.
		The keyboard layout is modified to provide links to most of
		the other routines, Lap, Run, Track, World, Clk, Rmv..
		On screen help available. Press any other key to abort.

2. World :      Displays current world times calculated from present time.
		When first using World, ZLIST & ZONE are stored in HOME,
		and can be altered. Please use correct pattern of elements
		in ZLIST (must be of form: alternating string and real)
		and ZONE must be a real (rudimentary check made).

3. Track :      Given input of the form HHH.MMSS (pos or neg real),
		it will store an alarm in the calculator HHH.MMSS from
		the current time. If successfully set, an integer will be
		returned indicating the position of the TRACK with respect
		to other existing alarms. Uses Hrval.

4. View :       Displays on screen the current status of the commands:
		stopwatch and countdown.

5. Clk :        Toggles whether current time and date are displayed (flag).

6. Rmv:         Deletes ALL Chrono,Track and World parameters.
		You are prompted for confirmation.
		This program does not touch any other alarms stored.
		"TRACK" is case sensitive. Please do not use the string
		"TRACK" as an executable for other alarms, or it will be
		deleted as well!

7. Start :      Sets the begin reference time (stores binary in CrDat).
		Start is called when Run or Lap are pressed for the 
		first time.
 
8. Run :        This is my attempt to reproduce a continuous display of laps
		as the clock ticks; the running times are displayed at the
		top; very fast. Time displayed in days hours:mins:secs, and 
		total seconds. Press any key to stop the display.

9. Lap :        Analogous to Run, but returns one lap-time to the stack 
		(total # of seconds passed) if the stopwatch is running. 
		In this way, the lap-times can be eventually manipulated.

10. Stop :      Resets the reference time only (CrDat).

11. Hrval :     Given input of the form HHH.MMSS (posit. or negat. real),
		this function returns a date on stacklevel 2 and a time on
		stacklevel 1 corresponding to the date&time as many hours
		ahead (or in the past) as the input HHH.MMSS.

		What is the date & time in 39h 24m 45s time from now ?
		input :    1:    39.2445         output : 2:   21.091994
							  1: 16.01233576
		Output explanation :  16h01 on the 21st September 1994
		(European notation)

		What was the date & time 674h 23m 14s ago ?
		input :     1:  -674.2314        output : 2:   4.171994
							  1:  21.3402348
		Output explanation :  21h34 on the 17th April 1994
		(North American notation)

12. ABOUT.Chrono : A one-page help screen.

Postscripts :

	All criticism is appreciated, and further versions will add the
suggestions that float :)   No response is expected, but very welcome.
All queries will be answered as far as I can give them.

This software is free-ware, not to be sold for profit in any manner,
to be used wisely and not disruptively to any goal. This documentation
must accompany Chronometer.lib, whose author disclaims all responsibility
for damage caused by use of this product. Use it at own risk.  Tom.
------------------------------------------------------------------------------
END CHRONOJ.DOC