Pine 4.0x Maildir c-client module
---------------------------------

Written by Mattias Larsson <ml@techno.org> <mta@freeit.com>

This is the second release of my Maildir driver for Pine 4. It is based
on Eric Greens IMAP2bis Maildir driver.

PLEASE NOTE that this driver has only been tested in the IMAP4rev1 daemon
before. It was just put into Pine 4.00, and it looks like it works, but it
has not been extensively tested. It has been running for 8 months in
production in our IMAP4 daemon though.

PLEASE NOTE:

This driver needs to store the UID's of the message in the file somehow. In
the earlier versions of this driver this was done by adding a new maildir
flag (the ,3 flag), however, this solution was not very good since most
other clients could not handle it. Thus I had to find another solution. In
this driver I use a pretty radical method. Any file in the maildir with the
execute bit set has its UID set in the mtime of the file. So you should not
edit the files in here, or in any otherway update the mtime, because then
the UID gets changed. Most clients should not do this, so I think this
solution is compatible with most other clients (if you find one that isn't,
let me know). If you for some reason have to edit a file in the Maildir,
delete the ".uidvalidity" file in the root of the Maildir (ie, the dir where
you find cur/ new/ and tmp/). Alternatively, edit maildir.c and define the
NO_UID_VALIDITY option, which will cause the Maildir to get set new UID's on
every start up. Note that if you are running IMAP and Netscape as a client,
you can't change the UID's, because Netscape do not support the UID validity
flag in the IMAP protocol. So use this with care. 

Please edit the maildir.c file in any case. There are 3 options you can
set yourself. The default configuration is not suitable for ISPs. If you are
an ISP, or system with many users, you might want to consider setting some
of the options different.

Ohh, if there are problems compiling it, let me know, and please let me know
what you did to fix it. This thing was developed on Solaris (using both GCC
and SunCC, should work with both), but I haven't tried it on any other
platform. It is also known to compile cleanly on Linux RH5.1

CONFIGURATION
-------------

There are a few configurable options. You find these at the top of the
maildir.c file (and it can be found in imap/src/osdep/unix if I'm not all
mistaken). Right now, two options are configurable. By default it is
configured for ISP use, something that you might want to change if you use
it at home.

HOW TO USE
----------

Use it as any other c-client driver. There is some option you want to change
if you want all folders to be created as Maildirs (and I can't remember what
the option is from the top of my head). Read the pine documentation.

CHANGES
-------

Rel 4.  Coredump problem fixed. In release 3 I decided to user the sparep
	in the message cache so no patching of mail.h would be necessary,
	however, PINE uses this pointer internally for other things, causing
	coredumps when used with the Rel 3. patch.

Rel 3.	New way of storing UID's (compatible with ,2 clients).
	Multiple inbox patches applied

Rel 2.  Pine 4 changes.

Rel 1.  Imap4rev 1 driver

FINAL NOTES
-----------

I'll try to maintain and release new versions as soon as I have time over,
which unfortunately does not happen very often in this business ;)

You can (might) find newer versions of this driver at:

http://www.freeit.com/mta/


Regards,
Daniel Mattias Larsson

e-mail: ml@techno.org
ph: +46-707-268785
snail-mail:
Industrivagen 4
SE-194 77 Upplands Vasby
SWEDEN
