Penguin
Recent Changes
Blame: pilot-addresses(1)
EditPageHistoryDiffInfoLikePages
Annotated edit history of pilot-addresses(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 PILOT-ADDRESSES
2 !!!PILOT-ADDRESSES
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 TARGET DEVICE
7 OPTIONS
8 USAGE
9 EXAMPLES
10 SEE ALSO
11 AUTHOR
12 ----
13 !!NAME
14
15
16 pilot-addresses - read and write address book databases to and from a Palm Computing Device, Handspring Visor, TRGPro, or other Palm Compatible Handheld PDA
17 !!SYNOPSIS
18
19
20 __pilot-addresses__ -p ''[['' [[__-c__
21 ''category'' ] [[__-d__ ''category'' ] [[__-r__
22 ''file'' | __-w__ ''file'' ]
23
24
25 (Note that some options are not shown above)
26 !!DESCRIPTION
27
28
29 __pilot-addresses__ allows the user to read all entries
30 in the Palm address book database, write new entries into
31 the database, and delete a category or delete all entries in
32 the database. Once the user has executed
2 perry 33 __pilot-addresses__ the user must invoke !HotSync on the
1 perry 34 target device.
35 !!TARGET DEVICE
36
37
38 The default serial device used to communicate with a Palm is
39 __/dev/pilot__. If the environment variable
40 __$PILOTPORT__ is set, its value will override the
41 default. A serial device specified on the command-line will
42 be used regardless of any __$PILOTPORT__
43 setting.
44 !!OPTIONS
45
46
47 Several options exist, including...
48
49
50 __-a__
51
52
53 Augments fields in address book records with additional
54 information. The augmented information is placed before and
55 separated from the field with a semi-colon,
56 (;).
57
58
59 Augmented information includes:''
60 category_name'' - placed in front of each record
61 or
62
63
64 [[____ | ____ |
65 ____ | ____ |
66 ____ | ____ |
67 ____ | ____ ] -
68 placed in front of each phone number field.
69
70
71 Empty fields are not augmented.
72
73
74 __-c__ ''category''
75
76
77 Install records to category ''category'' by default.
78 Normally pilot-addresses uses ''Unfiled'' as the default
79 category. This option is overridden by the category
80 specified in the record with the __-a__
81 option.
82
83
84 __-d__ ''category''
85
86
87 Delete all records in the specified ''category'' before
88 installing new records.
89
90
91 __-D__
92
93
94 Delete all address book records in all categories.
95 Obviously, be very careful with this one.
96
97
98 __-e__
99
100
101 Escape all special characters with a backslash. This enables
102 you to read and write entries with newline characters in a
103 field or note.
104
105
106 __-q__
107
108
109 Causes __pilot-addresses__ to be quiet and not prompt you
2 perry 110 to press the !HotSync button.
1 perry 111
112
113 __-r__ ''file''
114
115
116 Reads records from ''file'' and install them to the Palm
117 address book database. (Use the __-w__ ''file'' to get
118 a template file for input records.)
119
120
121 __-t__ ''delim''
122
123
124 Include category in each record, use the delimiter specified
125 to separate all fields of a record. Delimiters are specified
126 as follows: 3=tab, 2=;, 1=,. This overrides the default
127 delimiter of comma between fields and semi-colon between a
128 field's augmented information. (Please note that this may
129 generate confusing results when used with the __-a__
130 option.)
131
132
133 __-T__
134
135
136 Write a header line with field titles as the first line of
137 the data file.
138
139
140 __-w__ ''file''
141
142
143 Get all address book records from the Palm address book
144 database and writes them into ''file''
145 !!USAGE
146
147
148 The program will connect to a target device and port, prompt
2 perry 149 the user to !HotSync, and perform the requested read or write
1 perry 150 operation specified by the user.
151 !!EXAMPLES
152
153
154 To write all address records in a Palm to the file
155 addrbook.csv:
156
157
158 pilot-addresses -w addrbook.csv
159
160
161 or
162
163
164 pilot-addresses -p /dev/irnine -w addrbook.csv
165
166
167 To read the address book records in the file addrbook.csv
168 and install them on a Palm:
169
170
171 pilot-addresses -r addrbook.csv
172
173
174 To read the address book records in the file addrbook.csv
175 and place them into the Palm address book database category
176 ''Special'' after first deleting all current records in
177 the ''Special'' category on the palm:
178
179
180 pilot-addresses -c Special -d Special -r
181 addrbook.csv
182 !!SEE ALSO
183
184
185 __pilot-link(7)__.
186 !!AUTHOR
187
188
189 __pilot-addresses__ written by _____. This manual page
190 was originally written by Robert Wittig.
191 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.