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.
142 lines
5.0 KiB
142 lines
5.0 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-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)\&.
|
|
|