NAME

       pilot-addresses  -  read and write address book databases to and from a
       Palm handheld, such as  those  made  from  Palm,  Handspring,  Handera,
       TRGPro, Sony or other Palm handheld.

SYNOPSIS

       pilot-addresses  [-p <port>] [-c <category>] [-d <category>] [-r <file>
       | -w <file>]

       (Note that not all available options are shown above)

DESCRIPTION

       pilot-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
              environment  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
              information.  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
              augmented  information.  (Please  note  that  this  may generate
              confusing 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
              application 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/

AUTHOR

       pilot-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 ALSO

       addresses(1) pilot-link(7)

(c) FSF 1996-2003             pilot-link - 0.11.8           pilot-addresses(1)