summaryrefslogtreecommitdiffstats
path: root/debian/pilot-link/pilot-link-0.12.5-dfsg/doc/man/pilot-install-datebook.1
blob: 6bfa93a7a95e76fd3a8f08eec160fb7d1246804d (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
138
139
140
141
.\"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-dat" 1 "Copyright 1996-2007 FSF" "0.12.5" "PILOT-LINK"
.SH NAME
pilot-install-datebook \- Installs one or more new datebook entries onto your Palm handheld.
.SH "SECTION"

.PP
pilot\-link: Userland conduits

.SH "SYNOPSIS"

.PP
 \fIpilot\-install\-datebook\fR [\fB\-p\fR|\fB\-\-port\fR <\fBport\fR>] [\fB\-\-version\fR] [\fB\-?\fR|\fB\-\-help\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-usage\fR] [\fB\-r\fR|\fB\-\-read\fR  \fIfile\fR]

.SH "DESCRIPTION"

.PP
 \fIpilot\-install\-datebook\fR allows the user to create one or more datebook entries from one or more source files\&.

.PP
The format of the source file contains one datebook entry per line, containing four tab separated fields\&. The fields are start date/time, end date/time, alarm settings, and the description of datebook entry\&. This program doesn't yet support repeated entries\&. The date and time must be in format understood by \fIparsedate\&.y\fR\&. At the very least, the following two formats are understood:

.PP
August 11, 1997 0800 GMT+300

.PP
1997/08/11 08:22:33 GMT+300

.PP
If either one of the date and time fields is empty, the entry is installed without time\&. If the alarm field is empty, the entry is installed without setting any alarms\&. The alarm field can contain numbers followed by "m" (minutes), "h" (hours), or "d" (days)\&.

.SH "OPTIONS"

.SS "pilot-install-datebook options"

                        \fB\-r\fR, \fB\-\-read\fR
                    
.PP
Read entries from \fIfile\fR\&.

.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\-datebook\fR will look for the \fI$PILOTPORT\fR environment variable\&. If neither are found, \fIpilot\-install\-datebook\fR will print the usage information\&.

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

                        \fB\-\-version\fR
                    
.PP
Display the copyright information, version number, license details and build details and exit without connecting\&.

.SS "Help options"

                        \fB\-?\fR, \fB\-\-help\fR
                    
.PP
Show the help message 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 target Palm device, and create Datebook entries based on the datebook\-formatted file given on the commandline onto the Palm handheld (into the DatebookDB\&.pdb file)\&.

.SH "EXAMPLES"

.PP
([__TAB__] = tab, [__NL__] = newline in these examples):

.PP
1997/08/11 0800 GMT+300 [__TAB__] 1997/08/11 0900 GMT+300 [__TAB__] [__TAB__] IETF Registration [__NL__]

.PP
August 11, 1997 0900 GMT+300 [__TAB__] August 11, 1997 0930 GMT+300 [__TAB__] 2m [__TAB__] Introductions [__NL__]

.SH "AUTHOR"

.PP
 \fIpilot\-install\-datebook\fR was originally written by Tero Kivinen <kivinen@iki\&.fi>\&. This program was based on \fIpilot\-install\-todos\fR program written by Robert A\&. Kaplan <kaplan@openmarket\&.com>\&.

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

.SH "BUGS"

.SS "Known Bugs"

.PP
If no timezone is given, \fIpilot\-install\-datebook\fR will assume the time is in GMT and it will convert it to localtime\&. If you don't want to create timezone entries for all begin and end times, set the TZ environment variable to GMT before running this program\&.

.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
 \fIpilot\-install\-todos\fR(1), \fIpilot\-link\fR(7)\&.