pilot-install-datebook man page

pilot-install-datebook — Installs one or more new datebook entries onto your Palm handheld.


pilot-link: Userland conduits


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


pilot-install-datebook allows the user to create one or more datebook entries from one or more source files.

The format of the source file contains one datebook entry per 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 repeated entries. The date and time must be in format understood 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" (minutes), "h" (hours), or "d" (days).


pilot-install-datebook options

-r, --read

Read entries from file.

Conduit Options

-p, --port

Use device file <port> to communicate with the Palm handheld. If this is not specified, pilot-install-datebook will look for the $PILOTPORT environment variable. If neither are found, pilot-install-datebook will print the usage information.


Suppress 'Hit HotSync button' message


Display the copyright information, version number, license details and build details and exit without connecting.

Help options

-?, --help

Show the help message and exit without connecting.


Display a brief usage message and exit without connecting.


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


([__TAB__] = tab, [__NL__] = newline 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__]


pilot-install-datebook was originally written by Tero Kivinen <kivinen@iki.fi>. This program was based on pilot-install-todos program written by Robert A. Kaplan <kaplan@openmarket.com>.

This manual page was converted to XML by Neil Williams <linux@codehelp.co.uk>


Known Bugs

If no timezone is given, pilot-install-datebook will assume the time is in GMT and it will convert it to localtime. If you don't want to create timezone entries for all begin and end times, set the TZ environment variable to GMT before running this program.

Reporting Bugs

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

See Also

pilot-install-todos(1), pilot-link(7).

Referenced By


Explore man page connections for pilot-install-datebook(1).