.TH VCF2PQ
.SH NAME
vcf2pq \- convert vCards into pq-style data files
.SH SYNOPSIS
.B vcf2pq
.I file ...
.SH DESCRIPTION
.I Vcf2pq
reads
.IR file ,
which must contain one or more vCards, 
and converts it to a set of data files suitable for use by
.IR pq (1).
The corresponding Proto files are not created. The schema
used by the files
.IR person ,
.IR ema ,
.IR tel ,
.IR im ,
and
.I addr
are, respectively:
.TS
a a a a a a a a a a.
ID	nick	first	mid	last	suff	org	dept	title cats
ID	ema	role
ID	tel	type	role
ID	im	type	role
ID	role	street	city	state	zip	cc2
.TE
Attributes in the vCard other than those needed to construct
these entries are discarded. Most entries should be obvious;
the rest are:
.TP
.I ID
Sequential record number from
.IR file .
Used to correlate entries in the different tables.
.TP
.I cats
Categories taken from the vCard, often groups in the
creating program.
.TP
.I role
One of
.IR work ,
.IR home ,
or
.IR other ,
indicating the affiliation.
.TP
.I type
In the
.I im
data file, indicates the network
.RI ( aim , " jabber" ...).
In the
.I tel
data file, one of
.IR fixed ,
.IR mobile ,
or
.IR fax ,
indicating the type of line.
.PP
The created data files will be correctly correlated to each
other using their order in
.I file
and should not be assumed
to remain constant across invocations. This is sufficient to
ensure internal consistency and is useful for an initial
import, but is not (directly) suitable for updating an existing
database.

.SH SOURCE
.B /n/sources/contrib/anothy/src/vcf2pq
.SH SEE ALSO
.IR pq (1)
.SH BUGS
Only lightly tested, primarially against vCards exported
from Apple's Address Book.
.br
Various custom labels are all forced to "other".
.br
It might be prudent not to overwrite existing data files.