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

0.12.5                                       Copyright 1996-2007 FSF                        pilot-install-dat(1)