~ubuntu-branches/ubuntu/karmic/pilot-link/karmic

.\"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-memo" 1 "Copyright 1996-2007 FSF" "0.12.2" "PILOT-LINK"

.SH NAME

pilot-install-memo \- Installs a new Memo Pad entry onto your Palm handheld.

.SH "SECTION"

 

.PP

pilot\-link: Userland conduits

 

.SH "SYNOPSIS"

 

.PP

 \fIpilot\-install\-memo\fR [\fB\-p\fR|\fB\-\-port\fR <\fBport\fR>] [\fB\-\-version\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-?\fR|\fB\-\-help\fR] [\fB\-\-usage\fR] [\fB\-c\fR|\fB\-\-category\fR  \fBname\fR] [\fB\-r\fR|\fB\-\-replace\fR] [\fB\-t\fR|\fB\-\-title\fR] [\fB\-f\fR|\fB\-\-file\fR  \fBSTRING\fR \&.\&.\&.]

 

.SH "DESCRIPTION"

 

.PP

 \fIpilot\-install\-memo\fR allows the user to write one or more files as a new memo or memos, respectively, onto the Palm handheld\&.

 

.SH "OPTIONS"

 

.SS "pilot-install-memo options"

 

                        \fB\-c\fR,

                        \fB\-\-category\fR \fBcategory\fR

                    

.PP

Install memo(s) to category defined by \fBcategory\fR\&. \fIpilot\-install\-memo\fR uses the \fBUnfiled\fR category as the default category if no category is chosen or if the specified category does not already exist on the Palm\&.

 

                        \fB\-f\fR,

                        \fB\-\-file\fR \fISTRING\fR

                    

.PP

File containing the target memo entry\&. Append other filenames to install one memo per file\&.

 

                        \fB\-r\fR, \fB\-\-replace\fR

                    

.PP

Replace all memos in the category specified by the \fB\-c\fR  \fIcategory\fR option\&.

 

                        \fB\-t\fR \fB\-\-title\fR

                    

.PP

Use the filename as the title for the memo\&. (Normally, the first line of a memo is used as the title if one is not supplied with the \fB\-t\fR option)\&.

 

.SS "Conduit Options"

 

                        \fB\-p\fR, \fB\-\-port\fR\fBport\fR

                    

.PP

Use device file <\fBport\fR> to communicate with the Palm handheld\&. If this is not specified, \fIpilot\-install\-memo\fR will look for the \fI $PILOTPORT \fR environment variable\&. If neither are found or supplied, \fIpilot\-install\-memo\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\-memo\fR and exit without connecting\&.

 

.SS "Help Options"

 

                        \fB\-h\fR, \fB\-\-help\fR

                    

.PP

Display the help synopsis for \fIpilot\-install\-memo\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 the Palm handheld, and create memo entries for each file(s) given on the commandline into the Memo Pad application on the Palm\&.

 

.SH "AUTHOR"

 

.PP

 \fIpilot\-install\-memo\fR was originally written by Damien P\&. Neil <neild@rpi\&.edu>\&.

 

.PP

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

 

.SH "BUGS"

 

.SS "Known Bugs"

 

.PP

The Palm Device has a maximum length of 4,096 bytes (4k) on memopad entries, if you wish to retain the ability to edit the Memo (add/remove/change data within the memo) on the Palm itself\&. You can create a memo entry of 65,490 bytes in size (the absolute maximum) if you do not need to edit the memo entry any further on the Palm device itself\&. Any memo larger than 4,096 bytes and less than 65,490 bytes will not be editable on the Palm itself\&. Consider these memo entries "read\-only"\&.

 

.PP

This is not specifically a "bug", but a limitation in the PalmOS design itself\&.

 

.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

 \fImemos\fR(1), \fIpilot\-link\fR(7)\&.