IMPORTANT

For this plugin to work properly, you need jpilot 0.99.3 or above.

INTRODUCTION

jpilot-Mail is a plugin for jpilot (http://jpilot.org/) which enables you to deliver mail that was written on your pilot and upload mail that you received to your pilot.

jpilot-Mail sends mails via SMTP. This code was directly recycled from another GNU software project, masqmail

POTENTIAL PROBLEMS

jpilot-Mail uses a file ~/.jpilot/.mailids to identify messages that it has already seen, so that it does not read mails from your mailbox folder again. If you delete a mail in your pilot database, it will not be read again from the folder, because its mail id has already been seen. This is only a problem if you want that mail again, in this case find its message id in ~/.jpilot/.mailids and delete it. It may also cause problems if you switch between mailbox folders, because mail ids not seen in the folder will be deleted from ~/.jpilot/.mailids. If you used folder A, then use folder B and back again folder to A, the messages from folder A will be read again.

Sorry, but all this would be much easier if I found a better way to identify the messages.

MIME ENCODING

Doc from Joo-won Jung (patch author):

This patch enables the users to use other character sets than 'iso-8859-1'. Users can set the character set that they use on the pilot at the 'Mail Delivery' tab of Mail Preferences dialog box. The default charset is 'iso-8859-1' and the default header encoding is 'quoted-printable'. In my case, Korean, the charset is 'euc-kr' and the header encoding is 'base64' and it works with other mail user agents. For Japanese, charset='Shift_jis' and header_encoding='base64' would work, I think.

The outgoing messages conform to the MIME, RFC-2045, 2046, 2047. I did not touch the incoming messages yet, because they can be processed by procmail, etc.

INSTALLATION

is described in the INSTALL file. PLEASE READ THAT C A R E F U L L Y BEFORE YOU ask me what to do. Thanks.

BUGS

Are certainly there. Send them to me (ludovic.rousseau@free.fr) to get rid of them.

jpilot-Mail does not support VersaMail (the new mail client application on PalmOS PDA).

AUTHORS

Oliver Kurth is the original author. He has no more a Palm so can't debug jpilot-Mail anymore.

Ludovic Rousseau is the new maintainer. He is also the Debian maintainer of the jpilot-Mail, jpilot and other jpilot related Debian packages.

Oliver Kurth,
oliver.kurth@innominate.de
http://innominate.org/kurth/

Ludovic Rousseau,
ludovic.rousseau@free.fr
http://ludovic.rousseau.free.fr/

HISTORY

0.1.7: 1 August 2004

configure.in: modify the test on -lresolv so that it works on AMD64. Thanks to Kurt Roeckx for the patch (Debian bug #262676).

0.1.6: 18 July 2004

add --enable-gtk2 to compile the plugin with GTK+ 2.0
escape the "From " lines in the mail body
add a date to the "From " line to be mbox format compliant. Thanks to Wolfgang Becker
now works with jpilot-sync (no GUI)
some other bugs

0.1.5: 30 August 2003

patch from Sarah George to store mails sent in a configurable file
patch from Joo-won Jung for MIME support and charset other than ASCII
use $MAIL (if defined) as default mailbox instead of $HOME/nsmail/inbox
add documentation from Sarah George also available on http://www.users.bigpond.com/slgeo1/jpilot-Mail-User-Manual/jpilot-Mail-User-Manual.html
some minor bug correction

0.1.4: 15 June 2003

define glob_tooltips in the plugin itself and do not use the exported symbol from jpilot.
This bug prevented jpilot-sync to use the jpilot-mail plugin with an error message like: open failed on plugin [/usr/lib/jpilot/plugins/libmail.so] error [/usr/lib/jpilot/plugins/libmail.so: undefined symbol: glob_tooltips]
src/address.c: define FNM_CASEFOLD if it is not yet defined (on Solaris for example)

0.1.3: 5 March 2003

use libplubin.[c,h] from J-Pilot 0.99.5 and avoid the warning message: "jpilot: jpilot_logf deprecated, use jp_logf instead."
use automake 1.7

0.1.2: 12 January 2003

use Autoconf 2.56
update common files with masqmail up to masqmail-0.2.18
correct a date problem: date was sometime set to 0/0
add tooltips and accelerator on buttons
add a adjustable separator between the two lists and put the lists one above the other instead of side by side

0.1.1: 22 November 2002

remove the Aply button in Preferences. Its semantic was not obvious.
'make install' should work

0.1.0: 29 June 2002

autoconf 2.50 port
update source files from jpilot
always use jpilot_logf()

0.0.7: 7 May 2002

new maintainer: Ludovic Rousseau <ludovic.rousseau@free.fr>
debug Date:, Message-Id: and localization

0.0.6:

(re)enabled postsync_send option, it is now safe.
glibc 2.2.2 compile adjustment (include <time.h>)
finally figured out why mail from Outbox could not be deleted
adjustments to compile with jpilot 0.99
do not fork for delivery, this makes better checking if a mail was successfully send.

0.0.5:

resolved weird problems with the .spec file. Thanks to James Segarra!
correct date for mails (from Date: header)

0.0.4:

removed nasty bug in mail_get.c: tried to display_record even when plugin was not shown
made (most) variables local in mail.c, not global
no more cryptic menu entries before first sync
a default domain for unqualified addresses can now be set (also used for Message-ID)
Thanks to Mirko Zeibig there are now rpms available!
Chris Green sent a patch to set the preferences to more sane values on start. Thanks!
commented jpilot-logf when searching id headers in mail_get.c, since this caused problems
now recognizes READ flag
and the priority flag
Noam Halevy sent a patch which speeded up reading mail from the mailbox folder. Thanks!

0.0.3:

changelog missing

$Id: README,v 1.14 2004/08/01 14:50:25 rousseau Exp $

vim:ts=8: