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

QuickStart
----------

Step 0: Titrax needs PalmOS 2.0 or higher. If your PalmPilot still uses
PalmOS 1.x you can't run this version of titrax. Use version 1.23 instead.

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

Step 2: Install the included shared library libtitrax.prc on your Pilot.

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

Step 4: If you are a first time user of Titrax, you should read the
Tutorial.

Step 5: New AND experienced users should always read the News file, as i
update the README very infrequently and add changes and new features to
the NEWS file only.

Step 6: Start the program.

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

This was (and is still) my first program for the pilot. 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 GENERAL PUBLIC LICENSE. Be sure to read license.txt for full
details.

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

First of all this README, the shared library libtitrax.prc 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 will only need
libtitrax.prc and 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. For more information how to use it, you should
read the tutorial.

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
libtitrax.prc and 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.

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

I would very much like to get some feedback (comments, bugs, flames, ...).
Email should be sent to titrax@sifry.com.

The authors?
-----------

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

and

Dave Sifry <david@sifry.com>

