Palm Pilot Flat-File Database Utilities
---------------------------------------

This package contains several utilities that allow you to convert text
files to and from several different Palm Pilot flat-file database
formats. The two formats currently supported are:

  The "DB" open source database
  http://pilot-db.sourceforge.net/

  MobileDB
  http://www.mobilegeneration.com/products/mobiledb/

  List
  http://www.magma.ca/~roo/list/list.html

  JFile v3.x (v4.x support later)
  http://www.land-j.com/jfile.html

Complete documentation for using the conversion utilities is provided
in the "manual.txt" file in the "docs" subdirectory. Windows users
should have several .exe files in this top-level directory. UNIX users
will need to follow the build instructions listed below in order to
get a set of executable programs.


Resources (WEB)
---------------

You can always find the latest version of this package at the
following URL:

  http://palm-db-tools.sourceforge.net/


Compiling on UNIX
-----------------

You will need a C++ compiler on your system which supports the STL and
exceptions. Then run the following commands to compile the utilities:

  ./configure
  make

In the "flatfile" directory, you will find the "csv2pdb" program which
is used to convert from text files to Palm Pilot format and the
"pdb2csv" program which is used to convert from a Palm Pilot format
back to text files.


Compiling on Windows
--------------------

You will need Microsoft Visual C++ 6.0 or higher. A workspace file is
stored in the "win32" subdirectory called "dbtools.dsw". Open this
file and then just build the projects as you normally would.
