/head: changeset 76

Added more information to README and debian/control

head/ChangeLog

@@ -1,3 +1,144 @@
+2002-07-03 21:44  jgoerzen
+
+	* debian/changelog: Updated
+
+2002-07-03 21:43  jgoerzen
+
+	* README, debian/control: Added more information to README and
+	debian/control
+
+2002-07-03 17:35  jgoerzen
+
+	* offlineimap.py: Fixed a bug with generating mailbox listings
+
+2002-07-03 16:02  jgoerzen
+
+	* debian/: changelog, changelog: Fixed
+
+2002-07-03 15:44  jgoerzen
+
+	* offlineimap.py: Removed debug code
+
+2002-07-03 15:40  jgoerzen
+
+	* offlineimap.py: A bit more debugging
+
+2002-07-03 15:37  jgoerzen
+
+	* offlineimap.py: Added debug
+
+2002-07-03 15:23  jgoerzen
+
+	* offlineimap.py: Removed a debug tool
+
+2002-07-03 15:16  jgoerzen
+
+	* debian/: changelog, rules: Updated changelog with these options
+	
+	offlineimap (2.0.0) unstable; urgency=low
+	
+	  * This code is now multithreaded.  New config file options
+	control the
+	      behavior.  This can make synchronizing several times faster.
+		* Fixed the STATUS call to be compatible with Exchange.
+		  * Added the ability to exclude folders.
+		    * If upgrading from 1.0.x, you will need to add
+	maxsyncaccounts to the
+			general section and maxconnections to each account
+	sections.
+			    There is also a new folderfilter option.
+				You can find examples of all of these in
+	the new offlineimap.conf
+				    example file packaged with the
+	distribution.
+				      * The Debian package now properly
+	installs the example offlineimap.conf
+
+2002-07-03 15:10  jgoerzen
+
+	* offlineimap.conf, debian/changelog,
+	offlineimap/repository/IMAP.py: Added the ability to filter out
+	folders
+
+2002-07-03 12:59  jgoerzen
+
+	* offlineimap/threadutil.py: Re-enabled after debug.
+
+2002-07-03 12:58  jgoerzen
+
+	* offlineimap/folder/IMAP.py: Another bugfix
+
+2002-07-03 12:57  jgoerzen
+
+	* offlineimap.py, offlineimap/threadutil.py,
+	offlineimap/folder/Base.py, offlineimap/folder/IMAP.py,
+	offlineimap/repository/IMAP.py: More updates
+
+2002-07-03 11:40  jgoerzen
+
+	* offlineimap/imapserver.py: More work on threads
+
+2002-07-03 11:14  jgoerzen
+
+	* offlineimap.py, offlineimap/imapserver.py,
+	offlineimap/folder/Base.py, offlineimap/folder/IMAP.py,
+	offlineimap/ui/TTY.py: More working!
+
+2002-07-03 10:58  jgoerzen
+
+	* offlineimap.py, offlineimap/imapserver.py,
+	offlineimap/folder/IMAP.py: Bug fixes
+
+2002-07-03 10:35  jgoerzen
+
+	* offlineimap.py, offlineimap/imapserver.py,
+	offlineimap/threadutil.py, offlineimap/folder/Base.py,
+	offlineimap/folder/IMAP.py: Another work on syncing
+
+2002-07-03 10:00  jgoerzen
+
+	* offlineimap/folder/IMAP.py: Fixed a bug with the status call
+
+2002-07-03 09:15  jgoerzen
+
+	* offlineimap/repository/IMAP.py: Modified to new imapserver
+	semantics
+
+2002-07-03 09:02  jgoerzen
+
+	* offlineimap/imapserver.py: Moved some more code to threadutil
+
+2002-07-03 08:59  jgoerzen
+
+	* offlineimap/imapserver.py: Updated to use threadutil
+
+2002-07-03 08:58  jgoerzen
+
+	* offlineimap.py, offlineimap/__init__.py,
+	offlineimap/threadutil.py, offlineimap/ui/TTY.py,
+	offlineimap/ui/UIBase.py: Initial work on threading support
+
+2002-07-03 08:49  jgoerzen
+
+	* debian/changelog: Updated.
+
+2002-07-02 22:04  jgoerzen
+
+	* offlineimap/: imapserver.py, repository/IMAP.py: Start of support
+	for multi-threading
+
+2002-07-02 20:01  jgoerzen
+
+	* offlineimap.conf: Updated with thread support
+
+2002-07-02 18:37  jgoerzen
+
+	* debian/rules: Removed extraneous clean
+
+2002-07-02 15:56  jgoerzen
+
+	* ChangeLog: Final prep, 1.0.4
+
 2002-07-02 15:50  jgoerzen
 
 	* debian/changelog: Updated for 1.0.4
