install-datebook(1)		   Conduits		  install-datebook(1)



NAME
       install-datebook	 - installs a new datebook entry onto your Palm hand-
       held.



SYNOPSIS
       install-datebook [-p ] -r [ ...]



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 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
       No options are supported at this time.



USAGE
       The program will connect to the target Palm device, and	create	Date-
       book entries based on the datebook-formatted file given on the comman-
       dline onto the Palm handheld (into the DatebookDB.pdb file).



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


       REPORTING BUGS

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

AUTHOR
       install-datebook was written by Tero  Kivinen  .	 This
       program was based on install-todos program written by Robert A. Kaplan
       .



SEE ALSO
       install-todos(1)



(c) FSF 1996-2003	     pilot-link - 0.11.8	  install-datebook(1)

UNIX/Linux commands referenced on this page:

1. more
2. file
3. date
4. time
5. at
6. convert