This is simple timer application for PalmOS.
Useful when the timer on your toaster is broken.

REQUIREMENTS

PalmOS device (PalmOS version 2.0 and up should work,
but only Palm V with PalmOS 3.1 is tested).
Program to install with.

Only if you're building from source:
pilrc and prc-tools (I use pilrc-2.5c and prc-tools-2.0)
m4

BUILDING (unless there already are an up to date toast_timer.prc)

Make sure the prc-tools (m68k-palmos-gcc, etc. ) and pilrc are in the PATH

> ./configure
> make

INSTALLATION

Since this is beta quality software you should make a backup of all
your data before installing the program.

Install toast_timer.prc on your PalmOS device the usual way.

USAGE 

The application has 8 independent timers, each one may have
it's own alarm sound (or none).

Every timer occupies one row on the main page.
This page consists of four columns.
From left to right they are:

Timer name
This name is used when notifying that a timer has expired.
The filed is editable in place.

Countdown field
Shows how much time is left before expiring.

Preset field
The timer will start counting from this time.
Tap on it to bring up a dialog to change this time.

Control buttons
These are (left to right):
Pause - Stop them timer. Continue by pressing the run button.
Run - Start the countdown
Reset - Resets the counter to the preset value


Menus
There are some pages available through menus in the main page.
The Authors and Copying pages gives information about the application.

The preferences page enables you to set:

The number of times the alarm sound will repeat (unless you press Dissmiss).

The delay between the repeating alarm sounds.

Where to look for MIDI-sounds. In all MIDI-databases on the device or 
just the one defined by the system.


KNOWN PROBLEMS

When turned off the alarm is only checked once a minute.
Because of this the alarm may go off up to a minute later than supposed to.
If you know any solution to this please contact me.

BUGS

Report any bug you find to ksb@citu.kth.se

Please include:
Tools used to build (if there was a problem with building)
PalmOS version
Type of device
How to reproduce the bug

