Timeclock.tcl

This is a program to help you keep track of how you spend your time.
It displays a list of categories from which you select the activity
you are currently doing.  It keeps a running count of minutes spent in
each activity.  At the end of the day, click on "home" and it writes
out the days totals to a file in your homedir.  As an option you can
also install a routine which prints a nicely formatted timecard each
week by reading that file.

Created by Jim Davis, davis@dri.cornell.edu

This is public domain software, you may do anything you want with it.
Feel free to send suggestions, upgrades, or praise.  Note that my
personal timeclock has no category for repair of this program.  That's
a hint.

Installation instructions:

1) copy dot.timeclock to your homedir as .timeclock
2) Edit it to define the list of categories you care about

3) Copy show-help-window.tcl to your local tk library directory
(on my system it's /usr/local/lib/tk)

4) Edit tclIndex in that directory, and add the line

set auto_index(show-help-window) "source $dir/show-help-window.tcl"

5) Invoke timeclock.tcl &

------

To get a time report:

1) copy date-utils.tcl and lisp.tcl to your tcl lib dir (on my system it's
/usr/local/lib/tcl)

2) Edit tclIndex in that directory, and add:

set auto_index(parse_date) "source $dir/date-utils.tcl"
set auto_index(day_number) "source $dir/date-utils.tcl"
set auto_index(month_number) "source $dir/date-utils.tcl"
set auto_index(date_compare) "source $dir/date-utils.tcl"
set auto_index(date_plus) "source $dir/date-utils.tcl"
set auto_index(date_string) "source $dir/date-utils.tcl"

set auto_index(mapcar) "source $dir/lisp.tcl"


3) edit timecard (a shell script) to aggregate any projects that should
be listed on one line.

4) run timecard, which calls time-report.tcl

This help file written 30 Jan 95, revised 20 Feb 95