DB: Open Source Database Program for PalmOS
-------------------------------------------

*** WARNING: This program is DEVELOPMENT software. You use it at your
*** own risk. Since it is still under development, there may be bugs
*** which will cause it to crash your PDA to the point where it will
*** require a hard reset. (Hard resets cause loss of all data on the
*** PDA.)

DB is free software as specified in the GNU General Public License
included in the file COPYING.

Version 0.3.0 includes a new format for databases stored on the
PDA. However, DB can still read the format used under the 0.2.x
versions for compatibility purposes. During the 0.3.x series, the
database format may change. If it does, you may need to follow the
following procedure to use the old 0.2.x format as a "safe harbor"
during an upgrade:

1) Convert your databases back to the old format using the "Duplicate"
   option on the main screen.

2) Upgrade DB.

3) Convert your databases to the new format using the "Duplicate"
   option on the main screen.


Installation
------------

To install DB on your PDA, just HotSync one of the PRC file included
in the ZIP distribution to your PDA. (The .tar.gz distributions only
include source code.) The particular file depends on which language
you want:

  English     db.prc 
  German      db-de.prc
  Dutch       db-nl.prc

*** If you are upgrading from a previous version, please backup all
*** your DB databases to your desktop first. (This can be done by
*** enabling the "Backup database at HotSync" preference on all
*** databases.) Then delete the old version of DB from the PDA. You
*** can then install the new version of DB as described
*** above. Finally, use HotSync to restore your databases to the PDA.

Resources (Web and E-Mail)
--------------------------

You can find the latest version of DB at the following Web site:

  http://vger.rutgers.edu/~tdyas/pilot/

You can also join a mailing list for general discussion of DB. To
learn how to subscribe to this mailing list, just visit the following
Web site:

  http://lists.sourceforge.net/mailman/listinfo/pilot-db-list

You can post to this list by sending email to the following address:

  pilot-db-list@lists.sourceforge.net

Development of DB is now hosted at SourceForge. SourceForge is a site
which hosts free software projects. DB's particular page on
SourceForge is at the following Web site:

  http://sourceforge.net/projects/pilot-db/


Building Databases on your PC
-----------------------------

This package does not contain the conversion utilities that will take
text files and produce DB-format databases. They are available in a
seperate package called "palm-db-tools". You can get the latest copy
of the palm-db-tools from:

  http://vger.rutgers.edu/~tdyas/pilot/
