Section: PILOT-LINK (1)
Updated: Copyright 1996-2007 FSF
Index Return to Main Contents


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


Read entries from file.


Conduit Options


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


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.



This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.



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