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















































Man(1) output converted with man2html