read-ical - Exports the DatebookDB and/or ToDo applica-
tions to ical format.
SECTION
pilot-link: Userland Conduits
SYNOPSIS
read-ical [-p|--port <port>] [--version] [-q|--quiet]
[-?|--help] [--usage] [-d|--datebook] [-t|--pubtext pub-
text] [-f|--file file]
DESCRIPTION
Note, this is not the same as the iCal calendar format.
read-ical allows the user to retrieve the contents of the
ToDo and Datebook databases on a Palm handheld, and con-
vert their contents to an Ical calendar.
Note that the calendar file named by filename will be
deleted, so do not use your main calendar. Instead, use a
separate one for this purpose, and include it in your main
calendar.
As read-ical works by passing a script to ical, the ical
application must be in your $PATH.
OPTIONS
READ-ICAL OPTIONS
-d, --datebook
Datebook only, no ToDos
-t, --pubtext pubtext
Replace text of items not started with a bullet
with pubtext
-f, --file file
This is the file in which the ical-formatted data
should be saved. Note that this will be deleted,
so do not use your primary calendar file. See
DESCRIPTION for details.
CONDUIT OPTIONS
-p, --port <port>
Use device file <port> to communicate with the Palm
handheld. If this is not specified, read-ical will
look for the $PILOTPORT environment variable. If
neither are found, read-ical will print the usage
information.
-q, --quiet
Suppress 'Hit HotSync button' message
necting.
HELP OPTIONS
-h, --help.
Display the help synopsis for read-ical and exit
without connecting.
--usage
Display a brief usage message and exit without con-
necting.
USAGE
The program will connect to a target device, retrieve the
ToDo and Datebook databases (ToDoDB.pdb and DatebookDB.pdb
respectively), then instruct ical to write a calendar file
based on the retrieved information.
AUTHOR
read-ical was originally written by Kenneth Albanowski.
This manual page was written by Neil Williams linux@code-
help.co.uk
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
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., 59 Temple Place, Suite 330,
Boston, MA 02111-1307 USA
SEE ALSO
pilot-link(7)
Man(1) output converted with
man2html