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:
