pilot-mailsync configuration
jochen@pms.garcke.de


                                 Palm Settings:

The settings you specify in the Palm Mail application are always used. This
includes the signature, truncation length, sync type, and more. It's very
important to configure the Mail application (via the menu) before running
pilot-mailsync.

Note: The Unread sync type will NOT delete mails [keeping with the Palm Mail
app's documentation]. Therefore, if you wish to delete mail from your mail
source you should use the All or Filter sync types.

The remainder of this document describes how to configure
pilot-mailsync-specific options, such as your incoming mailbox, your From
address, etc.

                                   General:

Pilot-mailsync options are loaded in the following order (anything set later
will override earlier options):
- defaults
- environment variables
- ~/.pilotmailrc
- commandline switches

Some variables need not be set. For example, with a local mailbox there is no
need for a "user name" or "password". Even with remote mailboxes, you can be
prompted at runtime to log in (and it's much more secure to do it that way).


                                  Defaults:

device:	        /dev/pilot
sendmail cmd:   /usr/sbin/sendmail -t -i
mailbox:        ~/Mailbox
from addr:      $USER@$HOSTNAME
user name:      [none]
passwd:         [none]


                            Environment Variables:

device:	        $PILOTPORT
mailbox:        $MAIL
from addr:      $PILOTFROM
user name:      $LOGINNAME
replyto:        $REPLYTO


                                 Config file:

pilot-mailsync supports a simple config file, named ~/.pilotmailrc (not runtime
selectable). Here's an example:

device=/dev/pilot
sendmail=/usr/bin/sendmail -t -i
from=jochen@pms.garcke.de
outbox=~/Mail/Sent
mailbox={mail.somewhere.garcke.de/imap}
	see docs/mailbox for further information on the naming of the mailbox
	for /ssl with self-signed servers use also /novalidate-cert
drafts={mail.somewhere.garcke.de/imap}Drafts
filed={mail.somewhere.garcke.de/imap}Filed
	Drafts and Filed of the Palm mail application are also synched.
	Mail on the mail source gets transported on the palm but
	_not_ vice versa. Deleting in Drafts and Filed on Palm has no effect.
	This way you can at least read two other mail sources.

charset=US-ASCII
	The 'charset' is apparently only used to determine the matching mechanism
	for search compares. In other words, searching with charset 'US-ASCII' (the
	default) will still return matches in charset 'ISO-8859-1' etc.
user=jochen
passwd=ganzGehEim
verbose=on
reply-to=jochen@pms.garcke.de

delete=on
	Deletes mail transfered to Palm Inbox from the mail source.
	Deleting mail is potentially dangerous. If you are using POP3 or MH
	mailboxes, be sure you've read an understand the bugs file.

deleteread=on
	Deletes all mail in the Palm Inbox that has been marked read.
	Use of this option only makes sense with the Palm-Hotsync Option
	"Unread", i.e. only Unread mails get transported to Palm.
       
keepdays=<number>
	keep only mails from last <number> of days on the palm

sendfileonly=on
	Outgoing mail will only be stored in outbox and not sent (for offline use)

smtpserver=mail.yahoo.com
	see docs/mailbox for further information on the naming (/user=, /ssl)
smtpuser=jochen
smtppasswd=ganzGehEim
smtpdisableauth=PLAIN
	Use only as a workaround. Disable certain authentification procedures when
	smtp-servers misbehave. Use PLAIN here for yahoo, as long as they do not 
	fix their SMTP-server. CRAM-MD5, LOGIN are some other possibilities.
smtppop=on
	Use SMTP after POP for authentication while sending mail

versamail=on
	Sync with VersaMail, by default account number 1. Instead of 'on' use
	'1' to '8' to choose VersaMail account to sync to.

- you can specify as few options as you like
- comments have a # as the first character of the line
- all characters after the = and before \n are the value
- If you specify a "passwd" option, pilot-mailsync will require you to set
  permissions to ~/.pilotmailrc to 600 for some semblance of security


                                 Commandline:

usage: ./pilot-mailsync [options]

device:	        -p <device>
sendmail cmd:   -s <sendmail command>
mailbox:        -m <mailbox string>
from addr:      -f <from address>
user name:      -u <remote login name>
delete:         -d
verbose:        -v
replyto:        -t <reply-to address>


				J-Pilot plugin:

The plugin for J-Pilot is just a simple hack, J-Pilot essentially just 
calls pilot-mailsync. You should set up your .pilotmailrc so that it works
that way you want it with the executable pilot-mailsync. If that works you 
can use the plugin. 

                                gnome-pilot conduit:

The plugin for gnome-pilot is just a simple hack, gnome-pilot essentially just
calls pilot-mailsync. You should set up your .pilotmailrc so that it works
that way you want it with the executable pilot-mailsync. If that works you
can use the plugin.


