NAME
    install-datebook - installs a new datebook entries onto your Palm hand-
    held 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, con-
    taining 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 num-
    bers followed by "m" (minutes), "h" (hours), or "d" (days).
    Here are some example lines ("<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>

 OPTIONS
    none

USAGE
    The program will connect to the target Palm device, and write the date-
    book-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 running this program.

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

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

SEE ALSO