diff --git a/offlineimap/head/debian/changelog b/offlineimap/head/debian/changelog index 686af07..ac0e0c8 100644 --- a/offlineimap/head/debian/changelog +++ b/offlineimap/head/debian/changelog @@ -3,6 +3,7 @@ offlineimap (3.0.4) unstable; urgency=low * When uploading messages from a Maildir, now convert \r\n to \n in case the message is stored weirdly. That way, everything is uniform. Fixes [complete.org #11]. + * Manual: added UW IMAPD example with references from docwhat@gerf.org. -- John Goerzen Sun, 21 Jul 2002 16:09:42 -0500 diff --git a/offlineimap/head/manual.html b/offlineimap/head/manual.html index 1b22163..0fc5579 100644 --- a/offlineimap/head/manual.html +++ b/offlineimap/head/manual.html @@ -25,7 +25,7 @@
- +

NAME

That's it! + + + +
+UW-IMAPD AND REFERENCES
+ + + +
+Some users with a UW-IMAPD server need to use +OfflineIMAP's "reference" feature to get at +their mailboxes, specifying a reference of +"~/Mail" or "#mh/" depending on the +configuration. The below configuration from docwhat@gerf.org +shows using a reference of Mail, a nametrans that strips the +leading Mail/ off incoming folder names, and a folderfilter +that limits the folders synced to just three.
+ + + +
+[Gerf]
+localfolders = ~/Mail
+remotehost = gerf.org
+ssl = yes
+remoteuser = docwhat
+reference = Mail
+# Trims off the preceeding Mail on all the folder names.
+nametrans = lambda foldername: \
+re.sub('^Mail/', '', foldername)
+# Yeah, you have to mention the Mail dir, even though it
+# would seem intuitive that reference would trim it.
+folderfilter = lambda foldername: foldername in [
+'Mail/INBOX',
+'Mail/list/zaurus-general',
+'Mail/list/zaurus-dev',
+]
+maxconnections = 1
+holdconnectionopen = no

ERRORS

@@ -923,7 +965,9 @@ offlineimap@complete.org. Reports of bugs should be sent via e-mail to the OfflineIMAP bug-tracking system (BTS) at offlineimap@bugs.complete.org or submitted on-line using the -Web interface at http://bugs.complete.org/. +Web interface at http://bugs.complete.org/. The Web site +also lists all current bugs, where you can check their +status or contribute to fixing them.

COPYRIGHT

diff --git a/offlineimap/head/manual.pdf b/offlineimap/head/manual.pdf index fe34cb3..40c06fb 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 ead6bf0..f227be8 100644 --- a/offlineimap/head/manual.ps +++ b/offlineimap/head/manual.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.17.2 -%%CreationDate: Sun Jul 21 15:46:14 2002 +%%CreationDate: Sun Jul 21 19:55:24 2002 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic @@ -452,288 +452,318 @@ E F0(Add these lines to your)108 350.4 Q F2(~/.muttr)2.5 E(c:)-.37 E F1 (email@w)-.18 E(ork.com")-.1 E(set mbox_type=Maildir)108 398.4 Q(set f) 108 410.4 Q(older=$HOME/Mail)-.25 E(set spool\214le=+P)108 422.4 Q (ersonal/INBO)-.2 E(X)-.4 E F0(That')108 439.2 Q 2.5(si)-.55 G(t!)-2.5 E -F3(ERR)72 456 Q(ORS)-.329 E F0(If you get one of some frequently-encoun\ -tered or confusing errors, please check this section.)108 468 Q F1 -(UID v)87 484.8 Q(alidity pr)-.1 E(oblem f)-.18 E(or f)-.25 E(older)-.25 -E F0 1.637(IMAP serv)108 496.8 R 1.637 -(ers use a unique ID \(UID\) to refer to a speci\214c message.)-.15 F -1.638(This number is guaranteed to be)6.637 F 1.11 -(unique to a particular message FOREVER.)108 508.8 R 1.109 -(No other message in the same folder will e)6.11 F -.15(ve)-.25 G 3.609 -(rg).15 G 1.109(et the same)-3.609 F 2.873(UID. UIDs)108 520.8 R .373 -(are an inte)2.873 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 532.8 Q(er)-.15 E(.) --.55 E .108(Sometimes, the UIDs on the serv)108 549.6 R .108 -(er might get reset.)-.15 F .108 -(Usually this will happen if you delete and then recreate)5.108 F 3.742 -(af)108 561.6 S(older)-3.742 E 6.242(.W)-.55 G 1.242 -(hen you create a folder)-6.242 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.243 E F1 -(Of\215ineIMAP)3.743 E F0 .303(might still ha)108 573.6 R .603 -.15 -(ve t)-.2 H .303(he UIDs from the pre).15 F .302 -(vious folder by the same name stored.)-.25 F F1(Of\215ineIMAP)5.302 E -F0 .302(will detect this)2.802 F(condition and skip the folder)108 585.6 -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 602.4 S 2.826(uc)1.1 G .326 -(an \214x it by remo)-2.826 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.827 E -(old-)-1.05 E(er)108 614.4 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 631.2 Q(olders/INBO)-.25 E(X)-.4 E -(rm ~/.of\215ineimap/AccountName/INBO)108 643.2 Q(X)-.4 E F0 -(\(replacing AccountName with the account name as speci\214ed in)108 660 -Q F2(~/.of)2.5 E(\215ineimapr)-.18 E(c\))-.37 E F0(Ne)108 676.8 Q .802 -(xt time you run)-.15 F F1(Of\215ineIMAP)3.302 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.301(IDs. Note)-3.302 F .801(that the proce-)3.301 F -(dure speci\214ed abo)108 688.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 .522 -(Some IMAP serv)108 705.6 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 .067 -(your folders e)108 717.6 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 .066(alls into this cat-)-.1 F -.15(eg)108 729.6 S(ory).15 E(.) --.65 E F1(Of\215ineIMAP)5.983 E F0 .984(is incompatible with such serv) -3.483 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(John Goerzen)72 768 Q +F1(UW)87 456 Q(-IMAPD AND REFERENCES)-.37 E F0 .493 +(Some users with a UW)108 468 R .493(-IMAPD serv)-.65 F .493 +(er need to use)-.15 F F1(Of\215ineIMAP')2.993 E(s)-.37 E F0 .493 +("reference" feature to get at their mail-)2.993 F(box)108 480 Q .46(es\ +, specifying a reference of "~/Mail" or "#mh/" depending on the con\214\ +guration.)-.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 492 R 2.965(gs)-.18 G(ho)-2.965 E +.465(ws using a reference of Mail, a nametrans that strips the leading \ +Mail/ of)-.25 F(f)-.25 E(incoming folder names, and a folder\214lter th\ +at limits the folders synced to just three.)108 504 Q F1([Gerf])108 +520.8 Q(localf)108 532.8 Q(olders = ~/Mail)-.25 E -.18(re)108 544.8 S +(motehost = gerf).18 E(.or)-.15 E(g)-.1 E(ssl = y)108 556.8 Q(es)-.1 E +-.18(re)108 568.8 S(moteuser = docwhat).18 E -.18(re)108 580.8 S(fer).18 +E(ence = Mail)-.18 E 2.5(#T)108 592.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 604.8 Q(older)-.25 E(name: \\)-.15 E -.18(re) +138 616.8 S(.sub\('^Mail/', ').18 E(', f)-.63 E(older)-.25 E(name\))-.15 +E 2.5(#Y)108 628.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 640.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 652.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 664.8 Q(X',)-.4 E +('Mail/list/zaurus-general',)125.5 676.8 Q('Mail/list/zaurus-de)125.5 +688.8 Q(v',)-.15 E(])125.5 700.8 Q(maxconnections = 1)108 712.8 Q +(holdconnectionopen = no)108 724.8 Q F0(John Goerzen)72 768 Q (July 12, 2002)151.655 E(3)201.915 E EP %%Page: 4 4 %%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(an)108 84 Q 2.77 -(ym)-.15 G .27(ail, b)-2.77 F .27 +(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10.95 +/Times-Bold@0 SF(ERR)72 84 Q(ORS)-.329 E F0(If you get one of some freq\ +uently-encountered or confusing errors, please check this section.)108 +96 Q/F2 10/Times-Bold@0 SF(UID v)87 112.8 Q(alidity pr)-.1 E(oblem f) +-.18 E(or f)-.25 E(older)-.25 E F0 1.638(IMAP serv)108 124.8 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 136.8 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 148.8 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 160.8 Q(er)-.15 E(.) +-.55 E .107(Sometimes, the UIDs on the serv)108 177.6 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 189.6 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 F2 +(Of\215ineIMAP)3.742 E F0 .302(might still ha)108 201.6 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 F2(Of\215ineIMAP)5.303 E +F0 .303(will detect this)2.803 F(condition and skip the folder)108 213.6 +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 230.4 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 242.4 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 F2(rm -r ~/F)108 259.2 Q(olders/INBO)-.25 E(X)-.4 E +(rm ~/.of\215ineimap/AccountName/INBO)108 271.2 Q(X)-.4 E F0 +(\(replacing AccountName with the account name as speci\214ed in)108 288 +Q F3(~/.of)2.5 E(\215ineimapr)-.18 E(c\))-.37 E F0(Ne)108 304.8 Q .801 +(xt time you run)-.15 F F2(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 316.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 333.6 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 345.6 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 357.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 369.6 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.269(.\()-.55 G(Of)-5.269 E .269(\215ineIMAP will detect this con-)-.25 -F(dition and abort prior to synchronization\))108 96 Q/F1 10.95 -/Times-Bold@0 SF -.438(OT)72 124.8 S(HER FREQ).438 E(UENTL)-.11 E 2.738 -(YA)-1.007 G(SKED Q)-2.738 E(UESTIONS)-.11 E F0 .683 -(There are some other F)108 136.8 R -.55(AQ)-.74 G 3.184(st).55 G .684 +5.27(.\()-.55 G(Of)-5.27 E .27(\215ineIMAP will detect this con-)-.25 F +(dition and abort prior to synchronization\))108 381.6 Q F1 -.438(OT)72 +410.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 422.4 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.184(ya)-.15 G .684(re enumer)-3.184 F(-)-.2 E(ated here.)108 -148.8 Q/F2 10/Times-Bold@0 SF(What platf)108 165.6 Q -(orms does Of\215ineIMAP run on?)-.25 E F0(It should run on most platfo\ -rms supported by Python, which are quite a fe)144 177.6 Q -.65(w.)-.25 G -F2 .689(I'm using Mutt. Other IMAP sync pr)108 194.4 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 .688(es . Do I need to)-.1 F -(do that with Of\215ineIMAP?)108 206.4 Q F0(No.)144 218.4 Q F2 +-3.184 F 3.183(ya)-.15 G .683(re enumer)-3.183 F(-)-.2 E(ated here.)108 +434.4 Q F2(What platf)108 451.2 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 463.2 Q -.65(w.)-.25 G F2 .688 +(I'm using Mutt. Other IMAP sync pr)108 480 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 492 Q F0(No.)144 504 Q F2 (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 230.4 S(u')1.1 E +2.27(xtra crutch.)-.15 F -1.1(Yo)144 516 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 247.2 Q 2.5(wd)-.1 G +(se this setting, in f)-2.5 E(act.)-.1 E F2(Ho)108 532.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 259.2 S 3.55(ud)1.1 G 3.55(on)-3.55 G 1.05(ot need to.)-3.55 F +(Yo)144 544.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 -.679(present on the IMAP serv)144 271.2 R .679(er and synchronize them.) --.15 F -1.1(Yo)5.679 G 3.178(uc)1.1 G .678(an use the)-3.178 F F2 -.25 -(fo)3.178 G(lder\214lter).25 E F0(and)3.178 E F2 -.25(fo)3.178 G +.678(present on the IMAP serv)144 556.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 283.2 Q 2.5(yc)-.15 G -(ome in if you lik)-2.5 E(e.)-.1 E F2(Ho)108 300 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 312 Q F2 -.25(fo)2.5 G +olders and rename them as the)144 568.8 Q 2.5(yc)-.15 G +(ome in if you lik)-2.5 E(e.)-.1 E F2(Ho)108 585.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 597.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 328.8 Q 2.5(wc)-.1 G(an I add or delete a f)-2.5 E(older?)-.25 E -(Of\215ineIMAP)144 340.8 Q F0 .503(does not currently pro)3.003 F .504 -(vide this feature, b)-.15 F .504(ut if you create a ne)-.2 F 3.004(wf) --.25 G .504(older on the IMAP)-3.004 F(serv)144 352.8 Q(er)-.15 E 2.5 +(Ho)108 614.4 Q 2.5(wc)-.1 G(an I add or delete a f)-2.5 E(older?)-.25 E +(Of\215ineIMAP)144 626.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 638.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 369.6 Q 2.5(et)-.18 G(her)-2.5 E 2.5(ea)-.18 G +-.65 E F2(Ar)108 655.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 381.6 S(s; see the NO)1 E(TES section belo)-.4 E --.65(w.)-.25 G F2(What is the mailbox name r)108 398.4 Q +(f?)-2.5 E F0 -1(Ye)144 667.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 684 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 410.4 R(es.)-.15 E(Of)144 422.4 Q .265 -(\215ineIMAP can help it \(or man)-.25 F 2.765(yo)-.15 G .265 +144 696 R(es.)-.15 E(Of)144 708 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 434.4 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 451.2 Q -(onize multiple accounts with Of\215ineIMAP?)-.18 E F0 3.345(Sure. Just) -144 463.2 R .845(name them all in the accounts line in the general sect\ -ion of the con\214g \214le, and add a)3.345 F(per)144 475.2 Q -(-account section for each one.)-.2 E F2 -(Does Of\215ineIMAP support POP?)108 492 Q F0 4.076(No. POP)144 504 R -1.576(is not rob)4.076 F 1.576(ust enough to do a completely reliable m\ -ulti-machine synchronization lik)-.2 F(e)-.1 E(Of)144 516 Q -(\215ineIMAP can do.)-.25 E(Of)5 E(\215ineIMAP will not support it.)-.25 -E F2(Do y)108 532.8 Q(ou support mailbox f)-.25 E -(ormats other than Maildir?)-.25 E F0 .41(Not at present.)144 544.8 R -.41(There is no technical reason not to; just no demand yet.)5.41 F .409 -(Maildir is a superior for)5.409 F(-)-.2 E(mat an)144 556.8 Q(yw)-.15 E -(ay)-.1 E(.)-.65 E F2([technical] Wh)108 573.6 Q 2.5(ya)-.15 G .36 -.18 -(re y)-2.5 H(our Maildir message \214lenames so huge?)-.07 E -(Of\215ineIMAP)144 585.6 Q F0 .958(has tw)3.458 F 3.458(or)-.1 G(ele) --3.458 E -.25(va)-.25 G .958(nt principles: 1\) ne).25 F -.15(ve)-.25 G -3.459(rm).15 G .959(odifying your messages in an)-3.459 F 3.459(yw)-.15 -G .959(ay and 2\))-3.559 F .493 -(ensuring 100% reliable synchronizations.)144 597.6 R .493 -(In order to do a reliable sync,)5.493 F F2(Of\215ineIMAP)2.993 E F0 -.493(must ha)2.993 F -.15(ve)-.2 G 3.094(aw)144 609.6 S .594 -(ay to uniquely identify each e-mail.)-3.194 F .595 -(Three pieces of information are required to do this: your)5.594 F .538 -(account name, the folder name, and the message UID.)144 621.6 R .537 -(The account name can be calculated from)5.537 F 1.081 -(the path in which your messages are.)144 633.6 R 1.082 -(The folder name can usually be as well, B)6.082 F 1.082(UT some mail) --.1 F(clients mo)144 645.6 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 662.4 Q F2(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 F2(Of\215ineIMAP)3.2 E F0 .455 -(can detect a message mo)144 674.4 R -.15(ve)-.15 G 2.955(dt).15 G 2.955 -(oad)-2.955 G(if)-2.955 E .455(ferent folder)-.25 F(.)-.55 E F2 -(Of\215ineIMAP)5.455 E F0 .456(stores the UID \(U= number\) and)2.955 F -(an md5sum of the foldername \(FMD5= number\) to f)144 686.4 Q -(acilitate this.)-.1 E F2(What is the speed of Of\215ineIMAP')108 703.2 -Q 2.5(ss)-.37 G(ync?)-2.5 E(Of\215ineIMAP)144 715.2 Q F0 -.15(ve)2.891 G -.391(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 .39(ood w)-2.891 -F .39(ay to e)-.1 F(xperiment)-.15 E(is by setting maxsyncaccounts to 3\ - and maxconnections to 3 in each account clause.)144 727.2 Q -(John Goerzen)72 768 Q(July 12, 2002)151.655 E(4)201.915 E EP +(specify)144 720 Q 5(.S)-.65 G(ee the e)-5 E(xample of)-.15 E +(\215ineimap.conf \214le for details.)-.25 E(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 .381(This lets Of) -144 84 R .381(\215ineIMAP open up multiple connections simultaneously) --.25 F 5.382(.T)-.65 G .382(hat will let it process mul-)-5.382 F -(tiple folders and messages at once.)144 96 Q +(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10/Times-Bold@0 +SF(Can I synchr)108 84 Q(onize multiple accounts with Of\215ineIMAP?) +-.18 E F0 3.344(Sure. Just)144 96 R .845(name them all in the accounts \ +line in the general section of the con\214g \214le, and add a)3.344 F +(per)144 108 Q(-account section for each one.)-.2 E F1 +(Does Of\215ineIMAP support POP?)108 124.8 Q F0 4.077(No. POP)144 136.8 +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 148.8 Q +(\215ineIMAP can do.)-.25 E(Of)5 E(\215ineIMAP will not support it.)-.25 +E F1(Do y)108 165.6 Q(ou support mailbox f)-.25 E +(ormats other than Maildir?)-.25 E F0 .409(Not at present.)144 177.6 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 189.6 Q(yw)-.15 +E(ay)-.1 E(.)-.65 E F1([technical] Wh)108 206.4 Q 2.5(ya)-.15 G .36 -.18 +(re y)-2.5 H(our Maildir message \214lenames so huge?)-.07 E +(Of\215ineIMAP)144 218.4 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 230.4 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 242.4 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 254.4 R .538 +(The account name can be calculated from)5.537 F 1.082 +(the path in which your messages are.)144 266.4 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 278.4 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 295.2 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 307.2 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 319.2 Q +(acilitate this.)-.1 E F1(What is the speed of Of\215ineIMAP')108 336 Q +2.5(ss)-.37 G(ync?)-2.5 E(Of\215ineIMAP)144 348 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 360 Q .382 +(This lets Of)144 376.8 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 388.8 Q (In most cases, this will increase performance of the sync.)5 E(Don')144 -112.8 Q 3.104(ts)-.18 G .604(et the number too high.)-3.104 F .603 -(If you do that, things might actually slo)5.604 F 3.103(wd)-.25 G -.25 -(ow)-3.103 G 3.103(na).25 G 3.103(sy)-3.103 G .603(our link gets)-3.103 -F 2.632(saturated. Also,)144 124.8 R .132(too man)2.632 F 2.632(yc)-.15 -G .132(onnections can cause mail serv)-2.632 F .132(ers to ha)-.15 F -.433 -.15(ve ex)-.2 H(cessi).15 E .433 -.15(ve l)-.25 H 2.633 -(oad. Administra-).15 F .507(tors might tak)144 136.8 R 3.007(eu)-.1 G -.507(nkindly to this, and the serv)-3.007 F .506(er might bog do)-.15 F -3.006(wn. There)-.25 F .506(are man)3.006 F 3.006(yv)-.15 G .506 -(ariables in the)-3.256 F(optimal setting; e)144 148.8 Q +405.6 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 417.6 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 429.6 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 441.6 Q (xperimentation may help.)-.15 E -(An informal benchmark yields these results for my setup:)144 165.6 Q -(10 minutes with MacOS X Mail.app "manual cache")144 182.4 Q 2.5(5m)144 -194.4 S(inutes with GNUS agent sync)-2.5 E(20 seconds with Of)144 206.4 -Q(\215ineIMAP 1.x)-.25 E 2.5(9s)144 218.4 S(econds with Of)-2.5 E -(\215ineIMAP 2.x)-.25 E 2.5(3s)144 230.4 S(econds with Of)-2.5 E -(\215ineIMAP 3.x "cold start")-.25 E 2.5(2s)144 242.4 S(econds with Of) --2.5 E(\215ineIMAP 3.x "held connection")-.25 E/F1 10.95/Times-Bold@0 SF -(CONFORMING T)72 259.2 Q(O)-.197 E F0 32.5<8349>108 271.2 S +(An informal benchmark yields these results for my setup:)144 458.4 Q +(10 minutes with MacOS X Mail.app "manual cache")144 475.2 Q 2.5(5m)144 +487.2 S(inutes with GNUS agent sync)-2.5 E(20 seconds with Of)144 499.2 +Q(\215ineIMAP 1.x)-.25 E 2.5(9s)144 511.2 S(econds with Of)-2.5 E +(\215ineIMAP 2.x)-.25 E 2.5(3s)144 523.2 S(econds with Of)-2.5 E +(\215ineIMAP 3.x "cold start")-.25 E 2.5(2s)144 535.2 S(econds with Of) +-2.5 E(\215ineIMAP 3.x "held connection")-.25 E/F2 10.95/Times-Bold@0 SF +(CONFORMING T)72 552 Q(O)-.197 E F0 32.5<8349>108 564 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 288 S 8.92(aildir as speci\214ed in http://www)-32.5 F(.qmail.or) +108 580.8 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 300 Q(.yp.to/proto/maildir)-.55 E(.html.)-.55 E 32.5 -<8353>108 316.8 S +(http://cr)144 592.8 Q(.yp.to/proto/maildir)-.55 E(.html.)-.55 E 32.5 +<8353>108 609.6 S (tandard Python 2.2.1 as implemented on POSIX-compliant systems.)-32.5 E -F1(NO)72 333.6 Q(TES)-.438 E/F2 10/Times-Bold@0 SF -(DELETING LOCAL FOLDERS)87 345.6 Q(Of\215ineIMAP)108 357.6 Q F0 .533 -(does a tw)3.033 F(o-w)-.1 E .533(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.032(,i)-.4 G(t) --3.032 E .896(will be propog)108 369.6 R .896(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 .897(people might think that it w)3.397 F .897(ould be wise to)-.1 F -1.59(just delete all their local mail folders periodically)108 381.6 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 393.6 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 .416(intentional deletion of man)108 405.6 R 2.916(ym)-.15 G -.416(essages and will interpret your action as requesting them to be de\ -leted from)-2.916 F(the serv)108 417.6 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 434.4 Q -(GES BETWEEN FOLDERS)-.55 E F0(Normally)108 446.4 Q 5.858(,w)-.65 G -3.358(hen you cop)-5.858 F -8.357 5.858(ya m)-.1 H 3.359 -(essage between folders or add a ne)-5.858 F 5.859(wm)-.25 G 3.359 -(essage to a folder locally)-5.859 F(,)-.65 E F2(Of\215ineIMAP)108 458.4 -Q F0 .853(will just do the right thing.)3.353 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 470.4 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 .174 -(mine the ne)108 482.4 R 2.674(wU)-.25 G .174(ID of the message.)-2.674 -F .173(So, in these rare instances, Of)5.173 F .173 -(\215ineIMAP will upload the message to the)-.25 F .64(IMAP serv)108 -494.4 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.473(loaded with the proper UID.)108 506.4 R F2 -(Of\215ineIMAP)6.473 E F0(mak)3.973 E 1.473(es sure that the message w) --.1 F 1.472(as properly uploaded before)-.1 F -(deleting it, so there should be no risk of data loss.)108 518.4 Q F2 -(MAILING LIST)87 535.2 Q F0(There is an Of)108 547.2 Q -(\215ineIMAP mailing list a)-.25 E -.25(va)-.2 G(ilable.).25 E 2.447 -.8 -(To s)108 564 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.348(g. T)-.18 F(o)-.8 E -(post, send the message to of)108 576 Q(\215ineimap@complete.or)-.25 E -(g.)-.18 E F1 -.11(BU)72 592.8 S(GS).11 E F0 4.42(Reports of b)108 604.8 -R 4.419(ugs should be sent via e-mail to the)-.2 F F2(Of\215ineIMAP) -6.919 E F0 -.2(bu)6.919 G 4.419(g-tracking system \(BTS\) at).2 F(of)108 -616.8 Q(\215ineimap@b)-.25 E(ugs.complete.or)-.2 E 2.5(go)-.18 G 2.5(rs) --2.5 G(ubmitted on-line using the W)-2.5 E(eb interf)-.8 E -(ace at http://b)-.1 E(ugs.complete.or)-.2 E(g/.)-.18 E F1(COPYRIGHT)72 -633.6 Q F0(Of)108 645.6 Q(\215ineIMAP is Cop)-.25 E -(yright \(C\) 2002 John Goerzen.)-.1 E .286(This program is free softw) -108 662.4 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 674.4 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 686.4 Q -2.5(yl)-.15 G(ater v)-2.5 E(ersion.)-.15 E .579(This program is distrib) -108 703.2 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 715.2 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 727.2 Q -(John Goerzen)72 768 Q(July 12, 2002)151.655 E(5)201.915 E EP +F2(NO)72 626.4 Q(TES)-.438 E F1(DELETING LOCAL FOLDERS)87 638.4 Q +(Of\215ineIMAP)108 650.4 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 662.4 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 674.4 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 686.4 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 698.4 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 710.4 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(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 -1.1(Yo)108 84 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 +(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10/Times-Bold@0 +SF(COPYING MESSA)87 84 Q(GES BETWEEN FOLDERS)-.55 E F0(Normally)108 96 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 108 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 120 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 132 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 144 +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 156 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 168 Q F1 +(MAILING LIST)87 184.8 Q F0(There is an Of)108 196.8 Q +(\215ineIMAP mailing list a)-.25 E -.25(va)-.2 G(ilable.).25 E 2.448 -.8 +(To s)108 213.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 225.6 Q(\215ineimap@complete.or)-.25 E +(g.)-.18 E/F2 10.95/Times-Bold@0 SF -.11(BU)72 242.4 S(GS).11 E F0 4.419 +(Reports of b)108 254.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 266.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 278.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 F2(COPYRIGHT)72 295.2 Q F0(Of)108 307.2 Q +(\215ineIMAP is Cop)-.25 E(yright \(C\) 2002 John Goerzen.)-.1 E .286 +(This program is free softw)108 324 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 336 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 348 Q 2.5 +(yl)-.15 G(ater v)-2.5 E(ersion.)-.15 E .579(This program is distrib)108 +364.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 376.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 388.8 Q -1.1(Yo) +108 405.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 96 Q(Free Softw)108 112.8 Q(are F)-.1 E(oundation, Inc.) --.15 E(59 T)108 124.8 Q(emple Place)-.7 E(Suite 330)108 136.8 Q -(Boston, MA)108 148.8 Q(02111-1307)5 E(USA)108 160.8 Q/F1 10.95 -/Times-Bold@0 SF -.548(AU)72 177.6 S(THOR).548 E/F2 10/Times-Bold@0 SF -(Of\215ineIMAP)108 189.6 Q(,)-.92 E F0 .488 +-2.77 F(to:)108 417.6 Q(Free Softw)108 434.4 Q(are F)-.1 E +(oundation, Inc.)-.15 E(59 T)108 446.4 Q(emple Place)-.7 E(Suite 330)108 +458.4 Q(Boston, MA)108 470.4 Q(02111-1307)5 E(USA)108 482.4 Q F2 -.548 +(AU)72 499.2 S(THOR).548 E F1(Of\215ineIMAP)108 511.2 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 218.4 Q +(Goerzen and cop)-.18 E +(yright is held as stated in the COPYRIGHT section.)-.1 E(Of)108 540 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 235.2 Q + homepage via either Gopher or HTTP:)-.25 E(gopher://quux.or)108 556.8 Q (g/1/de)-.18 E -.15(ve)-.25 G(l/of).15 E(\215ineimap)-.25 E -(http://quux.or)108 247.2 Q(g/de)-.18 E -.15(ve)-.25 G(l/of).15 E -(\215ineimap)-.25 E(Of)108 264 Q 2.528(\215ineIMAP may also be do)-.25 F -2.528(wnloaded using Sub)-.25 F -.15(ve)-.15 G 5.028 +(http://quux.or)108 568.8 Q(g/de)-.18 E -.15(ve)-.25 G(l/of).15 E +(\215ineimap)-.25 E(Of)108 585.6 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 276 -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 288 Q -.15(ve)-.15 G -(rsion, please visit:).15 E(http://svn.complete.or)108 304.8 Q(g/)-.18 E -F1(SEE ALSO)72 321.6 Q F2(mutt)108 333.6 Q F0(\(1\),)A F2(python)2.5 E +(updated with a simple "svn update" command; it is ready to go.)108 +597.6 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 609.6 Q -.15(ve)-.15 G +(rsion, please visit:).15 E(http://svn.complete.or)108 626.4 Q(g/)-.18 E +F2(SEE ALSO)72 643.2 Q F1(mutt)108 655.2 Q F0(\(1\),)A F1(python)2.5 E F0(\(1\).)A(John Goerzen)72 768 Q(July 12, 2002)151.655 E(6)201.915 E EP %%Trailer end diff --git a/offlineimap/head/manual.txt b/offlineimap/head/manual.txt index 0c61c5b..22d71cc 100644 --- a/offlineimap/head/manual.txt +++ b/offlineimap/head/manual.txt @@ -223,54 +223,83 @@ EXAMPLES That's it! + UW-IMAPD AND REFERENCES + Some users with a UW-IMAPD server need to use + OfflineIMAP's "reference" feature to get at their mail- + boxes, specifying a reference of "~/Mail" or "#mh/" + depending on the configuration. The below configuration + from docwhat@gerf.org shows using a reference of Mail, a + nametrans that strips the leading Mail/ off incoming + folder names, and a folderfilter that limits the folders + synced to just three. + + [Gerf] + localfolders = ~/Mail + remotehost = gerf.org + ssl = yes + remoteuser = docwhat + reference = Mail + # Trims off the preceeding Mail on all the folder names. + nametrans = lambda foldername: \ + re.sub('^Mail/', '', foldername) + # Yeah, you have to mention the Mail dir, even though it + # would seem intuitive that reference would trim it. + folderfilter = lambda foldername: foldername in [ + 'Mail/INBOX', + 'Mail/list/zaurus-general', + 'Mail/list/zaurus-dev', + ] + maxconnections = 1 + holdconnectionopen = no + ERRORS If you get one of some frequently-encountered or confusing errors, please check this section. UID validity problem for folder - IMAP servers use a unique ID (UID) to refer to a specific + IMAP servers use a unique ID (UID) to refer to a specific message. This number is guaranteed to be unique to a par- - ticular message FOREVER. No other message in the same - folder will ever get the same UID. UIDs are an integral - part of OfflineIMAP's synchronization scheme; they are - used to match up messages on your computer to messages on + ticular message FOREVER. No other message in the same + folder will ever get the same UID. UIDs are an integral + part of OfflineIMAP's synchronization scheme; they are + used to match up messages on your computer to messages on the server. - Sometimes, the UIDs on the server might get reset. Usu- - ally this will happen if you delete and then recreate a - folder. When you create a folder, the server will often - start the UID back from 1. But OfflineIMAP might still - have the UIDs from the previous folder by the same name - stored. OfflineIMAP will detect this condition and skip - the folder. This is GOOD, because it prevents data loss. + Sometimes, the UIDs on the server might get reset. Usu- + ally this will happen if you delete and then recreate a + folder. When you create a folder, the server will often + start the UID back from 1. But OfflineIMAP might still + have the UIDs from the previous folder by the same name + stored. OfflineIMAP will detect this condition and skip + the folder. This is GOOD, because it prevents data loss. - You can fix it by removing your local folder and cache - data. For instance, if your folders are under ~/Folders + You can fix it by removing your local folder and cache + data. For instance, if your folders are under ~/Folders and the folder with the problem is INBOX, you'd type this: rm -r ~/Folders/INBOX rm ~/.offlineimap/AccountName/INBOX - (replacing AccountName with the account name as specified + (replacing AccountName with the account name as specified in ~/.offlineimaprc) - Next time you run OfflineIMAP, it will re-download the - folder with the new UIDs. Note that the procedure speci- + Next time you run OfflineIMAP, it will re-download the + folder with the new UIDs. Note that the procedure speci- fied above will lose any local changes made to the folder. Some IMAP servers are broken and do not support UIDs prop- - erly. If you continue to get this error for all your - folders even after performing the above procedure, it is - likely that your IMAP server falls into this category. - OfflineIMAP is incompatible with such servers. Using - OfflineIMAP with them will not destroy any mail, but at + erly. If you continue to get this error for all your + folders even after performing the above procedure, it is + likely that your IMAP server falls into this category. + OfflineIMAP is incompatible with such servers. Using + OfflineIMAP with them will not destroy any mail, but at the same time, it will not actually synchronize it either. (OfflineIMAP will detect this condition and abort prior to synchronization) OTHER FREQUENTLY ASKED QUESTIONS - There are some other FAQs that might not fit into another + There are some other FAQs that might not fit into another section of this document, and they are enumerated here. What platforms does OfflineIMAP run on? @@ -281,96 +310,96 @@ OTHER FREQUENTLY ASKED QUESTIONS set maildir_trash=yes . Do I need to do that with OfflineIMAP? No. OfflineIMAP is smart enough to figure out mes- - sage deletion without this extra crutch. You'll + sage deletion without this extra crutch. You'll get the best results if you don't use this setting, in fact. How do I specify the names of my folders? You do not need to. OfflineIMAP is smart enough to - automatically figure out what folders are present - on the IMAP server and synchronize them. You can - use the folderfilter and foldertrans configuration - file options to request certain folders and rename + automatically figure out what folders are present + on the IMAP server and synchronize them. You can + use the folderfilter and foldertrans configuration + file options to request certain folders and rename them as they come in if you like. How can I prevent certain folders from being synced? - Use the folderfilter option in the configuration + Use the folderfilter option in the configuration file. How can I add or delete a folder? - OfflineIMAP does not currently provide this fea- - ture, but if you create a new folder on the IMAP + OfflineIMAP does not currently provide this + feature, but if you create a new folder on the IMAP server, it will be created locally automatically. Are there any other warnings that I should be aware of? Yes; see the NOTES section below. What is the mailbox name recorder (mbnames) for? - The Mutt mail reader is not capable of automati- - cally determining the names of your mailboxes. - OfflineIMAP can help it (or many other) programs - out be writing these names out in a format you + The Mutt mail reader is not capable of automati- + cally determining the names of your mailboxes. + OfflineIMAP can help it (or many other) programs + out be writing these names out in a format you specify. See the example offlineimap.conf file for details. Can I synchronize multiple accounts with OfflineIMAP? - Sure. Just name them all in the accounts line in - the general section of the config file, and add a + Sure. Just name them all in the accounts line in + the general section of the config file, and add a per-account section for each one. Does OfflineIMAP support POP? - No. POP is not robust enough to do a completely - reliable multi-machine synchronization like - OfflineIMAP can do. OfflineIMAP will not support + No. POP is not robust enough to do a completely + reliable multi-machine synchronization like + OfflineIMAP can do. OfflineIMAP will not support it. Do you support mailbox formats other than Maildir? - Not at present. There is no technical reason not + Not at present. There is no technical reason not to; just no demand yet. Maildir is a superior for- mat anyway. - [technical] Why are your Maildir message filenames so + [technical] Why are your Maildir message filenames so huge? - OfflineIMAP has two relevant principles: 1) never - modifying your messages in any way and 2) ensuring - 100% reliable synchronizations. In order to do a - reliable sync, OfflineIMAP must have a way to - uniquely identify each e-mail. Three pieces of - information are required to do this: your account - name, the folder name, and the message UID. The - account name can be calculated from the path in - which your messages are. The folder name can usu- - ally be as well, BUT some mail clients move mes- - sages between folders by simply moving the file, + OfflineIMAP has two relevant principles: 1) never + modifying your messages in any way and 2) ensuring + 100% reliable synchronizations. In order to do a + reliable sync, OfflineIMAP must have a way to + uniquely identify each e-mail. Three pieces of + information are required to do this: your account + name, the folder name, and the message UID. The + account name can be calculated from the path in + which your messages are. The folder name can usu- + ally be as well, BUT some mail clients move mes- + sages between folders by simply moving the file, leaving the name intact. - So, OfflineIMAP must store both a UID folder ID. - The folder ID is necessary so OfflineIMAP can - detect a message moved to a different folder. - OfflineIMAP stores the UID (U= number) and an - md5sum of the foldername (FMD5= number) to facili- + So, OfflineIMAP must store both a UID folder ID. + The folder ID is necessary so OfflineIMAP can + detect a message moved to a different folder. + OfflineIMAP stores the UID (U= number) and an + md5sum of the foldername (FMD5= number) to facili- tate this. What is the speed of OfflineIMAP's sync? OfflineIMAP versions 2.0 and above contain a multi- - threaded system. A good way to experiment is by - setting maxsyncaccounts to 3 and maxconnections to + threaded 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 + 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. Administra- - tors might take unkindly to this, and the server - might bog down. There are many variables in the + 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. Administra- + tors 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 + An informal benchmark yields these results for my setup: 10 minutes with MacOS X Mail.app "manual cache" @@ -388,19 +417,19 @@ CONFORMING TO manual-html/man5/maildir.html and http://cr.yp.to/proto/maildir.html. - o Standard Python 2.2.1 as implemented on POSIX-com- + o Standard Python 2.2.1 as implemented on POSIX-com- pliant systems. NOTES DELETING LOCAL FOLDERS - OfflineIMAP does a two-way synchronization. That is, if - you make a change to the mail on the server, it will be - propogated to your local copy, and vise-versa. Some peo- - ple might think that it would be wise to just delete all - their local mail folders periodically. If you do this - with OfflineIMAP, remember to also remove your local sta- - tus cache (~/.offlineimap by default). Otherwise, - OfflineIMAP will take this as an intentional deletion of + OfflineIMAP does a two-way synchronization. That is, if + you make a change to the mail on the server, it will be + propogated to your local copy, and vise-versa. Some peo- + ple might think that it would be wise to just delete all + their local mail folders periodically. If you do this + with OfflineIMAP, remember to also remove your local sta- + tus cache (~/.offlineimap by default). Otherwise, + OfflineIMAP will take this as an intentional deletion of many messages and will interpret your action as requesting them to be deleted from the server as well. (If you don't understand this, don't worry; you probably won't encounter @@ -408,47 +437,49 @@ NOTES COPYING MESSAGES BETWEEN FOLDERS Normally, when you copy a message between folders or add a - new message to a folder locally, OfflineIMAP will just do + new message to a folder locally, OfflineIMAP will just do the right thing. However, sometimes this can be tricky -- - if your IMAP server does not provide the SEARCH command, - or does not return something useful, OfflineIMAP cannot - determine the new UID of the message. So, in these rare + if your IMAP server does not provide the SEARCH command, + or does not return something useful, OfflineIMAP cannot + determine the new UID of the message. So, in these rare instances, OfflineIMAP will upload the message to the IMAP - server and delete it from your local folder. Then, on + server and delete it from your local folder. Then, on your next sync, the message will be re-downloaded with the - proper UID. OfflineIMAP makes sure that the message was - properly uploaded before deleting it, so there should be + proper UID. OfflineIMAP makes sure that the message was + properly uploaded before deleting it, so there should be no risk of data loss. MAILING LIST There is an OfflineIMAP mailing list available. - To subscribe, send the text "Subscribe" in the subject of + To subscribe, send the text "Subscribe" in the subject of a mail to offlineimap-request@complete.org. To post, send the message to offlineimap@complete.org. BUGS - Reports of bugs should be sent via e-mail to the - OfflineIMAP bug-tracking system (BTS) at - offlineimap@bugs.complete.org or submitted on-line using - the Web interface at http://bugs.complete.org/. + Reports of bugs should be sent via e-mail to the + OfflineIMAP bug-tracking system (BTS) at + offlineimap@bugs.complete.org or submitted on-line using + the Web interface at http://bugs.complete.org/. The Web + site also lists all current bugs, where you can check + their status or contribute to fixing them. COPYRIGHT OfflineIMAP is Copyright (C) 2002 John Goerzen. - This program is free software; you can redistribute it + This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public - License as published by the Free Software Foundation; - either version 2 of the License, or (at your option) any + License as published by the Free Software Foundation; + either version 2 of the License, or (at your option) any later version. - This program is distributed in the hope that it will be + This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied - warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR - PURPOSE. See the GNU General Public License for more + warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + PURPOSE. See the GNU General Public License for more details. - You should have received a copy of the GNU General Public + You should have received a copy of the GNU General Public License along with this program; if not, write to: Free Software Foundation, Inc. @@ -458,9 +489,9 @@ COPYRIGHT USA AUTHOR - OfflineIMAP, its libraries, documentation, and all - included files, except where noted, was written by John - Goerzen and copyright is held as + OfflineIMAP, its libraries, documentation, and all + included files, except where noted, was written by John + Goerzen and copyright is held as stated in the COPYRIGHT section. OfflineIMAP may be downloaded, and information found, from @@ -471,7 +502,7 @@ AUTHOR OfflineIMAP may also be downloaded using Subversion. Additionally, the distributed tar.gz may be updated with a - simple "svn update" command; it is ready to go. For + simple "svn update" command; it is ready to go. For information on getting OfflineIMAP with Subversion, please visit: diff --git a/offlineimap/head/offlineimap.1 b/offlineimap/head/offlineimap.1 index 5925a4c..8d73908 100644 --- a/offlineimap/head/offlineimap.1 +++ b/offlineimap/head/offlineimap.1 @@ -309,6 +309,51 @@ Add these lines to your .B set spoolfile=+Personal/INBOX .PP That's it! +.SS UW-IMAPD AND REFERENCES +Some users with a UW-IMAPD server need to use +.B OfflineIMAP's +"reference" feature to get at their mailboxes, specifying a reference +of "~/Mail" or "#mh/" depending on the configuration. The below +configuration from docwhat@gerf.org +shows using a reference of Mail, a nametrans that strips +the leading Mail/ off incoming folder names, and a folderfilter that +limits the folders synced to just three. +.PP +.B [Gerf] +.br +.B localfolders = ~/Mail +.br +.B remotehost = gerf.org +.br +.B ssl = yes +.br +.B remoteuser = docwhat +.br +.B reference = Mail +.br +.B # Trims off the preceeding Mail on all the folder names. +.br +.B nametrans = lambda foldername: \\\\ +.br +.B " re.sub('^Mail/', '', foldername)" +.br +.B # Yeah, you have to mention the Mail dir, even though it +.br +.B # would seem intuitive that reference would trim it. +.br +.B folderfilter = lambda foldername: foldername in [ +.br +.B " 'Mail/INBOX'," +.br +.B " 'Mail/list/zaurus-general'," +.br +.B " 'Mail/list/zaurus-dev'," +.br +.B " ]" +.br +.B maxconnections = 1 +.br +.B holdconnectionopen = no .SH ERRORS If you get one of some frequently-encountered or confusing errors, please check this section. @@ -532,6 +577,8 @@ or submitted on-line using the Web interface at .UR http://bugs.complete.org/ http://bugs.complete.org/. .UE +The Web site also lists all current bugs, where you can check their +status or contribute to fixing them. .SH COPYRIGHT OfflineIMAP is Copyright (C) 2002 John Goerzen. .PP