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