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.

184 lines
5.6 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-foto" 1 "Copyright 1996-2007 FSF" "0.12.5" "PILOT-LINK"
.SH NAME
pilot-foto \- Palm 'Foto' Image Installer/Remover/Fetcher/Converter
.SH "SECTION"
.PP
pilot\-link: Userland conduits
.SH "SYNOPSIS"
.PP
\fIpilot\-foto\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\-d\fR|\fB\-\-delete\fR] [\fB\-\-delete\-all\fR] [\fB\-i\fR|\fB\-\-install\fR] [\fB\-l\fR|\fB\-\-list\fR] [\fB\-f\fR|\fB\-\-fetch\fR] [\fB\-F\fR|\fB\-\-fetch\-all\fR] [\fB\-c\fR|\fB\-\-convert\fR]
.SH "DESCRIPTION"
.PP
This is a palm conduit to fetch, install, or remove, Foto files from a Palm\&. It can also convert *\&.jpg\&.pdb files that have already been fetched from the Palm to jpeg files\&.
.PP
Delete all, or named fotos from handheld\&.
.PP
Install one, or many jpeg images to handheld\&.
.PP
List all jpeg files and thumbnails on handheld\&.
.PP
Fetch all jpeg files, or certain ones by name\&.
.PP
Tries to detect if a file really is a jpeg and refuses to install it, if it is not\&.
.PP
pilot\-foto allows you to do multiple operations in one sync\&. For instance, delete test\&.jpg and install test\&.jpg\&.
.SH "USAGE"
.PP
pilot\-foto \-p <port> [options] \fIfile\fR
.SH "OPTIONS"
.SS "pilot-foto options"
\fB\-d\fR, \fB\-\-delete\fR
.PP
Delete a jpg file on the handheld
\fB\-\-delete\-all\fR
.PP
Delete ALL jpg files on the handheld
\fB\-i\fR, \fB\-\-install\fR
.PP
Install a jpg file
\fB\-l\fR, \fB\-\-list\fR
.PP
List all photos and thumbnails
\fB\-f\fR, \fB\-\-fetch\fR
.PP
Fetch files from the Palm
\fB\-F\fR, \fB\-\-fetch\-all\fR
.PP
Fetch ALL jpg files from the Palm
\fB\-c\fR, \fB\-\-convert\fR
.PP
convert \fI[file]\&.jpg\&.pdb\fR files to jpg
.SS "Conduit Options"
\fB\-p\fR,
\fB\-\-port\fR \fIport\fR
.PP
Use device file \fIport\fR to communicate with the Palm handheld\&. If this is not specified, \fIpilot\-foto\fR will look for the \fI$PILOTPORT\fR environment variable\&. If neither are found or supplied, \fI pilot\-foto \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\-foto\fR and exit without connecting\&.
.SS "Help Options"
\fB\-h\fR, \fB\-\-help\fR
.PP
Display the help synopsis for \fIpilot\-foto\fR and exit without connecting\&.
\fB\-\-usage\fR
.PP
Display a brief usage message and exit without connecting\&.
.SH "EXAMPLES"
.nf
Examples:
pilot\-foto \-p \fB/dev/pilot\fR \-f pilot\-foto \-d \fBMyImage\&.jpg\fR
pilot\-foto \-i \fBMyImage\&.jpg\fR
pilot\-foto \-i \fB*\&.jpg\fR
pilot\-foto \-f \fBMyImage\fR
pilot\-foto \-c \fBMyImage\&.jpg\&.pdb\fR
.fi
.SH "PROBLEMS"
.PP
Palm has not published their database format for the thumbnails\&. So, pilot\-foto puts a generic penguin thumbnail for every image uploaded\&. Fotos can be accessed by a named list on the handheld as well as the thumbnails\&. This has been tried on a couple of handhelds\&. It is possible that a foreign palm or different model will not like it\&.
.PP
To get a thumbnail image you can copy the jpegs to the memory card\&. If you copy them back to the handheld they will have a new thumbnail that matches the jpeg\&.
.SH "AUTHOR"
.PP
This manual page was converted to XML by Neil Williams <linux@codehelp\&.co\&.uk>
.SH "BUGS"
.PP
If a jpeg is installed with the same name as one already on the palm you will have 2 thumbnails pointing to the same jpeg\&. The new jpeg will overwrite the old jpeg\&.
.PP
If the thumbnail fails to install then the jpeg should be removed\&. It is not\&.
.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\-link\fR(7)