Aug 7, 2003

This is an example and UNSUPPORTED script to convert a third party webmail 
addressbook format (Captaris webmail) to Sun ONE Messaging Server 
Personal Addressbook (PAB) used in version 5.x and 6.0.

Having said this, only the sections of the code that parse a "foreign" 
addressbook format as input can be easily changed for another addressbook 
format and the vast majority of the code can be reused.  Given the time 
constraints the author had tried his best to make the code as modular as 
possible so that it can be reused.  In particualr the functions that 
generate the output need not be modified.  The functions do things like 
generating random unique number, discarding duplicates, create hashes 
of the addressbook and lists, generate ldif etc

The cap2pab-guide-1.0.pdf file contains instructions on how to use the
cap2pab.pl script.
