---
name: "install-todo"
section: "1"
platform: "linux"
package: "pilot-link"
version: "0.12.1-5"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/install-todo"
---

# install-todo(1)

Updates the Palm ToDo list with one new entry.

## NAME

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

## SECTION

pilot-link: Conduits

## SYNOPSIS

 *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*\]

## DESCRIPTION

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

## OPTIONS

### install-todo options

- **-P**, **--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.

- **-d**, **--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).

- **-D**, **--description** **title**

  The title of the ToDo entry

- **-n**, **--note** **note**

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

- **-f**, **--file** *filename*

  A local filename containing the Note text.

### Conduit Options

- **-p**, **--port** \<**port**\>

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

- **-q**, **--quiet**

  Suppress 'Hit HotSync button' message

- **-v**, **--version**

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

### Help Options

- **-h**, **--help**

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

- **--usage**

  Display a brief usage message and exit without connecting.

## USAGE

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.

## EXAMPLE

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

## AUTHOR

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

This manual page was converted to XML by Neil Williams \<linux@codehelp.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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.

## SEE ALSO

 [*pilot-link*(7)](/pilot-link/7.md).