.\"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)