diff --git a/offlineimap/head/ChangeLog b/offlineimap/head/ChangeLog
index 91fa297..87f1765 100644
--- a/offlineimap/head/ChangeLog
+++ b/offlineimap/head/ChangeLog
@@ -1,3 +1,61 @@
+------------------------------------------------------------------------
+rev 233: jgoerzen | 2002-08-09 14:29:29 -0500 (Fri, 09 Aug 2002) | 2 lines
+Changed paths:
+ U /offlineimap/head/debian/changelog
+ U /offlineimap/head/offlineimap/folder/IMAP.py
+
+Made more resiliant in the face of invalid dates.
+
+------------------------------------------------------------------------
+rev 232: jgoerzen | 2002-08-09 11:25:28 -0500 (Fri, 09 Aug 2002) | 2 lines
+Changed paths:
+ U /offlineimap/head/debian/changelog
+ U /offlineimap/head/offlineimap.1
+ U /offlineimap/head/offlineimap.conf
+
+Added documentation for Tommi's patch.
+
+------------------------------------------------------------------------
+rev 231: jgoerzen | 2002-08-09 11:12:09 -0500 (Fri, 09 Aug 2002) | 2 lines
+Changed paths:
+ U /offlineimap/head/offlineimap/ui/detector.py
+ U /offlineimap/head/offlineimap.py
+
+Applied part 2 of tv's patch
+
+------------------------------------------------------------------------
+rev 230: jgoerzen | 2002-08-09 11:11:12 -0500 (Fri, 09 Aug 2002) | 2 lines
+Changed paths:
+ A /offlineimap/head/offlineimap/localeval.py
+
+More of part 1 of the patch
+
+------------------------------------------------------------------------
+rev 229: jgoerzen | 2002-08-09 11:10:38 -0500 (Fri, 09 Aug 2002) | 2 lines
+Changed paths:
+ U /offlineimap/head/offlineimap/mbnames.py
+ U /offlineimap/head/offlineimap/repository/IMAP.py
+ U /offlineimap/head/offlineimap/ui/detector.py
+ U /offlineimap/head/offlineimap.conf
+ U /offlineimap/head/offlineimap.py
+
+Applied part 1 of Tommi's patch.
+
+------------------------------------------------------------------------
+rev 228: jgoerzen | 2002-08-09 10:57:06 -0500 (Fri, 09 Aug 2002) | 2 lines
+Changed paths:
+ U /offlineimap/head/debian/changelog
+ U /offlineimap/head/offlineimap/folder/IMAP.py
+
+Nicely handle uploading messages without Message-Id headers
+
+------------------------------------------------------------------------
+rev 226: jgoerzen | 2002-08-08 15:58:44 -0500 (Thu, 08 Aug 2002) | 2 lines
+Changed paths:
+ U /offlineimap/head/ChangeLog
+
+Changelog committed
+
------------------------------------------------------------------------
rev 225: jgoerzen | 2002-08-08 15:58:14 -0500 (Thu, 08 Aug 2002) | 2 lines
Changed paths:
diff --git a/offlineimap/head/manual.html b/offlineimap/head/manual.html
index a55d51f..3dd17e2 100644
--- a/offlineimap/head/manual.html
+++ b/offlineimap/head/manual.html
@@ -26,7 +26,7 @@
-
+
NAME
@@ -887,6 +887,83 @@ folderfilter = lambda foldername: foldername in [
]
maxconnections = 1
holdconnectionopen = no
+
+
+
+ |
+PYTHONFILE CONFIGURATION FILE OPTION |
+
+
+
+ |
+You can have OfflineIMAP load up a Python file before
+evaluating the configuration file options that are Python
+expressions. This example is based on one supplied by Tommi
+Virtanen for this feature. |
+
+
+
+ |
+In ~/.offlineimap.rc, he adds these
+options: |
+
+
+
+ |
+[general]
+pythonfile=~/.offlineimap.py
+[foo]
+foldersort=mycmp |
+
+
+
+ |
+Then, the ~/.offlineimap.py file will
+contain: |
+
+
+
+ |
+prioritized = ['INBOX', 'personal', 'announce',
+'list'] |
+
+
+
+ |
+def mycmp(x, y):
+for prefix in prioritized:
+if x.startswith(prefix):
+return -1
+elif y.startswith(prefix):
+return +1
+return cmp(x, y) |
+
+
+
+ |
+def test_mycmp():
+import os, os.path
+
+folders=os.listdir(os.path.expanduser('~/data/mail/tv@hq.yok.utu.fi'))
+folders.sort(mycmp)
+print folders |
+
+
+
+ |
+This code snippet illustrates how the foldersort
+option can be customized with a Python function from the
+pythonfile to always synchronize certain folders
+first. |
ERRORS
diff --git a/offlineimap/head/manual.pdf b/offlineimap/head/manual.pdf
index 01560b9..feb1c11 100644
Binary files a/offlineimap/head/manual.pdf and b/offlineimap/head/manual.pdf differ
diff --git a/offlineimap/head/manual.ps b/offlineimap/head/manual.ps
index 4192c2d..d54bd70 100644
--- a/offlineimap/head/manual.ps
+++ b/offlineimap/head/manual.ps
@@ -1,11 +1,11 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.17.2
-%%CreationDate: Thu Aug 8 10:19:19 2002
+%%CreationDate: Fri Aug 9 15:51:31 2002
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
%%DocumentSuppliedResources: procset grops 1.17 2
-%%Pages: 8
+%%Pages: 9
%%PageOrder: Ascend
%%Orientation: Portrait
%%EndComments
@@ -312,9 +312,9 @@ G(ilable.).25 E 32.5<8359>108 660 S .086(ou must ha)-33.6 F .386 -.15
(ve P)-.2 H .813(ython already).15 F(,)-.65 E 3.88
(check with your system administrator or operating system v)144 684 R
3.88(endor; or)-.15 F 6.38(,d)-.4 G -.25(ow)-6.38 G 3.88(nload it from)
-.25 F(http://www)144 696 Q(.p)-.65 E(ython.or)-.1 E 3.377(g/. If)-.18 F
-.878(you intend to use the Tk interf)3.377 F .878(ace, you must ha)-.1 F
-1.178 -.15(ve T)-.2 H .878(kiner \(p).15 F(ython-tk\))-.1 E 2.86
+.25 F(http://www)144 696 Q(.p)-.65 E(ython.or)-.1 E 3.163(g/. If)-.18 F
+.664(you intend to use the Tk interf)3.163 F .664(ace, you must ha)-.1 F
+.964 -.15(ve T)-.2 H .664(kinter \(p).15 F(ython-tk\))-.1 E 2.86
(installed. If)144 708 R .36(you intend to use the SSL interf)2.86 F
.359(ace, your Python must ha)-.1 F .659 -.15(ve b)-.2 H .359(een b).15
F .359(uilt with SSL sup-)-.2 F(port.)144 720 Q(John Goerzen)72 768 Q
@@ -602,347 +602,380 @@ G(oninteracti)-3.934 E -.15(ve)-.25 G 1.434(.Basic, this user).15 F
(os)-3.014 G .514(et up)-3.014 F F1(Of\215ineIMAP)3.014 E F0 .514
(to synchronize multiple accounts with the mutt mail)3.014 F(reader)108
672 Q(.)-.55 E(Start by creating a directory to hold your folders:)108
-688.8 Q F1(mkdir ~/Mail)108 700.8 Q F0(In your)108 717.6 Q F2(~/.of)2.5
-E(\215ineimapr)-.18 E(c,)-.37 E F0(specify this:)2.5 E F1(accounts = P)
-108 729.6 Q(ersonal, W)-.2 E(ork)-.75 E F0(John Goerzen)72 768 Q
-(July 12, 2002)151.655 E(4)201.915 E EP
+696 Q F1(mkdir ~/Mail)108 708 Q F0(John Goerzen)72 768 Q(July 12, 2002)
+151.655 E(4)201.915 E EP
%%Page: 5 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R
-(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E(Mak)108 84 Q 2.821
-(es)-.1 G .321(ure that you ha)-2.821 F .621 -.15(ve b)-.2 H .321(oth a)
-.15 F/F1 10/Times-Bold@0 SF([P)2.821 E(ersonal])-.2 E F0 .321(and a)
-2.821 F F1([W)2.821 E(ork])-.75 E F0 .32(section, with dif)2.82 F .32
-(ferent localfolder pathnames and)-.25 F(enable)108 96 Q F1([mbnames].)
-2.5 E F0(In each account section, do something lik)108 112.8 Q 2.5(et)
--.1 G(his:)-2.5 E F1(localf)108 124.8 Q(olders = ~/Mail/P)-.25 E
-(ersonal)-.2 E F0(Add these lines to your)108 141.6 Q/F2 10
-/Times-Italic@0 SF(~/.muttr)2.5 E(c:)-.37 E F1(sour)108 153.6 Q
-(ce ~/path-to-mbnames-muttr)-.18 E(c-mailboxes)-.18 E -.25(fo)108 165.6
-S(lder).25 E(-hook P)-.37 E(ersonal set fr)-.2 E(om="y)-.18 E(our)-.25 E
-(email@personal.com")-.18 E -.25(fo)108 177.6 S(lder).25 E(-hook W)-.37
-E(ork set fr)-.75 E(om="y)-.18 E(our)-.25 E(email@w)-.18 E(ork.com")-.1
-E(set mbox_type=Maildir)108 189.6 Q(set f)108 201.6 Q(older=$HOME/Mail)
--.25 E(set spool\214le=+P)108 213.6 Q(ersonal/INBO)-.2 E(X)-.4 E F0
-(That')108 230.4 Q 2.5(si)-.55 G(t!)-2.5 E F1(UW)87 247.2 Q
-(-IMAPD AND REFERENCES)-.37 E F0 .493(Some users with a UW)108 259.2 R
-.493(-IMAPD serv)-.65 F .493(er need to use)-.15 F F1(Of\215ineIMAP')
+(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E(In your)108 84 Q/F1
+10/Times-Italic@0 SF(~/.of)2.5 E(\215ineimapr)-.18 E(c,)-.37 E F0
+(specify this:)2.5 E/F2 10/Times-Bold@0 SF(accounts = P)108 96 Q
+(ersonal, W)-.2 E(ork)-.75 E F0(Mak)108 120 Q 2.821(es)-.1 G .321
+(ure that you ha)-2.821 F .621 -.15(ve b)-.2 H .321(oth a).15 F F2([P)
+2.821 E(ersonal])-.2 E F0 .321(and a)2.821 F F2([W)2.821 E(ork])-.75 E
+F0 .32(section, with dif)2.82 F .32(ferent localfolder pathnames and)
+-.25 F(enable)108 132 Q F2([mbnames].)2.5 E F0
+(In each account section, do something lik)108 156 Q 2.5(et)-.1 G(his:)
+-2.5 E F2(localf)108 168 Q(olders = ~/Mail/P)-.25 E(ersonal)-.2 E F0
+(Add these lines to your)108 192 Q F1(~/.muttr)2.5 E(c:)-.37 E F2(sour)
+108 204 Q(ce ~/path-to-mbnames-muttr)-.18 E(c-mailboxes)-.18 E -.25(fo)
+108 216 S(lder).25 E(-hook P)-.37 E(ersonal set fr)-.2 E(om="y)-.18 E
+(our)-.25 E(email@personal.com")-.18 E -.25(fo)108 228 S(lder).25 E
+(-hook W)-.37 E(ork set fr)-.75 E(om="y)-.18 E(our)-.25 E(email@w)-.18 E
+(ork.com")-.1 E(set mbox_type=Maildir)108 240 Q(set f)108 252 Q
+(older=$HOME/Mail)-.25 E(set spool\214le=+P)108 264 Q(ersonal/INBO)-.2 E
+(X)-.4 E F0(That')108 288 Q 2.5(si)-.55 G(t!)-2.5 E F2(UW)87 304.8 Q
+(-IMAPD AND REFERENCES)-.37 E F0 .493(Some users with a UW)108 316.8 R
+.493(-IMAPD serv)-.65 F .493(er need to use)-.15 F F2(Of\215ineIMAP')
2.993 E(s)-.37 E F0 .493("reference" feature to get at their mail-)2.993
-F(box)108 271.2 Q .46(es, specifying a reference of "~/Mail" or "#mh/" \
+F(box)108 328.8 Q .46(es, specifying a reference of "~/Mail" or "#mh/" \
depending on the con\214guration.)-.15 F .46(The belo)5.46 F 2.96(wc)
--.25 G(on\214gura-)-2.96 E .465(tion from docwhat@gerf.or)108 283.2 R
+-.25 G(on\214gura-)-2.96 E .465(tion from docwhat@gerf.or)108 340.8 R
2.965(gs)-.18 G(ho)-2.965 E .465(ws using a reference of Mail, a nametr\
ans that strips the leading Mail/ of)-.25 F(f)-.25 E(incoming folder na\
mes, and a folder\214lter that limits the folders synced to just three.)
-108 295.2 Q F1([Gerf])108 312 Q(localf)108 324 Q(olders = ~/Mail)-.25 E
--.18(re)108 336 S(motehost = gerf).18 E(.or)-.15 E(g)-.1 E(ssl = y)108
-348 Q(es)-.1 E -.18(re)108 360 S(moteuser = docwhat).18 E -.18(re)108
-372 S(fer).18 E(ence = Mail)-.18 E 2.5(#T)108 384 S(rims off the pr)
--3.24 E(eceeding Mail on all the f)-.18 E(older names.)-.25 E
-(nametrans = lambda f)108 396 Q(older)-.25 E(name: \\)-.15 E -.18(re)138
-408 S(.sub\('^Mail/', ').18 E(', f)-.63 E(older)-.25 E(name\))-.15 E 2.5
-(#Y)108 420 S(eah, y)-3.61 E(ou ha)-.25 E .2 -.1(ve t)-.25 H 2.5(om).1 G
-(ention the Mail dir)-2.5 E 2.5(,e)-.92 G -.1(ve)-2.65 G 2.5(nt).1 G
-(hough it)-2.5 E 2.5(#w)108 432 S(ould seem intuiti)-2.6 E .2 -.1(ve t)
--.1 H(hat r).1 E(efer)-.18 E(ence w)-.18 E(ould trim it.)-.1 E -.25(fo)
-108 444 S(lder\214lter = lambda f).25 E(older)-.25 E(name: f)-.15 E
-(older)-.25 E(name in [)-.15 E('Mail/INBO)125.5 456 Q(X',)-.4 E
-('Mail/list/zaurus-general',)125.5 468 Q('Mail/list/zaurus-de)125.5 480
-Q(v',)-.15 E(])125.5 492 Q(maxconnections = 1)108 504 Q
-(holdconnectionopen = no)108 516 Q/F3 10.95/Times-Bold@0 SF(ERR)72 532.8
-Q(ORS)-.329 E F0(If you get one of some frequently-encountered or confu\
-sing errors, please check this section.)108 544.8 Q F1(UID v)87 561.6 Q
-(alidity pr)-.1 E(oblem f)-.18 E(or f)-.25 E(older)-.25 E F0 1.638
-(IMAP serv)108 573.6 R 1.637
-(ers use a unique ID \(UID\) to refer to a speci\214c message.)-.15 F
-1.637(This number is guaranteed to be)6.637 F 1.109
-(unique to a particular message FOREVER.)108 585.6 R 1.109
-(No other message in the same folder will e)6.109 F -.15(ve)-.25 G 3.61
-(rg).15 G 1.11(et the same)-3.61 F 2.874(UID. UIDs)108 597.6 R .373
-(are an inte)2.874 F .373(gral part of Of)-.15 F(\215ineIMAP')-.25 E
-2.873(ss)-.55 G .373(ynchronization scheme; the)-2.873 F 2.873(ya)-.15 G
-.373(re used to match up mes-)-2.873 F
-(sages on your computer to messages on the serv)108 609.6 Q(er)-.15 E(.)
--.55 E .107(Sometimes, the UIDs on the serv)108 626.4 R .108
-(er might get reset.)-.15 F .108
-(Usually this will happen if you delete and then recreate)5.108 F 3.743
-(af)108 638.4 S(older)-3.743 E 6.243(.W)-.55 G 1.243
-(hen you create a folder)-6.243 F 3.742(,t)-.4 G 1.242(he serv)-3.742 F
-1.242(er will often start the UID back from 1.)-.15 F(But)6.242 E F1
-(Of\215ineIMAP)3.742 E F0 .302(might still ha)108 650.4 R .602 -.15
-(ve t)-.2 H .302(he UIDs from the pre).15 F .302
-(vious folder by the same name stored.)-.25 F F1(Of\215ineIMAP)5.303 E
-F0 .303(will detect this)2.803 F(condition and skip the folder)108 662.4
-Q 5(.T)-.55 G(his is GOOD, because it pre)-5 E -.15(ve)-.25 G
-(nts data loss.).15 E -1.1(Yo)108 679.2 S 2.827(uc)1.1 G .327
-(an \214x it by remo)-2.827 F .327
-(ving your local folder and cache data.)-.15 F -.15(Fo)5.327 G 2.827(ri)
-.15 G .327(nstance, if your folders are under)-2.827 F F2(~/F)2.826 E
-(old-)-1.05 E(er)108 691.2 Q(s)-.1 E F0
-(and the folder with the problem is INBO)2.5 E(X, you')-.4 E 2.5(dt)-.5
-G(ype this:)-2.5 E F1(rm -r ~/F)108 708 Q(olders/INBO)-.25 E(X)-.4 E
-(rm ~/.of\215ineimap/AccountName/INBO)108 720 Q(X)-.4 E F0(John Goerzen)
-72 768 Q(July 12, 2002)151.655 E(5)201.915 E EP
+108 352.8 Q F2([Gerf])108 376.8 Q(localf)108 388.8 Q(olders = ~/Mail)
+-.25 E -.18(re)108 400.8 S(motehost = gerf).18 E(.or)-.15 E(g)-.1 E
+(ssl = y)108 412.8 Q(es)-.1 E -.18(re)108 424.8 S(moteuser = docwhat).18
+E -.18(re)108 436.8 S(fer).18 E(ence = Mail)-.18 E 2.5(#T)108 448.8 S
+(rims off the pr)-3.24 E(eceeding Mail on all the f)-.18 E(older names.)
+-.25 E(nametrans = lambda f)108 460.8 Q(older)-.25 E(name: \\)-.15 E
+-.18(re)138 472.8 S(.sub\('^Mail/', ').18 E(', f)-.63 E(older)-.25 E
+(name\))-.15 E 2.5(#Y)108 484.8 S(eah, y)-3.61 E(ou ha)-.25 E .2 -.1
+(ve t)-.25 H 2.5(om).1 G(ention the Mail dir)-2.5 E 2.5(,e)-.92 G -.1
+(ve)-2.65 G 2.5(nt).1 G(hough it)-2.5 E 2.5(#w)108 496.8 S
+(ould seem intuiti)-2.6 E .2 -.1(ve t)-.1 H(hat r).1 E(efer)-.18 E
+(ence w)-.18 E(ould trim it.)-.1 E -.25(fo)108 508.8 S
+(lder\214lter = lambda f).25 E(older)-.25 E(name: f)-.15 E(older)-.25 E
+(name in [)-.15 E('Mail/INBO)125.5 520.8 Q(X',)-.4 E
+('Mail/list/zaurus-general',)125.5 532.8 Q('Mail/list/zaurus-de)125.5
+544.8 Q(v',)-.15 E(])125.5 556.8 Q(maxconnections = 1)108 568.8 Q
+(holdconnectionopen = no)108 580.8 Q(PYTHONFILE CONFIGURA)87 597.6 Q
+(TION FILE OPTION)-.95 E F0 -1.1(Yo)108 609.6 S 3.495(uc)1.1 G .995
+(an ha)-3.495 F 1.295 -.15(ve O)-.2 H -.25<668d>.15 G .995
+(ineIMAP load up a Python \214le before e).25 F -.25(va)-.25 G .995
+(luating the con\214guration \214le options that are).25 F(Python e)108
+621.6 Q 2.5(xpressions. This)-.15 F -.15(ex)2.5 G
+(ample is based on one supplied by T).15 E(ommi V)-.8 E
+(irtanen for this feature.)-.6 E(In)108 645.6 Q F1(~/.of)2.5 E
+(\215ineimap.r)-.18 E(c)-.37 E F0 2.5(,h)C 2.5(ea)-2.5 G
+(dds these options:)-2.5 E F2([general])108 669.6 Q
+(python\214le=~/.of\215ineimap.py)108 681.6 Q([f)108 693.6 Q(oo])-.25 E
+-.25(fo)108 705.6 S(ldersort=mycmp).25 E F0(Then, the)108 729.6 Q F1
+(~/.of)2.5 E(\215ineimap.py)-.18 E F0(\214le will contain:)2.5 E
+(John Goerzen)72 768 Q(July 12, 2002)151.655 E(5)201.915 E EP
%%Page: 6 6
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R
-(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E
-(\(replacing AccountName with the account name as speci\214ed in)108 84
-Q/F1 10/Times-Italic@0 SF(~/.of)2.5 E(\215ineimapr)-.18 E(c\))-.37 E F0
-(Ne)108 100.8 Q .801(xt time you run)-.15 F/F2 10/Times-Bold@0 SF
-(Of\215ineIMAP)3.301 E(,)-.92 E F0 .802(it will re-do)3.302 F .802
-(wnload the folder with the ne)-.25 F 3.302(wU)-.25 G 3.302(IDs. Note)
--3.302 F .802(that the proce-)3.302 F(dure speci\214ed abo)108 112.8 Q
-.3 -.15(ve w)-.15 H(ill lose an).15 E 2.5(yl)-.15 G
-(ocal changes made to the folder)-2.5 E(.)-.55 E .523(Some IMAP serv)108
-129.6 R .522(ers are brok)-.15 F .522
+(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10/Times-Bold@0
+SF(prioritized = ['INBO)108 84 Q(X', 'personal', 'announce', 'list'])-.4
+E(def mycmp\(x, y\):)108 108 Q -.25(fo)115.5 120 S 2.5(rp).25 G -.18(re)
+-2.5 G(\214x in prioritized:).18 E(if x.startswith\(pr)125.5 132 Q
+(e\214x\):)-.18 E -.18(re)135.5 144 S(tur).18 E 2.5(n-)-.15 G(1)-2.5 E
+(elif y)125.5 156 Q(.startswith\(pr)-.7 E(e\214x\):)-.18 E -.18(re)135.5
+168 S(tur).18 E 2.5(n+)-.15 G(1)-2.5 E -.18(re)115.5 180 S(tur).18 E 2.5
+(nc)-.15 G(mp\(x, y\))-2.5 E(def test_mycmp\(\):)108 204 Q
+(import os, os.path)115.5 216 Q -.25(fo)115.5 228 S
+(lders=os.listdir\(os.path.expanduser\('~/data/mail/tv@hq.y).25 E
+(ok.utu.\214'\)\))-.25 E -.25(fo)115.5 240 S(lders.sort\(mycmp\)).25 E
+(print f)115.5 252 Q(olders)-.25 E F0 .401
+(This code snippet illustrates ho)108 276 R 2.902(wt)-.25 G(he)-2.902 E
+F1 -.25(fo)2.902 G(ldersort).25 E F0 .402
+(option can be customized with a Python function from the)2.902 F F1
+(python\214le)108 288 Q F0(to al)2.5 E -.1(wa)-.1 G
+(ys synchronize certain folders \214rst.).1 E/F2 10.95/Times-Bold@0 SF
+(ERR)72 304.8 Q(ORS)-.329 E F0(If you get one of some frequently-encoun\
+tered or confusing errors, please check this section.)108 316.8 Q F1
+(UID v)87 333.6 Q(alidity pr)-.1 E(oblem f)-.18 E(or f)-.25 E(older)-.25
+E F0 1.638(IMAP serv)108 345.6 R 1.637
+(ers use a unique ID \(UID\) to refer to a speci\214c message.)-.15 F
+1.637(This number is guaranteed to be)6.637 F 1.109
+(unique to a particular message FOREVER.)108 357.6 R 1.109
+(No other message in the same folder will e)6.109 F -.15(ve)-.25 G 3.61
+(rg).15 G 1.11(et the same)-3.61 F 2.874(UID. UIDs)108 369.6 R .373
+(are an inte)2.874 F .373(gral part of Of)-.15 F(\215ineIMAP')-.25 E
+2.873(ss)-.55 G .373(ynchronization scheme; the)-2.873 F 2.873(ya)-.15 G
+.373(re used to match up mes-)-2.873 F
+(sages on your computer to messages on the serv)108 381.6 Q(er)-.15 E(.)
+-.55 E .107(Sometimes, the UIDs on the serv)108 398.4 R .108
+(er might get reset.)-.15 F .108
+(Usually this will happen if you delete and then recreate)5.108 F 3.743
+(af)108 410.4 S(older)-3.743 E 6.243(.W)-.55 G 1.243
+(hen you create a folder)-6.243 F 3.742(,t)-.4 G 1.242(he serv)-3.742 F
+1.242(er will often start the UID back from 1.)-.15 F(But)6.242 E F1
+(Of\215ineIMAP)3.742 E F0 .302(might still ha)108 422.4 R .602 -.15
+(ve t)-.2 H .302(he UIDs from the pre).15 F .302
+(vious folder by the same name stored.)-.25 F F1(Of\215ineIMAP)5.303 E
+F0 .303(will detect this)2.803 F(condition and skip the folder)108 434.4
+Q 5(.T)-.55 G(his is GOOD, because it pre)-5 E -.15(ve)-.25 G
+(nts data loss.).15 E -1.1(Yo)108 451.2 S 2.827(uc)1.1 G .327
+(an \214x it by remo)-2.827 F .327
+(ving your local folder and cache data.)-.15 F -.15(Fo)5.327 G 2.827(ri)
+.15 G .327(nstance, if your folders are under)-2.827 F/F3 10
+/Times-Italic@0 SF(~/F)2.826 E(old-)-1.05 E(er)108 463.2 Q(s)-.1 E F0
+(and the folder with the problem is INBO)2.5 E(X, you')-.4 E 2.5(dt)-.5
+G(ype this:)-2.5 E F1(rm -r ~/F)108 480 Q(olders/INBO)-.25 E(X)-.4 E
+(rm ~/.of\215ineimap/AccountName/INBO)108 492 Q(X)-.4 E F0
+(\(replacing AccountName with the account name as speci\214ed in)108
+508.8 Q F3(~/.of)2.5 E(\215ineimapr)-.18 E(c\))-.37 E F0(Ne)108 525.6 Q
+.801(xt time you run)-.15 F F1(Of\215ineIMAP)3.301 E(,)-.92 E F0 .802
+(it will re-do)3.302 F .802(wnload the folder with the ne)-.25 F 3.302
+(wU)-.25 G 3.302(IDs. Note)-3.302 F .802(that the proce-)3.302 F
+(dure speci\214ed abo)108 537.6 Q .3 -.15(ve w)-.15 H(ill lose an).15 E
+2.5(yl)-.15 G(ocal changes made to the folder)-2.5 E(.)-.55 E .523
+(Some IMAP serv)108 554.4 R .522(ers are brok)-.15 F .522
(en and do not support UIDs properly)-.1 F 5.522(.I)-.65 G 3.022(fy)
-5.522 G .522(ou continue to get this error for all)-3.022 F .066
-(your folders e)108 141.6 R -.15(ve)-.25 G 2.566(na).15 G .066
+(your folders e)108 566.4 R -.15(ve)-.25 G 2.566(na).15 G .066
(fter performing the abo)-2.566 F .366 -.15(ve p)-.15 H .066
(rocedure, it is lik).15 F .066(ely that your IMAP serv)-.1 F .066(er f)
--.15 F .067(alls into this cat-)-.1 F -.15(eg)108 153.6 S(ory).15 E(.)
--.65 E F2(Of\215ineIMAP)5.984 E F0 .984(is incompatible with such serv)
-3.484 F 3.484(ers. Using)-.15 F F2(Of\215ineIMAP)3.484 E F0 .984
-(with them will not destro)3.484 F(y)-.1 E(an)108 165.6 Q 2.769(ym)-.15
+-.15 F .067(alls into this cat-)-.1 F -.15(eg)108 578.4 S(ory).15 E(.)
+-.65 E F1(Of\215ineIMAP)5.984 E F0 .984(is incompatible with such serv)
+3.484 F 3.484(ers. Using)-.15 F F1(Of\215ineIMAP)3.484 E F0 .984
+(with them will not destro)3.484 F(y)-.1 E(an)108 590.4 Q 2.769(ym)-.15
G .269(ail, b)-2.769 F .269
(ut at the same time, it will not actually synchronize it either)-.2 F
5.27(.\()-.55 G(Of)-5.27 E .27(\215ineIMAP will detect this con-)-.25 F
-(dition and abort prior to synchronization\))108 177.6 Q/F3 10.95
-/Times-Bold@0 SF -.438(OT)72 206.4 S(HER FREQ).438 E(UENTL)-.11 E 2.738
-(YA)-1.007 G(SKED Q)-2.738 E(UESTIONS)-.11 E F0 .684
-(There are some other F)108 218.4 R -.55(AQ)-.74 G 3.184(st).55 G .684
+(dition and abort prior to synchronization\))108 602.4 Q F2 -.438(OT)72
+631.2 S(HER FREQ).438 E(UENTL)-.11 E 2.738(YA)-1.007 G(SKED Q)-2.738 E
+(UESTIONS)-.11 E F0 .684(There are some other F)108 643.2 R -.55(AQ)-.74
+G 3.184(st).55 G .684
(hat might not \214t into another section of this document, and the)
-3.184 F 3.183(ya)-.15 G .683(re enumer)-3.183 F(-)-.2 E(ated here.)108
-230.4 Q F2(What platf)108 247.2 Q(orms does Of\215ineIMAP run on?)-.25 E
+655.2 Q F1(What platf)108 672 Q(orms does Of\215ineIMAP run on?)-.25 E
F0(It should run on most platforms supported by Python, which are quite\
- a fe)144 259.2 Q -.65(w.)-.25 G F2 .688
-(I'm using Mutt. Other IMAP sync pr)108 276 R .689(ograms r)-.18 F
+ a fe)144 684 Q -.65(w.)-.25 G F1 .688
+(I'm using Mutt. Other IMAP sync pr)108 700.8 R .689(ograms r)-.18 F
(equir)-.18 E 3.189(em)-.18 G 3.189(et)-3.189 G 3.189(ou)-3.189 G .689
(se set maildir_trash=y)-3.189 F .689(es . Do I need to)-.1 F
-(do that with Of\215ineIMAP?)108 288 Q F0(No.)144 300 Q F2
+(do that with Of\215ineIMAP?)108 712.8 Q F0(No.)144 724.8 Q F1
(Of\215ineIMAP)7.27 E F0 2.27
(is smart enough to \214gure out message deletion without this e)4.77 F
-2.27(xtra crutch.)-.15 F -1.1(Yo)144 312 S(u')1.1 E
-(ll get the best results if you don')-.1 E 2.5(tu)-.18 G
-(se this setting, in f)-2.5 E(act.)-.1 E F2(Ho)108 328.8 Q 2.5(wd)-.1 G
-2.5(oIs)-2.5 G(pecify the names of my f)-2.5 E(olders?)-.25 E F0 -1.1
-(Yo)144 340.8 S 3.55(ud)1.1 G 3.55(on)-3.55 G 1.05(ot need to.)-3.55 F
-F2(Of\215ineIMAP)6.05 E F0 1.05
-(is smart enough to automatically \214gure out what folders are)3.55 F
-.678(present on the IMAP serv)144 352.8 R .678(er and synchronize them.)
--.15 F -1.1(Yo)5.679 G 3.179(uc)1.1 G .679(an use the)-3.179 F F2 -.25
-(fo)3.179 G(lder\214lter).25 E F0(and)3.179 E F2 -.25(fo)3.179 G
-(ldertrans).25 E F0(con\214guration \214le options to request certain f\
-olders and rename them as the)144 364.8 Q 2.5(yc)-.15 G
-(ome in if you lik)-2.5 E(e.)-.1 E F2(Ho)108 381.6 Q 2.5(wc)-.1 G
-(an I pr)-2.5 E -2.3 -.15(ev e)-.18 H(nt certain f).15 E(olders fr)-.25
-E(om being synced?)-.18 E F0(Use the)144 393.6 Q F2 -.25(fo)2.5 G
-(lder\214lter).25 E F0(option in the con\214guration \214le.)2.5 E F2
-(Ho)108 410.4 Q 2.5(wc)-.1 G(an I add or delete a f)-2.5 E(older?)-.25 E
-(Of\215ineIMAP)144 422.4 Q F0 .504(does not currently pro)3.004 F .504
-(vide this feature, b)-.15 F .504(ut if you create a ne)-.2 F 3.003(wf)
--.25 G .503(older on the IMAP)-3.003 F(serv)144 434.4 Q(er)-.15 E 2.5
-(,i)-.4 G 2.5(tw)-2.5 G(ill be created locally automatically)-2.5 E(.)
--.65 E F2(Ar)108 451.2 Q 2.5(et)-.18 G(her)-2.5 E 2.5(ea)-.18 G
-(ny other war)-2.5 E(nings that I should be awar)-.15 E 2.5(eo)-.18 G
-(f?)-2.5 E F0 -1(Ye)144 463.2 S(s; see the NO)1 E(TES section belo)-.4 E
--.65(w.)-.25 G F2(What is the mailbox name r)108 480 Q
-(ecorder \(mbnames\) f)-.18 E(or?)-.25 E F0 1.019(The Mutt mail reader \
-is not capable of automatically determining the names of your mailbox)
-144 492 R(es.)-.15 E(Of)144 504 Q .266(\215ineIMAP can help it \(or man)
--.25 F 2.765(yo)-.15 G .265
-(ther\) programs out be writing these names out in a format you)-2.765 F
-(specify)144 516 Q 5(.S)-.65 G(ee the e)-5 E(xample of)-.15 E
-(\215ineimap.conf \214le for details.)-.25 E F2(Can I synchr)108 532.8 Q
-(onize multiple accounts with Of\215ineIMAP?)-.18 E F0 3.344(Sure. Just)
-144 544.8 R .845(name them all in the accounts line in the general sect\
-ion of the con\214g \214le, and add a)3.344 F(per)144 556.8 Q
-(-account section for each one.)-.2 E F2
-(Does Of\215ineIMAP support POP?)108 573.6 Q F0 4.077(No. POP)144 585.6
-R 1.576(is not rob)4.077 F 1.576(ust enough to do a completely reliable\
- multi-machine synchronization lik)-.2 F(e)-.1 E(Of)144 597.6 Q
-(\215ineIMAP can do.)-.25 E(Of)5 E(\215ineIMAP will not support it.)-.25
-E F2(Do y)108 614.4 Q(ou support mailbox f)-.25 E
-(ormats other than Maildir?)-.25 E F0 .409(Not at present.)144 626.4 R
-.409(There is no technical reason not to; just no demand yet.)5.409 F
-.41(Maildir is a superior for)5.41 F(-)-.2 E(mat an)144 638.4 Q(yw)-.15
-E(ay)-.1 E(.)-.65 E F2([technical] Wh)108 655.2 Q 2.5(ya)-.15 G .36 -.18
-(re y)-2.5 H(our Maildir message \214lenames so huge?)-.07 E
-(Of\215ineIMAP)144 667.2 Q F0 .959(has tw)3.459 F 3.459(or)-.1 G(ele)
--3.459 E -.25(va)-.25 G .959(nt principles: 1\) ne).25 F -.15(ve)-.25 G
-3.459(rm).15 G .958(odifying your messages in an)-3.459 F 3.458(yw)-.15
-G .958(ay and 2\))-3.558 F .493
-(ensuring 100% reliable synchronizations.)144 679.2 R .493
-(In order to do a reliable sync,)5.493 F F2(Of\215ineIMAP)2.993 E F0
-.494(must ha)2.993 F -.15(ve)-.2 G 3.095(aw)144 691.2 S .595
-(ay to uniquely identify each e-mail.)-3.195 F .594
-(Three pieces of information are required to do this: your)5.594 F .537
-(account name, the folder name, and the message UID.)144 703.2 R .538
-(The account name can be calculated from)5.537 F 1.082
-(the path in which your messages are.)144 715.2 R 1.082
-(The folder name can usually be as well, B)6.082 F 1.081(UT some mail)
--.1 F(clients mo)144 727.2 Q .3 -.15(ve m)-.15 H
-(essages between folders by simply mo).15 E(ving the \214le, lea)-.15 E
-(ving the name intact.)-.2 E(John Goerzen)72 768 Q(July 12, 2002)151.655
-E(6)201.915 E EP
+2.27(xtra crutch.)-.15 F(John Goerzen)72 768 Q(July 12, 2002)151.655 E
+(6)201.915 E EP
%%Page: 7 7
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R
-(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E(So,)144 84 Q/F1 10
-/Times-Bold@0 SF(Of\215ineIMAP)3.2 E F0 .7
+(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E -1.1(Yo)144 84 S
+(u')1.1 E(ll get the best results if you don')-.1 E 2.5(tu)-.18 G
+(se this setting, in f)-2.5 E(act.)-.1 E/F1 10/Times-Bold@0 SF(Ho)108
+100.8 Q 2.5(wd)-.1 G 2.5(oIs)-2.5 G(pecify the names of my f)-2.5 E
+(olders?)-.25 E F0 -1.1(Yo)144 112.8 S 3.55(ud)1.1 G 3.55(on)-3.55 G
+1.05(ot need to.)-3.55 F F1(Of\215ineIMAP)6.05 E F0 1.05
+(is smart enough to automatically \214gure out what folders are)3.55 F
+.678(present on the IMAP serv)144 124.8 R .678(er and synchronize them.)
+-.15 F -1.1(Yo)5.679 G 3.179(uc)1.1 G .679(an use the)-3.179 F F1 -.25
+(fo)3.179 G(lder\214lter).25 E F0(and)3.179 E F1 -.25(fo)3.179 G
+(ldertrans).25 E F0(con\214guration \214le options to request certain f\
+olders and rename them as the)144 136.8 Q 2.5(yc)-.15 G
+(ome in if you lik)-2.5 E(e.)-.1 E F1(Ho)108 153.6 Q 2.5(wc)-.1 G
+(an I pr)-2.5 E -2.3 -.15(ev e)-.18 H(nt certain f).15 E(olders fr)-.25
+E(om being synced?)-.18 E F0(Use the)144 165.6 Q F1 -.25(fo)2.5 G
+(lder\214lter).25 E F0(option in the con\214guration \214le.)2.5 E F1
+(Ho)108 182.4 Q 2.5(wc)-.1 G(an I add or delete a f)-2.5 E(older?)-.25 E
+(Of\215ineIMAP)144 194.4 Q F0 .504(does not currently pro)3.004 F .504
+(vide this feature, b)-.15 F .504(ut if you create a ne)-.2 F 3.003(wf)
+-.25 G .503(older on the IMAP)-3.003 F(serv)144 206.4 Q(er)-.15 E 2.5
+(,i)-.4 G 2.5(tw)-2.5 G(ill be created locally automatically)-2.5 E(.)
+-.65 E F1(Ar)108 223.2 Q 2.5(et)-.18 G(her)-2.5 E 2.5(ea)-.18 G
+(ny other war)-2.5 E(nings that I should be awar)-.15 E 2.5(eo)-.18 G
+(f?)-2.5 E F0 -1(Ye)144 235.2 S(s; see the NO)1 E(TES section belo)-.4 E
+-.65(w.)-.25 G F1(What is the mailbox name r)108 252 Q
+(ecorder \(mbnames\) f)-.18 E(or?)-.25 E F0 1.019(The Mutt mail reader \
+is not capable of automatically determining the names of your mailbox)
+144 264 R(es.)-.15 E(Of)144 276 Q .266(\215ineIMAP can help it \(or man)
+-.25 F 2.765(yo)-.15 G .265
+(ther\) programs out be writing these names out in a format you)-2.765 F
+(specify)144 288 Q 5(.S)-.65 G(ee the e)-5 E(xample of)-.15 E
+(\215ineimap.conf \214le for details.)-.25 E F1(Can I synchr)108 304.8 Q
+(onize multiple accounts with Of\215ineIMAP?)-.18 E F0 3.344(Sure. Just)
+144 316.8 R .845(name them all in the accounts line in the general sect\
+ion of the con\214g \214le, and add a)3.344 F(per)144 328.8 Q
+(-account section for each one.)-.2 E F1
+(Does Of\215ineIMAP support POP?)108 345.6 Q F0 4.077(No. POP)144 357.6
+R 1.576(is not rob)4.077 F 1.576(ust enough to do a completely reliable\
+ multi-machine synchronization lik)-.2 F(e)-.1 E(Of)144 369.6 Q
+(\215ineIMAP can do.)-.25 E(Of)5 E(\215ineIMAP will not support it.)-.25
+E F1(Do y)108 386.4 Q(ou support mailbox f)-.25 E
+(ormats other than Maildir?)-.25 E F0 .409(Not at present.)144 398.4 R
+.409(There is no technical reason not to; just no demand yet.)5.409 F
+.41(Maildir is a superior for)5.41 F(-)-.2 E(mat an)144 410.4 Q(yw)-.15
+E(ay)-.1 E(.)-.65 E F1([technical] Wh)108 427.2 Q 2.5(ya)-.15 G .36 -.18
+(re y)-2.5 H(our Maildir message \214lenames so huge?)-.07 E
+(Of\215ineIMAP)144 439.2 Q F0 .959(has tw)3.459 F 3.459(or)-.1 G(ele)
+-3.459 E -.25(va)-.25 G .959(nt principles: 1\) ne).25 F -.15(ve)-.25 G
+3.459(rm).15 G .958(odifying your messages in an)-3.459 F 3.458(yw)-.15
+G .958(ay and 2\))-3.558 F .493
+(ensuring 100% reliable synchronizations.)144 451.2 R .493
+(In order to do a reliable sync,)5.493 F F1(Of\215ineIMAP)2.993 E F0
+.494(must ha)2.993 F -.15(ve)-.2 G 3.095(aw)144 463.2 S .595
+(ay to uniquely identify each e-mail.)-3.195 F .594
+(Three pieces of information are required to do this: your)5.594 F .537
+(account name, the folder name, and the message UID.)144 475.2 R .538
+(The account name can be calculated from)5.537 F 1.082
+(the path in which your messages are.)144 487.2 R 1.082
+(The folder name can usually be as well, B)6.082 F 1.081(UT some mail)
+-.1 F(clients mo)144 499.2 Q .3 -.15(ve m)-.15 H
+(essages between folders by simply mo).15 E(ving the \214le, lea)-.15 E
+(ving the name intact.)-.2 E(So,)144 516 Q F1(Of\215ineIMAP)3.2 E F0 .7
(must store both a UID folder ID.)3.2 F .7
(The folder ID is necessary so)5.7 F F1(Of\215ineIMAP)3.2 E F0 .456
-(can detect a message mo)144 96 R -.15(ve)-.15 G 2.956(dt).15 G 2.955
+(can detect a message mo)144 528 R -.15(ve)-.15 G 2.956(dt).15 G 2.955
(oad)-2.956 G(if)-2.955 E .455(ferent folder)-.25 F(.)-.55 E F1
(Of\215ineIMAP)5.455 E F0 .455(stores the UID \(U= number\) and)2.955 F
-(an md5sum of the foldername \(FMD5= number\) to f)144 108 Q
-(acilitate this.)-.1 E F1(What is the speed of Of\215ineIMAP')108 124.8
-Q 2.5(ss)-.37 G(ync?)-2.5 E(Of\215ineIMAP)144 136.8 Q F0 -.15(ve)2.89 G
+(an md5sum of the foldername \(FMD5= number\) to f)144 540 Q
+(acilitate this.)-.1 E F1(What is the speed of Of\215ineIMAP')108 556.8
+Q 2.5(ss)-.37 G(ync?)-2.5 E(Of\215ineIMAP)144 568.8 Q F0 -.15(ve)2.89 G
.39(rsions 2.0 and abo).15 F .691 -.15(ve c)-.15 H .391
(ontain a multithreaded system.).15 F 2.891(Ag)5.391 G .391(ood w)-2.891
F .391(ay to e)-.1 F(xperiment)-.15 E(is by setting maxsyncaccounts to \
-3 and maxconnections to 3 in each account clause.)144 148.8 Q .382
-(This lets Of)144 165.6 R .382
+3 and maxconnections to 3 in each account clause.)144 580.8 Q .382
+(This lets Of)144 597.6 R .382
(\215ineIMAP open up multiple connections simultaneously)-.25 F 5.381
(.T)-.65 G .381(hat will let it process mul-)-5.381 F
-(tiple folders and messages at once.)144 177.6 Q
+(tiple folders and messages at once.)144 609.6 Q
(In most cases, this will increase performance of the sync.)5 E(Don')144
-194.4 Q 3.103(ts)-.18 G .603(et the number too high.)-3.103 F .603
+626.4 Q 3.103(ts)-.18 G .603(et the number too high.)-3.103 F .603
(If you do that, things might actually slo)5.603 F 3.104(wd)-.25 G -.25
(ow)-3.104 G 3.104(na).25 G 3.104(sy)-3.104 G .604(our link gets)-3.104
-F 2.633(saturated. Also,)144 206.4 R .133(too man)2.633 F 2.633(yc)-.15
+F 2.633(saturated. Also,)144 638.4 R .133(too man)2.633 F 2.633(yc)-.15
G .132(onnections can cause mail serv)-2.633 F .132(ers to ha)-.15 F
.432 -.15(ve ex)-.2 H(cessi).15 E .432 -.15(ve l)-.25 H 2.632
-(oad. Administra-).15 F .506(tors might tak)144 218.4 R 3.006(eu)-.1 G
+(oad. Administra-).15 F .506(tors might tak)144 650.4 R 3.006(eu)-.1 G
.506(nkindly to this, and the serv)-3.006 F .507(er might bog do)-.15 F
3.007(wn. There)-.25 F .507(are man)3.007 F 3.007(yv)-.15 G .507
-(ariables in the)-3.257 F(optimal setting; e)144 230.4 Q
+(ariables in the)-3.257 F(optimal setting; e)144 662.4 Q
(xperimentation may help.)-.15 E
-(An informal benchmark yields these results for my setup:)144 247.2 Q
-(10 minutes with MacOS X Mail.app "manual cache")144 264 Q 2.5(5m)144
-276 S(inutes with GNUS agent sync)-2.5 E(20 seconds with Of)144 288 Q
-(\215ineIMAP 1.x)-.25 E 2.5(9s)144 300 S(econds with Of)-2.5 E
-(\215ineIMAP 2.x)-.25 E 2.5(3s)144 312 S(econds with Of)-2.5 E
-(\215ineIMAP 3.x "cold start")-.25 E 2.5(2s)144 324 S(econds with Of)
--2.5 E(\215ineIMAP 3.x "held connection")-.25 E/F2 10.95/Times-Bold@0 SF
-(CONFORMING T)72 340.8 Q(O)-.197 E F0 32.5<8349>108 352.8 S
-(nternet Message Access Protocol v)-32.5 E(ersion 4re)-.15 E
-(v1 \(IMAP 4re)-.25 E(v1\) as speci\214ed in RFC2060)-.25 E 32.5<834d>
-108 369.6 S 8.92(aildir as speci\214ed in http://www)-32.5 F(.qmail.or)
--.65 E(g/qmail-manual-html/man5/maildir)-.18 E 8.92(.html and)-.55 F
-(http://cr)144 381.6 Q(.yp.to/proto/maildir)-.55 E(.html.)-.55 E 32.5
-<8353>108 398.4 S
-(tandard Python 2.2.1 as implemented on POSIX-compliant systems.)-32.5 E
-F2(NO)72 415.2 Q(TES)-.438 E F1(DELETING LOCAL FOLDERS)87 427.2 Q
-(Of\215ineIMAP)108 439.2 Q F0 .532(does a tw)3.032 F(o-w)-.1 E .532
-(ay synchronization.)-.1 F .532(That is, if you mak)5.532 F 3.032(eac)
--.1 G .532(hange to the mail on the serv)-3.032 F(er)-.15 E 3.033(,i)-.4
-G(t)-3.033 E .897(will be propog)108 451.2 R .897
-(ated to your local cop)-.05 F 2.197 -.65(y, a)-.1 H .897(nd vise-v).65
-F 3.397(ersa. Some)-.15 F .896(people might think that it w)3.397 F .896
-(ould be wise to)-.1 F 1.59
-(just delete all their local mail folders periodically)108 463.2 R 6.59
-(.I)-.65 G 4.09(fy)-6.59 G 1.59(ou do this with Of)-4.09 F(\215ineIMAP)
--.25 E 4.09(,r)-1.11 G 1.59(emember to also)-4.09 F(remo)108 475.2 Q
-1.67 -.15(ve y)-.15 H 1.37(our local status cache \(~/.of).15 F 1.37
-(\215ineimap by def)-.25 F 3.87(ault\). Otherwise,)-.1 F(Of)3.87 E 1.37
-(\215ineIMAP will tak)-.25 F 3.87(et)-.1 G 1.37(his as an)-3.87 F .415
-(intentional deletion of man)108 487.2 R 2.915(ym)-.15 G .416(essages a\
-nd will interpret your action as requesting them to be deleted from)
--2.915 F(the serv)108 499.2 Q(er as well.)-.15 E(\(If you don')5 E 2.5
-(tu)-.18 G(nderstand this, don')-2.5 E 2.5(tw)-.18 G
-(orry; you probably w)-2.6 E(on')-.1 E 2.5(te)-.18 G
-(ncounter this situation\))-2.5 E F1(COPYING MESSA)87 516 Q
-(GES BETWEEN FOLDERS)-.55 E F0(Normally)108 528 Q 5.859(,w)-.65 G 3.359
-(hen you cop)-5.859 F 5.859(yam)-.1 G 3.359
-(essage between folders or add a ne)-5.859 F 5.859(wm)-.25 G 3.358
-(essage to a folder locally)-5.859 F(,)-.65 E F1(Of\215ineIMAP)108 540 Q
-F0 .853(will just do the right thing.)3.352 F(Ho)5.853 E(we)-.25 E -.15
-(ve)-.25 G 1.653 -.4(r, s).15 H .853(ometimes this can be trick).4 F
-3.353(y-)-.15 G 3.353(-i)-3.353 G 3.353(fy)-3.353 G .853(our IMAP serv)
--3.353 F(er)-.15 E .29(does not pro)108 552 R .29
-(vide the SEARCH command, or does not return something useful,)-.15 F F1
-(Of\215ineIMAP)2.79 E F0 .29(cannot deter)2.79 F(-)-.2 E .173
-(mine the ne)108 564 R 2.673(wU)-.25 G .173(ID of the message.)-2.673 F
-.173(So, in these rare instances, Of)5.173 F .174
-(\215ineIMAP will upload the message to the)-.25 F .64(IMAP serv)108 576
-R .64(er and delete it from your local folder)-.15 F 5.64(.T)-.55 G .64
-(hen, on your ne)-5.64 F .64(xt sync, the message will be re-do)-.15 F
-(wn-)-.25 E 1.472(loaded with the proper UID.)108 588 R F1
-(Of\215ineIMAP)6.473 E F0(mak)3.973 E 1.473(es sure that the message w)
--.1 F 1.473(as properly uploaded before)-.1 F
-(deleting it, so there should be no risk of data loss.)108 600 Q F1
-(MAILING LIST)87 616.8 Q F0(There is an Of)108 628.8 Q
-(\215ineIMAP mailing list a)-.25 E -.25(va)-.2 G(ilable.).25 E 2.448 -.8
-(To s)108 645.6 T .847(ubscribe, send the te).8 F .847
-(xt "Subscribe" in the subject of a mail to of)-.15 F
-(\215ineimap-request@complete.or)-.25 E 3.347(g. T)-.18 F(o)-.8 E
-(post, send the message to of)108 657.6 Q(\215ineimap@complete.or)-.25 E
-(g.)-.18 E F2 -.11(BU)72 674.4 S(GS).11 E F0 4.419(Reports of b)108
-686.4 R 4.419(ugs should be sent via e-mail to the)-.2 F F1
-(Of\215ineIMAP)6.919 E F0 -.2(bu)6.92 G 4.42
-(g-tracking system \(BTS\) at).2 F(of)108 698.4 Q(\215ineimap@b)-.25 E
-(ugs.complete.or)-.2 E 3.397(go)-.18 G 3.397(rs)-3.397 G .897
-(ubmitted on-line using the W)-3.397 F .896(eb interf)-.8 F .896
-(ace at http://b)-.1 F(ugs.complete.or)-.2 E(g/.)-.18 E(The W)108 710.4
-Q(eb site also lists all current b)-.8 E
-(ugs, where you can check their status or contrib)-.2 E
-(ute to \214xing them.)-.2 E(John Goerzen)72 768 Q(July 12, 2002)151.655
-E(7)201.915 E EP
+(An informal benchmark yields these results for my setup:)144 679.2 Q
+(10 minutes with MacOS X Mail.app "manual cache")144 696 Q 2.5(5m)144
+708 S(inutes with GNUS agent sync)-2.5 E(20 seconds with Of)144 720 Q
+(\215ineIMAP 1.x)-.25 E(John Goerzen)72 768 Q(July 12, 2002)151.655 E(7)
+201.915 E EP
%%Page: 8 8
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R
-(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10.95
-/Times-Bold@0 SF(COPYRIGHT)72 84 Q F0(Of)108 96 Q(\215ineIMAP is Cop)
--.25 E(yright \(C\) 2002 John Goerzen.)-.1 E .286
-(This program is free softw)108 112.8 R .286(are; you can redistrib)-.1
-F .287(ute it and/or modify it under the terms of the GNU General)-.2 F
-.766(Public License as published by the Free Softw)108 124.8 R .766
-(are F)-.1 F .766(oundation; either v)-.15 F .766
-(ersion 2 of the License, or \(at your)-.15 F(option\) an)108 136.8 Q
-2.5(yl)-.15 G(ater v)-2.5 E(ersion.)-.15 E .579(This program is distrib)
-108 153.6 R .579(uted in the hope that it will be useful, b)-.2 F .58
+(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E 2.5(9s)144 84 S
+(econds with Of)-2.5 E(\215ineIMAP 2.x)-.25 E 2.5(3s)144 96 S
+(econds with Of)-2.5 E(\215ineIMAP 3.x "cold start")-.25 E 2.5(2s)144
+108 S(econds with Of)-2.5 E(\215ineIMAP 3.x "held connection")-.25 E/F1
+10.95/Times-Bold@0 SF(CONFORMING T)72 124.8 Q(O)-.197 E F0 32.5<8349>108
+136.8 S(nternet Message Access Protocol v)-32.5 E(ersion 4re)-.15 E
+(v1 \(IMAP 4re)-.25 E(v1\) as speci\214ed in RFC2060)-.25 E 32.5<834d>
+108 153.6 S 8.92(aildir as speci\214ed in http://www)-32.5 F(.qmail.or)
+-.65 E(g/qmail-manual-html/man5/maildir)-.18 E 8.92(.html and)-.55 F
+(http://cr)144 165.6 Q(.yp.to/proto/maildir)-.55 E(.html.)-.55 E 32.5
+<8353>108 182.4 S
+(tandard Python 2.2.1 as implemented on POSIX-compliant systems.)-32.5 E
+F1(NO)72 199.2 Q(TES)-.438 E/F2 10/Times-Bold@0 SF
+(DELETING LOCAL FOLDERS)87 211.2 Q(Of\215ineIMAP)108 223.2 Q F0 .532
+(does a tw)3.032 F(o-w)-.1 E .532(ay synchronization.)-.1 F .532
+(That is, if you mak)5.532 F 3.032(eac)-.1 G .532
+(hange to the mail on the serv)-3.032 F(er)-.15 E 3.033(,i)-.4 G(t)
+-3.033 E .897(will be propog)108 235.2 R .897(ated to your local cop)
+-.05 F 2.197 -.65(y, a)-.1 H .897(nd vise-v).65 F 3.397(ersa. Some)-.15
+F .896(people might think that it w)3.397 F .896(ould be wise to)-.1 F
+1.59(just delete all their local mail folders periodically)108 247.2 R
+6.59(.I)-.65 G 4.09(fy)-6.59 G 1.59(ou do this with Of)-4.09 F
+(\215ineIMAP)-.25 E 4.09(,r)-1.11 G 1.59(emember to also)-4.09 F(remo)
+108 259.2 Q 1.67 -.15(ve y)-.15 H 1.37(our local status cache \(~/.of)
+.15 F 1.37(\215ineimap by def)-.25 F 3.87(ault\). Otherwise,)-.1 F(Of)
+3.87 E 1.37(\215ineIMAP will tak)-.25 F 3.87(et)-.1 G 1.37(his as an)
+-3.87 F .415(intentional deletion of man)108 271.2 R 2.915(ym)-.15 G
+.416(essages and will interpret your action as requesting them to be de\
+leted from)-2.915 F(the serv)108 283.2 Q(er as well.)-.15 E
+(\(If you don')5 E 2.5(tu)-.18 G(nderstand this, don')-2.5 E 2.5(tw)-.18
+G(orry; you probably w)-2.6 E(on')-.1 E 2.5(te)-.18 G
+(ncounter this situation\))-2.5 E F2(COPYING MESSA)87 300 Q
+(GES BETWEEN FOLDERS)-.55 E F0(Normally)108 312 Q 5.859(,w)-.65 G 3.359
+(hen you cop)-5.859 F 5.859(yam)-.1 G 3.359
+(essage between folders or add a ne)-5.859 F 5.859(wm)-.25 G 3.358
+(essage to a folder locally)-5.859 F(,)-.65 E F2(Of\215ineIMAP)108 324 Q
+F0 .853(will just do the right thing.)3.352 F(Ho)5.853 E(we)-.25 E -.15
+(ve)-.25 G 1.653 -.4(r, s).15 H .853(ometimes this can be trick).4 F
+3.353(y-)-.15 G 3.353(-i)-3.353 G 3.353(fy)-3.353 G .853(our IMAP serv)
+-3.353 F(er)-.15 E .29(does not pro)108 336 R .29
+(vide the SEARCH command, or does not return something useful,)-.15 F F2
+(Of\215ineIMAP)2.79 E F0 .29(cannot deter)2.79 F(-)-.2 E .173
+(mine the ne)108 348 R 2.673(wU)-.25 G .173(ID of the message.)-2.673 F
+.173(So, in these rare instances, Of)5.173 F .174
+(\215ineIMAP will upload the message to the)-.25 F .64(IMAP serv)108 360
+R .64(er and delete it from your local folder)-.15 F 5.64(.T)-.55 G .64
+(hen, on your ne)-5.64 F .64(xt sync, the message will be re-do)-.15 F
+(wn-)-.25 E 1.472(loaded with the proper UID.)108 372 R F2
+(Of\215ineIMAP)6.473 E F0(mak)3.973 E 1.473(es sure that the message w)
+-.1 F 1.473(as properly uploaded before)-.1 F
+(deleting it, so there should be no risk of data loss.)108 384 Q F2
+(MAILING LIST)87 400.8 Q F0(There is an Of)108 412.8 Q
+(\215ineIMAP mailing list a)-.25 E -.25(va)-.2 G(ilable.).25 E 2.448 -.8
+(To s)108 429.6 T .847(ubscribe, send the te).8 F .847
+(xt "Subscribe" in the subject of a mail to of)-.15 F
+(\215ineimap-request@complete.or)-.25 E 3.347(g. T)-.18 F(o)-.8 E
+(post, send the message to of)108 441.6 Q(\215ineimap@complete.or)-.25 E
+(g.)-.18 E F1 -.11(BU)72 458.4 S(GS).11 E F0 4.419(Reports of b)108
+470.4 R 4.419(ugs should be sent via e-mail to the)-.2 F F2
+(Of\215ineIMAP)6.919 E F0 -.2(bu)6.92 G 4.42
+(g-tracking system \(BTS\) at).2 F(of)108 482.4 Q(\215ineimap@b)-.25 E
+(ugs.complete.or)-.2 E 3.397(go)-.18 G 3.397(rs)-3.397 G .897
+(ubmitted on-line using the W)-3.397 F .896(eb interf)-.8 F .896
+(ace at http://b)-.1 F(ugs.complete.or)-.2 E(g/.)-.18 E(The W)108 494.4
+Q(eb site also lists all current b)-.8 E
+(ugs, where you can check their status or contrib)-.2 E
+(ute to \214xing them.)-.2 E F1(COPYRIGHT)72 511.2 Q F0(Of)108 523.2 Q
+(\215ineIMAP is Cop)-.25 E(yright \(C\) 2002 John Goerzen.)-.1 E .286
+(This program is free softw)108 540 R .286(are; you can redistrib)-.1 F
+.287(ute it and/or modify it under the terms of the GNU General)-.2 F
+.766(Public License as published by the Free Softw)108 552 R .766(are F)
+-.1 F .766(oundation; either v)-.15 F .766
+(ersion 2 of the License, or \(at your)-.15 F(option\) an)108 564 Q 2.5
+(yl)-.15 G(ater v)-2.5 E(ersion.)-.15 E .579(This program is distrib)108
+580.8 R .579(uted in the hope that it will be useful, b)-.2 F .58
(ut WITHOUT ANY W)-.2 F(ARRANTY)-1.2 E 3.08(;w)-.92 G(ithout)-3.08 E
--2.15 -.25(ev e)108 165.6 T 2.73(nt).25 G .23(he implied w)-2.73 F .229
+-2.15 -.25(ev e)108 592.8 T 2.73(nt).25 G .23(he implied w)-2.73 F .229
(arranty of MERCHANT)-.1 F .229(ABILITY or FITNESS FOR A P)-.93 F(AR)
-.92 E .229(TICULAR PURPOSE.)-.6 F(See)5.229 E
-(the GNU General Public License for more details.)108 177.6 Q -1.1(Yo)
-108 194.4 S 2.77(us)1.1 G .27(hould ha)-2.77 F .57 -.15(ve r)-.2 H(ecei)
+(the GNU General Public License for more details.)108 604.8 Q -1.1(Yo)
+108 621.6 S 2.77(us)1.1 G .27(hould ha)-2.77 F .57 -.15(ve r)-.2 H(ecei)
.15 E -.15(ve)-.25 G 2.77(dac).15 G(op)-2.77 E 2.77(yo)-.1 G 2.77(ft)
-2.77 G .27
(he GNU General Public License along with this program; if not, write)
--2.77 F(to:)108 206.4 Q(Free Softw)108 223.2 Q(are F)-.1 E
-(oundation, Inc.)-.15 E(59 T)108 235.2 Q(emple Place)-.7 E(Suite 330)108
-247.2 Q(Boston, MA)108 259.2 Q(02111-1307)5 E(USA)108 271.2 Q F1 -.548
-(AU)72 288 S(THOR).548 E/F2 10/Times-Bold@0 SF(Of\215ineIMAP)108 300 Q
-(,)-.92 E F0 .488
+-2.77 F(to:)108 633.6 Q(Free Softw)108 650.4 Q(are F)-.1 E
+(oundation, Inc.)-.15 E(59 T)108 662.4 Q(emple Place)-.7 E(Suite 330)108
+674.4 Q(Boston, MA)108 686.4 Q(02111-1307)5 E(USA)108 698.4 Q
+(John Goerzen)72 768 Q(July 12, 2002)151.655 E(8)201.915 E EP
+%%Page: 9 9
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R
+(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10.95
+/Times-Bold@0 SF -.548(AU)72 84 S(THOR).548 E/F2 10/Times-Bold@0 SF
+(Of\215ineIMAP)108 96 Q(,)-.92 E F0 .488
(its libraries, documentation, and all included \214les, e)2.988 F .488
(xcept where noted, w)-.15 F .487(as written by John)-.1 F
-(Goerzen and cop)-.18 E
-(yright is held as stated in the COPYRIGHT section.)-.1 E(Of)108 328.8 Q
+(Goerzen and cop)-.18 E
+(yright is held as stated in the COPYRIGHT section.)-.1 E(Of)108 124.8 Q
(\215ineIMAP may be do)-.25 E(wnloaded, and information found, from its\
- homepage via either Gopher or HTTP:)-.25 E(gopher://quux.or)108 345.6 Q
+ homepage via either Gopher or HTTP:)-.25 E(gopher://quux.or)108 141.6 Q
(g/1/de)-.18 E -.15(ve)-.25 G(l/of).15 E(\215ineimap)-.25 E
-(http://quux.or)108 357.6 Q(g/de)-.18 E -.15(ve)-.25 G(l/of).15 E
-(\215ineimap)-.25 E(Of)108 374.4 Q 2.528(\215ineIMAP may also be do)-.25
+(http://quux.or)108 153.6 Q(g/de)-.18 E -.15(ve)-.25 G(l/of).15 E
+(\215ineimap)-.25 E(Of)108 170.4 Q 2.528(\215ineIMAP may also be do)-.25
F 2.528(wnloaded using Sub)-.25 F -.15(ve)-.15 G 5.028
(rsion. Additionally).15 F 5.028(,t)-.65 G 2.529(he distrib)-5.028 F
2.529(uted tar)-.2 F 2.529(.gz may be)-.55 F .718
(updated with a simple "svn update" command; it is ready to go.)108
-386.4 R -.15(Fo)5.717 G 3.217(ri).15 G .717(nformation on getting Of)
--3.217 F(\215ineIMAP)-.25 E(with Sub)108 398.4 Q -.15(ve)-.15 G
-(rsion, please visit:).15 E(http://svn.complete.or)108 415.2 Q(g/)-.18 E
-F1(SEE ALSO)72 432 Q F2(mutt)108 444 Q F0(\(1\),)A F2(python)2.5 E F0
-(\(1\).)A(John Goerzen)72 768 Q(July 12, 2002)151.655 E(8)201.915 E EP
+182.4 R -.15(Fo)5.717 G 3.217(ri).15 G .717(nformation on getting Of)
+-3.217 F(\215ineIMAP)-.25 E(with Sub)108 194.4 Q -.15(ve)-.15 G
+(rsion, please visit:).15 E(http://svn.complete.or)108 211.2 Q(g/)-.18 E
+F1(SEE ALSO)72 228 Q F2(mutt)108 240 Q F0(\(1\),)A F2(python)2.5 E F0
+(\(1\).)A(John Goerzen)72 768 Q(July 12, 2002)151.655 E(9)201.915 E EP
%%Trailer
end
%%EOF
diff --git a/offlineimap/head/manual.txt b/offlineimap/head/manual.txt
index d13cd66..5bb03f9 100644
--- a/offlineimap/head/manual.txt
+++ b/offlineimap/head/manual.txt
@@ -88,7 +88,7 @@ INSTALLATION
check with your system administrator or operating
system vendor; or, download it from
http://www.python.org/. If you intend to use the
- Tk interface, you must have Tkiner (python-tk)
+ Tk interface, you must have Tkinter (python-tk)
installed. If you intend to use the SSL interface,
your Python must have been built with SSL support.
@@ -403,6 +403,42 @@ EXAMPLES
maxconnections = 1
holdconnectionopen = no
+ PYTHONFILE CONFIGURATION FILE OPTION
+ You can have OfflineIMAP load up a Python file before
+ evaluating the configuration file options that are Python
+ expressions. This example is based on one supplied by
+ Tommi Virtanen for this feature.
+
+ In ~/.offlineimap.rc, he adds these options:
+
+ [general]
+ pythonfile=~/.offlineimap.py
+ [foo]
+ foldersort=mycmp
+
+ Then, the ~/.offlineimap.py file will contain:
+
+ prioritized = ['INBOX', 'personal', 'announce', 'list']
+
+ def mycmp(x, y):
+ for prefix in prioritized:
+ if x.startswith(prefix):
+ return -1
+ elif y.startswith(prefix):
+ return +1
+ return cmp(x, y)
+
+ def test_mycmp():
+ import os, os.path
+ folders=os.list-
+ dir(os.path.expanduser('~/data/mail/tv@hq.yok.utu.fi'))
+ folders.sort(mycmp)
+ print folders
+
+ This code snippet illustrates how the foldersort option
+ can be customized with a Python function from the python-
+ file to always synchronize certain folders first.
+
ERRORS
If you get one of some frequently-encountered or confusing
errors, please check this section.
diff --git a/offlineimap/head/offlineimap/version.py b/offlineimap/head/offlineimap/version.py
index 14317e5..b559cd4 100644
--- a/offlineimap/head/offlineimap/version.py
+++ b/offlineimap/head/offlineimap/version.py
@@ -1,8 +1,8 @@
productname = 'OfflineIMAP'
-versionstr = "3.2.4"
-revno = long('$Rev: 225 $'[6:-2])
+versionstr = "3.2.5"
+revno = long('$Rev: 234 $'[6:-2])
revstr = "Rev %d" % revno
-datestr = '$Date: 2002-08-08 15:58:14 -0500 (Thu, 08 Aug 2002) $'
+datestr = '$Date: 2002-08-09 15:52:09 -0500 (Fri, 09 Aug 2002) $'
versionlist = versionstr.split(".")