TimeTrak is freeware. You may use and distribute this program as you wish. Distribution must include this readme file.The author of TimeTrak is in no way responsible for any damages caused by the use of TimeTrak. If you find that TimeTrak is useful, please send an email just to let me know how many people are using the program. Copyright 1998 Tom Stevic ************************************************************************************* TimeTrak is a little timer that records the elapsed time between pressing the Start button and exiting the program. Pressing the Stop button will cause the timer to stop, but not reset. When the program is exited, a file will be created, or appended to, the default name is "timetrak.log" that has the date of shut down,the elapsed time, and, if selected, the start and stop times for that session. This file will be created in the directory where TimeTrak is run from. I use the program to keep track of billable hours on projects that I do. If anyone has any suggestions feel free to forward them to me at the above email address. ********************************************************************************* Directions for use. Starting the program with no arguments will cause a log file with the name "timetrak.log" to be created if any logging options are selected.If you wish to use a different log file name, start the program with that name passed as an argument. Such as, 'timetrak project1' ( no quotes ). Then the logfile will be called project1.log, and any options you choose will be kept in a file called project1.ini. The program may be set up with many different log file names if you wish to use it for different timing functions. Create program object for each name that you wish to use and place the name you want to use in the parameters field. The program can also be started from the command line or a *.cmd file. **Note: There is no error checking when TimeTrak writes to a file. If the name you use in not a valid name, or if there is not enough room to write the file, TimeTrak will ignore the error without warning, or it may crash. Please make sure the file name you choose is valid. Do not supply and extension, do not use blanks ( TimeTrak will ignore everything after the blank ), and use no more than 8 characters if saving to a FAT partition. Once started, TimeTrak has 4 control buttons. The Green one starts the timer, the Red one Stops it, the Black button exits and the Blue button pops up a dialog that will insert a 'note' into the log file. The 'note' can be up to 80 characters in length, and pressing the 'Accept' button on the dialog will write the text immediately into the log file. Clicking the mouse on the time display will bring up the settings page. On the settings page, selecting 'Save Start Time' will cause the start time to be written to the log file every time the time is started. Selecting 'Save Stop Time' will cause the stop time to be written to the log file every time the timer is stopped. Selecting 'Save Elapsed Time' Causes the elapsed time to be saved to the log file when the program is terminated. Selecting 'Display Total Time' will record the elapsed time and reload it between sessions, giving you a running total time. ( useful for things like total time spent on a job over several days ) Pressing the 'Clear Total' Button will reset the stored time back to 0 seconds. Selecting 'Start When Opened' will start the time when the program is started. Selecting 'Log Elapsed on Stop' will cause the current elapsed time to be written to the log file when ever the stop button is pressed. Normally the elapsed time is only written when the program terminates. Selecting 'Log Day of Week' will add the day of the week ( Sunday, Monday, etc ) to the date code in the log file. Selecting 'Add CR in Log' will insert a blank line into the log after a timer stop and after the elapsed time is written. This make the file a little easier to read by humans. ************************************************************************************ History: V 1.00 Released to public 2/15/98 V 1.01 Replaced objectrexx function with classicrexx to fix error on exit 2/16/98 V 1.02 Added the options of changing the log file name, and storing the start and stop times. V 1.03 Added the option to start timing when opened. Also added the ability to create different setups. When a log file name other than "timetrak.log" is used, a separate *.ini file will be created. Then if the first part of the *.ini file is passed as a parameter when timetrak is started, it will use the settings stored in the separate *.ini file. For example, if you create a setup with the logfile "project1.log" and another setup with the logfile "project2.log", the you can start either setup by creating a program object with 'project1' or 'project2' in the parameters field of the properties notebook. ( note: do not include the quotes ). It can also be started from the command line by typing 'timetrak project1' v 1.04 Added the option to save a running total time that is loaded into the display window upon start up of the program. Also, in the settings window, a stored time can be cleared. This release has two executable files TimeTrak.exe and TimeTrk2.exe. The second program has the window sizes adjusted for proper display on some video card / resolution combinations. It has been noted that the right side of the window was chopped of when displayed using some display card at high resolutions. You can erase TimeTrak.exe and rename TimeTrk2.exe if you see this behavior on your monitor. 3/27/98 v 1.05 Fixed bug that would cause the time for a current session to be lost when the stop button was pushed. 3/29/98 v 1.06 Added the options "Log Elapsed on Stop", "Log Day of Week", "Add CR in Log", and the optional 'note' entry. Changed the buttons from having text descriptions to smaller colored ones. Made Y2K compatible with the following note: TimeTrak will now work properly after the year 2000 as long as the timer is not started when the year is 1999 and allowed to run over the year change. 6/7/98