
-----------------------------------------------------------------------
SyncMAL plugin for J-Pilot

by Jason Day <jasonday@worldnet.att.net>
http://jasonday.home.att.net
-----------------------------------------------------------------------

REQUIREMENTS

- J-Pilot version 0.99.2 or greater, available from http://jpilot.org


INSTALLING

Building jpilot-syncmal used to be a chore, but it's much simpler now.  Just
extract jpilot-syncmal_x.xx.tar.gz into a directory somewhere, then do the
standard
   ./configure
   make
to build libsyncmal.so.  Then you can either do a global install, by becoming
root and typing:   
   make install
or you can do a local install by typing:
   make local_install
This will install libsyncmal.so in your ~/.jpilot/plugins directory.  Or, if
you want to install manually, copy .libs/libsyncmal.so to your location of
choice, preferably somewhere J-Pilot can find it :-).

If you've installed pilot-link in a non-standard location, or if configure
complains that it cannot find the pilot-link headers, try using the
--with-pilot-prefix=/path/to/pilot-link switch.  There are other options
to configure that might be of interest; type ./configure --help to list
them all.

IMPORTANT: If you built J-Pilot with GTK2 support, you *must* use the
--enable-gtk2 option when building jpilot-syncmal.


If you can't get SyncMAL to build, please reread these instructions
carefully, and if you still can't get it to work send me a message at
jasonday@worldnet.att.net and I'll see what I can do.

NOTE: If you run 'make install' or 'make local_install', libtool will issue
the following warning message:

libtool: install: warning: remember to run libtool --finish
/usr/local/share/jpilot/plugins'

Please ignore this message.


USAGE

If you've never used AvantGo before, point your browser at
http://avantgo.com and explore for a while.  Make sure you visit
http://avantgo.com/doc/mobile/unix.html while you're there; this page
has instructions and links to software that you will need.

Once you have your account setup and your pilot configured correctly (see
the web sites above), using SyncMAL should be very straightforward: just enter
your proxy or SOCKS configuration, if necessary, and make sure the enabled
checkbox is checked.

NOTE: SyncMAL stores its preferences in a file called "syncmal.rc" in your
~/.jpilot directory.  This means that your proxy username and password, if
entered, are stored in plain text.  SyncMAL will make sure that syncmal.rc
is readable only by the owner, and will complain if the permissions are
otherwise.


ACKNOWLEDGEMENTS

To say I wrote this program would not be correct.  I simply implemented the
required plugin callbacks needed for J-Pilot and added them to the malsync
code by Tom Whittaker (http://www.tomw.org).

Thanks also to Chris Bagwell <cbagwell@sprynet.com> for making SyncMAL work
with J-Pilot 0.99's new plugin architecture.


BUGS

If you find a bug, please send me a message at jasonday@worldnet.att.net .
It would also be helpful to start J-Pilot in debug mode (jpilot -d),
reproduce the bug, and send the contents of ~/.jpilot/jpilot.log in the
message.


Thank you for using SyncMAL!
Jason Day <jasonday@worldnet.att.net>
