SECTION

pilot-link: Userland conduits

SYNOPSIS

 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]

DESCRIPTION

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

OPTIONS

pilot-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, pilot-install-todo will look for the $PILOTPORT environment variable. If neither are found or supplied, pilot-install-todo will print the usage information.

                        -q, 
                        --quiet
                    

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.

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

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

AUTHOR

 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 <[email protected]>

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.

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.