                       Contacts-SSML to VCard Converter
                       ================================

This is an adaptation of Mark Adams' code -- part of the Sayanara Project --
for reading a Contacts file off a Psion and converting it into other formats.
It takes data in 'SSML' format (tag-based, like XML etc.) and generates 'VCard'
format output.  It is intended for use with PsiONtrack under BeOS (but the
code is not BeOS specific).

The original version of the program works under Linux and uses plptools (via a
socket) to connect to the Psion.  A custom server ('SYS$SAYANCNT') installed
there generates the SSML from the Contacts database.  The output is a form of
VCard intended for the Linux 'GnomeCard' PIM.

This variation has one main difference.  It expects another program to contact
the server on the Psion to read the SSML data, which should be piped to this
one via stdin.  A socket is not involved.  Output is normally to stdout, intended
for piping to a third application that -- under BeOS -- converts VCard data
to People files. There is a command-line option for specifying a file for
output instead, if desired.

Some minor changes were made to the VCard output, to ensure that it hopefully
confirms more exactly to the standard.  I believe it properly converts all
data in Contacts.  A bug or two in the original was also fixed.

The source should compile and run on almost any platform with a fairly standard
C++.  The supplied Makefile components, however, are BeOS-only, as they require
the standard eakefile-engine.

                                       -- Pete Goodeve --
                                       pete.goodeve@computer.org

                                       May 2002


You can find all the details of the Sayanara Project -- and the original
source code -- at:
             http://www.goldenlion.freeserve.co.uk/sayanara/

The VCard protocol is described at the Internet Mail Consortium's site:
             http://www.imc.org/
