           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)