summaryrefslogtreecommitdiffstats
path: root/debian/pilot-link/pilot-link-0.12.5-dfsg/doc/man/pilot-install-memo.1
blob: 1a9a48f7d863e4fbf035b8e0882abfd3e7f5e60b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
.\"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.5" "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)\&.