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