StopWatch - Program Execution Timer
Version 2.0.0: June 18, 1990

Author: Don A Williams
CompuServ - 75410,543
GEnie - DON-WILL


********************* NOTICE ************************
* Contrary to the current trend in MS-DOS software *
* this program, for whatever it is worth, is NOT *
* copyrighted (with the exception of the runtime *
* library from the C compiler)! The program, in *
* whole or in part, may be used freely in any *
* fashion or environment desired. If you find this *
* program to be useful to you, do NOT send any *
* contribution to the author; in the words of Rick *
* Conn, 'Enjoy!' However, if you make any *
* improvements, I would enjoy receiving a copy of *
* the modified source. I can be reached, usually *
* within 24 hours, by messages on any of the *
* following Phoenix, AZ systems (the Phoenix systems *
* can all be reached through StarLink node #9532): *
* *
* The Tool Shop BBS [PCBOARD] [PC-Pursuit] *
* (602) 279-2673 1200/2400/9600 bps *
* Technoids Anonymous [PCBOARD] *
* (602) 899-4876 300/1200/2400 bps *
* (602) 899-5233 *
* (602) 786-9131 *
* Inn On The Park [PCBOARD] *
* (602) 957-0631 1200/2400/9600 bps *
* Pascalaholics Anonymous [WBBS] *
* (602) 484-9356 1200/2400 bps *
* *
* or: *
* Blue Ridge Express [RBBS] Richmond, VA *
* (804) 790-1675 2400 bps [StarLink #413] *
* *
* The Lunacy BBS [PCBOARD] Van Nuys, CA *
* (805) 251-7052 2400/9600 [StarLink 6295] *
* (805) 251-8637 2400/9600 [StarLink 6295] *
* *
* or: *
* GEnie, mail address: DON-WILL *
* CompuServ: 75410,543 *
* *
* Every effort has been made to avoid error and *
* moderately extensive testing has been performed *
* on this program, however, the author does not *
* warrant it to be fit for any purpose or to be *
* free from error and disclaims any liability for *
* actual or any other damage arising from the use *
* of this program. *
*******************************************************


StopWatch is a program that can be used to time the execution
of other programs. It uses the BIOS timer which has a resolution
of ~55 milliseconds and should be accurate to at least .1
seconds.


USAGE:

There are two formats for the StopWatch command:

STOP
and
STOP <"any command with I/O redirection">

The angle brackets ('<' and '>') are not actually entered,
however, the quotes in form 2 must be entered.


EXAMPLES:

1) STOP DIR *.*

This StopWatch command would time the execution of the
PC/MS-DOS DIR command.

2) STOP "TRIM 0 STOPWTCH.C"

This StopWatch command would time the execution of the
TRIM filter which uses I/O redirection.

3) STOP "TRIM 0 STOPWTCH.C" >TIME

This StopWatch command is the same as that in 2) except
that the StopWatch output is redirected to the file TIME.


OUTPUT:

The output of StopWatch shows the date of execution (from the
system date), the command that was executed, the start time for
execution of the command (from the system time of day), the end
time of the execution, and the elapsed time (from the BIOS time).
The following is an example of the output of the StopWatch
command for an execution of DIR:


StopWatch - Version 2.0.0: June 18, 1990
Turbo C++ 1.0 Compiler Version
Date: 06/18/1990
Command: dir
Start time: 4:50:36
Stop time: 4:50:36
Elapsed time: 00.50 seconds