REQUIREMENTS
The windows client comes complete with all software needed to run the
webcalngsync application.  The webcalngsync script provided for Unix
based clients requires that the pilot-link tools be installed on the
client system, and that pilot-xfer can be found via the user's \$PATH
environment variable.  Unix based clients will also require Perl and
the necessary Perl modules such as p5-Palm, Tk, and LWP.


RUNNING
To run webcalngsync on a Windows client, just double click on the
desktop shortcut, or select the application from the Start menu.
To run the webcalngsync GUI on a Unix based client, just type in
"webcalngsync.pl" and it will start up.  If you would like to run
the webcalngsync application on a Unix client in command line mode
only, just run "webcalngsync.pl -nogui".

The GUI version of webcalngsync will allow you to easily configure
all options.  If you are runnig the command line version of the
application on a Unix client, you will be prompted for the
configuration options as needed.  The only command line option
that you may need to use is "-f" in order to force the application
to "Keep all data", as described in the Options section below.

If you have an application that is consistently waiting for a
connection from your palm pilot, such as the Palm Desktop Software
on a Windows client, you will need to disable it in order for the
webcalngsync application to communicate with your Palm Pilot and
run successfully.  The exception to this is if you are using the
Backup Buddy integration features of webcalngsync.  See the "USING
webcalngsync WITH Backup Buddy" section below for more information.


CONFIGURATION
->webcalng URL: This is the URL for the webcalng server that you will be
synchronizing your palm pilot with.
  Example: http://my.webserver.com/cgi-bin/webcalng/webcalng.pl

->webcalng calendar: This is the name of your webcalng calendar.

->webcalng username: This is the username that you use to login to
webcalng.  This user must be the owner of the calendar that you are
synchronizing your palm pilot with.

->webcalng password: This is the password that you use with your webcalng
username when logging in to webcalng.  The password is not saved along
with the other configuration data, so you must enter it before every
synchronization.

->palm pilot device: This is the name of the device used to access your
palm pilot when doing a synchronization.  The webcalngsync client supports
synchronizing your palm pilot via a serial port on both Windows and
Unix based clients.  The following are some examples, but you will need to
find out what the correct device name is for your configuration.

  Serial port on a Linux client:   /dev/ttyS0
  Serial port on a Windows client: COM1

The webcalngsync also supports synchronizing your USB connected palm pilot
device natively on Unix platforms, if you have a working version of the
pilot-link toolkit that can connect to your USB connected Palm Pilot.
In order to use webcalngsync with USB connected palm pilots on the Windows
platform, see the "USING webcalngsync WITH Backup Buddy" section below.

->Saving your configuration: Choose File->Save Configuration to save all
current configuration values so that they are present the next time you
launch the webcalngsync client.


OPTIONS
->Keep all data: If you select this option, then all items in your
palm pilot datebook will be written to webcalng, and all items in
webcalng will be written to the palm pilot.  This is a useful option if
you have lost all your palm pilot data, and need to get it restored from
the items in your webcalng calendar.  It may also be useful when you
first synchronize your palm pilot with webcalng if you had previously
been using a different synchronization method.  If the webcalngsync
application detects that all data is about to be removed from either
webcalng or your palm pilot, it will abort and instruct you to use
this option, in order to prevent data loss.


SYNCHRONIZATION
Hit the "Synchronize" button.  The status of the synchronization process
will be displayed in the status box.  You will be prompted to hit the
"HotSync" Icon on your palm pilot device two times during the process.
The first time you hit the HotSync Icon, the webcalngsync application will
pull the palm pilot DateBook data off your palm pilot.  After comparing this
data to your webcalng data, the DateBook database file will be rewritten,
and you will be prompted to hit the HotSync Icon again in order to copy the
updated DateBook database back onto the palm pilot


USING webcalngsync WITH Backup Buddy
Backup Buddy is Palm Pilot backup software for the Windows platform.  It
integrates with the Palm Desktop software, so there is no need to disable
the Palm Desktop software when using webcalngsync in a configuration with
Backup Buddy.  You can use the Backup Buddy integration features of
webcalngsync to synchronize webcalng with a USB connected Palm Pilot, or
with any other type of Palm Pilot connection that the Palm Desktop software
supports.

The way to configure webcalngsync to do a Backup Buddy assisted
synchronization is to use a special "palm pilot device" in the webcalngsync
configuration screen.  If the "palm pilot device" begins with "file:",
and then contains the path to a DatebookDB.PDB file, webcalngsync will
assume that you are referring to a Backup Buddy created Datebook database
file.  Here is an example of just such a configuration:

file:C:\Palm\username\backup\DatebookDB.PDB

Be sure to substitue your Palm Pilot username for the "username" section of
the path given above.

There are two other requirements in order to do a Backup Buddy assisted
synchronization:

1. In the Backup Buddy configuration screen, select "Backup builtin
   databases mapped to conduits".
2. On your Windows client, right click on hotsync icon task bar.  Go to
   "Custom".  Select "DateBook" and "Change".  Select "Do Nothing", and
   make sure "Set as default" is checked.

Here are the steps to do a Backup Buddy assisted synchronization with
webcalng:

1. Initate a hotsync before launching webcalngsync.  This will copy the
   current DatebookDB.PDB to the Palm backup directory.
2. Launch webcalngsync.  For your palm pilot device, use something like
   "file:C:\Palm\username\backup\DatebookDB.PDB".  Hit "Synchronize".
3. webcalngsync will compare the data in your backup DatebookDB.PDB file with
   the data in webcalng.  It will update webcalng, and create a new
   DatebookDB.pdb file to be used for installation onto your Palm.
4. webcalngsync will launch the Palm instapp.exe utility to schedule the
   updated DatebookDB.pdb file for installation at the next hotsync.  Just
   click on "Done" when the instapp.exe utility is launched.
5. webcalngsync can now be exited.  You should then run one more hotsync to
   get the updated DatebookDB.pdb file put onto your Palm Pilot.


LICENSE
The webcalngsync palm pilot sync application is released under the GNU GPL.
The base webcalng application is not released under the GNU GPL.
See the webcalng homepage for webcalng licensing information.
webcalngsync is copyright 2004 webcalng software solutions