                       VCard to 'People' Converter
                       ===========================

This is a BeOS application that will accept VCard-format data (by one of
several routes) and generate appropriate Person files.  These are placed in
the sub-folder 'Contacts' of /boot/home/people so that they do not immediately
supplant any of the same name that might already exist in the main people folder.

A VCard file (or several at once) may be dragged onto the app's icon to do
the conversion, or it may be called from the command line with the names of
VCard files.  If invoked from the shell with no arguments, it expects the
data on stdin, so that VCard data may be piped from another program -- for
example 'ssml2vcard'.

This app should (hopefully) accept any standard VCard data, and convert
what it can to Person file attributes.  It tries to be reasonably smart in
deciding which VCard line should be dumped in which attribute, but it probably
won't always be smart enough, so the results should be checked before moving
them to the main people folder.  A number of possible VCard tags (such as
'ADR;WORK') have no real Person-file equivalent and will be discarded -- at
least if a more relevant ('ADR') line exists. [You have the source, so fix it
if you don't like my choices! (:-)]

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

                                       May 2002


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