pilot-install-todo man page

pilot-install-todo — Updates the Palm ToDo list with one new entry.


pilot-link: Userland conduits


pilot-install-todo [-p|--port <port>] [-q|--quiet] [--version] [-?|--help] [--usage] [-P|--priority [1|2|3|4|5]] [-d|--due mm/dd/yyyy] [-c|--completed] [-D|--description [title]] [-n|--note note] [-f|--file filename]


pilot-install-todo allows the user to install one new ToDo list entry with specified paramters passed to pilot-install-todo and add a Note entry using text found in a filename <filename> passed to pilot-install-todo.


pilot-install-todo options

--priority priority

Specify the priority of the ToDo entry - 1|2|3|4|5 (defaults to a priority of 1).

NOTE: this value has changed from the default of 4 to the default of 1, just as a new ToDo entry on the Palm would set it.

--due duedate

The due Date MM/DD/YYYY (defaults to blank, no due date if this is not specified).

-c, --completed

Mark the item complete (the default is to mark the item as incomplete, as the Palm would do it).

--description title

The title of the ToDo entry

-n, --note

The Note text you wish to add to this ToDo entry, if any.

--file filename

A local filename containing the Note text.

Conduit Options

-p, --port

Use device file <port> to communicate with the Palm handheld. If this is not specified, pilot-install-todo will look for the $PILOTPORT environment variable. If neither are found or supplied, pilot-install-todo will print the usage information.


Suppress 'Hit HotSync button' message

-v, --version

Display version of pilot-install-todo and exit without connecting.

Help Options

-h, --help

Display the help synopsis for pilot-install-todo and exit without connecting.


Display a brief usage message and exit without connecting.


The program will connect to a target Palm handheld, and creates the ToDo entry to the Palm ToDo application, using the specified parameters and input from the supplied file passed as arguments on the commandline.


pilot-install-todo -p /dev/pilot -n 'Buy Milk' -D 'Go shopping, see note for items'


pilot-install-todo was originally written by Martin Fick, based on code in pilot-install-todos by Robert A. Kaplan.

This manual page was converted to XML by Neil Williams <linux@codehelp.co.uk>

Reporting Bugs

We have an online bug tracker. Using this is the only way to ensure that your bugs are recorded and that we can track them until they are resolved or closed. Reporting bugs via email, while easy, is not very useful in terms of accountability. Please point your browser to http://bugs.pilot-link.org: http://bugs.pilot-link.org and report your bugs and issues there.

See Also

pilot-install-todos(1), pilot-link(7).

Referenced By


Explore man page connections for pilot-install-todo(1).