Excel Sheet Installation and Usage
----------------------------------

xdbtools.xlt is an Excel model sheet which give you the opportunity
to modify the databases created on the Palm device with Pilot-DB.

The self-extractor will install xdbtools.xlt model sheet in your 
installation directory and your "Application data\Microsoft\Teplates"
directory.

Create a new document with xdbtools model sheet. There is two ways
to do that:
   1. Start Excel and select the "File/New" menu. In the box select
      the "xdbtools" model.
   2. Open directly the xdbtools.xlt file (you canfind a link in your
      start menu).
Enable the macro, and select a database from your palm backup
directory in the first box.
In the first sheet you can modify all fields of your database.
In the second one you can find 3 buttons:
   1. Load: to reload the current *.pdb file.
   2. Save and install: to save your data in the *.pdb file and ask
      the installation at the next synchronisation of your palm.
   3. Init: to load a new *.pdb file.
When you save your database a box ask to select the merge mode:
   1. Rebuild: to rebuild  the database with all and only wit the data
      of the first sheet. (RECOMMENDED)
   2. Diff: to rebuild the database with the data of he first sheet
      modified since the loading and the existing data of the database
	  *.pdb.
   3. Append: to rebuild the database with the data of the first sheet
      and the existing data inside the database *.pdb.
   4. Do not merge: to rebuild the database from scratch. You can
      modify the database structure with the Metadata displayed in the
	  second sheet.

StarOffice 5.2 sheet Installation and Usage
-------------------------------------------

Start SartOffice 5.2 and select the "File/new/from models" menu. In the
box select the "pdbtools" model.

To Launch the macros, select the "Tools/Macro" menu. In the box select
the macro inside "[document]/standard/Main" that you need.
    pdb2csv macro: read a Palm Database (*.pdb) file and put the data
	               in the current sheet. A (*.csv) and (*.ifo) files are
				   still created.
    csv2pdb macro: create a Palm Database (*.pdb) file with the (*.ifo)
	               file which have the same name and with the data of the
				   current sheet. A (*.csv) file are created.
    OpenMetaFile macro: open the (*.ifo) file which have the same name
	                    that the Palm Database (*.pdb) file.
    (SelectFilePath macro is unuse)

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
as root:
  make install

The default install directory is /usr/local, you need to check if the
directory /usr/local/lib is written in the /etc/ld.so.conf file. You can
modifiy the install directory during the configuration, please run the
following command to know all the features availables:

  ./configure --help

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

You need cygwin tools and build like on UNIX.

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.


