diff --git a/offlineimap/head/ChangeLog b/offlineimap/head/ChangeLog index dbedd46..8c1dd40 100644 --- a/offlineimap/head/ChangeLog +++ b/offlineimap/head/ChangeLog @@ -1,3 +1,52 @@ +------------------------------------------------------------------------ +rev 220: jgoerzen | 2002-08-08 10:18:45 -0500 (Thu, 08 Aug 2002) | 2 lines +Changed paths: + U /offlineimap/head/offlineimap/repository/Maildir.py + +Now logs folder names of return value when debugging. + +------------------------------------------------------------------------ +rev 219: jgoerzen | 2002-08-08 10:17:36 -0500 (Thu, 08 Aug 2002) | 2 lines +Changed paths: + U /offlineimap/head/offlineimap/repository/Maildir.py + +Updated debugging + +------------------------------------------------------------------------ +rev 218: jgoerzen | 2002-08-08 10:15:30 -0500 (Thu, 08 Aug 2002) | 2 lines +Changed paths: + U /offlineimap/head/offlineimap/repository/Maildir.py + +Added maildir repository debug code + +------------------------------------------------------------------------ +rev 217: jgoerzen | 2002-08-08 10:03:36 -0500 (Thu, 08 Aug 2002) | 4 lines +Changed paths: + U /offlineimap/head/debian/changelog + U /offlineimap/head/offlineimap/imaplib.py + U /offlineimap/head/offlineimap/repository/Maildir.py + U /offlineimap/head/offlineimap/ui/TTY.py + U /offlineimap/head/offlineimap/ui/UIBase.py + U /offlineimap/head/offlineimap.1 + U /offlineimap/head/offlineimap.py + +-d now takes a parameter to specify what kind of debugging to do. +imaplib now does debugging through the UI system. +UIBase now has a debugging process. + +------------------------------------------------------------------------ +rev 215: jgoerzen | 2002-08-07 20:28:34 -0500 (Wed, 07 Aug 2002) | 2 lines +Changed paths: + U /offlineimap/head/ChangeLog + U /offlineimap/head/debian/changelog + U /offlineimap/head/manual.html + U /offlineimap/head/manual.pdf + U /offlineimap/head/manual.ps + U /offlineimap/head/manual.txt + U /offlineimap/head/offlineimap/version.py + +Readying version 3.2.2. + ------------------------------------------------------------------------ rev 214: jgoerzen | 2002-08-07 17:27:55 -0500 (Wed, 07 Aug 2002) | 2 lines Changed paths: diff --git a/offlineimap/head/manual.html b/offlineimap/head/manual.html index 6c93bba..a55d51f 100644 --- a/offlineimap/head/manual.html +++ b/offlineimap/head/manual.html @@ -26,7 +26,7 @@
- +

NAME

