You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

151 lines
4.5 KiB

.\"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-read-todos" 1 "Copyright 1996-2007 FSF" "0.12.5" "PILOT-LINK"
.SH NAME
pilot-read-todos \- Syncronize your Palm ToDo application's database with your desktop machine.
.SH "SECTION"
.PP
pilot\-link: Userland conduits
.SH "SYNOPSIS"
.PP
\fIpilot\-read\-todos\fR [\fB\-p\fR|\fB\-\-port\fR <\fBport\fR>] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-A\fR|\fB\-\-archived\fR] [\fB\-w\fR|\fB\-\-write\fR]
.PP
\fIpilot\-read\-todos\fR [\fB\-f\fR|\fB\-\-file\fR \fIfile\fR] [\fB\-A\fR|\fB\-\-archived\fR] [\fB\-w\fR|\fB\-\-write\fR]
.PP
\fIpilot\-read\-todos\fR [\fB\-\-version\fR] [\fB\-?\fR|\fB\-\-help\fR] [\fB\-\-usage\fR]
.SH "DESCRIPTION"
.PP
\fIpilot\-read\-todos\fR will read the ToDo database on the Palm handheld, or read the ToDoDB\&.pdb file directly from disk on your desktop machine, and print the contents to STDOUT (generally the screen)\&.
.PP
Use only one of \fB\-\-port\fR or \fB\-\-file\fR\&.
.SH "OPTIONS"
.SS "pilot-read-todos option"
\fB\-f\fR, \fB\-\-file\fR \fIfile\fR
.PP
Read a local todo database file from disk for printing\&. Excludes \-\-port\&.
\fB\-A\fR, \fB\-\-archived\fR
.PP
Write archived entries only, in human\-readable format
\fB\-w\fR, \fB\-\-write\fR
.PP
Write output \- every operation must include a write command\&.
.SS "Conduit Options"
\fB\-p\fR, \fB\-\-port\fR \fIport\fR
.PP
Use device file <\fIport\fR> to communicate with the Palm handheld device\&. If this is not specified, \fIpilot\-read\-todos\fR will look for the \fI $PILOTPORT \fR environment variable\&. If neither are found or supplied, \fIpilot\-read\-todos\fR will print the usage information\&.
.PP
Excludes \-\-file\&.
\fB\-q\fR,
\fB\-\-quiet\fR
.PP
Suppress 'Hit HotSync button' message
\fB\-v\fR, \fB\-\-version\fR
.PP
Display version of \fIpilot\-read\-todos\fR and exit without connecting\&.
.SS "Help Options"
\fB\-h\fR, \fB\-\-help\fR
.PP
Display the help synopsis for \fIpilot\-read\-todos\fR and exit without connecting\&.
\fB\-\-usage\fR
.PP
Display a brief usage message and exit without connecting\&.
.SH "USAGE"
.PP
Connect to a target Palm handheld and read the ToDo database, or read the ToDoDB\&.pdb file from disk and print the entries found to STDOUT\&.
.SH "EXAMPLES"
.PP
Read the on\-Palm ToDo database, and dump to STDOUT\&.
.PP
\fIpilot\-read\-todos\fR \fB\-w\fR \fB\-p\fR \fI/dev/pilot\fR
.PP
Read the ToDoDB\&.pdb file on disk, and dump to STDOUT
.PP
\fIpilot\-read\-todos\fR \fB\-w\fR \fB\-f\fR \fIToDoDB\&.pdb\fR
.SH "AUTHOR"
.PP
\fIpilot\-read\-todos\fR was originally written by Kenneth Albanowski
.SH "BUGS"
.SS "Known Bugs"
.PP
\fIpilot\-read\-todos\fR does not support Notes attached to ToDo items at this time\&.
.SS "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
\fIinstall\-todo\fR (1), \fIinstall\-todos\fR (1), \fIpilot\-link\fR(7)