Initial Alpine Version

2 files changed, 200 insertions, 0 deletions

diff --git a/contrib/carmel/doc/carmel-driver b/contrib/carmel/doc/carmel-driver
new file mode 100644
index 00000000..aa157cf8
--- /dev/null
+++ b/contrib/carmel/doc/carmel-driver
@@ -0,0 +1,157 @@
+
+
+Carmel driver notes
+-------------------
+Set folder-collections=#carmel#[] to configure Pine to use the
+carmel driver. You may include other colllections like a directory full
+of Berkeley mail folder
+
+
+
+Be sure you don't have a file called ".mailboxlist" in your home
+directory. If you do the list of mailboxes presented to be by
+the c-client will be out of that file rather than by querying each
+driver.
+
+If you have files in your home or mail directory, be sure they aren't
+called anything that starts with "#carmel#" or %carmel%. They will be
+incorrectly included by mail_find for the bezerk and other drivers.
+
+The carmel driver doesn't grab "inbox". This is to allow other drivers
+a shot at it. This may or may not work out in the long run.  With the
+current version of Pine you must set your inbox-path=#carmel#inbox to
+cause the carmel inbox to be used.
+
+
+Patching/Compilation for Pine
+-----------------------------
+
+This set of files and patches was created for Pine 3.85 and the
+corresponding version 3.0 of the c-client and 7.63 of imapd. Hopefully
+they will continue to work with future versions of all of these. To
+apply the patches copy all the files in the subdirectories here (pine,
+c-client and imapd) to the corresponding directories in the Pine
+source. The run patch on each of the patch files and finally run the
+build script in Pine source root directory. This should result in a
+pine, pico and imapd binary in the bin directory ready to be
+installed. In the c-client directory there will be a bzk2cml binary
+for converting a Berkeley format mailbox to a Carmel format mailbox
+for the user running the program.
+
+The modifications to the Pine source are minimal. The two parts are
+the calls to link in the carmel driver, and the patches to display
+BWC-GLYPH text. Nearly all the patches are for the later. One
+additional patch is needed to specify the right driver for creating
+new mailboxes. This is currently a bit of a hack in Pine and will
+hopefully be fixed future versions of Pine. The patches to imapd are
+of exactly the same nature as those to Pine.
+
+If some of these patches fail, it's probably due to changes made in
+Pine (applying them to some other version than 3.85).  In that cases
+the patches will have to be made manually. 
+
+
+   
+Fixed since the version of Sept '92.
+------------------------------------
+* Updated to conform with the changes in UW internal changes from
+  version 3.5X to 3.84. With these changes all the internal Pine calls
+  to the c-client are stabilized, possibly except some changes for
+  mail_create. This makes the carmel driver trivial to integrate with
+  future versions of Pine.
+
+* Driver now checkpoints both carmel and carmel2 indexes. This should
+  save the nightly from deleting mail that it shouldn't.
+
+* The driver only defaults messages without any content-type to
+  X-bwc-glyph instead of messages that were tagged text/plain. This will
+  cause the the glyph to richtext translations not to be applied when
+  the message already has a MIME header.
+
+* Some bug fixes to display of BWC-GLYPH text, including bug causing
+  periodic core dumps. 
+
+* Handles case where data file for a message is missing properly
+
+* Bug fixes so critical code in driver is properly protected from
+  signals and interrupts.
+
+* Bzk2cml utility included to convert Berkeley mail folder into carmel
+  folders. 
+
+* Fixed bug causing text of currently viewed message to be redisplayed
+  incorrectly after the arrival of new mail.
+
+* Carmel text served up by imapd is tagged type "plain" instead of
+  "X-bwc-glyph", though the text is not yet converted to richtext
+  and quoted-printable encoded like it should be to work with other
+  clients. 
+
+
+Fixed in the Aug 1 version
+--------------------------
+* Only creates a maximum of four Carmel index backup files (COD.FUR files)
+ 
+* Folder listing now works with standard IMAP patterns
+  
+* Carmel index is check-pointed on expunges
+ 
+* Carmel driver checks for new mail with folder name #carmel#inbox
+ 
+* New mail is incorporated on other than inbox
+
+* MIME decoding works properly now
+
+* Safer incorporation of new mail from /usr/spool/mail (carmel2 writes flushed)
+
+
+Fixed in Aug 23 version
+-----------------------
+ 
+* Fetchheader includes the separator so append will work
+
+* Fixed append to get size right and not insert random NULL's, \n's...
+
+* Conversion of glyph format to rich text in imapd
+
+
+Fixed in Aug 29 version
+-----------------------
+* Further fixes to append, including full locking
+
+* The #carmel#user#folder syntax now works properly
+
+* Further fixes to imapd to convert to richtext only when appropriate
+
+
+Fixed in Sep 2 version
+----------------------
+* Nearly complete conversion from glyph to richtext
+
+* Fixed bug causing lost new mail on quick in/out Pine sessions
+
+* A few related Pine bugs fixed: sorting, wrapping
+  
+
+Fixed in Sep 25 version
+-----------------------
+
+* Recognizes all messages with subtype beginning with x-bwc-glyph as Glyph text. 
+* Saves messages of type x-bwc-glyph-wide in files ending with .wid
+
+* When saving messages, the link is used rather than making a new file
+
+* Glyph messages after 1994 must have the x-bwc-glyph tag to be recognized
+
+* Bug fix to properly display '@' in glyph text
+
+* Incorporation of latest version of c-client (minor bug fixes)
+
+
+
+General Features
+----------------
+* The driver checks the MAIL environment variable for the place to
+look for new incoming mail for the "inbox".
+
+(There's a lot more than this, but it's not documented yet)
diff --git a/contrib/carmel/doc/todo b/contrib/carmel/doc/todo
new file mode 100644
index 00000000..acf99f19
--- /dev/null
+++ b/contrib/carmel/doc/todo
@@ -0,0 +1,43 @@
+Legend:  P - Pine, C - Carmel, W - BWC specific hacks, I - Imapd
+         Capitial letters are bugs, small are feature additions
+
+Size is in days it will take LL to accomplish. A * means the UW or
+other are interested and might actually do this for us if we wait.
+
+Size   Where   What
+----   -----   -------------
+ 3       c     Make readonly mode parameters work
+ 3       C     Occaisional problem/error message with Fcc
+ 6       W     Copying/recognizing wide documents as wide (a new mime type?)
+ 2       b     Can't handle _ in folder names
+ 4       c     Testing to make sure all works in disk full conditions
+ 1       c     Quick hacks to work with ECS mail
+ 5*      i     Imapd modifications to work with ECS mail properly
+ 2       b/p   A default Bcc to oneself instead of Fcc (can you Fcc:inbox?)
+ 2*      p     Better handling of non-recognized attachment
+ 5       w     Printing wide documents
+ 2       W     Problems with glyph text column alignment for torture test
+15             Gateway to convert glyph to standard format as leaving BWC
+ 3       c     Initial account set up
+10       c     Kiss of death to steal write access from another running Pine
+ 6       C     Full IMAP searching in Carmel (not used by Pine yet)
+ 6       c     Carmel driver performance enhancments (for folders > 500 msgs)
+ 6*      ci    Auto updating deleted status for folder open by several users
+ 3       C     Doesn't incorporate new mail on start up like other IMAPware
+ 6       I/C   Handling of non-FQN's via IMAP (will solve ECS problems above)
+
+Things fixed for Aug 31 version
+-------------------------------
+- fixed bug with 1994 cut off date for forcing Carmel mail to x-bwc-glyph
+- fixed bugs in text header searching
+- changed to new c-client way of looking up hostname
+- works with new c-client for remote creates with FQNs
+- now works with new c-client scheme for including new mail file drivers
+- integrated x-bwc-glyph stuff with Pine 3.90
++ (Fixed in by UW) Handles passwords for multiple imap servers/accounts
+- Implemented TRYCREATE protocol for IMAP copies and appends
+
+Previous fixes
+--------------
+- Better handling of case of full disk
+