install-datebook(1)
NAME
install-datebook - installs a new datebook entries onto
your Palm handheld device
SYNOPSIS
For serial devices, the -p <port> option is required, or you may use the $PILOTPORT environment variable: install-datebook -p /dev/ttySX filename [filename filename ...] For USB devices, the new USB port specification is: install-datebook -p usb:/dev/ttyUSBX filename [filename filename ...]
DESCRIPTION
install-datebook allows the user to write one or more
datebook entries from one or more source files. Once
install-datebook is started, the user must invoke HotSync
on the target device by pressing the HotSync button on the
cradle or by tapping on the HotSync icon in the Palm
launcher.
The format of the source file contains one datebook entry
on line, containing four tab separated fields. The fields
are start date/time, end date/time, alarm settings, and
the description of datebook entry. This program doesn't
yet support repeted entries. The date and time must be in
format understand by parsedate.y. At the very least, the
following two formats are understood:
August 11, 1997 0800 GMT+300
1997/08/11 08:22:33 GMT+300
If either one of the date and time fields is empty, the
entry is installed without time. If the alarm field is
empty, the entry is installed without setting any alarms.
The alarm field can contain numbers followed by "m" (min
utes), "h" (hours), or "d" (days).
Here are some example lines ("<TAB>" = tab, "<NL>" = new
line in these examples):
-> 1997/08/11 0800 GMT+300 <TAB> 1997/08/11 0900 GMT+300
<TAB> <TAB> IETF Registration <NL>
- -> August 11, 1997 0900 GMT+300 <TAB> August 11, 1997 0930
GMT+300 <TAB> 2m <TAB> Introductions <NL> - OPTIONS
- none
USAGE
The program will connect to the target Palm device, and
write the datebook-formatted file given on the command
line onto the Palm into the DatebookDB.pdb file.
KNOWN BUGS
If no timezone is given, install-datebook will assume the
time is in GMT and it will convert it to localtime. If you
don't want to write timezone entries to all begin and end
times, set the TZ environment variable to GMT before run
ning this program.
REPORTING BUGS
Report bugs at http://bugs.pilot-link.org/
AUTHOR
install-datebook was written by Tero Kivinen <kivi_ nen@iki.fi>. This program was based on install-todos pro gram written by Robert A. Kaplan <kaplan@openmarket.com>.