NAME

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

SECTION

       pilot-link: Userland conduits

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

   pilot-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,
       pilot-install-datebook  will  look for the $PILOTPORT environment variable. If neither are
       found, pilot-install-datebook will print the usage information.

                               -q,
                               --quiet

       Suppress 'Hit HotSync button' message

                               --version

       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.

                               --usage

       Display a brief usage message and exit without connecting.

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

        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>

BUGS

   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.

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

SEE ALSO

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