pilot-mailsync configuration
hollis@austin.rr.com


                                 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=hollis@andrew.cmu.edu
outbox={cyrus.andrew.cmu.edu/imap}Sentmail
mailbox={cyrus.andrew.cmu.edu/imap}
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=hollis
passwd=SeCReT
verbose=on
reply-to=hollis@austin.rr.com

delete=on
	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.

syncseen=on
	This will prevent the seen flags from being updated when transferring to
	the Palm. The seen flags will be kept in sync; i.e. if you read the
	message on the Palm the original message will be marked 'Seen' on next
	sync. Correspondingly mail read in the mail source will be marked read on
	the Palm.


- 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. 