@@ -431,9 +572,14 @@
 
 	* offlineimap/repository/: Base.py, __init__.py: Added
 
+2002-06-18 13:28  jgoerzen
+
+	* offlineimap/mailbox/__init__.py: [no log message]
+
 2002-06-18 13:26  jgoerzen
 
-	* offlineimap/: folder/__init__.py, repository/Base.py: Updated
+	* offlineimap/: folder/__init__.py, mailbox/__init__.py,
+	repository/Base.py: Updated
 
 2002-06-18 13:09  jgoerzen
 

head/README

@@ -31,6 +31,12 @@ OfflimeIMAP, you can:
  * Synchronize your mail using a completely safe and fault-tolerant
    algorithm.  (At least I think it is!)
 
+ * Customize which mailboxes to synchronize with regular expressions
+   or lists.
+
+ * Synchronize your mail two to four times faster than with other tools
+   or other mail readers' internal IMAP support.
+
 In short, OfflineIMAP is a tool to let you read mail how YOU want to.
 
 ==================================================
@@ -260,3 +266,33 @@ set folder=$HOME/Mail
 set spoolfile=+Personal/INBOX
 
 That's it!
+
+--------------------------------------------------
+
+Q. What about the speed of the sync?
+
+A. OfflineIMAP 2.0 contains a multithreaded system.  A good way to
+experiment is by setting maxsyncaccounts to 3 and maxconnections to 3
+in each account clause.
+
+This lets OfflineIMAP open up multiple connections simultaneously.
+That will let it process multiple folders and messages at once.  In
+most cases, this will increase performance of the sync.
+
+Don't set the number too high.  If you do that, things might actually
+slow down as your link gets saturated.  Also, too many connections can
+cause mail servers to have excessive load.  Administrators might take
+unkindly to this, and the server might bog down.  There are many
+variables in the optimal setting; experimentation may help.
+
+An informal benchmark yields these results for my setup:
+
+OfflineIMAP 2.0 sync with multitreading:  9 seconds
+OfflineIMAP 1.x sync w/o multithreading: 20 seconds
+GNUS sync:                                5 minutes
+MacOS X Mail.app "manual cache" method:  10 minutes
+
+OfflineIMAP's default configuration example does not have
+multithreading enabled.  You must configure it yourself to gain these
+performance benefits.  This decision was taken to provide a "works out
+of the box" experience.

head/debian/changelog

@@ -11,6 +11,9 @@ offlineimap (2.0.0) unstable; urgency=low
     example file packaged with the distribution.
   * The Debian package now properly installs the example offlineimap.conf
     file.
+  * There is a new mailing list available.  To join, send SUBSCRIBE
+    to offlineimap-request@complete.org.  The posting address is
+    offlineimap@complete.org.
 
  -- John Goerzen <jgoerzen@complete.org>  Wed,  3 Jul 2002 19:21:32 -0500
 

head/debian/control

@@ -29,4 +29,10 @@ Description: IMAP/Maildir synchronization and reader support
  * Synchronize your mail using a completely safe and fault-tolerant
    algorithm.  (At least I think it is!)
  .
+ * Customize which mailboxes to synchronize with regular expressions
+   or lists.
+ .
+ * Synchronize your mail two to four times faster than with other tools
+   or other mail readers' internal IMAP support.
+ .
  In short, OfflineIMAP is a tool to let you read mail how YOU want to.