.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "pilot-install-todo" 1 "Copyright 1996-2007 FSF" "0.12.5" "PILOT-LINK"
.SH NAME
pilot-install-todo \- Updates the Palm ToDo list with one new entry.
.SH "SECTION"

.PP
pilot\-link: Userland conduits

.SH "SYNOPSIS"

.PP
 \fIpilot\-install\-todo\fR [\fB\-p\fR|\fB\-\-port\fR <\fBport\fR>] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-version\fR] [\fB\-?\fR|\fB\-\-help\fR] [\fB\-\-usage\fR] [\fB\-P\fR|\fB\-\-priority\fR [\fB1|2|3|4|5\fR]] [\fB\-d\fR|\fB\-\-due\fR  \fBmm/dd/yyyy\fR] [\fB\-c\fR|\fB\-\-completed\fR] [\fB\-D\fR|\fB\-\-description\fR [\fBtitle\fR]] [\fB\-n\fR|\fB\-\-note\fR  \fBnote\fR] [\fB\-f\fR|\fB\-\-file\fR  \fIfilename\fR]

.SH "DESCRIPTION"

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

.SH "OPTIONS"

.SS "pilot-install-todo options"

                        \fB\-P\fR,
                        \fB\-\-priority\fR \fBpriority\fR
                    
.PP
Specify the priority of the ToDo entry \- 1|2|3|4|5 (defaults to a priority of 1)\&.

.PP
 \fINOTE:\fR 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\&.

                        \fB\-d\fR,
                        \fB\-\-due\fR \fBduedate\fR
                    
.PP
The due Date MM/DD/YYYY (defaults to blank, no due date if this is not specified)\&.

                        \fB\-c\fR, \fB\-\-completed\fR
                    
.PP
Mark the item complete (the default is to mark the item as incomplete, as the Palm would do it)\&.

                        \fB\-D\fR,
                        \fB\-\-description\fR \fBtitle\fR
                    
.PP
The title of the ToDo entry

                        \fB\-n\fR, \fB\-\-note\fR
                        \fBnote\fR
                    
.PP
The Note text you wish to add to this ToDo entry, if any\&.

                        \fB\-f\fR,
                        \fB\-\-file\fR \fIfilename\fR
                    
.PP
A local filename containing the Note text\&.

.SS "Conduit Options"

                        \fB\-p\fR, \fB\-\-port\fR
                        <\fBport\fR>
                    
.PP
Use device file <\fIport\fR> to communicate with the Palm handheld\&. If this is not specified, \fIpilot\-install\-todo\fR will look for the \fI $PILOTPORT \fR environment variable\&. If neither are found or supplied, \fIpilot\-install\-todo\fR will print the usage information\&.

                        \fB\-q\fR, 
                        \fB\-\-quiet\fR
                    
.PP
Suppress 'Hit HotSync button' message

                        \fB\-v\fR, \fB\-\-version\fR
                    
.PP
Display version of \fIpilot\-install\-todo\fR and exit without connecting\&.

.SS "Help Options"

                        \fB\-h\fR, \fB\-\-help\fR
                    
.PP
Display the help synopsis for \fIpilot\-install\-todo\fR and exit without connecting\&.

                        \fB\-\-usage\fR 
                    
.PP
Display a brief usage message and exit without connecting\&.

.SH "USAGE"

.PP
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\&.

.SH "EXAMPLE"

.PP
 \fIpilot\-install\-todo\fR  \fB\-p\fR  \fI/dev/pilot\fR  \fB\-n\fR  \fB'Buy Milk'\fR  \fB\-D\fR  \fB'Go shopping, see note for items'\fR 

.SH "AUTHOR"

.PP
 \fIpilot\-install\-todo\fR was originally written by Martin Fick, based on code in \fIpilot\-install\-todos\fR by Robert A\&. Kaplan\&.

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

.SH "REPORTING BUGS"

.PP
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: \fIhttp://bugs.pilot-link.org\fR and report your bugs and issues there\&.

.SH "COPYRIGHT"

.PP
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\&.

.PP
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\&.

.PP
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\&.

.SH "SEE ALSO"

.PP
 \fIpilot\-install\-todos\fR(1), \fIpilot\-link\fR(7)\&.