1.1 --- a/README.maildir	Mon Sep 14 19:23:11 2009 +0900
     1.2 +++ b/README.maildir	Thu Oct 30 00:03:05 2014 +0900
     1.3 @@ -91,3 +91,96 @@
     1.4  Industrivagen 4
     1.5  SE-194 77 Upplands Vasby
     1.6  SWEDEN
     1.7 +Pine 4.0x Maildir c-client module
     1.8 +---------------------------------
     1.9 +
    1.10 +Written by Mattias Larsson <ml@techno.org> <mta@freeit.com>
    1.11 +
    1.12 +This is the second release of my Maildir driver for Pine 4. It is based
    1.13 +on Eric Greens IMAP2bis Maildir driver.
    1.14 +
    1.15 +PLEASE NOTE that this driver has only been tested in the IMAP4rev1 daemon
    1.16 +before. It was just put into Pine 4.00, and it looks like it works, but it
    1.17 +has not been extensively tested. It has been running for 8 months in
    1.18 +production in our IMAP4 daemon though.
    1.19 +
    1.20 +PLEASE NOTE:
    1.21 +
    1.22 +This driver needs to store the UID's of the message in the file somehow. In
    1.23 +the earlier versions of this driver this was done by adding a new maildir
    1.24 +flag (the ,3 flag), however, this solution was not very good since most
    1.25 +other clients could not handle it. Thus I had to find another solution. In
    1.26 +this driver I use a pretty radical method. Any file in the maildir with the
    1.27 +execute bit set has its UID set in the mtime of the file. So you should not
    1.28 +edit the files in here, or in any otherway update the mtime, because then
    1.29 +the UID gets changed. Most clients should not do this, so I think this
    1.30 +solution is compatible with most other clients (if you find one that isn't,
    1.31 +let me know). If you for some reason have to edit a file in the Maildir,
    1.32 +delete the ".uidvalidity" file in the root of the Maildir (ie, the dir where
    1.33 +you find cur/ new/ and tmp/). Alternatively, edit maildir.c and define the
    1.34 +NO_UID_VALIDITY option, which will cause the Maildir to get set new UID's on
    1.35 +every start up. Note that if you are running IMAP and Netscape as a client,
    1.36 +you can't change the UID's, because Netscape do not support the UID validity
    1.37 +flag in the IMAP protocol. So use this with care. 
    1.38 +
    1.39 +Please edit the maildir.c file in any case. There are 3 options you can
    1.40 +set yourself. The default configuration is not suitable for ISPs. If you are
    1.41 +an ISP, or system with many users, you might want to consider setting some
    1.42 +of the options different.
    1.43 +
    1.44 +Ohh, if there are problems compiling it, let me know, and please let me know
    1.45 +what you did to fix it. This thing was developed on Solaris (using both GCC
    1.46 +and SunCC, should work with both), but I haven't tried it on any other
    1.47 +platform. It is also known to compile cleanly on Linux RH5.1
    1.48 +
    1.49 +CONFIGURATION
    1.50 +-------------
    1.51 +
    1.52 +There are a few configurable options. You find these at the top of the
    1.53 +maildir.c file (and it can be found in imap/src/osdep/unix if I'm not all
    1.54 +mistaken). Right now, two options are configurable. By default it is
    1.55 +configured for ISP use, something that you might want to change if you use
    1.56 +it at home.
    1.57 +
    1.58 +HOW TO USE
    1.59 +----------
    1.60 +
    1.61 +Use it as any other c-client driver. There is some option you want to change
    1.62 +if you want all folders to be created as Maildirs (and I can't remember what
    1.63 +the option is from the top of my head). Read the pine documentation.
    1.64 +
    1.65 +CHANGES
    1.66 +-------
    1.67 +
    1.68 +Rel 4.  Coredump problem fixed. In release 3 I decided to user the sparep
    1.69 +	in the message cache so no patching of mail.h would be necessary,
    1.70 +	however, PINE uses this pointer internally for other things, causing
    1.71 +	coredumps when used with the Rel 3. patch.
    1.72 +
    1.73 +Rel 3.	New way of storing UID's (compatible with ,2 clients).
    1.74 +	Multiple inbox patches applied
    1.75 +
    1.76 +Rel 2.  Pine 4 changes.
    1.77 +
    1.78 +Rel 1.  Imap4rev 1 driver
    1.79 +
    1.80 +FINAL NOTES
    1.81 +-----------
    1.82 +
    1.83 +I'll try to maintain and release new versions as soon as I have time over,
    1.84 +which unfortunately does not happen very often in this business ;)
    1.85 +
    1.86 +You can (might) find newer versions of this driver at:
    1.87 +
    1.88 +http://www.freeit.com/mta/
    1.89 +
    1.90 +
    1.91 +Regards,
    1.92 +Daniel Mattias Larsson
    1.93 +
    1.94 +e-mail: ml@techno.org
    1.95 +ph: +46-707-268785
    1.96 +snail-mail:
    1.97 +Industrivagen 4
    1.98 +SE-194 77 Upplands Vasby
    1.99 +SWEDEN