Build Instructions
------------------

This document describes how to produce the db-LANG.prc binary file
from the source code distribution. (LANG will be replaced with a
language code.)

The first step is to make sure that you have a recent copy of the
prc-tools package installed. The prc-tools package includes a complete
compiler toolchain and debugger that support PalmOS. (It is just gcc,
binutils, and gdb with PalmOS patches.) You will need to install
prc-tools version 2.0.90 (2.1pre1) or higher. Follow the instructions
at the following URL to download this version of prc-tools:

  http://prc-tools.sourceforge.net/

Next, you will need to install a SDK (Software Development Kit) which
contains the header files and libraries needed to build any PalmOS
application. Make sure that you install version 3.5 of the PalmOS SDK
and apply the 3.5update1 update. The SDK can be found at the URL:

  http://www.palm.com/devzone/tools/sdk35.html

You will also need a recent copy of PilRC which turns the db.rcp
resource file into the binary resources expected by PalmOS. Visit the
PilRC home page to download a copy of PilRC. You should download and
install version 2.7a or later. The PilRC Web site is at:

  http://www.ardiri.com/index.cfm?redir=palm&cat=pilrc

You are now ready to build DB. To build the English version of DB,
just run:

  make

You will now see a db-en.prc file which can be installed on your Palm
Pilot device using HotSync. Other languages can be built be running
the command:

  make db-LANG.prc

where LANG is the two letter language code for the language that you
want. DB currently supports "de" for German, "fr" for French, "nl" for
Dutch, and "ja" for Japanese.

You can clean up all of the files that are created during the build
process by running the command:

  make distclean