offlineimap [ -1 ] [ -P profiledir ] [ -a accountlist ] [ --c configfile ] [ -d ] [ -o ] [ --u interface ]
+-c configfile ] [ -d +debugtype[,debugtype...] ] [ -o ] [ -u +interface ] @@ -375,20 +376,31 @@ default, ~/.offlineimaprc.
cols="2" cellspacing="0" cellpadding="0"> --d +-d debugtype[,debugtype...]
-Enables IMAP protocol stream and parsing debugging. This is -useful if you are trying to track down a malfunction or -figure out what is going on under the hood. I suggest that -you use this with -1 in order to make the results -more sensible. Note that this output will contain full IMAP -protocol in plain text, including passwords, so take care to -remove that from the debugging output before sending it to -anyone else.
+Enables debugging for OfflineIMAP. This is useful if you are +trying to track down a malfunction or figure out what is +going on under the hood. I suggest that you use this with +-1 in order to make the results more +sensible. + + + +
+-d now requires one or more debugtypes, separated by commas. +These define what exactly will be debugged, and so far +include two options: imap and maildir. The +imap option will enable IMAP protocol stream and +parsing debugging. Note that the output may contain +passwords, so take care to remove that from the debugging +output before sending it to anyone else. The maildir +option will enable debugging for certain Maildir +operations.
diff --git a/offlineimap/head/manual.pdf b/offlineimap/head/manual.pdf index ec53a64..01560b9 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 82c46ce..4192c2d 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: Wed Aug 7 20:26:59 2002 +%%CreationDate: Thu Aug 8 10:19:19 2002 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic @@ -210,111 +210,114 @@ BP (\215ineIMAP \255 Po)-.25 E (werful IMAP/Maildir synchronization and reader support)-.25 E F1 (SYNOPSIS)72 112.8 Q/F2 10/Times-Bold@0 SF(of\215ineimap)108 124.8 Q F0 -([)2.5 E F22.5 E F0 2.5(][)2.5 G F2A/F3 10/Times-Italic@0 SF -(pr)2.5 E(o\214ledir)-.45 E F0 2.5(][)2.5 G F2A F3(accountlist)2.5 -E F0 2.5(][)2.5 G F2A F3(con\214g\214le)2.5 E F0 2.5(][)2.5 G F2 -A F0 2.5(][)2.5 G F2A F0 2.5(][)2.5 G F2A F3 -(interface)2.5 E F0(])2.5 E F2(of\215ineimap \255h)108 148.8 Q F0(|)2.5 -E F2(\255\255help)2.5 E F1(DESCRIPTION)72 165.6 Q F2(Of\215ineIMAP)108 -177.6 Q F0 .019(is a tool to simplify your e-mail reading.)2.519 F -.4 -(Wi)5.019 G(th).4 E F2(Of\215ineIMAP)2.519 E(,)-.92 E F0 .018 -(you can read the same mailbox)2.519 F 1.115(from multiple computers.) -108 189.6 R -1.1(Yo)6.115 G 3.615(ug)1.1 G 1.115(et a current cop)-3.615 -F 3.616(yo)-.1 G 3.616(fy)-3.616 G 1.116(our messages on each computer) --3.616 F 3.616(,a)-.4 G 1.116(nd changes you)-3.616 F(mak)108 201.6 Q -2.915(eo)-.1 G .414(ne place will be visible on all other systems.) --2.915 F -.15(Fo)5.414 G 2.914(ri).15 G .414 +([)2.699 E F22.699 E F0 2.699(][)2.699 G F2A/F3 10 +/Times-Italic@0 SF(pr)2.5 E(o\214ledir)-.45 E F0 2.699(][)2.699 G F2 +A F3(accountlist)2.5 E F0 2.699(][)2.699 G F2A F3 +(con\214g\214le)2.5 E F0 2.699(][)2.699 G F2A F3(deb)2.5 E +(ugtype[,deb)-.2 E(ugtype)-.2 E(...])-.15 E F0 2.699(][)5.199 G F2 +-.001 E F0(])2.698 E([)108 136.8 Q F22.5 E F3(interface)2.5 E F0 +(])2.5 E F2(of\215ineimap \255h)108 160.8 Q F0(|)2.5 E F2(\255\255help) +2.5 E F1(DESCRIPTION)72 177.6 Q F2(Of\215ineIMAP)108 189.6 Q F0 .019 +(is a tool to simplify your e-mail reading.)2.518 F -.4(Wi)5.019 G(th).4 +E F2(Of\215ineIMAP)2.519 E(,)-.92 E F0 .019 +(you can read the same mailbox)2.519 F 1.116(from multiple computers.) +108 201.6 R -1.1(Yo)6.116 G 3.616(ug)1.1 G 1.116(et a current cop)-3.616 +F 3.616(yo)-.1 G 3.616(fy)-3.616 G 1.115(our messages on each computer) +-3.616 F 3.615(,a)-.4 G 1.115(nd changes you)-3.615 F(mak)108 213.6 Q +2.914(eo)-.1 G .414(ne place will be visible on all other systems.) +-2.914 F -.15(Fo)5.414 G 2.914(ri).15 G .414 (nstance, you can delete a message on your home)-2.914 F(computer)108 -213.6 Q 3.5(,a)-.4 G 1(nd it will appear deleted on your w)-3.5 F 1 +225.6 Q 3.5(,a)-.4 G 1(nd it will appear deleted on your w)-3.5 F 1 (ork computer as well.)-.1 F F2(Of\215ineIMAP)6 E F0 1 -(is also useful if you)3.5 F -.1(wa)108 225.6 S .827 +(is also useful if you)3.5 F -.1(wa)108 237.6 S .827 (nt to use a mail reader that does not ha).1 F 1.127 -.15(ve I)-.2 H .827(MAP support, has poor IMAP support, or does not pro).15 F(vide)-.15 -E(disconnected operation.)108 237.6 Q F2(Of\215ineIMAP)108 254.4 Q F0 -(is)3.216 E F3 -1.15(FA)3.216 G(ST)1.15 E(;)-.65 E F0 .716 -(it synchronizes my tw)3.216 F 3.216(oa)-.1 G .716(ccounts with o)-3.216 -F -.15(ve)-.15 G 3.216(r5).15 G 3.216(0f)-3.216 G .717 -(olders in 3 seconds.)-3.216 F .717(Other similar)5.717 F .26 -(tools might tak)108 266.4 R 2.76(eo)-.1 G -.15(ve)-2.91 G 2.76(ram).15 -G .26(inute, and achie)-2.76 F .56 -.15(ve a l)-.25 H .259 -(ess-reliable result.).15 F .259(Some mail readers can tak)5.259 F 2.759 -(eo)-.1 G -.15(ve)-2.909 G 2.759(r1).15 G 2.759(0m)-2.759 G(in-)-2.759 E -.157(utes to do the same thing, and some don')108 278.4 R 2.657(te)-.18 -G -.15(ve)-2.907 G 2.657(ns).15 G .157(upport it at all.)-2.657 F(Unlik) -5.158 E 2.658(eo)-.1 G .158(ther mail tools,)-2.658 F F2(Of\215ineIMAP) -2.658 E F0(fea-)2.658 E .321(tures a multi-threaded synchronization alg\ -orithm that can dramatically speed up performance in man)108 290.4 R -2.82(ys)-.15 G(itu-)-2.82 E(ations by synchronizing se)108 302.4 Q -.15 -(ve)-.25 G(ral dif).15 E(ferent things simultaneously)-.25 E(.)-.65 E F2 -(Of\215ineIMAP)108 319.2 Q F0(is)3.065 E F3(FLEXIBLE;)3.065 E F0 .566 -(you can customize which folders are synced via re)3.065 F .566(gular e) --.15 F .566(xpressions, lists, or)-.15 F .734(Python e)108 331.2 R .734 -(xpressions; a v)-.15 F .734(ersatile and comprehensi)-.15 F 1.034 -.15 -(ve c)-.25 H .733(on\214guration \214le is used to control beha).15 F -.733(vior; tw)-.2 F 3.233(ou)-.1 G(ser)-3.233 E(interf)108 343.2 Q .535 -(aces are b)-.1 F .535(uilt-in; \214ne-tuning of synchronization perfor\ -mance is possible; internal or e)-.2 F .535(xternal automa-)-.15 F .441 -(tion is supported; SSL and PREA)108 355.2 R .441 -(UTH tunnels are both supported; of)-.55 F .44 +E(disconnected operation.)108 249.6 Q F2(Of\215ineIMAP)108 266.4 Q F0 +(is)3.217 E F3 -1.15(FA)3.217 G(ST)1.15 E(;)-.65 E F0 .716 +(it synchronizes my tw)3.217 F 3.216(oa)-.1 G .716(ccounts with o)-3.216 +F -.15(ve)-.15 G 3.216(r5).15 G 3.216(0f)-3.216 G .716 +(olders in 3 seconds.)-3.216 F .716(Other similar)5.716 F .259 +(tools might tak)108 278.4 R 2.759(eo)-.1 G -.15(ve)-2.909 G 2.759(ram) +.15 G .259(inute, and achie)-2.759 F .559 -.15(ve a l)-.25 H .259 +(ess-reliable result.).15 F .26(Some mail readers can tak)5.26 F 2.76 +(eo)-.1 G -.15(ve)-2.91 G 2.76(r1).15 G 2.76(0m)-2.76 G(in-)-2.76 E .158 +(utes to do the same thing, and some don')108 290.4 R 2.657(te)-.18 G +-.15(ve)-2.907 G 2.657(ns).15 G .157(upport it at all.)-2.657 F(Unlik) +5.157 E 2.657(eo)-.1 G .157(ther mail tools,)-2.657 F F2(Of\215ineIMAP) +2.657 E F0(fea-)2.657 E .321(tures a multi-threaded synchronization alg\ +orithm that can dramatically speed up performance in man)108 302.4 R +2.821(ys)-.15 G(itu-)-2.821 E(ations by synchronizing se)108 314.4 Q +-.15(ve)-.25 G(ral dif).15 E(ferent things simultaneously)-.25 E(.)-.65 +E F2(Of\215ineIMAP)108 331.2 Q F0(is)3.066 E F3(FLEXIBLE;)3.066 E F0 +.566(you can customize which folders are synced via re)3.066 F .565 +(gular e)-.15 F .565(xpressions, lists, or)-.15 F .733(Python e)108 +343.2 R .733(xpressions; a v)-.15 F .733(ersatile and comprehensi)-.15 F +1.033 -.15(ve c)-.25 H .734 +(on\214guration \214le is used to control beha).15 F .734(vior; tw)-.2 F +3.234(ou)-.1 G(ser)-3.234 E(interf)108 355.2 Q .535(aces are b)-.1 F +.535(uilt-in; \214ne-tuning of synchronization performance is possible;\ + internal or e)-.2 F .535(xternal automa-)-.15 F .44 +(tion is supported; SSL and PREA)108 367.2 R .441 +(UTH tunnels are both supported; of)-.55 F .441 (\215ine \(or "unplugged"\) reading is sup-)-.25 F .543(ported; and eso\ teric IMAP features are supported to ensure compatibility with the wide\ -st v)108 367.2 R .544(ariety of IMAP)-.25 F(serv)108 379.2 Q(ers.)-.15 E -F2(Of\215ineIMAP)108 396 Q F0(is)4.065 E F3(SAFE;)4.065 E F0 1.565 -(it uses an algorithm designed to pre)4.065 F -.15(ve)-.25 G 1.565 -(nt mail loss at all costs.).15 F 1.564(Because of the)6.564 F .01 -(design of this algorithm, e)108 408 R -.15(ve)-.25 G 2.51(np).15 G .01 -(rogramming errors should not result in loss of mail.)-2.51 F 2.511(Ia) -5.011 G 2.511(ms)-2.511 G 2.511(oc)-2.511 G .011(on\214dent in the) --2.511 F .448(algorithm that I use my o)108 420 R .448 -(wn personal and w)-.25 F .448(ork accounts for testing of)-.1 F F2 -(Of\215ineIMAP)2.948 E F0 .448(pre-release, de)2.948 F -.15(ve)-.25 G -(lop-).15 E(ment, and beta releases.)108 432 Q F2(METHOD OF OPERA)87 -448.8 Q(TION)-.95 E(Of\215ineIMAP)108 460.8 Q F0 .07 +st v)108 379.2 R .543(ariety of IMAP)-.25 F(serv)108 391.2 Q(ers.)-.15 E +F2(Of\215ineIMAP)108 408 Q F0(is)4.064 E F3(SAFE;)4.064 E F0 1.565 +(it uses an algorithm designed to pre)4.064 F -.15(ve)-.25 G 1.565 +(nt mail loss at all costs.).15 F 1.565(Because of the)6.565 F .011 +(design of this algorithm, e)108 420 R -.15(ve)-.25 G 2.511(np).15 G +.011(rogramming errors should not result in loss of mail.)-2.511 F 2.51 +(Ia)5.01 G 2.51(ms)-2.51 G 2.51(oc)-2.51 G .01(on\214dent in the)-2.51 F +.448(algorithm that I use my o)108 432 R .448(wn personal and w)-.25 F +.448(ork accounts for testing of)-.1 F F2(Of\215ineIMAP)2.948 E F0 .448 +(pre-release, de)2.948 F -.15(ve)-.25 G(lop-).15 E +(ment, and beta releases.)108 444 Q F2(METHOD OF OPERA)87 460.8 Q(TION) +-.95 E(Of\215ineIMAP)108 472.8 Q F0 .07 (operates by maintaining a hierarch)2.57 F 2.57(yo)-.05 G 2.57(fm)-2.57 G .07(ail folders in Maildir format locally)-2.57 F 5.07(.Y)-.65 G .07 -(our o)-6.17 F .07(wn mail)-.25 F .618 -(reader will read mail from this tree, and need ne)108 472.8 R -.15(ve) --.25 G 3.118(rk).15 G(no)-3.118 E 3.118(wt)-.25 G .617 -(hat the mail comes from IMAP)-3.118 F(.)-1.11 E F2(Of\215ineIMAP)5.617 +(our o)-6.17 F .07(wn mail)-.25 F .617 +(reader will read mail from this tree, and need ne)108 484.8 R -.15(ve) +-.25 G 3.118(rk).15 G(no)-3.118 E 3.118(wt)-.25 G .618 +(hat the mail comes from IMAP)-3.118 F(.)-1.11 E F2(Of\215ineIMAP)5.618 E F0 .849(will detect changes to the mail folders on your IMAP serv)108 -484.8 R .849(er and your o)-.15 F .849(wn computer and bi-directionally) --.25 F(synchronize them, cop)108 496.8 Q +496.8 R .849(er and your o)-.15 F .848(wn computer and bi-directionally) +-.25 F(synchronize them, cop)108 508.8 Q (ying, marking, and deleting messages as necessary)-.1 E(.)-.65 E F1 -(INST)72 513.6 Q(ALLA)-.986 E(TION)-1.04 E F0 .491 +(INST)72 525.6 Q(ALLA)-.986 E(TION)-1.04 E F0 .49 (If you are reading this document via the "man" command, it is lik)108 -525.6 R .49(ely that you ha)-.1 F .79 -.15(ve n)-.2 H 2.99(oi).15 G .49 -(nstallation tasks to)-2.99 F .043 -(perform; your system administrator has already installed it.)108 537.6 -R .044(If you need to install it yourself, you ha)5.043 F .344 -.15 +537.6 R .491(ely that you ha)-.1 F .791 -.15(ve n)-.2 H 2.991(oi).15 G +.491(nstallation tasks to)-2.991 F .044 +(perform; your system administrator has already installed it.)108 549.6 +R .043(If you need to install it yourself, you ha)5.044 F .343 -.15 (ve t)-.2 H(hree).15 E .39(options: a system-wide installation with Deb\ ian, system-wide installation with other systems, and a single-)108 -549.6 R 12.823(user installation.)108 561.6 R -1.1(Yo)17.823 G 15.323 +561.6 R 12.823(user installation.)108 573.6 R -1.1(Yo)17.823 G 15.323 (uc)1.1 G 12.823(an do)-15.323 F 12.823(wnload the latest v)-.25 F 12.823(ersion of Of)-.15 F 12.823(\215ineIMAP from)-.25 F -(http://quux.or)108 573.6 Q(g/de)-.18 E -.15(ve)-.25 G(l/of).15 E -(\215ineimap/.)-.25 E F2(PREREQ)87 590.4 Q(UISITES)-.1 E F0 -(In order to use Of)108 602.4 Q(\215ineIMAP)-.25 E 2.5(,y)-1.11 G +(http://quux.or)108 585.6 Q(g/de)-.18 E -.15(ve)-.25 G(l/of).15 E +(\215ineimap/.)-.25 E F2(PREREQ)87 602.4 Q(UISITES)-.1 E F0 +(In order to use Of)108 614.4 Q(\215ineIMAP)-.25 E 2.5(,y)-1.11 G (ou need to ha)-2.5 E .3 -.15(ve t)-.2 H(hese conditions satis\214ed:) -.15 E 32.5<8359>108 619.2 S .197(our mail serv)-33.6 F .197 +.15 E 32.5<8359>108 631.2 S .196(our mail serv)-33.6 F .197 (er must support IMAP)-.15 F 5.197(.M)-1.11 G .197 (ost Internet Service Pro)-5.197 F .197(viders and corporate netw)-.15 F -.196(orks do,)-.1 F(and most operating systems ha)144 631.2 Q .3 -.15 +.197(orks do,)-.1 F(and most operating systems ha)144 643.2 Q .3 -.15 (ve a)-.2 H 2.5(nI).15 G(MAP implementation readily a)-2.5 E -.25(va)-.2 -G(ilable.).25 E 32.5<8359>108 648 S .085(ou must ha)-33.6 F .385 -.15 -(ve P)-.2 H .085(ython v).15 F .085(ersion 2.2.1 or abo)-.15 F .385 -.15 -(ve i)-.15 H 2.585(nstalled. If).15 F .086 -(you are running on Debian GNU/Linux,)2.585 F .813 -(this requirement will automatically be tak)144 660 R .813 -(en care of for you.)-.1 F .812(If you do not ha)5.812 F 1.112 -.15 -(ve P)-.2 H .812(ython already).15 F(,)-.65 E 3.88 -(check with your system administrator or operating system v)144 672 R +G(ilable.).25 E 32.5<8359>108 660 S .086(ou must ha)-33.6 F .386 -.15 +(ve P)-.2 H .086(ython v).15 F .085(ersion 2.2.1 or abo)-.15 F .385 -.15 +(ve i)-.15 H 2.585(nstalled. If).15 F .085 +(you are running on Debian GNU/Linux,)2.585 F .812 +(this requirement will automatically be tak)144 672 R .812 +(en care of for you.)-.1 F .813(If you do not ha)5.813 F 1.113 -.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 684 Q(.p)-.65 E(ython.or)-.1 E 3.378(g/. If)-.18 F -.878(you intend to use the Tk interf)3.378 F .877(ace, you must ha)-.1 F -1.177 -.15(ve T)-.2 H .877(kiner \(p).15 F(ython-tk\))-.1 E 2.859 -(installed. If)144 696 R .359(you intend to use the SSL interf)2.859 F -.359(ace, your Python must ha)-.1 F .66 -.15(ve b)-.2 H .36(een b).15 F -.36(uilt with SSL sup-)-.2 F(port.)144 708 Q(John Goerzen)72 768 Q +.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 +(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 (July 12, 2002)151.655 E(1)201.915 E EP %%Page: 2 2 %%BeginPageSetup @@ -324,73 +327,73 @@ BP (\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E 32.5<8348>108 84 S -2.25 -.2(av e)-32.5 H 2.784(am)2.984 G .284 (ail reader that supports the Maildir mailbox format.)-2.784 F .284 -(Most modern mail readers ha)5.284 F .584 -.15(ve t)-.2 H(his).15 E .111 +(Most modern mail readers ha)5.284 F .584 -.15(ve t)-.2 H(his).15 E .112 (support b)144 96 R .112(uilt-in, so you can choose from a wide v)-.2 F -.112(ariety of mail serv)-.25 F 2.612(ers. This)-.15 F .112 -(format is also kno)2.612 F(wn)-.25 E(as the "qmail" format, so an)144 +.112(ariety of mail serv)-.25 F 2.612(ers. This)-.15 F .111 +(format is also kno)2.611 F(wn)-.25 E(as the "qmail" format, so an)144 108 Q 2.5(ym)-.15 G(ail reader compatible with it will w)-2.5 E (ork with Of)-.1 E(\215ineIMAP)-.25 E(.)-1.11 E/F1 10/Times-Bold@0 SF (DEBIAN SYSTEM-WIDE INST)87 124.8 Q(ALLA)-.9 E(TION)-.95 E F0 .708 (If you are tracking Debian unstable, you may install)108 136.8 R F1 (Of\215ineIMAP)3.208 E F0 .708(by simply running the follo)3.208 F .708 (wing com-)-.25 F(mand as root:)108 148.8 Q F1 -(apt-get install of\215ineimap)108 165.6 Q F0 .339 -(If you are not tracking Debian unstable, do)108 182.4 R .34 -(wnload the Debian .deb package from the Of)-.25 F .34 -(\215ineIMAP website)-.25 F .39(and then run)108 194.4 R F1 .39(dpkg -i) -2.89 F F0 .389(to install the do)2.89 F .389(wnloaded package.)-.25 F -.389(Then, go to CONFIGURA)5.389 F .389(TION belo)-1.11 F 4.189 -.65 -(w. Y)-.25 H .389(ou will)-.45 F(type)108 206.4 Q F1(of\215ineimap)2.5 E -F0(to in)2.5 E -.2(vo)-.4 G .2 -.1(ke t).2 H(he program.).1 E F1 -.4(OT) -87 223.2 S(HER SYSTEM-WIDE INST).4 E(ALLA)-.9 E(TION)-.95 E F0(Do)108 -235.2 Q(wnload the tar)-.25 E(.gz v)-.55 E -(ersion of the package from the website.)-.15 E +(apt-get install of\215ineimap)108 165.6 Q F0 .34 +(If you are not tracking Debian unstable, do)108 182.4 R .339 +(wnload the Debian .deb package from the Of)-.25 F .339 +(\215ineIMAP website)-.25 F .389(and then run)108 194.4 R F1 .389 +(dpkg -i)2.889 F F0 .389(to install the do)2.889 F .389 +(wnloaded package.)-.25 F .39(Then, go to CONFIGURA)5.389 F .39 +(TION belo)-1.11 F 4.19 -.65(w. Y)-.25 H .39(ou will)-.45 F(type)108 +206.4 Q F1(of\215ineimap)2.5 E F0(to in)2.5 E -.2(vo)-.4 G .2 -.1(ke t) +.2 H(he program.).1 E F1 -.4(OT)87 223.2 S(HER SYSTEM-WIDE INST).4 E +(ALLA)-.9 E(TION)-.95 E F0(Do)108 235.2 Q(wnload the tar)-.25 E(.gz v) +-.55 E(ersion of the package from the website.)-.15 E (Then run these commands:)5 E F1(tar -zxvf of\215ineimap-x.y)108 252 Q (.z.tar)-.7 E(.gz)-1 E(cd of\215ineimap-x.y)108 264 Q(.z)-.7 E -(python2.2 setup.py)108 276 Q F0 1.272(Some systems will need to use)108 +(python2.2 setup.py)108 276 Q F0 1.273(Some systems will need to use)108 292.8 R F1(python)3.773 E F0 1.273(instead of)3.773 F F1(python2.2.) -3.773 E F0(Ne)6.273 E 1.273(xt, proceed to con\214guration.)-.15 F -1.1 -(Yo)6.273 G 3.773(uw)1.1 G(ill)-3.773 E(type)108 304.8 Q F1 +3.773 E F0(Ne)6.273 E 1.272(xt, proceed to con\214guration.)-.15 F -1.1 +(Yo)6.272 G 3.772(uw)1.1 G(ill)-3.772 E(type)108 304.8 Q F1 (of\215ineimap)2.5 E F0(to in)2.5 E -.2(vo)-.4 G .2 -.1(ke t).2 H (he program.).1 E F1(SINGLE-A)87 321.6 Q(CCOUNT INST)-.55 E(ALLA)-.9 E (TION)-.95 E F0(Do)108 333.6 Q(wnload the tar)-.25 E(.gz v)-.55 E (ersion of the package from the website.)-.15 E (Then run these commands:)5 E F1(tar -zxvf of\215ineimap-x.y)108 350.4 Q -(.z.tar)-.7 E(.gz)-1 E(cd of\215ineimap-x.y)108 362.4 Q(.z)-.7 E F0 .149 -(When you w)108 379.2 R .149(ant to run)-.1 F F1(Of\215ineIMAP)2.648 E +(.z.tar)-.7 E(.gz)-1 E(cd of\215ineimap-x.y)108 362.4 Q(.z)-.7 E F0 .148 +(When you w)108 379.2 R .148(ant to run)-.1 F F1(Of\215ineIMAP)2.648 E (,)-.92 E F0 .148(you will issue the)2.648 F F1(cd)2.648 E F0 .148 -(command as abo)2.648 F .448 -.15(ve a)-.15 H .148(nd then type).15 F F1 -(./of\215ineimap;)2.648 E F0(there is no installation step necessary)108 +(command as abo)2.648 F .449 -.15(ve a)-.15 H .149(nd then type).15 F F1 +(./of\215ineimap;)2.649 E F0(there is no installation step necessary)108 391.2 Q(.)-.65 E/F2 10.95/Times-Bold@0 SF(CONFIGURA)72 408 Q(TION)-1.04 -E F1(Of\215ineIMAP)108 420 Q F0 .508(is re)3.008 F .508 +E F1(Of\215ineIMAP)108 420 Q F0 .509(is re)3.009 F .508 (gulated by a con\214guration \214le that is normally stored in)-.15 F -/F3 10/Times-Italic@0 SF(~/.of)3.009 E(\215ineimapr)-.18 E(c.)-.37 E F1 -(Of\215ineIMAP)5.509 E F0 .004(ships with a \214le named)108 432 R F3 +/F3 10/Times-Italic@0 SF(~/.of)3.008 E(\215ineimapr)-.18 E(c.)-.37 E F1 +(Of\215ineIMAP)5.508 E F0 .003(ships with a \214le named)108 432 R F3 (of)2.503 E(\215ineimap.conf)-.18 E F0 .003(that you should cop)2.503 F 2.503(yt)-.1 G 2.503(ot)-2.503 G .003(hat location and then edit.)-2.503 -F .003(This \214le is vital)5.003 F .255 +F .004(This \214le is vital)5.003 F .256 (to proper operation of the system; it sets e)108 444 R -.15(ve)-.25 G -.256(rything you need to run).15 F F1(Of\215ineIMAP)2.756 E(.)-1.1 E F0 -.256(Full documentation for)5.256 F +.256(rything you need to run).15 F F1(Of\215ineIMAP)2.755 E(.)-1.1 E F0 +.255(Full documentation for)5.255 F (the con\214guration \214le is included within the sample \214le.)108 456 Q F2(OPTIONS)72 472.8 Q F0 .061 (Most con\214guration is done via the con\214guration \214le.)108 484.8 R(Ne)5.061 E -.15(ve)-.25 G .061(rtheless, there are a fe).15 F 2.561 -(wo)-.25 G .061(ptions that you may set)-2.561 F(for)108 496.8 Q F1 +(wo)-.25 G .062(ptions that you may set)-2.561 F(for)108 496.8 Q F1 (Of\215ineIMAP)2.5 E(.)-1.1 E108 513.6 Q F0 .281(Disable all mult\ -ithreading operations and use solely a single-thread sync.)25.3 F .281 -(This ef)5.281 F(fecti)-.25 E -.15(ve)-.25 G .281(ly sets the).15 F F1 +ithreading operations and use solely a single-thread sync.)25.3 F .28 +(This ef)5.281 F(fecti)-.25 E -.15(ve)-.25 G .28(ly sets the).15 F F1 (maxsyncaccounts)144 525.6 Q F0(and all)2.5 E F1(maxconnections)2.5 E F0 (con\214guration \214le v)2.5 E(ariables to 1.)-.25 E F1108 542.4 Q F3(pr)2.5 E(o\214ledir)-.45 E F0(Sets)144 554.4 Q F1(Of\215ineIMAP) -4.196 E F0 1.696(into pro\214le mode.)4.196 F 1.695 -(The program will create)6.696 F F1(pr)4.195 E(o\214ledir)-.18 E F0 -1.695(\(it must not already)4.195 F -.15(ex)144 566.4 S 2.88(ist\). As) +4.195 E F0 1.695(into pro\214le mode.)4.195 F 1.695 +(The program will create)6.695 F F1(pr)4.196 E(o\214ledir)-.18 E F0 +1.696(\(it must not already)4.196 F -.15(ex)144 566.4 S 2.881(ist\). As) .15 F .381(it runs, Python pro\214ling information about each thread is\ - logged into pro\214ledir)2.88 F 5.381(.P)-.55 G(lease)-5.381 E .485 + logged into pro\214ledir)2.881 F 5.38(.P)-.55 G(lease)-5.38 E .484 (note: This option is present for deb)144 578.4 R .485 -(ugging and optimization only)-.2 F 2.985(,a)-.65 G .484(nd should NO) --2.985 F 2.984(Tb)-.4 G 2.984(eu)-2.984 G .484(sed unless)-2.984 F .778 +(ugging and optimization only)-.2 F 2.985(,a)-.65 G .485(nd should NO) +-2.985 F 2.985(Tb)-.4 G 2.985(eu)-2.985 G .485(sed unless)-2.985 F .778 (you ha)144 590.4 R 1.078 -.15(ve a s)-.2 H .778 (peci\214c reason to do so.).15 F .778(It will signi\214cantly slo)5.778 F 3.278(wp)-.25 G .778(rogram performance, may reduce)-3.278 F @@ -400,19 +403,14 @@ F 3.278(wp)-.25 G .778(rogram performance, may reduce)-3.278 F E(.)-1.1 E108 631.2 Q F3(accountlist)2.5 E F0(Ov)144 643.2 Q .84 (errides the)-.15 F F1(accounts)3.34 E F0 .84 (section in the con\214g \214le.)3.34 F .84 -(Lets you specify a particular account or set of)5.84 F 1.647 -(accounts to sync without ha)144 655.2 R 1.647 -(ving to edit the con\214g \214le.)-.2 F -1.1(Yo)6.648 G 4.148(um)1.1 G -1.648(ight use this to e)-4.148 F 1.648(xclude certain)-.15 F +(Lets you specify a particular account or set of)5.84 F 1.648 +(accounts to sync without ha)144 655.2 R 1.648 +(ving to edit the con\214g \214le.)-.2 F -1.1(Yo)6.647 G 4.147(um)1.1 G +1.647(ight use this to e)-4.147 F 1.647(xclude certain)-.15 F (accounts, or to sync some accounts that you normally prefer not to.)144 667.2 Q F1108 684 Q F3(con\214g\214le)2.5 E F0 (Speci\214es a con\214guration \214le to use in lieu of the def)144 696 -Q(ault,)-.1 E F3(~/.of)2.5 E(\215ineimapr)-.18 E(c.)-.37 E F1108 -712.8 Q F0 1.139(Enables IMAP protocol stream and parsing deb)24.74 F -3.639(ugging. This)-.2 F 1.138(is useful if you are trying to track) -3.639 F(do)144 724.8 Q .081 -(wn a malfunction or \214gure out what is going on under the hood.)-.25 -F 2.582(Is)5.082 G .082(uggest that you use this with)-2.582 F +Q(ault,)-.1 E F3(~/.of)2.5 E(\215ineimapr)-.18 E(c.)-.37 E F0 (John Goerzen)72 768 Q(July 12, 2002)151.655 E(2)201.915 E EP %%Page: 3 3 %%BeginPageSetup @@ -420,513 +418,531 @@ 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/Times-Bold@0 -SF144 84 Q F0 .336(in order to mak)2.836 F 2.836(et)-.1 G .335 -(he results more sensible.)-2.836 F .335 -(Note that this output will contain full IMAP proto-)5.335 F 1.7 -(col in plain te)144 96 R 1.7(xt, including passw)-.15 F 1.7 -(ords, so tak)-.1 F 4.2(ec)-.1 G 1.7(are to remo)-4.2 F 2 -.15(ve t)-.15 -H 1.7(hat from the deb).15 F 1.7(ugging output)-.2 F -(before sending it to an)144 108 Q(yone else.)-.15 E F1108 124.8 Q -F0(Run only once, ignoring an)25.3 E 2.5(ya)-.15 G +SF108 84 Q/F2 10/Times-Italic@0 SF(deb)2.5 E(ugtype[,deb)-.2 E +(ugtype)-.2 E(...])-.15 E F0 .505(Enables deb)144 96 R .505 +(ugging for Of)-.2 F(\215ineIMAP)-.25 E 5.505(.T)-1.11 G .505 +(his is useful if you are trying to track do)-5.505 F .506 +(wn a malfunction)-.25 F .113 +(or \214gure out what is going on under the hood.)144 108 R 2.613(Is) +5.113 G .113(uggest that you use this with)-2.613 F F12.613 E F0 +.112(in order to mak)2.613 F(e)-.1 E(the results more sensible.)144 120 +Q .149(-d no)144 136.8 R 2.649(wr)-.25 G .149(equires one or more deb) +-2.649 F .149(ugtypes, separated by commas.)-.2 F .15 +(These de\214ne what e)5.149 F .15(xactly will be)-.15 F(deb)144 148.8 Q +.347(ugged, and so f)-.2 F .347(ar include tw)-.1 F 2.847(oo)-.1 G +(ptions:)-2.847 E F1(imap)2.847 E F0(and)2.847 E F1(maildir)2.847 E(.)-1 +E F0(The)5.347 E F1(imap)2.846 E F0 .346(option will enable IMAP)2.846 F +.362(protocol stream and parsing deb)144 160.8 R 2.862(ugging. Note)-.2 +F .362(that the output may contain passw)2.862 F .362(ords, so tak)-.1 F +2.863(ec)-.1 G(are)-2.863 E .983(to remo)144 172.8 R 1.283 -.15(ve t) +-.15 H .983(hat from the deb).15 F .983 +(ugging output before sending it to an)-.2 F .982(yone else.)-.15 F(The) +5.982 E F1(maildir)3.482 E F0(option)3.482 E(will enable deb)144 184.8 Q +(ugging for certain Maildir operations.)-.2 E F1108 201.6 Q F0 +(Run only once, ignoring an)25.3 E 2.5(ya)-.15 G (utorefresh setting in the con\214g \214le.)-2.5 E F1 -(\255h, \255\255help)108 141.6 Q F0(Sho)144 153.6 Q 2.5(ws)-.25 G -(ummary of options.)-2.5 E F1108 170.4 Q/F2 10/Times-Italic@0 SF -(interface)2.5 E F0 1.133(Speci\214es an alternati)144 182.4 R 1.433 --.15(ve u)-.25 H 1.133(ser interf).15 F 1.133(ace module to use.)-.1 F -1.133(This o)6.133 F -.15(ve)-.15 G 1.133(rrides the def).15 F 1.132 -(ault speci\214ed in the)-.1 F .28(con\214guration \214le.)144 194.4 R -.28(The UI speci\214ed with)5.28 F F1(-u)2.78 E F0 .281 -(will be forced to be used, e)2.78 F -.15(ve)-.25 G 2.781(ni).15 G 2.781 -(fi)-2.781 G(ts)-2.781 E F1(isuable\(\))2.781 E F0(method)2.781 E .274 -(states that it cannot be.)144 206.4 R .274(Use this option with care.) -5.274 F .273(The pre-de\214ned options are listed in the USER)5.273 F -(INTERF)144 218.4 Q -.4(AC)-.74 G(ES section.).4 E/F3 10.95/Times-Bold@0 -SF(USER INTERF)72 235.2 Q -.602(AC)-.986 G(ES).602 E F1(Of\215ineIMAP) -108 247.2 Q F0 .85(has a plugg)3.35 F .85(able user interf)-.05 F .851 -(ace system that lets you choose ho)-.1 F 3.351(wt)-.25 G .851 -(he program communicates)-3.351 F .024(information to you.)108 259.2 R -.024(There are tw)5.024 F 2.524(og)-.1 G .024(raphical interf)-2.524 F -.023(aces, one terminal interf)-.1 F .023(ace, and tw)-.1 F 2.523(on)-.1 -G(oninteracti)-2.523 E .323 -.15(ve i)-.25 H(nter).15 E(-)-.2 E -.1(fa) -108 271.2 S 1.002(ces suitable for scripting or logging purposes.).1 F +(\255h, \255\255help)108 218.4 Q F0(Sho)144 230.4 Q 2.5(ws)-.25 G +(ummary of options.)-2.5 E F1108 247.2 Q F2(interface)2.5 E F0 +1.132(Speci\214es an alternati)144 259.2 R 1.433 -.15(ve u)-.25 H 1.133 +(ser interf).15 F 1.133(ace module to use.)-.1 F 1.133(This o)6.133 F +-.15(ve)-.15 G 1.133(rrides the def).15 F 1.133(ault speci\214ed in the) +-.1 F .281(con\214guration \214le.)144 271.2 R .281 +(The UI speci\214ed with)5.281 F F1(-u)2.781 E F0 .281 +(will be forced to be used, e)2.781 F -.15(ve)-.25 G 2.78(ni).15 G 2.78 +(fi)-2.78 G(ts)-2.78 E F1(isuable\(\))2.78 E F0(method)2.78 E .273 +(states that it cannot be.)144 283.2 R .273(Use this option with care.) +5.273 F .274(The pre-de\214ned options are listed in the USER)5.274 F +(INTERF)144 295.2 Q -.4(AC)-.74 G(ES section.).4 E/F3 10.95/Times-Bold@0 +SF(USER INTERF)72 312 Q -.602(AC)-.986 G(ES).602 E F1(Of\215ineIMAP)108 +324 Q F0 .851(has a plugg)3.351 F .851(able user interf)-.05 F .851 +(ace system that lets you choose ho)-.1 F 3.35(wt)-.25 G .85 +(he program communicates)-3.35 F .023(information to you.)108 336 R .023 +(There are tw)5.023 F 2.523(og)-.1 G .024(raphical interf)-2.523 F .024 +(aces, one terminal interf)-.1 F .024(ace, and tw)-.1 F 2.524(on)-.1 G +(oninteracti)-2.524 E .324 -.15(ve i)-.25 H(nter).15 E(-)-.2 E -.1(fa) +108 348 S 1.002(ces suitable for scripting or logging purposes.).1 F (The)6.002 E F2(ui)3.502 E F0 1.002 (option in the con\214guration \214le speci\214es the user)3.502 F -(interf)108 283.2 Q .476(ace preferences.)-.1 F(The)5.476 E F2 -2.976 E F0 .475(command-line option can o)2.976 F -.15(ve)-.15 G .475 -(rride the con\214guration \214le.).15 F .475(The a)5.475 F -.25(va)-.2 -G .475(ilable v).25 F(al-)-.25 E(ues for the con\214guration \214le or \ -command-line are describef in this section.)108 295.2 Q F1(Tk.Blink)87 -312 Q(enlights)-.1 E F0 1.708(This is an interf)108 324 R 1.709 +(interf)108 360 Q .475(ace preferences.)-.1 F(The)5.475 E F22.975 +E F0 .475(command-line option can o)2.975 F -.15(ve)-.15 G .476 +(rride the con\214guration \214le.).15 F .476(The a)5.476 F -.25(va)-.2 +G .476(ilable v).25 F(al-)-.25 E(ues for the con\214guration \214le or \ +command-line are describef in this section.)108 372 Q F1(Tk.Blink)87 +388.8 Q(enlights)-.1 E F0 1.709(This is an interf)108 400.8 R 1.709 (ace designed to be sleek, fun to w)-.1 F 1.709(atch, and informati)-.1 F 2.009 -.15(ve o)-.25 H 4.209(ft).15 G 1.709(he o)-4.209 F -.15(ve)-.15 -G 1.709(rall picture of what).15 F F1(Of\215ineIMAP)108 336 Q F0 .18 +G 1.708(rall picture of what).15 F F1(Of\215ineIMAP)108 412.8 Q F0 .18 (is doing.)2.68 F 2.68(Ic)5.18 G .18 (onsider it to be the best general-purpose interf)-2.68 F .18(ace in)-.1 F F1(Of\215ineIMAP)2.68 E(.)-1.1 E F0(Tk.Blink)5.18 E(en-)-.1 E .499 -(lights contains, by def)108 348 R .499(ault, a small windo)-.1 F 2.999 -(ww)-.25 G .499(ith a ro)-2.999 F 2.999(wo)-.25 G 2.999(fL)-2.999 G .499 -(EDs and a ro)-2.999 F 2.999(wo)-.25 G 2.999(fc)-2.999 G .499(ommand b) --2.999 F 2.999(uttons. The)-.2 F(total)2.999 E .553(size of the windo) -108 360 R 3.053(wi)-.25 G 3.053(sv)-3.053 G .552(ery small, so it uses \ -little desktop space, yet it is quite functional.)-3.203 F .552 -(There is also an)5.552 F 1.339(optional, togg)108 372 R 1.339 -(able, log that sho)-.05 F 1.339 -(ws more detail about what is happening and is color)-.25 F 1.34 -(-coded to match the)-.2 F(color of the lights.)108 384 Q(Tk.Blink)108 -400.8 Q 5.224(enlights is the only user interf)-.1 F 5.224 +(lights contains, by def)108 424.8 R .499(ault, a small windo)-.1 F +2.999(ww)-.25 G .499(ith a ro)-2.999 F 2.999(wo)-.25 G 2.999(fL)-2.999 G +.499(EDs and a ro)-2.999 F 2.999(wo)-.25 G 2.999(fc)-2.999 G .499 +(ommand b)-2.999 F 2.999(uttons. The)-.2 F(total)2.998 E .552 +(size of the windo)108 436.8 R 3.052(wi)-.25 G 3.052(sv)-3.052 G .552(e\ +ry small, so it uses little desktop space, yet it is quite functional.) +-3.202 F .553(There is also an)5.553 F 1.34(optional, togg)108 448.8 R +1.34(able, log that sho)-.05 F 1.339 +(ws more detail about what is happening and is color)-.25 F 1.339 +(-coded to match the)-.2 F(color of the lights.)108 460.8 Q(Tk.Blink)108 +477.6 Q 5.224(enlights is the only user interf)-.1 F 5.224 (ace that has con\214gurable parameters; see the e)-.1 F(xample)-.15 E -F2(of)108 412.8 Q(\215ineimap.conf)-.18 E F0(for more details.)2.5 E -.429(Each light in the Tk.Blink)108 429.6 R .429(enlights interf)-.1 F -.429(ace represents a thread of e)-.1 F -.15(xe)-.15 G .43 +F2(of)108 489.6 Q(\215ineimap.conf)-.18 E F0(for more details.)2.5 E .43 +(Each light in the Tk.Blink)108 506.4 R .43(enlights interf)-.1 F .429 +(ace represents a thread of e)-.1 F -.15(xe)-.15 G .429 (cution -- that is, a particular task that).15 F F1(Of\215ineIMAP)108 -441.6 Q F0 .867(is performing right no)3.367 F 4.667 -.65(w. T)-.25 H -.866(he color indicates what task the particular thread is performing,) -.65 F(and are as follo)108 453.6 Q(ws:)-.25 E F1(Black)108 470.4 Q F0 -.569(indicates that this light')11.55 F 3.069(st)-.55 G .569 -(hread has terminated; it will light up ag)-3.069 F .57 -(ain later when ne)-.05 F 3.07(wt)-.25 G .57(hreads start)-3.07 F 2.5 -(up. So,)144 482.4 R(black indicates no acti)2.5 E(vity)-.25 E(.)-.65 E -F1(Red \(Meaning 1\))108 499.2 Q F0 .442 -(is the color of the main program')144 511.2 R 2.942(st)-.55 G .442 +518.4 Q F0 .866(is performing right no)3.366 F 4.666 -.65(w. T)-.25 H +.867(he color indicates what task the particular thread is performing,) +.65 F(and are as follo)108 530.4 Q(ws:)-.25 E F1(Black)108 547.2 Q F0 +.57(indicates that this light')11.55 F 3.07(st)-.55 G .569 +(hread has terminated; it will light up ag)-3.07 F .569 +(ain later when ne)-.05 F 3.069(wt)-.25 G .569(hreads start)-3.069 F 2.5 +(up. So,)144 559.2 R(black indicates no acti)2.5 E(vity)-.25 E(.)-.65 E +F1(Red \(Meaning 1\))108 576 Q F0 .442 +(is the color of the main program')144 588 R 2.942(st)-.55 G .442 (hread, which basically does nothing b)-2.942 F .442 -(ut monitor the others.)-.2 F(It)5.441 E -(might remind you of HAL 9000 in)144 523.2 Q F2(2001.)2.5 E F1(Gray)108 -540 Q F0(indicates that the thread is establishing a ne)13.78 E 2.5(wc) --.25 G(onnection to the IMAP serv)-2.5 E(er)-.15 E(.)-.55 E F1(Pur)108 -556.8 Q(ple)-.1 E F0 .656(is the color of an account synchronization th\ -read that is monitoring the progress of the folders in)7.21 F -(that account \(not generating an)144 568.8 Q 2.5(yI)-.15 G(/O\).)-2.5 E -F1(Cyan)108 585.6 Q F0(indicates that the thread is syncing a folder) -13.22 E(.)-.55 E F1(Gr)108 602.4 Q(een)-.18 E F0(means that a folder') -9.52 E 2.5(sm)-.55 G(essage list is being loaded.)-2.5 E F1(Blue)108 -619.2 Q F0(is the color of a message synchronization controller thread.) -16.55 E F1(Orange)108 636 Q F0 -(indicates that an actual message is being copied.)144 648 Q F1 -(Red \(Meaning 2\))108 664.8 Q F0 -(indicates that a message is being deleted.)144 676.8 Q F1 -1.11(Ye)108 -693.6 S(llo)1.11 E(w)-.1 E F0 -(\(bright orange\) indicates that message \215ags are being added.)7.77 -E F1(Pink)108 710.4 Q F0 -(\(bright red\) indicates that message \215ags are being remo)15.99 E --.15(ve)-.15 G(d.).15 E(John Goerzen)72 768 Q(July 12, 2002)151.655 E(3) -201.915 E EP +(ut monitor the others.)-.2 F(It)5.442 E +(might remind you of HAL 9000 in)144 600 Q F2(2001.)2.5 E F1(Gray)108 +616.8 Q F0(indicates that the thread is establishing a ne)13.78 E 2.5 +(wc)-.25 G(onnection to the IMAP serv)-2.5 E(er)-.15 E(.)-.55 E F1(Pur) +108 633.6 Q(ple)-.1 E F0 .656(is the color of an account synchronizatio\ +n thread that is monitoring the progress of the folders in)7.21 F +(that account \(not generating an)144 645.6 Q 2.5(yI)-.15 G(/O\).)-2.5 E +F1(Cyan)108 662.4 Q F0(indicates that the thread is syncing a folder) +13.22 E(.)-.55 E F1(Gr)108 679.2 Q(een)-.18 E F0(means that a folder') +9.52 E 2.5(sm)-.55 G(essage list is being loaded.)-2.5 E F1(Blue)108 696 +Q F0(is the color of a message synchronization controller thread.)16.55 +E(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/F1 10/Times-Bold@0 -SF(Red / Black Flashing)108 84 Q F0(corresponds to the countdo)144 96 Q -(wn timer that runs between synchronizations.)-.25 E 1.317 -(The name of this interf)108 112.8 R 1.316(ace deri)-.1 F -.15(ve)-.25 G +SF(Orange)108 84 Q F0(indicates that an actual message is being copied.) +144 96 Q F1(Red \(Meaning 2\))108 112.8 Q F0 +(indicates that a message is being deleted.)144 124.8 Q F1 -1.11(Ye)108 +141.6 S(llo)1.11 E(w)-.1 E F0 +(\(bright orange\) indicates that message \215ags are being added.)7.77 +E F1(Pink)108 158.4 Q F0 +(\(bright red\) indicates that message \215ags are being remo)15.99 E +-.15(ve)-.15 G(d.).15 E F1(Red / Black Flashing)108 175.2 Q F0 +(corresponds to the countdo)144 187.2 Q +(wn timer that runs between synchronizations.)-.25 E 1.316 +(The name of this interf)108 204 R 1.316(ace deri)-.1 F -.15(ve)-.25 G 3.816(sf).15 G 1.316(rom a bit of computer science history)-3.816 F -6.316(.E)-.65 G 1.316(ric Raymond')-6.316 F(s)-.55 E/F2 10 -/Times-Italic@0 SF -.35(Ja)3.816 G -.37(rg).35 G 1.316(on F).37 F(ile) --.45 E F0(de\214nes blink)108 124.8 Q(enlights, in part, as:)-.1 E .132 -(Front-panel diagnostic lights on a computer)144 141.6 R 2.632(,e)-.4 G +6.317(.E)-.65 G 1.317(ric Raymond')-6.317 F(s)-.55 E/F2 10 +/Times-Italic@0 SF -.35(Ja)3.817 G -.37(rg).35 G 1.317(on F).37 F(ile) +-.45 E F0(de\214nes blink)108 216 Q(enlights, in part, as:)-.1 E .132 +(Front-panel diagnostic lights on a computer)144 232.8 R 2.632(,e)-.4 G .132(sp. a dinosaur)-2.632 F 2.632(.N)-.55 G .632 -.25(ow t)-2.632 H .132(hat dinosaurs are rare, this term).25 F -(usually refers to status lights on a modem, netw)144 153.6 Q -(ork hub, or the lik)-.1 E(e.)-.1 E 1.244(This term deri)144 170.4 R --.15(ve)-.25 G 3.744(sf).15 G 1.244(rom the last w)-3.744 F 1.244 -(ord of the f)-.1 F 1.243(amous blackletter)-.1 F 1.243 +(usually refers to status lights on a modem, netw)144 244.8 Q +(ork hub, or the lik)-.1 E(e.)-.1 E 1.243(This term deri)144 261.6 R +-.15(ve)-.25 G 3.743(sf).15 G 1.243(rom the last w)-3.743 F 1.244 +(ord of the f)-.1 F 1.244(amous blackletter)-.1 F 1.244 (-Gothic sign in mangled pseudo-)-.2 F .566(German that once graced abo\ -ut half the computer rooms in the English-speaking w)144 182.4 R .566 +ut half the computer rooms in the English-speaking w)144 273.6 R .565 (orld. One v)-.1 F(er)-.15 E(-)-.2 E(sion ran in its entirety as follo) -144 194.4 Q(ws:)-.25 E F1 -.55(AC)144 211.2 S -(HTUNG! ALLES LOOKENSPEEPERS!).55 E F0 1.648 -(Das computermachine ist nicht fuer ge\214ngerpok)144 228 R 1.647 -(en und mittengrabben.)-.1 F 1.647(Ist easy schnappen der)6.647 F .12 -(springenwerk, blo)144 240 R .121(wenfusen und poppencork)-.25 F .121 +144 285.6 Q(ws:)-.25 E F1 -.55(AC)144 302.4 S +(HTUNG! ALLES LOOKENSPEEPERS!).55 E F0 1.647 +(Das computermachine ist nicht fuer ge\214ngerpok)144 319.2 R 1.647 +(en und mittengrabben.)-.1 F 1.648(Ist easy schnappen der)6.647 F .121 +(springenwerk, blo)144 331.2 R .121(wenfusen und poppencork)-.25 F .121 (en mit spitzenspark)-.1 F 2.621(en. Ist)-.1 F .121(nicht fuer ge)2.621 -F(werk)-.25 E .121(en bei das)-.1 F(dumpk)144 252 Q 2.519(opfen. Das)-.1 -F(rubberneck)2.519 E .018(en sichtseeren k)-.1 F .018 -(eepen das cotten-pick)-.1 F .018(enen hans in das pock)-.1 F .018 -(ets muss;)-.1 F(relax)144 264 Q(en und w)-.15 E(atchen das blink)-.1 E -(enlichten.)-.1 E F1(Tk.V)87 280.8 Q(erboseUI)-1 E F0 .503(This interf) -108 292.8 R .503(ace \(formerly kno)-.1 F .503 -(wn as Tk.TkUI\) is a graphical interf)-.25 F .504 -(ace that presents a v)-.1 F .504(ariable-sized windo)-.25 F -.65(w.) --.25 G 1.37(In the windo)108 304.8 R 2.67 -.65(w, e)-.25 H 1.37 +F(werk)-.25 E .121(en bei das)-.1 F(dumpk)144 343.2 Q 2.518(opfen. Das) +-.1 F(rubberneck)2.518 E .018(en sichtseeren k)-.1 F .018 +(eepen das cotten-pick)-.1 F .018(enen hans in das pock)-.1 F .019 +(ets muss;)-.1 F(relax)144 355.2 Q(en und w)-.15 E(atchen das blink)-.1 +E(enlichten.)-.1 E F1(Tk.V)87 372 Q(erboseUI)-1 E F0 .504(This interf) +108 384 R .504(ace \(formerly kno)-.1 F .504 +(wn as Tk.TkUI\) is a graphical interf)-.25 F .503 +(ace that presents a v)-.1 F .503(ariable-sized windo)-.25 F -.65(w.) +-.25 G 1.37(In the windo)108 396 R 2.67 -.65(w, e)-.25 H 1.37 (ach currently-e).65 F -.15(xe)-.15 G 1.37 (cuting thread has a section where its name and current status are dis-) -.15 F 2.768(played. This)108 316.8 R(interf)2.768 E .268 -(ace is best suited to people running on slo)-.1 F .269 -(wer connections, as you get a lot of detail, b)-.25 F(ut)-.2 E .357 -(for f)108 328.8 R .356 +.15 F 2.769(played. This)108 408 R(interf)2.769 E .269 +(ace is best suited to people running on slo)-.1 F .268 +(wer connections, as you get a lot of detail, b)-.25 F(ut)-.2 E .356 +(for f)108 420 R .356 (ast connections, the detail may go by too quickly to be useful.)-.1 F -.356(People with f)5.356 F .356(ast connections may wish)-.1 F -(to use Tk.Blink)108 340.8 Q(enlights instead.)-.1 E F1(TTY)87 357.6 Q -(.TTYUI)-.92 E F0 1.341(This interf)108 369.6 R 1.341(ace is the def)-.1 -F 1.342(ault for people running in terminals.)-.1 F 1.342 +.356(People with f)5.356 F .357(ast connections may wish)-.1 F +(to use Tk.Blink)108 432 Q(enlights instead.)-.1 E F1(TTY)87 448.8 Q +(.TTYUI)-.92 E F0 1.342(This interf)108 460.8 R 1.342(ace is the def)-.1 +F 1.342(ault for people running in terminals.)-.1 F 1.341 (It prints out basic status messages, has an)6.342 F -(interruptible timer lik)108 381.6 Q 2.5(et)-.1 G(he graphical interf) +(interruptible timer lik)108 472.8 Q 2.5(et)-.1 G(he graphical interf) -2.5 E(aces do, and is generally friendly to use on a console or xterm.) --.1 E F1(Noninteracti)87 398.4 Q -.1(ve)-.1 G(.Basic).1 E F0 .552 -(This interf)108 410.4 R .552(ace is designed for situations where)-.1 F +-.1 E F1(Noninteracti)87 489.6 Q -.1(ve)-.1 G(.Basic).1 E F0 .551 +(This interf)108 501.6 R .551(ace is designed for situations where)-.1 F F1(Of\215ineIMAP)3.051 E F0 .551 (will be run non-attended and the status of its)3.051 F -.15(exe)108 -422.4 S .697(cution will be logged.).15 F -1.1(Yo)5.697 G 3.197(um)1.1 G +513.6 S .697(cution will be logged.).15 F -1.1(Yo)5.697 G 3.197(um)1.1 G .697(ight use it, for instance, to ha)-3.197 F .997 -.15(ve t)-.2 H .697 -(he system run automatically and e-mail).15 F .903 -(you the results of the synchronization.)108 434.4 R .902 -(This user interf)5.903 F .902(ace is not capable of reading a passw)-.1 -F .902(ord from the)-.1 F -.1(ke)108 446.4 S(yboard; account passw)-.05 +(he system run automatically and e-mail).15 F .902 +(you the results of the synchronization.)108 525.6 R .902 +(This user interf)5.902 F .903(ace is not capable of reading a passw)-.1 +F .903(ord from the)-.1 F -.1(ke)108 537.6 S(yboard; account passw)-.05 E(ords must be speci\214ed using one of the con\214guration \214le opti\ -ons.)-.1 E F1(Noninteracti)87 463.2 Q -.1(ve)-.1 G(.Quiet).1 E F0 1.622 -(This interf)108 475.2 R 1.623(ace is designed for non-attended running\ - in situations where normal status messages are not)-.1 F 3.934 -(desired. It)108 487.2 R 1.434(will output nothing e)3.934 F 1.434 +ons.)-.1 E F1(Noninteracti)87 554.4 Q -.1(ve)-.1 G(.Quiet).1 E F0 1.623 +(This interf)108 566.4 R 1.623(ace is designed for non-attended running\ + in situations where normal status messages are not)-.1 F 3.933 +(desired. It)108 578.4 R 1.434(will output nothing e)3.933 F 1.434 (xcept errors and serious w)-.15 F 3.934(arnings. Lik)-.1 F 3.934(eN)-.1 -G(oninteracti)-3.934 E -.15(ve)-.25 G 1.433(.Basic, this user).15 F -(interf)108 499.2 Q 1.38(ace is not capable of reading a passw)-.1 F +G(oninteracti)-3.934 E -.15(ve)-.25 G 1.434(.Basic, this user).15 F +(interf)108 590.4 Q 1.38(ace is not capable of reading a passw)-.1 F 1.38(ord from the k)-.1 F -.15(ey)-.1 G 1.38(board; account passw).15 F 1.38(ords must be speci\214ed)-.1 F -(using one of the con\214guration \214le options.)108 511.2 Q/F3 10.95 -/Times-Bold@0 SF(EXAMPLES)72 528 Q F0(Here is an e)108 540 Q +(using one of the con\214guration \214le options.)108 602.4 Q/F3 10.95 +/Times-Bold@0 SF(EXAMPLES)72 619.2 Q F0(Here is an e)108 631.2 Q (xample con\214guration for a particularly comple)-.15 E 2.5(xs)-.15 G (ituation; more e)-2.5 E(xamples will be added later)-.15 E(.)-.55 E F1 -(MUL)87 556.8 Q(TIPLE A)-.92 E(CCOUNTS WITH MUTT)-.55 E F0 .514(This e) -108 568.8 R .514(xample sho)-.15 F .514(ws you ho)-.25 F 3.014(wt)-.25 G -3.014(os)-3.014 G .514(et up)-3.014 F F1(Of\215ineIMAP)3.014 E F0 .513 +(MUL)87 648 Q(TIPLE A)-.92 E(CCOUNTS WITH MUTT)-.55 E F0 .513(This e)108 +660 R .513(xample sho)-.15 F .513(ws you ho)-.25 F 3.014(wt)-.25 G 3.014 +(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 -580.8 Q(.)-.55 E(Start by creating a directory to hold your folders:)108 -597.6 Q F1(mkdir ~/Mail)108 609.6 Q F0(In your)108 626.4 Q F2(~/.of)2.5 +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 638.4 Q(ersonal, W)-.2 E(ork)-.75 E F0(Mak)108 655.2 Q 2.82(es)-.1 G -.32(ure that you ha)-2.82 F .62 -.15(ve b)-.2 H .32(oth a).15 F F1([P) -2.821 E(ersonal])-.2 E F0 .321(and a)2.821 F F1([W)2.821 E(ork])-.75 E -F0 .321(section, with dif)2.821 F .321(ferent localfolder pathnames and) --.25 F(enable)108 667.2 Q F1([mbnames].)2.5 E F0 -(In each account section, do something lik)108 684 Q 2.5(et)-.1 G(his:) --2.5 E F1(localf)108 696 Q(olders = ~/Mail/P)-.25 E(ersonal)-.2 E F0 -(Add these lines to your)108 712.8 Q F2(~/.muttr)2.5 E(c:)-.37 E F1 -(sour)108 724.8 Q(ce ~/path-to-mbnames-muttr)-.18 E(c-mailboxes)-.18 E -F0(John Goerzen)72 768 Q(July 12, 2002)151.655 E(4)201.915 E EP +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 %%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/F1 10/Times-Bold@0 -SF -.25(fo)108 84 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 96 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 108 Q(set f)108 -120 Q(older=$HOME/Mail)-.25 E(set spool\214le=+P)108 132 Q(ersonal/INBO) --.2 E(X)-.4 E F0(That')108 148.8 Q 2.5(si)-.55 G(t!)-2.5 E F1(UW)87 -165.6 Q(-IMAPD AND REFERENCES)-.37 E F0 .494(Some users with a UW)108 -177.6 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 189.6 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 201.6 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 that limits the folders synced to just three.)108 213.6 Q F1 -([Gerf])108 230.4 Q(localf)108 242.4 Q(olders = ~/Mail)-.25 E -.18(re) -108 254.4 S(motehost = gerf).18 E(.or)-.15 E(g)-.1 E(ssl = y)108 266.4 Q -(es)-.1 E -.18(re)108 278.4 S(moteuser = docwhat).18 E -.18(re)108 290.4 -S(fer).18 E(ence = Mail)-.18 E 2.5(#T)108 302.4 S(rims off the pr)-3.24 -E(eceeding Mail on all the f)-.18 E(older names.)-.25 E -(nametrans = lambda f)108 314.4 Q(older)-.25 E(name: \\)-.15 E -.18(re) -138 326.4 S(.sub\('^Mail/', ').18 E(', f)-.63 E(older)-.25 E(name\))-.15 -E 2.5(#Y)108 338.4 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 350.4 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 362.4 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 374.4 Q(X',)-.4 E -('Mail/list/zaurus-general',)125.5 386.4 Q('Mail/list/zaurus-de)125.5 -398.4 Q(v',)-.15 E(])125.5 410.4 Q(maxconnections = 1)108 422.4 Q -(holdconnectionopen = no)108 434.4 Q/F2 10.95/Times-Bold@0 SF(ERR)72 -451.2 Q(ORS)-.329 E F0(If you get one of some frequently-encountered or\ - confusing errors, please check this section.)108 463.2 Q F1(UID v)87 -480 Q(alidity pr)-.1 E(oblem f)-.18 E(or f)-.25 E(older)-.25 E F0 1.637 -(IMAP serv)108 492 R 1.637 +(\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') +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/" \ +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 +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.638(This number is guaranteed to be)6.637 F 1.11 -(unique to a particular message FOREVER.)108 504 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 516 R .373 -(are an inte)2.873 F .373(gral part of Of)-.15 F(\215ineIMAP')-.25 E +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 528 Q(er)-.15 E(.) --.55 E .108(Sometimes, the UIDs on the serv)108 544.8 R .108 +(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.742 -(af)108 556.8 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 568.8 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 580.8 +(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 597.6 S 2.826(uc)1.1 G .326 -(an \214x it by remo)-2.826 F .327 +(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/F3 10 -/Times-Italic@0 SF(~/F)2.827 E(old-)-1.05 E(er)108 609.6 Q(s)-.1 E F0 +.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 626.4 Q(olders/INBO)-.25 E(X)-.4 E -(rm ~/.of\215ineimap/AccountName/INBO)108 638.4 Q(X)-.4 E F0 -(\(replacing AccountName with the account name as speci\214ed in)108 -655.2 Q F3(~/.of)2.5 E(\215ineimapr)-.18 E(c\))-.37 E F0(Ne)108 672 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 684 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 700.8 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 712.8 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 724.8 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 -(July 12, 2002)151.655 E(5)201.915 E EP +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 %%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(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 +(\(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 +(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 +(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 +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 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 (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 +230.4 Q F2(What platf)108 247.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 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 +(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 (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 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 247.2 Q 2.5(wd)-.1 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 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 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 -.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 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 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 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 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 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 369.6 Q 2.5(et)-.18 G(her)-2.5 E 2.5(ea)-.18 G +-.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 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 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 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 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 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 +(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 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 +(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 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 +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 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 +(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 -.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 +.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(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(6)201.915 E EP +(ving the name intact.)-.2 E(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 .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(So,)144 84 Q/F1 10 +/Times-Bold@0 SF(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 +(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 +.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 +(\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 (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 +194.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 +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 +.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 (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 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 288 S 8.92(aildir as speci\214ed in http://www)-32.5 F(.qmail.or) +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 300 Q(.yp.to/proto/maildir)-.55 E(.html.)-.55 E 32.5 -<8353>108 316.8 S +(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 -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 +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 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 +-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.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 +-.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.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 3.396(go)-.18 G 3.396 -(rs)-3.396 G .897(ubmitted on-line using the W)-3.396 F .897(eb interf) --.8 F .897(ace at http://b)-.1 F(ugs.complete.or)-.2 E(g/.)-.18 E(The W) -108 628.8 Q(eb site also lists all current b)-.8 E +(\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 F1(COPYRIGHT)72 645.6 Q F0(Of)108 657.6 Q -(\215ineIMAP is Cop)-.25 E(yright \(C\) 2002 John Goerzen.)-.1 E .287 -(This program is free softw)108 674.4 R .287(are; you can redistrib)-.1 -F .286(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 686.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 698.4 Q -2.5(yl)-.15 G(ater v)-2.5 E(ersion.)-.15 E .58(This program is distrib) -108 715.2 R .579(uted in the hope that it will be useful, b)-.2 F .579 -(ut WITHOUT ANY W)-.2 F(ARRANTY)-1.2 E 3.079(;w)-.92 G(ithout)-3.079 E --2.15 -.25(ev e)108 727.2 T 2.729(nt).25 G .229(he implied w)-2.729 F -.229(arranty of MERCHANT)-.1 F .229(ABILITY or FITNESS FOR A P)-.93 F -(AR)-.92 E .23(TICULAR PURPOSE.)-.6 F(See)5.23 E(John Goerzen)72 768 Q -(July 12, 2002)151.655 E(7)201.915 E EP +(ute to \214xing them.)-.2 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 -(the GNU General Public License for more details.)108 84 Q -1.1(Yo)108 -100.8 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.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 +(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 +(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) +.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 112.8 Q(Free Softw)108 129.6 Q(are F)-.1 E -(oundation, Inc.)-.15 E(59 T)108 141.6 Q(emple Place)-.7 E(Suite 330)108 -153.6 Q(Boston, MA)108 165.6 Q(02111-1307)5 E(USA)108 177.6 Q/F1 10.95 -/Times-Bold@0 SF -.548(AU)72 194.4 S(THOR).548 E/F2 10/Times-Bold@0 SF -(Of\215ineIMAP)108 206.4 Q(,)-.92 E F0 .488 -(its libraries, documentation, and all included \214les, e)2.987 F .488 -(xcept where noted, w)-.15 F .488(as written by John)-.1 F -(Goerzen and cop)-.18 E -(yright is held as stated in the COPYRIGHT section.)-.1 E(Of)108 235.2 Q +-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 +(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 (\215ineIMAP may be do)-.25 E(wnloaded, and information found, from its\ - homepage via either Gopher or HTTP:)-.25 E(gopher://quux.or)108 252 Q + homepage via either Gopher or HTTP:)-.25 E(gopher://quux.or)108 345.6 Q (g/1/de)-.18 E -.15(ve)-.25 G(l/of).15 E(\215ineimap)-.25 E -(http://quux.or)108 264 Q(g/de)-.18 E -.15(ve)-.25 G(l/of).15 E -(\215ineimap)-.25 E(Of)108 280.8 Q 2.529(\215ineIMAP may also be do)-.25 +(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 F 2.528(wnloaded using Sub)-.25 F -.15(ve)-.15 G 5.028 -(rsion. Additionally).15 F 5.028(,t)-.65 G 2.528(he distrib)-5.028 F -2.528(uted tar)-.2 F 2.528(.gz may be)-.55 F .717 +(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 -292.8 R -.15(Fo)5.718 G 3.218(ri).15 G .718(nformation on getting Of) --3.218 F(\215ineIMAP)-.25 E(with Sub)108 304.8 Q -.15(ve)-.15 G -(rsion, please visit:).15 E(http://svn.complete.or)108 321.6 Q(g/)-.18 E -F1(SEE ALSO)72 338.4 Q F2(mutt)108 350.4 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 +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 %%Trailer end %%EOF diff --git a/offlineimap/head/manual.txt b/offlineimap/head/manual.txt index 0bdd511..d13cd66 100644 --- a/offlineimap/head/manual.txt +++ b/offlineimap/head/manual.txt @@ -8,111 +8,112 @@ NAME SYNOPSIS offlineimap [ -1 ] [ -P profiledir ] [ -a accountlist ] [ - -c configfile ] [ -d ] [ -o ] [ -u interface ] + -c configfile ] [ -d debugtype[,debugtype...] ] [ -o ] [ + -u interface ] offlineimap -h | --help DESCRIPTION - OfflineIMAP is a tool to simplify your e-mail reading. - With OfflineIMAP, you can read the same mailbox from mul- - tiple computers. You get a current copy of your messages - on each computer, and changes you make one place will be - visible on all other systems. For instance, you can + OfflineIMAP is a tool to simplify your e-mail reading. + With OfflineIMAP, you can read the same mailbox from mul- + tiple computers. You get a current copy of your messages + on each computer, and changes you make one place will be + visible on all other systems. For instance, you can delete a message on your home computer, and it will appear - deleted on your work computer as well. OfflineIMAP is + deleted on your work computer as well. OfflineIMAP is also useful if you want to use a mail reader that does not have IMAP support, has poor IMAP support, or does not pro- vide disconnected operation. - OfflineIMAP is FAST; it synchronizes my two accounts with - over 50 folders in 3 seconds. Other similar tools might - take over a minute, and achieve a less-reliable result. - Some mail readers can take over 10 minutes to do the same - thing, and some don't even support it at all. Unlike - other mail tools, OfflineIMAP features a multi-threaded - synchronization algorithm that can dramatically speed up - performance in many situations by synchronizing several + OfflineIMAP is FAST; it synchronizes my two accounts with + over 50 folders in 3 seconds. Other similar tools might + take over a minute, and achieve a less-reliable result. + Some mail readers can take over 10 minutes to do the same + thing, and some don't even support it at all. Unlike + other mail tools, OfflineIMAP features a multi-threaded + synchronization algorithm that can dramatically speed up + performance in many situations by synchronizing several different things simultaneously. - OfflineIMAP is FLEXIBLE; you can customize which folders - are synced via regular expressions, lists, or Python - expressions; a versatile and comprehensive configuration - file is used to control behavior; two user interfaces are - built-in; fine-tuning of synchronization performance is - possible; internal or external automation is supported; - SSL and PREAUTH tunnels are both supported; offline (or - "unplugged") reading is supported; and esoteric IMAP fea- - tures are supported to ensure compatibility with the + OfflineIMAP is FLEXIBLE; you can customize which folders + are synced via regular expressions, lists, or Python + expressions; a versatile and comprehensive configuration + file is used to control behavior; two user interfaces are + built-in; fine-tuning of synchronization performance is + possible; internal or external automation is supported; + SSL and PREAUTH tunnels are both supported; offline (or + "unplugged") reading is supported; and esoteric IMAP fea- + tures are supported to ensure compatibility with the widest variety of IMAP servers. OfflineIMAP is SAFE; it uses an algorithm designed to pre- - vent mail loss at all costs. Because of the design of - this algorithm, even programming errors should not result - in loss of mail. I am so confident in the algorithm that - I use my own personal and work accounts for testing of + vent mail loss at all costs. Because of the design of + this algorithm, even programming errors should not result + in loss of mail. I am so confident in the algorithm that + I use my own personal and work accounts for testing of OfflineIMAP pre-release, development, and beta releases. METHOD OF OPERATION - OfflineIMAP operates by maintaining a hierarchy of mail - folders in Maildir format locally. Your own mail reader - will read mail from this tree, and need never know that + OfflineIMAP operates by maintaining a hierarchy of mail + folders in Maildir format locally. Your own mail reader + will read mail from this tree, and need never know that the mail comes from IMAP. OfflineIMAP will detect changes - to the mail folders on your IMAP server and your own com- + to the mail folders on your IMAP server and your own com- puter and bi-directionally synchronize them, copying, marking, and deleting messages as necessary. INSTALLATION If you are reading this document via the "man" command, it - is likely that you have no installation tasks to perform; - your system administrator has already installed it. If + is likely that you have no installation tasks to perform; + your system administrator has already installed it. If you need to install it yourself, you have three options: a - system-wide installation with Debian, system-wide instal- + system-wide installation with Debian, system-wide instal- lation with other systems, and a single-user installation. - You can download the latest version of OfflineIMAP from + You can download the latest version of OfflineIMAP from http://quux.org/devel/offlineimap/. PREREQUISITES In order to use OfflineIMAP, you need to have these condi- tions satisfied: - o Your mail server must support IMAP. Most Internet - Service Providers and corporate networks do, and - most operating systems have an IMAP implementation + o Your mail server must support IMAP. Most Internet + Service Providers and corporate networks do, and + most operating systems have an IMAP implementation readily available. - o You must have Python version 2.2.1 or above + o You must have Python version 2.2.1 or above installed. If you are running on Debian GNU/Linux, - this requirement will automatically be taken care - of for you. If you do not have Python already, - 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) + this requirement will automatically be taken care + of for you. If you do not have Python already, + 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) installed. If you intend to use the SSL interface, - your Python must have been built with SSL support. + your Python must have been built with SSL support. - o Have a mail reader that supports the Maildir mail- - box format. Most modern mail readers have this - support built-in, so you can choose from a wide + o Have a mail reader that supports the Maildir mail- + box format. Most modern mail readers have this + support built-in, so you can choose from a wide variety of mail servers. This format is also known - as the "qmail" format, so any mail reader compati- + as the "qmail" format, so any mail reader compati- ble with it will work with OfflineIMAP. DEBIAN SYSTEM-WIDE INSTALLATION - If you are tracking Debian unstable, you may install - OfflineIMAP by simply running the following command as + If you are tracking Debian unstable, you may install + OfflineIMAP by simply running the following command as root: apt-get install offlineimap - If you are not tracking Debian unstable, download the - Debian .deb package from the OfflineIMAP website and then - run dpkg -i to install the downloaded package. Then, go - to CONFIGURATION below. You will type offlineimap to + If you are not tracking Debian unstable, download the + Debian .deb package from the OfflineIMAP website and then + run dpkg -i to install the downloaded package. Then, go + to CONFIGURATION below. You will type offlineimap to invoke the program. OTHER SYSTEM-WIDE INSTALLATION - Download the tar.gz version of the package from the web- + Download the tar.gz version of the package from the web- site. Then run these commands: tar -zxvf offlineimap-x.y.z.tar.gz @@ -124,139 +125,146 @@ INSTALLATION to invoke the program. SINGLE-ACCOUNT INSTALLATION - Download the tar.gz version of the package from the web- + Download the tar.gz version of the package from the web- site. Then run these commands: tar -zxvf offlineimap-x.y.z.tar.gz cd offlineimap-x.y.z - When you want to run OfflineIMAP, you will issue the cd - command as above and then type ./offlineimap; there is no + When you want to run OfflineIMAP, you will issue the cd + command as above and then type ./offlineimap; there is no installation step necessary. CONFIGURATION - OfflineIMAP is regulated by a configuration file that is - normally stored in ~/.offlineimaprc. OfflineIMAP ships + OfflineIMAP is regulated by a configuration file that is + normally stored in ~/.offlineimaprc. OfflineIMAP ships with a file named offlineimap.conf that you should copy to that location and then edit. This file is vital to proper - operation of the system; it sets everything you need to + operation of the system; it sets everything you need to run OfflineIMAP. Full documentation for the configuration file is included within the sample file. OPTIONS - Most configuration is done via the configuration file. + Most configuration is done via the configuration file. Nevertheless, there are a few options that you may set for OfflineIMAP. - -1 Disable all multithreading operations and use + -1 Disable all multithreading operations and use solely a single-thread sync. This effectively sets the maxsyncaccounts and all maxconnections configu- ration file variables to 1. -P profiledir - Sets OfflineIMAP into profile mode. The program + Sets OfflineIMAP into profile mode. The program will create profiledir (it must not already exist). As it runs, Python profiling information about each - thread is logged into profiledir. Please note: - This option is present for debugging and optimiza- + thread is logged into profiledir. Please note: + This option is present for debugging and optimiza- tion only, and should NOT be used unless you have a - specific reason to do so. It will significantly - slow program performance, may reduce reliability, - and can generate huge amounts of data. You must + specific reason to do so. It will significantly + slow program performance, may reduce reliability, + and can generate huge amounts of data. You must use the -1 option when you use -P. -a accountlist - Overrides the accounts section in the config file. - Lets you specify a particular account or set of - accounts to sync without having to edit the config + Overrides the accounts section in the config file. + Lets you specify a particular account or set of + accounts to sync without having to edit the config file. You might use this to exclude certain - accounts, or to sync some accounts that you nor- + accounts, or to sync some accounts that you nor- mally prefer not to. -c configfile - Specifies a configuration file to use in lieu of + Specifies a configuration file to use in lieu of the default, ~/.offlineimaprc. - -d Enables IMAP protocol stream and parsing debugging. - This is useful if you are trying to track down a - malfunction or figure out what is going on under - the hood. I suggest that you use this with -1 in - order to make the results more sensible. Note that - this output will contain full IMAP protocol in - plain text, including passwords, so take care to - remove that from the debugging output before send- - ing it to anyone else. + -d debugtype[,debugtype...] + Enables debugging for OfflineIMAP. This is useful + if you are trying to track down a malfunction or + figure out what is going on under the hood. I sug- + gest that you use this with -1 in order to make the + results more sensible. - -o Run only once, ignoring any autorefresh setting in + -d now requires one or more debugtypes, separated + by commas. These define what exactly will be + debugged, and so far include two options: imap and + maildir. The imap option will enable IMAP protocol + stream and parsing debugging. Note that the output + may contain passwords, so take care to remove that + from the debugging output before sending it to any- + one else. The maildir option will enable debugging + for certain Maildir operations. + + -o Run only once, ignoring any autorefresh setting in the config file. -h, --help Show summary of options. -u interface - Specifies an alternative user interface module to - use. This overrides the default specified in the - configuration file. The UI specified with -u will - be forced to be used, even if its isuable() method - states that it cannot be. Use this option with - care. The pre-defined options are listed in the + Specifies an alternative user interface module to + use. This overrides the default specified in the + configuration file. The UI specified with -u will + be forced to be used, even if its isuable() method + states that it cannot be. Use this option with + care. The pre-defined options are listed in the USER INTERFACES section. USER INTERFACES - OfflineIMAP has a pluggable user interface system that - lets you choose how the program communicates information - to you. There are two graphical interfaces, one terminal - interface, and two noninteractive interfaces suitable for - scripting or logging purposes. The ui option in the con- - figuration file specifies the user interface preferences. - The -u command-line option can override the configuration - file. The available values for the configuration file or + OfflineIMAP has a pluggable user interface system that + lets you choose how the program communicates information + to you. There are two graphical interfaces, one terminal + interface, and two noninteractive interfaces suitable for + scripting or logging purposes. The ui option in the con- + figuration file specifies the user interface preferences. + The -u command-line option can override the configuration + file. The available values for the configuration file or command-line are describef in this section. Tk.Blinkenlights - This is an interface designed to be sleek, fun to watch, + This is an interface designed to be sleek, fun to watch, and informative of the overall picture of what OfflineIMAP - is doing. I consider it to be the best general-purpose - interface in OfflineIMAP. Tk.Blinkenlights contains, by - default, a small window with a row of LEDs and a row of - command buttons. The total size of the window is very - small, so it uses little desktop space, yet it is quite + is doing. I consider it to be the best general-purpose + interface in OfflineIMAP. Tk.Blinkenlights contains, by + default, a small window with a row of LEDs and a row of + command buttons. The total size of the window is very + small, so it uses little desktop space, yet it is quite functional. There is also an optional, toggable, log that - shows more detail about what is happening and is color- + shows more detail about what is happening and is color- coded to match the color of the lights. - Tk.Blinkenlights is the only user interface that has con- + Tk.Blinkenlights is the only user interface that has con- figurable parameters; see the example offlineimap.conf for more details. - Each light in the Tk.Blinkenlights interface represents a - thread of execution -- that is, a particular task that - OfflineIMAP is performing right now. The color indicates - what task the particular thread is performing, and are as + Each light in the Tk.Blinkenlights interface represents a + thread of execution -- that is, a particular task that + OfflineIMAP is performing right now. The color indicates + what task the particular thread is performing, and are as follows: - Black indicates that this light's thread has terminated; + Black indicates that this light's thread has terminated; it will light up again later when new threads start up. So, black indicates no activity. Red (Meaning 1) - is the color of the main program's thread, which - basically does nothing but monitor the others. It + is the color of the main program's thread, which + basically does nothing but monitor the others. It might remind you of HAL 9000 in 2001. - Gray indicates that the thread is establishing a new + Gray indicates that the thread is establishing a new connection to the IMAP server. - Purple is the color of an account synchronization thread - that is monitoring the progress of the folders in + Purple is the color of an account synchronization thread + that is monitoring the progress of the folders in that account (not generating any I/O). Cyan indicates that the thread is syncing a folder. Green means that a folder's message list is being loaded. - Blue is the color of a message synchronization con- + Blue is the color of a message synchronization con- troller thread. Orange indicates that an actual message is being copied. @@ -264,83 +272,83 @@ USER INTERFACES Red (Meaning 2) indicates that a message is being deleted. - Yellow (bright orange) indicates that message flags are + Yellow (bright orange) indicates that message flags are being added. Pink (bright red) indicates that message flags are being removed. Red / Black Flashing - corresponds to the countdown timer that runs + corresponds to the countdown timer that runs between synchronizations. - The name of this interface derives from a bit of computer + The name of this interface derives from a bit of computer science history. Eric Raymond's Jargon File defines blinkenlights, in part, as: Front-panel diagnostic lights on a computer, esp. a - dinosaur. Now that dinosaurs are rare, this term + dinosaur. Now that dinosaurs are rare, this term usually refers to status lights on a modem, network hub, or the like. - This term derives from the last word of the famous - blackletter-Gothic sign in mangled pseudo-German - that once graced about half the computer rooms in - the English-speaking world. One version ran in its + This term derives from the last word of the famous + blackletter-Gothic sign in mangled pseudo-German + that once graced about half the computer rooms in + the English-speaking world. One version ran in its entirety as follows: ACHTUNG! ALLES LOOKENSPEEPERS! - Das computermachine ist nicht fuer gefingerpoken - und mittengrabben. Ist easy schnappen der sprin- - genwerk, blowenfusen und poppencorken mit - spitzensparken. Ist nicht fuer gewerken bei das - dumpkopfen. Das rubbernecken sichtseeren keepen + Das computermachine ist nicht fuer gefingerpoken + und mittengrabben. Ist easy schnappen der sprin- + genwerk, blowenfusen und poppencorken mit + spitzensparken. Ist nicht fuer gewerken bei das + dumpkopfen. Das rubbernecken sichtseeren keepen das cotten-pickenen hans in das pockets muss; relaxen und watchen das blinkenlichten. Tk.VerboseUI - This interface (formerly known as Tk.TkUI) is a graphical - interface that presents a variable-sized window. In the - window, each currently-executing thread has a section - where its name and current status are displayed. This - interface is best suited to people running on slower con- + This interface (formerly known as Tk.TkUI) is a graphical + interface that presents a variable-sized window. In the + window, each currently-executing thread has a section + where its name and current status are displayed. This + interface is best suited to people running on slower con- nections, as you get a lot of detail, but for fast connec- - tions, the detail may go by too quickly to be useful. - People with fast connections may wish to use Tk.Blinken- + tions, the detail may go by too quickly to be useful. + People with fast connections may wish to use Tk.Blinken- lights instead. TTY.TTYUI This interface is the default for people running in termi- - nals. It prints out basic status messages, has an inter- - ruptible timer like the graphical interfaces do, and is + nals. It prints out basic status messages, has an inter- + ruptible timer like the graphical interfaces do, and is generally friendly to use on a console or xterm. Noninteractive.Basic - This interface is designed for situations where + This interface is designed for situations where OfflineIMAP will be run non-attended and the status of its execution will be logged. You might use it, for instance, - to have the system run automatically and e-mail you the - results of the synchronization. This user interface is - not capable of reading a password from the keyboard; - account passwords must be specified using one of the con- + to have the system run automatically and e-mail you the + results of the synchronization. This user interface is + not capable of reading a password from the keyboard; + account passwords must be specified using one of the con- figuration file options. Noninteractive.Quiet - This interface is designed for non-attended running in - situations where normal status messages are not desired. + This interface is designed for non-attended running in + situations where normal status messages are not desired. It will output nothing except errors and serious warnings. - Like Noninteractive.Basic, this user interface is not - capable of reading a password from the keyboard; account + Like Noninteractive.Basic, this user interface is not + capable of reading a password from the keyboard; account passwords must be specified using one of the configuration file options. EXAMPLES - Here is an example configuration for a particularly com- + Here is an example configuration for a particularly com- plex situation; more examples will be added later. MULTIPLE ACCOUNTS WITH MUTT - This example shows you how to set up OfflineIMAP to syn- + This example shows you how to set up OfflineIMAP to syn- chronize multiple accounts with the mutt mail reader. Start by creating a directory to hold your folders: @@ -349,8 +357,8 @@ EXAMPLES In your ~/.offlineimaprc, specify this: accounts = Personal, Work - Make sure that you have both a [Personal] and a [Work] - section, with different localfolder pathnames and enable + Make sure that you have both a [Personal] and a [Work] + section, with different localfolder pathnames and enable [mbnames]. In each account section, do something like this: @@ -367,13 +375,13 @@ 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- + 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 + 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] @@ -400,49 +408,49 @@ ERRORS 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? @@ -453,96 +461,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 fea- + ture, 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" @@ -560,19 +568,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 @@ -580,49 +588,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/. The Web - site also lists all current bugs, where you can check + 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. @@ -632,9 +640,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 @@ -645,7 +653,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/version.py b/offlineimap/head/offlineimap/version.py index 9c5d426..47a7958 100644 --- a/offlineimap/head/offlineimap/version.py +++ b/offlineimap/head/offlineimap/version.py @@ -1,8 +1,8 @@ productname = 'OfflineIMAP' versionstr = "3.2.2" -revno = long('$Rev: 215 $'[6:-2]) +revno = long('$Rev: 221 $'[6:-2]) revstr = "Rev %d" % revno -datestr = '$Date: 2002-08-07 20:28:34 -0500 (Wed, 07 Aug 2002) $' +datestr = '$Date: 2002-08-08 10:21:56 -0500 (Thu, 08 Aug 2002) $' versionlist = versionstr.split(".") @@ -41,67 +41,71 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA""" cmdhelp = """ offlineimap [ -1 ] [ -P profiledir ] [ -a accountlist ] [ - -c configfile ] [ -d ] [ -o ] [ -u interface ] + -c configfile ] [ -d debugtype[,debugtype...] ] [ -o ] [ + -u interface ] offlineimap -h | --help - -1 Disable all multithreading operations and use + -1 Disable all multithreading operations and use solely a single-thread sync. This effectively sets the maxsyncaccounts and all maxconnections configu- ration file variables to 1. -P profiledir - Sets OfflineIMAP into profile mode. The program + Sets OfflineIMAP into profile mode. The program will create profiledir (it must not already exist). As it runs, Python profiling information about each - thread is logged into profiledir. Please note: - This option is present for debugging and optimiza- + thread is logged into profiledir. Please note: + This option is present for debugging and optimiza- tion only, and should NOT be used unless you have a - specific reason to do so. It will significantly - slow program performance, may reduce reliability, - and can generate huge amounts of data. You must + specific reason to do so. It will significantly + slow program performance, may reduce reliability, + and can generate huge amounts of data. You must use the -1 option when you use -P. -a accountlist - Overrides the accounts section in the config file. - Lets you specify a particular account or set of - accounts to sync without having to edit the config + Overrides the accounts section in the config file. + Lets you specify a particular account or set of + accounts to sync without having to edit the config file. You might use this to exclude certain - accounts, or to sync some accounts that you nor- + accounts, or to sync some accounts that you nor- mally prefer not to. -c configfile - Specifies a configuration file to use in lieu of + Specifies a configuration file to use in lieu of the default, ~/.offlineimaprc. - -d Enables IMAP protocol stream and parsing debugging. - This is useful if you are trying to track down a - malfunction or figure out what is going on under - the hood. I suggest that you use this with -1 in - order to make the results more sensible. Note that - this output will contain full IMAP protocol in - plain text, including passwords, so take care to - remove that from the debugging output before send- - ing it to anyone else. + -d debugtype[,debugtype...] + Enables debugging for OfflineIMAP. This is useful + if you are trying to track down a malfunction or + figure out what is going on under the hood. I sug- + gest that you use this with -1 in order to make the + results more sensible. - -o Run only once, ignoring any autorefresh setting in + -d now requires one or more debugtypes, separated + by commas. These define what exactly will be + debugged, and so far include two options: imap and + maildir. The imap option will enable IMAP protocol + stream and parsing debugging. Note that the output + may contain passwords, so take care to remove that + from the debugging output before sending it to any- + one else. The maildir option will enable debugging + for certain Maildir operations. + + -o Run only once, ignoring any autorefresh setting in the config file. -h, --help Show summary of options. -u interface - Specifies an alternative user interface module to - use. This overrides the default specified in the - configuration file. The UI specified with -u will - be forced to be used, even if its isuable() method - states that it cannot be. Use this option with - care. + Specifies an alternative user interface module to + use. This overrides the default specified in the + configuration file. The UI specified with -u will + be forced to be used, even if its isuable() method + states that it cannot be. Use this option with + care. The pre-defined options are listed in the + USER INTERFACES section. - The pre-defined options are Tk.TKUI (a graphical - interface), TTY.TTYUI (a text-mode interface), Non- - interactive.Basic (a non-interactive mode suitable - for cronning), and Noninteractive.Quiet (a mode - that generates no output except for errors). """