
This is the README for titrax version 1.20
------------------------------------------

QuickStart
----------

Step 1: If an older version of titrax is installed on your pilot save the data
and remove this version because the titrax database will be erased when 
installing the new version.

Step 2: Install the included titrax.prc on your Pilot.

Step 3: Start the program.

News
----

News since 1.19

 o the total amount of time is stored separately into the memopad note

News since 1.18

 o added an experimental timestamp option

News since 1.17

 o fixed a stupid off-by-one bug in the notes code

News since 1.16

 o all menues can be invoked by tapping into the windows title bar

News since 1.15

 o fixed the redraw-bug in the notes-dialog introduced in 1.15

 o added "undo" and "select all" menu options in the notes- and edit-dialog

News since 1.14

 o removed the minor scrolling glitch 

 o added a new about-box

News since 1.13

 o scrolling in the notes dialog is working (with one minor glitch)

 o removed the size limits for the notes. Notes are now handled 
   dynamically

 o added a datestamp button in the note dialog

 o Titrax should now be 2 or 3 k smaller

News since 1.12

 o you can switch between existing(!) projects by pressing the Pilots up
   and down keys (for those guys who do not want to use pens or fingers)

 o separated the sources into various files

 o removed timestamp menu-option

 o added scrolling for the notes window

 o interface changes

News since 1.11

 o changed the icons for the note-symbols

 o added a timestamp menu-option (explained in the tips text)

 o added a timestamp button to the note dialog

News since 1.10

 o new menu item "justification" in the main menu toggles between centered
	and left justified project names

 o all times are displayed right justified and with as many digits as 
	nessesary

 o new menu items "cut, "copy" and "paste" in the edit- and note-dialog

 o added a seperate "clear all" button

 o tapping on the times will switch the project AND invoke the edit-form

News since 1.9

 o changed the layout of the project window
 
 o minor improvements in the user interface

 o the project buttons are now pushbuttons

 o changed the redraw algorithm (there might be redraw problems, please
   report!)

News since 1.8

 o The edit dialog box and the notes dialog box will select the current
   string only if the current string is empty. 

 o more code clean ups

 o no new features

News since 1.7

 o Titrax can now save all names, times and notes into a memopad note

News since 1.6

 o open dialogs should be restored when switching apps

News since 1.5

 o the database code seems to work now

 o database uses a seperate record for each chunk of slot information

 o factored out most stuff from the start/stop application code

 o no new features

News since 1.4

 o complete code rewrite, i am not sure why it works, but it seems to 

 o projects can now accumulate time up to 999 hours

 o you can add notes to every project

 o shift-time-to-other project now displays the accumulated time of both 
   projects

 o Titrax should(?!) now work on PalmOS 1.x devices

 o Titrax uses a database with one record for each project information slot
   (perhaps this will be the start of a conduit???)

News since 1.3

 o none, only code clean ups

News since 1.2

 o solved redraw problems

 o new layout for the edit-project form 

Readme First!
-------------

This is my first program for the pilot and it is still in beta. I make this
program available for the public in the hope that some people will help in 
completing this program or suggest improvements (both in functionality and
coding style). The code is provided as is, with no warranties.

Copyright?
----------

I am releasing the titrax program and the sources as free software, licensed 
under the GNU PUBLIC LICENSE. Be sure to read license.txt for full details.

What is inside the package?
---------------------------

First of all this README and the Pilot executable titrax.prc. Furthermore 
the c-sources, the resource files titrax.rcp and titrax.bmp and the Makefile. 
To use this program you only need titrax.prc.

What is titrax?
---------------

Titrax is a well known time tracking utility. It is usefull for people who
are working in many different projects and have to track their daily time
spent in any project. The original titrax is available for UNIX and M$. 
This program is a from scratch rewrite of the original software written
by Harald Tveit Alvestrand.

Usage
-----

Start Titrax by tapping it's icon (for frequent users with PalmOS 2.x devices
it could be useful to attach Titrax to one of the Pilots knobs). You will
see the main screen with empty slots waiting for your projects. In the lower
part of the screen you will see four buttons (explained later).

Just start over by tapping one of the empty slots. A dialog box will pop up
where you can enter the project name. When done, tap "Ok". The dialog box
will disappear and the slot will show the project name you have entered and
a time. The whole slot will be highlighted, to show you that this project is
currently active. The timer in the right half of the slot will count the time
since you activated this project. You can enter more projects in the same 
manner.

You can stop the timer for the current project by tapping on it's slot, the 
slot will be unhighlighted, to show you that this project is inactive.

You can switch between projects by tapping the project you want to activate
(you can also use the Up and Down keys on your Pilot). Only one project can
be active, so when you tap a inactive slot, this project is activated and 
the formerly active project is deactivated.

If you want to manipulate the times of the current project, press the 
"Edit" button in the lower part of the screen. The dialog box you have seen 
when creating the project will pop up. In the upper part of this dialog you 
can modify the timer for this project. Just tap the digit you want to change 
and use the up and down buttons. 

If you want to shift time from this project to another project, select the
project to shift to with the popup list in the middle of the box. Select one 
of the available projects and use the "5m", "30m" and "60m" buttons to shift
5, 30 or 60 minutes from the active project to this project. The current time
of other project is shown to the left of the "5m" button. 

If you want to modify the project name, change it in the stringfield in the
lower part of the dialog box. If you clear the project name, the project
is cleared (this means: zero the timer and remove the notes for this 
project).

When you check the "log project start/stop time" button, all activations and
deactivations of this project will produce a timestamp in the notes for the
current project.

You can add textual notes to any project. When you create a project you will
notice a small empty note icon appearing at the rightmost part of the screen. 
When you tap this icon a dialog box will pop up where you can enter your notes 
for this project. Furthermore you can insert the current time and the current
date with the "time" and "date" buttons. When you are finished with your
notes tap "Ok". You will notice, that the icon changes to a filled o'note.

Beneath the "Edit" button in the lower part of the screen, you will see the
"Clr" button. This button resets the current project (it's timer and notes but
not the project name).

With the "Clr All" button, you can reset all projects (timers and notes).

With the "Save" button you can save all projects, times and notes into a
memopad note, but remember the 4096 byte limit for memopad notes. If your
data is too big, the program will warn you and you can abort the process
and try to save the data trough the clipboard mechanism. After a succesful
save the program will ask you to reset all projects.

All dialog boxes have a menu where you can access the Pilot clipboard.

How was it done?
----------------

I have used prc-tools-0.5.0 and xcopilot for development and debugging on 
a Linux-PC. The application ID Ttrx is registered with 3COM/USR.

Installation?
-------------

If you want to use the provided executable you only have to install titrax.prc
with the Pilot Installer (you should delete any old version of titrax before 
installing). If you want to rebuild or modify the source you will have to 
modify the Makefile. The paths to the gcc and other programs are specific 
for my setup.

Open problems?
--------------

(I am still missing some comments from the Pilot programming gurus)
Up to now some i have not really understood some of the redraw mechanisms 
of the Pilot. For example: How can the program notice, when the user switches
off the device and switches it on a few minutes later?

What else?
----------

I would very much like to get some feedback (comments, bugs, flames, ...). 

The author?
-----------

Bernd Esser <Bernd.Esser@testnetz.detecon.net>
DETECON GmbH, Oberkasseler Str.2, 53222 Bonn, Germany
