pilot-addresses(1)

1pilot-addresses(1)                PILOT-LINK                pilot-addresses(1)
2
3
4

NAME

6       pilot-addresses  -  Read and write address book databases to and from a
7       Palm handheld.
8

SECTION

10       pilot-link: Userland conduits
11
12

LOCATION

14       ./src
15
16

SYNOPSIS

18        pilot-addresses [-p|--port <port>] [--version]  [-?|--help]  [--usage]
19       [-q|--quiet] [--delete-all] [-t|--delimiter  INT] [-d|--delete-category
20       category  ] [-c|--category  category] [-a|--augment] [-r|--read   file]
21       [-w|--write   file  ] [-C|--human-readable]
22
23

DESCRIPTION

25        pilot-addresses  allows the user to read all entries from a Palm hand‐
26       held such as those made by Palm, Handspring, Handera, TRGPro,  Sony  or
27       other  Palm  handheld  in  the Palm Address Book application, write new
28       entries into the database, and delete a category or delete all  entries
29       in the database.
30
31

COMMANDS

33       Provide exactly one of --read or --write.
34
35                           -r,
36                           --read=<file>
37
38
39       Reads  records  from  <file>  and install them to the Palm Address Book
40       application. (Use the -w <file> option to get a sample "template  file"
41       for input records to see how the fields are laid out).
42
43                           -w, --write=file
44
45
46       Reads  all  address book records from the Palm Address Book application
47       and writes them into  file
48
49

OPTIONS

51   pilot-addresses options
52                               -a, --augment
53
54
55       Augments fields in address book records  with  additional  information.
56       The augmented information is placed before and separated from the field
57       with a semi-colon, (;).
58
59
60       Augmented information can include any of the following below.
61
62
63        category # Placed in front of each record or..
64
65
66       Placed in front of each phone number field:
67
68
69       ["Work"|"Home"|"Fax"|"Other"|"E-mail"|"Main"|"Pager"|"Mobile"]
70
71
72       Empty fields are not augmented.
73
74                               -c,
75                               --category=category
76
77
78       Install   records   to   category   category   by   default.   Normally
79       pilot-addresses  uses  the  Unfiled category by default. This option is
80       overridden by the  category  specified  in  the  record  with  the   -a
81       option.
82
83                               -d, --delete-category
84
85
86       Delete all records in the specified category category before installing
87       new records.
88
89
90       Note that the long name of this option has changed since 0.11.8
91
92                               -D, --delete-all
93
94
95       Delete all address book records in all categories. Obviously,  be  very
96       careful with this one.
97
98
99       Note that the long name of this option has changed since 0.11.8
100
101                               -t,
102                               --delimiter INT
103
104
105       Include  category  in each record, use the delimiter specified to sepa‐
106       rate all fields of a  record.  Delimiters  are  specified  as  follows:
107       3=tab,  2=;, 1=,. This overrides the default delimiter of comma between
108       fields and semi-colon between a field's augmented information.  (Please
109       note  that  this  may  generate confusing results when used with the -a
110       option.)
111
112
113       Note that the long name of this option has changed since 0.11.8
114
115                               -T, --titles
116
117
118       Obsolete. This option has been removed since 0.11.8
119
120                               -C|--human-readable
121
122
123       Write generic human-readable output instead of CSV.
124
125
126   Conduit Options
127                               -p,
128                               --port <port>
129
130
131       Use device file <port> to communicate with the Palm handheld.  If  this
132       is  not specified, pilot-addresses will look for the  $PILOTPORT  envi‐
133       ronment variable. If neither are  found  or  supplied,  pilot-addresses
134       will print the usage information.
135
136                               -q,
137                               --quiet
138
139
140       Suppress 'Hit HotSync button' message
141
142                               -v, --version
143
144
145       Display version of pilot-addresses and exit without connecting.
146
147
148   Help Options
149                               -h, --help
150
151
152       Display the help synopsis for pilot-addresses and exit without connect‐
153       ing.
154
155                               --usage
156
157
158       Display a brief usage message and exit without connecting.
159
160

USAGE

162       The program  will  connect  to  the  Palm  handheld,  and  perform  the
163       requested read or write operation specified by the user.
164
165

EXAMPLES

167       To write all address records in a Palm to the file addrbook.csv:
168
169
170        pilot-addresses  -w  addrbook.csv
171
172
173       or
174
175
176        pilot-addresses  -p  /dev/pilot  -w  addrbook.csv
177
178
179       To  read  the address book records in the file addrbook.csv and install
180       them onto the Palm:
181
182
183        pilot-addresses  -r  addrbook.csv
184
185
186       To read the address book records in the  file  addrbook.csv  and  place
187       them  into  the Palm address book database category Special after first
188       deleting all current records in the  Special  category on the palm:
189
190
191        pilot-addresses  -c  Special  -d  Special  -r  addrbook.csv
192
193

AUTHOR

195        pilot-addresses originally written by Kenneth Albanowski, this  manual
196       page  was  originally  written by Robert Wittig <bob.wittig@gt.org> and
197       later updated by David A. Desrosiers <hacker@gnu-designs.com> and  Neil
198       Williams <linux@codehelp.co.uk>.
199
200

REPORTING BUGS

202       We  have  an  online  bug tracker. Using this is the only way to ensure
203       that your bugs are recorded and that we can track them until  they  are
204       resolved  or  closed. Reporting bugs via email, while easy, is not very
205       useful in  terms  of  accountability.  Please  point  your  browser  to
206       http://bugs.pilot-link.org:  http://bugs.pilot-link.org and report your
207       bugs and issues there.
208
209

COPYRIGHT

211       This program is free software; you can redistribute it and/or modify it
212       under  the  terms of the GNU General Public License as published by the
213       Free Software Foundation; either version 2 of the License, or (at  your
214       option) any later version.
215
216
217       This  program  is  distributed  in the hope that it will be useful, but
218       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
219       CHANTABILITY  or  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
220       Public License for more details.
221
222
223       You should have received a copy of the GNU General Public License along
224       with this program; if not, write to the Free Software Foundation, Inc.,
225       51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
226
227