TCLogger version 0.5

Even though there are many time card logging programs out there, some
that are pretty good, none of them completely filled my needs.  I
decided to write my own time card logger.  The purpose is to accumulate
time for a specific charge number or program throughout the day.  At the
end of the day you copy data from TCLogger onto your timecard.

For changes to this version see "HISTORY" file.

This software is distributed FREE under the GPL (see below).

FEATURES:

     - Has 7 timers for accumulating time.
     - Switch back and forth between projects/charge numbers and get a
       single accumulated time.
     - "Go Home" Alarm.
     - Export data to the MemoPad.
     - ToDo application is launched when ToDo hardbutton pushed.  This
       allows TCLogger to be assigned to the ToDo hard button and you
       can still easily launch ToDo application by pushing it a second
       time.
     - "Go Home" Alarm for when required total time has been reached.

NOTE:  The only major design decision I made was to not round data.
When a timer is checked, it accumulates seconds.  The seconds are
converted into selected display format.  The formats are hours and
tenths of hours, hours and minutes, and seconds (not really useful
except for testing).  The rounding design decision results in you don't
see minutes incremented until a full 60 seconds is reached.  If the
timer has been running for 59 seconds the display will be 0:00.

USAGE:

Just enter a description (optional) and check the checkbox next to it to
start accumulating time.

TCLogger also has a "In" and "Out" button for recording in and out times
for the day.

The "Update Timers"  button is used to update the timers to show the
currently accumulated time.  I did not have the displays dynamically
update since I did not want to possibly run down batteries by signing up
for the "nil" event.  I heard/believe, but have no proof, that this
could drain batteries.

Menus

     Export to MemoPad (/M) - This menu exports the data to the Unfiled
     category of the MemoPad.  The first line contains the date the data
     was exported.  Only timers with non-zero time are exported.

     Preferences (/O) - This menu brings up the preferences dialog.
     From here you can toggle the dynamic updating of timers on or off,
     and you can set your accumulated time total for the "Go Home"
     Alarm.  The alarm is also turned on or off from here.  Time format
     can be changed.

     All the Edit menus function like the ones you have seen before.

     Clear Focused - Clears the accumulated time for the timer that
     currently has focus (insertion point on time or description of
     timer.  The timer must be stopped to clear.

     Clear Stopped - Clears all stopped timers and clears the In and Out
     times.

     Display - allows switching between display formats (H.H, H:M, Sec).

When editing the time accumulated, the timer must be stopped.  The time
entered must have the format H.H, H:M, SEC.  Hit the "Update Timers"
button to make sure the time was valid.  Edited time that is invalid
will not be replaced and the previous time will be restored.  Starting a
timer or hitting "Update Timers" will cause the program to check and
validate time that has been edited.

If you want map TCLogger to the ToDo hardware button so you can bring it
up quickly when changing charged projects/numbers.

I have been running TCLogger on my PalmIIIx for several weeks and have
not had problems with it.  This does not mean it will work correctly for
everyone, so please test it for awhile to make sure it works the way you
expect.

INSTALLATION:

Just use your normal method of installing PalmOS applications to install
the tclogger.prc file onto your Palm Connected organizer.  You do not
have to remove any old versions prior to the install.  Always remember
to backup before installing a new application.

FILES:

     README - this file
     HISTORY - revision history file and wanted future additions.
     tclogger.prc - TCLogger program
     callback.h - Callback routine needed for GNU gcc compiled programs
     tclogger.bmp - icon bitmap
     tclogger.c - main program source code
     tclogger.h - include file for defines of IDs
     tclogger.rcp - resource file for prctools
     tclogger.xpm - XPM version of icon
     util.c - Utilities I try to reuse on other programs
     util.h - include file for Utilities
     util.rcp - resource file for Utilities
     util_id.h - include file for defines of Utilties IDs
     Makefile - makefile for use with tools listed below


In order to give back some software, since I use a Linux/GNU system, I
am distributing this application under the GNU General Public License
(GPL).  See http://www.gnu.org/copyleft/gpl.html for a copy of the
license.

I would like to thank all the programmers that provided tools that I
used to develop this program.  Here is a list of the PalmOS development
tools I used:

     pilot-xfer-0.9.0
     pilrc-2.3a
     gcc-2.7.2 cross compiler for Palm Connected Organizers
     gdb-4.16
     prctools-0.5.0
     pilot-template-1.31
     xcopilot-0.6.6

DISCLAIMER:

This software comes with NO warranty at all and I cannot be held
responsible for anything it may do.  I take no responsibility for any
problems that may arrise by using this program to log time.  Please
fully check out the program to make sure it logs time as you expect.  I
make no claims as to my ability to write programs.  You have the source
code, so check it out. 


Enjoy,

Kevin Dupree
kdupree@flash.net
