                            STPWATCH.DOC File

                    (c) Hewlett-Packard Company, 1990.


OVERVIEW
--------

The STPWATCH application provides stopwatch functionality for the HP 48:

  o  Real-time, menu-driven "ticking" stopwatch (to 100 hours).
  o  Stopwatch reset.    
  o  Split recall and storage (memory limited only).
  o  Split display and print (absolute and relative) in H.MS format.
  o  Programmable stopwatch commands.

The program creates a list in a user variable named SWDAT:
          
         SWDAT -->  {  n   array(mx2)   d  }

where

         n = Real non-negative integer (number of stored splits). Default
             for n is 0.
array(mx2) = Real two-dimensional array (mx2) permitting m stored splits. 
             Default for m is 25.
         d = Real delay (seconds) between display of splits. Default is 0.4.


For example, the following command sequence creates a SWDAT that permits 
storage of 100 splits and provides a delay of 0.5 seconds between display of 
stored splits.

             0  { 100 2 }  0  CON  0.5  3  ->LIST  'SWDAT  STO



PROCEDURE
---------

 1. Using Kermit, transfer the STPWATCH.LIB file from the computer to the
    calculator. The menu label {STPW} will appear in your HP 48 VAR menu.

 2. Attach the library to your HOME directory:

        A. Press the VAR menu key {STPW} to recall the library to the stack.

        B. Enter the port number where you want the library to reside (0,
           1, or 2), then press [STO].

        C. Turn the HP 48 off and then on again. {SW-A} attaches itself and 
           appears as a library in the LIBRARY menu.

 3. Press [left-shift][LIBRARY]{SW-A} to display the stopwatch program menu 
    keys.

 4. Press {DOSW} to enter the stopwatch environment. Use the {START}, {STOP}, 
    and {RESET} menu keys to operate the stopwatch; use [ENTER] to record 
    splits without stopping the stopwatch.

 5. Press [ATTN] to exit the stopwatch application.



MENU KEYS
---------

{DOSW} - Enters the stopwatch environment; displays stopwatch menu.
         {START} - Activates stopwatch.
          {STOP} - Halts stopwatch.
         {RESET} - Resets stopwatch time and number of stored splits to zero.
        (Press [ENTER] to record splits while the stopwatch continues running.)

{VSP+} - Views split specified by level 1 argument n; successive presses 
         increment (n+1) and view remaining splits.

{VSP-} - Views split specified by level 1 argument n; successive presses 
         decrement (n-1) and view remaining splits.

{VALL} - Views all splits (once) with specified delay.

{PSP+} - Prints split specified by level 1 argument n; returns n+1 to stack.

{PALL} - Prints all stored splits.

{RCLSP}- Returns the absolute (level 2) and relative (level 1) values of split
         specified by level 1 argument. ({RCLSP} is found on page 2 of the 
         menu.)

{RESET}- Resets stopwatch time and number of stored splits to zero.
         ({RESET} is found on page 2 of the menu.)

 
 
STOPWATCH DISPLAY
-----------------

                     ____________________________
    +-------------> |00025           00:00:12:34 | <--- Stopwatch time.
    |        +----> |00003           00:00:09:82 | <--- Last key press time.
    |        |      |                            |
    |        |
    |       Number of stored splits.
    |
 Number of splits that can be stored.

-------------------------------------------------------------------------------
NOTE:  As with any program, leaving the stopwatch running for extended periods
       will drain the batteries and could result in loss of all data stored
       in the calculator.

       Also, while the stopwatch is running, alarms are disabled.
-------------------------------------------------------------------------------
