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

This document describes how to produce the db.prc binary file from the
source code distribution.

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.) Follow the instructions at:

  http://www.palm.com/devzone/tools/gcc/

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. It is at:

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

You will also need a 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. The home page 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.prc file which can be HotSync'ed to your Palm
Pilot. 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, "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
