read-ical(1)

read-ical1

Exports the datebookdb and/or todo applications to ical format.

Usage

read-ical [{-p | --port <port>}] [--version] [{-? | --help}] [{-q | --quiet}] [--usage] [{-d | --datebook}] [{-t | --pubtext pubtext}] [{-f | --file file}]

Section

pilot-link: Conduits

Overview

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 convert 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

-v, --version

Display version of read-ical and exit without connecting.

Help Options

-h, --help.

Display the help synopsis for read-ical and exit without connecting.

--usage

Display a brief usage message and exit without connecting.

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.

Releases

6 releases since Debian 2.0 (Hamm); the text changed 5 times.

  1. 2.0
  2. 2.1
  3. 2.2
  4. 3.0
  5. 3.1
  6. 4.0

--datebook since Debian 4.0 (Etch); --file since Debian 4.0 (Etch); --help. since Debian 4.0 (Etch); --port since Debian 3.1 (Sarge); --pubtext since Debian 4.0 (Etch); --quiet since Debian 4.0 (Etch); --usage since Debian 4.0 (Etch); --version since Debian 3.1 (Sarge); -d since Debian 4.0 (Etch); -f since Debian 4.0 (Etch); -h since Debian 3.1 (Sarge); -p since Debian 3.1 (Sarge); -q since Debian 4.0 (Etch); -t since Debian 4.0 (Etch); -v since Debian 3.1 (Sarge).

--help until Debian 3.1 (Sarge).

Author

read-ical was originally written by Kenneth Albanowski.

This manual page was converted to XML by Neil Williams <[email protected]>

Reporting bugs

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

From pilot-link 0.12.1-5 in Debian 4.0 (Etch). Parsed by carta from the page's man source.