           install-datebook - installs a new datebook entry onto your
           Palm handheld.

## SECTION

           pilot-link: Userland Conduits

## SYNOPSIS

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

## DESCRIPTION

           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" (min-
           utes), "h" (hours), or "d" (days).

## OPTIONS

       INSTALL-DATEBOOK OPTIONS
           -r, --read
                  Read entries from file.

       CONDUIT OPTIONS
           -p, --port <port>
                  Use device file <port> to communicate with the Palm
                  handheld.  If  this is not specified, install-date-
                  book will look for the $PILOTPORT environment vari-
                  able.  If  neither are found, install-datebook will
                  print the usage information.

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

           -q, --quiet
                  Suppress 'Hit HotSync button' message

           -?, --help
                  Show the help message and exit without  connecting.

           --usage
                  Display a brief usage message and exit without con-
                  necting.

## USAGE

           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).

## EXAMPLES

           ([__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__]

## 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.

           This manual page was written by Neil Williams  linux@code-
           help.co.uk

## BUGS

       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  create timezone entries for all begin and
           end times, set the TZ environment variable to  GMT  before
           running this program.

       REPORTING BUGS
           Report bugs at http://bugs.pilot-link.org/

## COPYRIGHT

           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
           License along with this program; if not, write to the Free
           Software  Foundation,  Inc.,  59  Temple Place, Suite 330,
           Boston, MA 02111-1307 USA

## SEE ALSO

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