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 - 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 ) - 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: