==========================================
RUNTIME
V1.5.1a 6.7.2000
(c) Uwe Klimmek
uwe.klimmek@web.de
==========================================

Runtime is a tool for your Palm organizer, which is used to record the last ten 
changes of battery, its runtime between changes and the battery voltage over 
the last 120 days.

You may switch between the two main program screens by tapping the button 
at the upper-right corner of either screen, or by tapping your MENU button 
and selecting the first Option item ( "Bat.voltage" or "Runtime").

BAT. VOLTAGE SCREEN
On theleft side of this screen, the date of the last battery change is shown. 
Beside it is the time elapsed since this date.

On the right, you will see the runtime of your Palm with its current batteries. 
If 2 or more changes of battery have been recorded, the average of the 
runtimes is displayed above the bottom line. ("Avg" or "Mtl" in the german 
version).

On the bottom line, you will see the runtime since the last reset of your Palm.

The format "12d 13:24" means 12 days 13 hours and 24 minutes.

RECORDING A CHANGE OF BATTERY
Tap your MENU button and select the item, "New Battery" to register a change 
of battery.

In the displayed dialogbox, you have three choices:
<YES>: This records the change of battery with the current date and time.
<HAND>: This allows you to select a date and time for recording a change of 
battery.
<NO>: This aborts the procedure.

You can edit or delete the values of date and time of all stored battery changes
by tapping on the date (displayed in the left column). This action also allows 
you to enter a note of up to 100 characters in length.

BATTERY VOLTAGE GRAPH
Time is displayed on the x-axis. Voltages are displayed on the y-axis.
The current battery voltage is shown at the centre of the x-axis, between the 
two dates. The range of the voltage graph is adjustable and may be re-set by 
tapping the title "Battery voltage graph" at the top of the screen. In the 
displayed dialog box, adjust the range of the displayed voltages by selecting 
their minimum and maximum values. This adjustment is useful if you have 
rechargable batteries or a Palm V (which has a voltage range from 3.5V to 4V).

The option "Start" is triggered by tapping the button "Date" to select the
starting date of the x-axis. If you set this date before the first stored value
it starts with the first day stored. (If you select a day after the last stored day, 
you see nothing!)

The option "Count" determines the number of days for which voltage values 
will be displayed. Tap the arrows to increase or decrease the count. (I know, 
to tap 100 times to reduce te number from 120 to 20 is not user friendly. This is 
a point of improvement for future versions of the program.)

The option "Auto. Store" will cause the program to automatically record the 
battery voltage every day, without having to call the program from the launch 
pad. If you do not select this option, it is a good idea to call the program once 
a day, to make sure that it regularly records battery voltage. In this setting, the 
program will only store voltage values when the program is called.

The option "Lines" connects the points between each day's voltage with a line.

The option "Bars" draws a vertical line for every day. These lines represent the
minimum and maximum range of the detected battery voltage for each day.

The option "Backup" toggles on/off the Backup-Flag of the database. This 
enablesyou to make backups of the Battery database each time you perform 
a hotsync. With this option selected, you are able to restore your Battery 
database after a hard reset, by installing the file "runtimeDB.pdb" from the 
backup directory on your PC. With this option selected, your Battery data 
is "reset" resistant (stored in database "runtimeDB.pdb").

You can update older versions (V1.1, V1.2, V1.2.1, V1.3, V1.4 and V1.4.1) on 
your palm. Old data will be converted and used in the new version.

This software has a registerd App-ID "RuTi" from 3Com/Palm computing.

=======================================================================

PC-Tool pdb2csv

The program pdb2csv  converts a RuntimeDB.PDB File from
the Palm program Runtime/Laufzeit in a csv-File. This file-format can
be read from Excel.
The tool has a command line interface only. It is available for
Windows and Linux.

Usage:
-i inputfile
-o outputfile
[-g]
[-dc] 

-g: Switch to german as program language. Set colon as decimalsign. If
    not selected default language is english.
-dc: Select decimalsign. Place for c the character you want. 

Examples:

German language and colon as decimalsign:
pdb2csv -g -i runtimeDB.pdb -o runtime.csv

English language and dot as decimalsign: 
pdb2csv -i runtimeDB.pdb -o runtime.csv

English language and colon as decimalsign: 
pdb2csv -i runtimeDB.pdb -o runtime.csv -d,

German language and dot as decimalsign: 
pdb2csv -i runtimeDB.pdb -o runtime.csv -g -d.
(Attention: select -d after -g !)

Linux: pdb2csv is compiled for using library libc.so.6.

======================================================================

FILES INCLUDED
==============
Runtime.prc	The english version of the application
Laufzeit.prc	The german version of the application
pdb2csv.exe	Windows-Executable to convert runtimedb.pdb to csv-format
pdb2csv		Linux-Executable to convert runtimedb.pdb to csv-format
readme.txt	This file.

RELEASE NOTES / NEW FEATURES
============================
Runtime 1.5.1a	english version
Laufzeit 1.5.1a	german version
- Tool pdb2csv added. 
- improvements of readme.txt from Paul Fungs

Runtime 1.5.1	english version
Laufzeit 1.5.1	german version
- fixed a Bug for OS3.5: If a battery change date was edited and the 
  menu "Change battery" was invoked, a Palm with OS3.5 would hang.

Runtime 1.5	english version
Laufzeit 1.5	german version
- toggle Backup-Flag of database
- add note to battery change date

Runtime 1.4.1	english version
Laufzeit 1.4.1	german version
- all dates of battery change can be deleted

Runtime 1.4	english version
Laufzeit 1.4	german version
- all dates of battery change can be edited
- new menu functionality
- new about dialog
- button for battery change eliminated (use menu now)

Runtime 1.3.2	english version
Laufzeit 1.3.2	german version
- Bugfix for V1.3.1 (crashed, if installed for the first time)

Runtime 1.3.1	english version
Laufzeit 1.3.1	german version
- average runtime of the stored values are calculated and displayed.
- menu added. You can perform all actions now on each screen via menu.
- small icon for Palm OS3.0 added.
- Bugfix: if MenuHack (Hackmaster) was activated, the Palm has hang up.

Runtime 1.3.0	english version
Laufzeit 1.3.0	german version
- extend memory to store 120 days
- select date and time of the change of battery from hand (if
  forgotten at the moment when battery had been changed)
- show current voltage under the battery graph
- rescale x-axis by selection of start day and numbers of days.

Runtime 1.2.1	english version
Laufzeit 1.2.1	german version
- Bugfix in Auto store option

Runtime 1.2	english version
Laufzeit 1.2	german version
- Bugfix: the value of the 40. day was not correct copied on the
  41. day. This results in data, where only the 40. day and the last
  day were displayed.
- Adjustment of battery voltage range added.
- Option added for store the battery voltage automaticly.
- Display option added for the voltage graph.
- Now the date is formated corresponding the preferences in the setup.
- online help improved

Runtime 1.1	english version
Laufzeit 1.1	german version
- First public release. Tested on a PalmPilot Professional.

HOW TO CONTACT ME
=================
Got a suggestion?  Find a bug?  Send e-mail to uwe.klimmek@web.de
Thanks for all comments and suggestions, which have been sent to me.

LEGAL STUFF
===========
Runtime and Laufzeit are "freeware", meaning it's copyrighted software
and Uwe Klimmek retains all rights to it.

THIS SOFTWARE AND THE ACCOMPANYING FILES ARE PROVIDED "AS IS" AND
WITHOUT WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY
OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED. THE USER MUST ASSUME
THE ENTIRE RISK OF USING THE PROGRAM.