pilot-addresses(1) Conduits pilot-addresses(1)NAMEpilot-addresses - read and write address book databases to and from a
Palm handheld, such as those made from Palm, Handspring, Handera, TRG‐
Pro, Sony or other Palm handheld.
SYNOPSISpilot-addresses [-p <port>] [-c <category>] [-d <category>] [-r <file>
| -w <file>]
(Note that not all available options are shown above)
DESCRIPTIONpilot-addresses allows the user to read all entries in the Palm Address
Book application, write new entries into the database, and delete a
category or delete all entries in the database.
OPTIONS-p, --port <port>
Use device file <port> to communicate with the Palm handheld.
If this is not specified, will look for the $PILOTPORT environ‐
ment variable. If both are not found or supplied,
install-expenses will fall back to /dev/pilot.
-h, --help
Display the help synopsis for pilot-addresses.
-v, --version
Display version of pilot-addresses.
-a, --augment
Augments fields in address book records with additional informa‐
tion. The augmented information is placed before and separated
from the field with a semi-colon, (;).
Augmented information can include any of the following below.
<category> # Placed in front of each record or..
Placed in front of each phone number field:
["Work"|"Home"|"Fax"|"Other"|"E-mail"|"Main"|"Pager"|"Mobile"]
Empty fields are not augmented.
-c, --category <category>
Install records to category <category> by default. Normally
pilot-addresses uses the Unfiled category by default. This
option is overridden by the category specified in the record
with the -a option.
-d, --delcat <category>
Delete all records in the specified category <category> before
installing new records.
-D, --delall
Delete all address book records in all categories. Obviously, be
very careful with this one.
-e, --escape
Escape all special characters with a backslash. This enables you
to read and write entries with newline characters in a field or
note.
-r, --read <file>
Reads records from <file> and install them to the Palm Address
Book application. (Use the -w <file> option to get a sample
"template file" for input records to see how the fields are laid
out).
-t, --tdelim <delim>
Include category in each record, use the delimiter specified to
separate all fields of a record. Delimiters are specified as
follows: 3=tab, 2=;, 1=,. This overrides the default delimiter
of comma between fields and semi-colon between a field's aug‐
mented information. (Please note that this may generate confus‐
ing results when used with the -a option.)
-T, --titles
Write a header line with field titles as the first line of the
data file.
-w, --write <file>
Reads all address book records from the Palm Address Book appli‐
cation and writes them into <file>
USAGE
The program will connect to the Palm handheld, and perform the
requested read or write operation specified by the user.
EXAMPLES
To write all address records in a Palm to the file addrbook.csv:
pilot-addresses-w addrbook.csv
or
pilot-addresses-p /dev/pilot -w addrbook.csv
To read the address book records in the file addrbook.csv and install
them onto the Palm:
pilot-addresses-r addrbook.csv
To read the address book records in the file addrbook.csv and place
them into the Palm address book database category Special after first
deleting all current records in the Special category on the palm:
pilot-addresses-c Special -d Special -r addrbook.csv
BUGS
KNOWN BUGS
pilot-addresses has no known bugs at this time.
REPORTING BUGS
Report bugs at http://bugs.pilot-link.org/
AUTHORpilot-addresses originally written by Kenneth Albanowski, this manual
page was written by Robert Wittig <bob.wittig@gt.org> and later updated
by David A. Desrosiers <hacker@gnu-designs.com>
SEE ALSOaddresses(1)pilot-link(7)
(c) FSF 1996-2003 pilot-link - 0.11.8 pilot-addresses(1)