pilot-install-datebook(1)

1pilot-install-dat(1)              PILOT-LINK              pilot-install-dat(1)
2
3
4

NAME

6       pilot-install-datebook - Installs one or more new datebook entries onto
7       your Palm handheld.
8

SECTION

10       pilot-link: Userland conduits
11
12

SYNOPSIS

14        pilot-install-datebook  [-p|--port  <port>]  [--version]   [-?|--help]
15       [-q|--quiet] [--usage] [-r|--read  file]
16
17

DESCRIPTION

19        pilot-install-datebook  allows the user to create one or more datebook
20       entries from one or more source files.
21
22
23       The format of the source file contains one  datebook  entry  per  line,
24       containing  four  tab separated fields. The fields are start date/time,
25       end date/time, alarm settings, and the description of  datebook  entry.
26       This  program  doesn't  yet support repeated entries. The date and time
27       must be in format understood by parsedate.y. At  the  very  least,  the
28       following two formats are understood:
29
30
31       August 11, 1997 0800 GMT+300
32
33
34       1997/08/11 08:22:33 GMT+300
35
36
37       If  either  one  of  the  date  and  time fields is empty, the entry is
38       installed without time. If the alarm  field  is  empty,  the  entry  is
39       installed  without setting any alarms. The alarm field can contain num‐
40       bers followed by "m" (minutes), "h" (hours), or "d" (days).
41
42

OPTIONS

44   pilot-install-datebook options
45                               -r, --read
46
47
48       Read entries from file.
49
50
51   Conduit Options
52                               -p, --port
53                               <port>
54
55
56       Use device file <port> to communicate with the Palm handheld.  If  this
57       is  not  specified, pilot-install-datebook will look for the $PILOTPORT
58       environment variable. If neither are found, pilot-install-datebook will
59       print the usage information.
60
61                               -q,
62                               --quiet
63
64
65       Suppress 'Hit HotSync button' message
66
67                               --version
68
69
70       Display  the copyright information, version number, license details and
71       build details and exit without connecting.
72
73
74   Help options
75                               -?, --help
76
77
78       Show the help message and exit without connecting.
79
80                               --usage
81
82
83       Display a brief usage message and exit without connecting.
84
85

USAGE

87       The program will connect to the target Palm device, and create Datebook
88       entries  based  on the datebook-formatted file given on the commandline
89       onto the Palm handheld (into the DatebookDB.pdb file).
90
91

EXAMPLES

93       ([__TAB__] = tab, [__NL__] = newline in these examples):
94
95
96       1997/08/11 0800 GMT+300 [__TAB__]  1997/08/11  0900  GMT+300  [__TAB__]
97       [__TAB__] IETF Registration [__NL__]
98
99
100       August  11,  1997  0900  GMT+300 [__TAB__] August 11, 1997 0930 GMT+300
101       [__TAB__] 2m [__TAB__] Introductions [__NL__]
102
103

AUTHOR

105        pilot-install-datebook was originally written by Tero  Kivinen  <kivi‐
106       nen@iki.fi>.  This  program  was  based  on pilot-install-todos program
107       written by Robert A. Kaplan <kaplan@openmarket.com>.
108
109
110       This manual page was converted to XML  by  Neil  Williams  <linux@code‐
111       help.co.uk>
112
113

BUGS

115   Known Bugs
116       If no timezone is given, pilot-install-datebook will assume the time is
117       in GMT and it will convert it to localtime. If you don't want to create
118       timezone  entries  for  all begin and end times, set the TZ environment
119       variable to GMT before running this program.
120
121
122   Reporting Bugs
123       We have an online bug tracker. Using this is the  only  way  to  ensure
124       that  your  bugs are recorded and that we can track them until they are
125       resolved or closed. Reporting bugs via email, while easy, is  not  very
126       useful  in  terms  of  accountability.  Please  point  your  browser to
127       http://bugs.pilot-link.org: http://bugs.pilot-link.org and report  your
128       bugs and issues there.
129
130

COPYRIGHT

132       This program is free software; you can redistribute it and/or modify it
133       under the terms of the GNU General Public License as published  by  the
134       Free  Software Foundation; either version 2 of the License, or (at your
135       option) any later version.
136
137
138       This program is distributed in the hope that it  will  be  useful,  but
139       WITHOUT  ANY  WARRANTY;  without  even  the  implied  warranty  of MER‐
140       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the  GNU  General
141       Public License for more details.
142
143
144       You should have received a copy of the GNU General Public License along
145       with this program; if not, write to the Free Software Foundation, Inc.,
146       51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
147
148