
If you have unsynced changes sync before installing a newer version of
J-Pilot.

Be sure to read the docs in the doc directory, or if installed from the RPM
in /usr/doc/jpilot-0.97/.

To compile J-Pilot you need to have GTK+1.2 or better.
You can find out what version you have by running "gtk-config --version".
GTK+ requires glib.  The glib version probably should match the gtk version.
You can also do a "glib-config --version".
You can get these at http://www.gtk.org

Pilot link must be installed and working.
ftp://ryeham.ee.ryerson.ca/pub/PalmOS/
RedHat users must also have the pilot-link-dev rpm installed for the header
 files so that jpilot can compile.  You don't need these if you install the
RPM.

If you want i18n support you should have gettext installed.  Preferably GNU
gettext.  If you don't have or want it use "configure --disable-nls"

To compile and install do the following:
./configure
make
make install
jpilot

For Japanese support, use ./configure --with-japanese, ./configure --help
will list all the options.

See below for compiling plugins.

make uninstall is an option also.

I have included a spec file so if you want to create your own RPM all you
have to do is "rpm -tb jpilot-0.99.tar.gz"


JPilot was written in such a way that it should be very safe to sync.
There is always the possibility of something going wrong though.  As with
anything else, backup your data if you cannot afford to lose it.  Just make
sure your backup software destroy it first ;)


I have added a couple of example plugins Expense, and SyncTime.  To use them
change to the directory (Expense, SyncTime, etc.) and do
./configure
make
make install (installs the plugin system wide)
If you want to install the plugin for just 1 user you can copy the shared
library to ~/.jpilot/plugins/

--- Error Messages ---

Message:
bash$ jpilot
jpilot: error in loading shared libraries: libpisock.so.3: cannot open 
shared object file: No such file or directory
bash$

Solution:
libpisock.so is the pilot-link shared library.
J-Pilot uses this library to talk over the serial port to the palm.
You can find it by doing a "locate libpisock".
Shared libraries are loaded at runtime, not compile time.
This error is caused by ld.so not being able to find libpisock.so
You can fix this by either adding the path to libpisock.so to the environment
variable LD_LIBRARY_PATH.  Do this by
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/libpath in bash, some other shells have
different syntax.  This can be put in your .bashrc, or profile, etc.
The other way to fix it is to add the path to libpisock in /etc/ld.so.conf
and then run ldconfig.  You need root to do this.

