tobias/docker-offlineimap
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

/offlineimap/head: changeset 158

Browse Source 
Added UW IMAPD example from docwhat@gerf.org
This commit is contained in:
jgoerzen 2002-07-22 06:56:21 +01:00
parent de9ea5c05c
commit 39060259d0
6 changed files with 496 additions and 343 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
offlineimap/head/debian/changelog
View File

@ -3,6 +3,7 @@ offlineimap (3.0.4) unstable; urgency=low
* When uploading messages from a Maildir, now convert \r\n to \n in case
the message is stored weirdly. That way, everything is uniform.
Fixes [complete.org #11].
* Manual: added UW IMAPD example with references from docwhat@gerf.org.
-- John Goerzen <jgoerzen@complete.org> Sun, 21 Jul 2002 16:09:42 -0500

48
offlineimap/head/manual.html
View File

@ -25,7 +25,7 @@
<hr>
<!-- Creator : groff version 1.17.2 -->
<!-- CreationDate: Sun Jul 21 15:46:17 2002 -->
<!-- CreationDate: Sun Jul 21 19:55:27 2002 -->
<a name="NAME"></a>
<h2>NAME</h2>
<table width="100%" border=0 rules="none" frame="void"
@ -487,6 +487,48 @@ set spoolfile=+Personal/INBOX</b></td></table>
<tr valign="top" align="left">
<td width="10%"></td><td width="90%">
That's it!</td></table>
<table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="4%"></td><td width="96%">
<b>UW-IMAPD AND REFERENCES</b></td></table>
<table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="10%"></td><td width="90%">
Some users with a UW-IMAPD server need to use
<b>OfflineIMAP's</b> &quot;reference&quot; feature to get at
their mailboxes, specifying a reference of
&quot;~/Mail&quot; or &quot;#mh/&quot; 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.</td></table>
<table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="10%"></td><td width="90%">
<b>[Gerf]<br>
localfolders = ~/Mail<br>
remotehost = gerf.org<br>
ssl = yes<br>
remoteuser = docwhat<br>
reference = Mail<br>
# Trims off the preceeding Mail on all the folder names.<br>
nametrans = lambda foldername: \<br>
re.sub('^Mail/', '', foldername)<br>
# Yeah, you have to mention the Mail dir, even though it<br>
# would seem intuitive that reference would trim it.<br>
folderfilter = lambda foldername: foldername in [<br>
'Mail/INBOX',<br>
'Mail/list/zaurus-general',<br>
'Mail/list/zaurus-dev',<br>
]<br>
maxconnections = 1<br>
holdconnectionopen = no</b></td></table>
<a name="ERRORS"></a>
<h2>ERRORS</h2>
@ -923,7 +965,9 @@ offlineimap@complete.org.</td></table>
Reports of bugs should be sent via e-mail to the
<b>OfflineIMAP</b> bug-tracking system (BTS) at
offlineimap@bugs.complete.org or submitted on-line using the
Web interface at http://bugs.complete.org/.</td></table>
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.</td></table>
<a name="COPYRIGHT"></a>
<h2>COPYRIGHT</h2>

BIN
offlineimap/head/manual.pdf
View File

Binary file not shown.

508
offlineimap/head/manual.ps
View File

@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.17.2
%%CreationDate: Sun Jul 21 15:46:14 2002
%%CreationDate: Sun Jul 21 19:55:24 2002
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
@ -452,288 +452,318 @@ E F0(Add these lines to your)108 350.4 Q F2(~/.muttr)2.5 E(c:)-.37 E F1
(email@w)-.18 E(ork.com")-.1 E(set mbox_type=Maildir)108 398.4 Q(set f)
108 410.4 Q(older=$HOME/Mail)-.25 E(set spool\214le=+P)108 422.4 Q
(ersonal/INBO)-.2 E(X)-.4 E F0(That')108 439.2 Q 2.5(si)-.55 G(t!)-2.5 E
F3(ERR)72 456 Q(ORS)-.329 E F0(If you get one of some frequently-encoun\
tered or confusing errors, please check this section.)108 468 Q F1
(UID v)87 484.8 Q(alidity pr)-.1 E(oblem f)-.18 E(or f)-.25 E(older)-.25
E F0 1.637(IMAP serv)108 496.8 R 1.637
(ers use a unique ID \(UID\) to refer to a speci\214c message.)-.15 F
1.638(This number is guaranteed to be)6.637 F 1.11
(unique to a particular message FOREVER.)108 508.8 R 1.109
(No other message in the same folder will e)6.11 F -.15(ve)-.25 G 3.609
(rg).15 G 1.109(et the same)-3.609 F 2.873(UID. UIDs)108 520.8 R .373
(are an inte)2.873 F .373(gral part of Of)-.15 F(\215ineIMAP')-.25 E
2.873(ss)-.55 G .373(ynchronization scheme; the)-2.873 F 2.873(ya)-.15 G
.373(re used to match up mes-)-2.873 F
(sages on your computer to messages on the serv)108 532.8 Q(er)-.15 E(.)
-.55 E .108(Sometimes, the UIDs on the serv)108 549.6 R .108
(er might get reset.)-.15 F .108
(Usually this will happen if you delete and then recreate)5.108 F 3.742
(af)108 561.6 S(older)-3.742 E 6.242(.W)-.55 G 1.242
(hen you create a folder)-6.242 F 3.742(,t)-.4 G 1.242(he serv)-3.742 F
1.242(er will often start the UID back from 1.)-.15 F(But)6.243 E F1
(Of\215ineIMAP)3.743 E F0 .303(might still ha)108 573.6 R .603 -.15
(ve t)-.2 H .303(he UIDs from the pre).15 F .302
(vious folder by the same name stored.)-.25 F F1(Of\215ineIMAP)5.302 E
F0 .302(will detect this)2.802 F(condition and skip the folder)108 585.6
Q 5(.T)-.55 G(his is GOOD, because it pre)-5 E -.15(ve)-.25 G
(nts data loss.).15 E -1.1(Yo)108 602.4 S 2.826(uc)1.1 G .326
(an \214x it by remo)-2.826 F .327
(ving your local folder and cache data.)-.15 F -.15(Fo)5.327 G 2.827(ri)
.15 G .327(nstance, if your folders are under)-2.827 F F2(~/F)2.827 E
(old-)-1.05 E(er)108 614.4 Q(s)-.1 E F0
(and the folder with the problem is INBO)2.5 E(X, you')-.4 E 2.5(dt)-.5
G(ype this:)-2.5 E F1(rm -r ~/F)108 631.2 Q(olders/INBO)-.25 E(X)-.4 E
(rm ~/.of\215ineimap/AccountName/INBO)108 643.2 Q(X)-.4 E F0
(\(replacing AccountName with the account name as speci\214ed in)108 660
Q F2(~/.of)2.5 E(\215ineimapr)-.18 E(c\))-.37 E F0(Ne)108 676.8 Q .802
(xt time you run)-.15 F F1(Of\215ineIMAP)3.302 E(,)-.92 E F0 .802
(it will re-do)3.302 F .802(wnload the folder with the ne)-.25 F 3.302
(wU)-.25 G 3.301(IDs. Note)-3.302 F .801(that the proce-)3.301 F
(dure speci\214ed abo)108 688.8 Q .3 -.15(ve w)-.15 H(ill lose an).15 E
2.5(yl)-.15 G(ocal changes made to the folder)-2.5 E(.)-.55 E .522
(Some IMAP serv)108 705.6 R .522(ers are brok)-.15 F .522
(en and do not support UIDs properly)-.1 F 5.522(.I)-.65 G 3.022(fy)
-5.522 G .522(ou continue to get this error for all)-3.022 F .067
(your folders e)108 717.6 R -.15(ve)-.25 G 2.566(na).15 G .066
(fter performing the abo)-2.566 F .366 -.15(ve p)-.15 H .066
(rocedure, it is lik).15 F .066(ely that your IMAP serv)-.1 F .066(er f)
-.15 F .066(alls into this cat-)-.1 F -.15(eg)108 729.6 S(ory).15 E(.)
-.65 E F1(Of\215ineIMAP)5.983 E F0 .984(is incompatible with such serv)
3.483 F 3.484(ers. Using)-.15 F F1(Of\215ineIMAP)3.484 E F0 .984
(with them will not destro)3.484 F(y)-.1 E(John Goerzen)72 768 Q
F1(UW)87 456 Q(-IMAPD AND REFERENCES)-.37 E F0 .493
(Some users with a UW)108 468 R .493(-IMAPD serv)-.65 F .493
(er need to use)-.15 F F1(Of\215ineIMAP')2.993 E(s)-.37 E F0 .493
("reference" feature to get at their mail-)2.993 F(box)108 480 Q .46(es\
, specifying a reference of "~/Mail" or "#mh/" depending on the con\214\
guration.)-.15 F .46(The belo)5.46 F 2.96(wc)-.25 G(on\214gura-)-2.96 E
.465(tion from docwhat@gerf.or)108 492 R 2.965(gs)-.18 G(ho)-2.965 E
.465(ws using a reference of Mail, a nametrans that strips the leading \
Mail/ of)-.25 F(f)-.25 E(incoming folder names, and a folder\214lter th\
at limits the folders synced to just three.)108 504 Q F1([Gerf])108
520.8 Q(localf)108 532.8 Q(olders = ~/Mail)-.25 E -.18(re)108 544.8 S
(motehost = gerf).18 E(.or)-.15 E(g)-.1 E(ssl = y)108 556.8 Q(es)-.1 E
-.18(re)108 568.8 S(moteuser = docwhat).18 E -.18(re)108 580.8 S(fer).18
E(ence = Mail)-.18 E 2.5(#T)108 592.8 S(rims off the pr)-3.24 E
(eceeding Mail on all the f)-.18 E(older names.)-.25 E
(nametrans = lambda f)108 604.8 Q(older)-.25 E(name: \\)-.15 E -.18(re)
138 616.8 S(.sub\('^Mail/', ').18 E(', f)-.63 E(older)-.25 E(name\))-.15
E 2.5(#Y)108 628.8 S(eah, y)-3.61 E(ou ha)-.25 E .2 -.1(ve t)-.25 H 2.5
(om).1 G(ention the Mail dir)-2.5 E 2.5(,e)-.92 G -.1(ve)-2.65 G 2.5(nt)
.1 G(hough it)-2.5 E 2.5(#w)108 640.8 S(ould seem intuiti)-2.6 E .2 -.1
(ve t)-.1 H(hat r).1 E(efer)-.18 E(ence w)-.18 E(ould trim it.)-.1 E
-.25(fo)108 652.8 S(lder\214lter = lambda f).25 E(older)-.25 E(name: f)
-.15 E(older)-.25 E(name in [)-.15 E('Mail/INBO)125.5 664.8 Q(X',)-.4 E
('Mail/list/zaurus-general',)125.5 676.8 Q('Mail/list/zaurus-de)125.5
688.8 Q(v',)-.15 E(])125.5 700.8 Q(maxconnections = 1)108 712.8 Q
(holdconnectionopen = no)108 724.8 Q F0(John Goerzen)72 768 Q
(July 12, 2002)151.655 E(3)201.915 E EP
%%Page: 4 4
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R
(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E(an)108 84 Q 2.77
(ym)-.15 G .27(ail, b)-2.77 F .27
(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10.95
/Times-Bold@0 SF(ERR)72 84 Q(ORS)-.329 E F0(If you get one of some freq\
uently-encountered or confusing errors, please check this section.)108
96 Q/F2 10/Times-Bold@0 SF(UID v)87 112.8 Q(alidity pr)-.1 E(oblem f)
-.18 E(or f)-.25 E(older)-.25 E F0 1.638(IMAP serv)108 124.8 R 1.637
(ers use a unique ID \(UID\) to refer to a speci\214c message.)-.15 F
1.637(This number is guaranteed to be)6.637 F 1.109
(unique to a particular message FOREVER.)108 136.8 R 1.109
(No other message in the same folder will e)6.109 F -.15(ve)-.25 G 3.61
(rg).15 G 1.11(et the same)-3.61 F 2.874(UID. UIDs)108 148.8 R .373
(are an inte)2.874 F .373(gral part of Of)-.15 F(\215ineIMAP')-.25 E
2.873(ss)-.55 G .373(ynchronization scheme; the)-2.873 F 2.873(ya)-.15 G
.373(re used to match up mes-)-2.873 F
(sages on your computer to messages on the serv)108 160.8 Q(er)-.15 E(.)
-.55 E .107(Sometimes, the UIDs on the serv)108 177.6 R .108
(er might get reset.)-.15 F .108
(Usually this will happen if you delete and then recreate)5.108 F 3.743
(af)108 189.6 S(older)-3.743 E 6.243(.W)-.55 G 1.243
(hen you create a folder)-6.243 F 3.742(,t)-.4 G 1.242(he serv)-3.742 F
1.242(er will often start the UID back from 1.)-.15 F(But)6.242 E F2
(Of\215ineIMAP)3.742 E F0 .302(might still ha)108 201.6 R .602 -.15
(ve t)-.2 H .302(he UIDs from the pre).15 F .302
(vious folder by the same name stored.)-.25 F F2(Of\215ineIMAP)5.303 E
F0 .303(will detect this)2.803 F(condition and skip the folder)108 213.6
Q 5(.T)-.55 G(his is GOOD, because it pre)-5 E -.15(ve)-.25 G
(nts data loss.).15 E -1.1(Yo)108 230.4 S 2.827(uc)1.1 G .327
(an \214x it by remo)-2.827 F .327
(ving your local folder and cache data.)-.15 F -.15(Fo)5.327 G 2.827(ri)
.15 G .327(nstance, if your folders are under)-2.827 F/F3 10
/Times-Italic@0 SF(~/F)2.826 E(old-)-1.05 E(er)108 242.4 Q(s)-.1 E F0
(and the folder with the problem is INBO)2.5 E(X, you')-.4 E 2.5(dt)-.5
G(ype this:)-2.5 E F2(rm -r ~/F)108 259.2 Q(olders/INBO)-.25 E(X)-.4 E
(rm ~/.of\215ineimap/AccountName/INBO)108 271.2 Q(X)-.4 E F0
(\(replacing AccountName with the account name as speci\214ed in)108 288
Q F3(~/.of)2.5 E(\215ineimapr)-.18 E(c\))-.37 E F0(Ne)108 304.8 Q .801
(xt time you run)-.15 F F2(Of\215ineIMAP)3.301 E(,)-.92 E F0 .802
(it will re-do)3.302 F .802(wnload the folder with the ne)-.25 F 3.302
(wU)-.25 G 3.302(IDs. Note)-3.302 F .802(that the proce-)3.302 F
(dure speci\214ed abo)108 316.8 Q .3 -.15(ve w)-.15 H(ill lose an).15 E
2.5(yl)-.15 G(ocal changes made to the folder)-2.5 E(.)-.55 E .523
(Some IMAP serv)108 333.6 R .522(ers are brok)-.15 F .522
(en and do not support UIDs properly)-.1 F 5.522(.I)-.65 G 3.022(fy)
-5.522 G .522(ou continue to get this error for all)-3.022 F .066
(your folders e)108 345.6 R -.15(ve)-.25 G 2.566(na).15 G .066
(fter performing the abo)-2.566 F .366 -.15(ve p)-.15 H .066
(rocedure, it is lik).15 F .066(ely that your IMAP serv)-.1 F .066(er f)
-.15 F .067(alls into this cat-)-.1 F -.15(eg)108 357.6 S(ory).15 E(.)
-.65 E F2(Of\215ineIMAP)5.984 E F0 .984(is incompatible with such serv)
3.484 F 3.484(ers. Using)-.15 F F2(Of\215ineIMAP)3.484 E F0 .984
(with them will not destro)3.484 F(y)-.1 E(an)108 369.6 Q 2.769(ym)-.15
G .269(ail, b)-2.769 F .269
(ut at the same time, it will not actually synchronize it either)-.2 F
5.269(.\()-.55 G(Of)-5.269 E .269(\215ineIMAP will detect this con-)-.25
F(dition and abort prior to synchronization\))108 96 Q/F1 10.95
/Times-Bold@0 SF -.438(OT)72 124.8 S(HER FREQ).438 E(UENTL)-.11 E 2.738
(YA)-1.007 G(SKED Q)-2.738 E(UESTIONS)-.11 E F0 .683
(There are some other F)108 136.8 R -.55(AQ)-.74 G 3.184(st).55 G .684
5.27(.\()-.55 G(Of)-5.27 E .27(\215ineIMAP will detect this con-)-.25 F
(dition and abort prior to synchronization\))108 381.6 Q F1 -.438(OT)72
410.4 S(HER FREQ).438 E(UENTL)-.11 E 2.738(YA)-1.007 G(SKED Q)-2.738 E
(UESTIONS)-.11 E F0 .684(There are some other F)108 422.4 R -.55(AQ)-.74
G 3.184(st).55 G .684
(hat might not \214t into another section of this document, and the)
-3.184 F 3.184(ya)-.15 G .684(re enumer)-3.184 F(-)-.2 E(ated here.)108
148.8 Q/F2 10/Times-Bold@0 SF(What platf)108 165.6 Q
(orms does Of\215ineIMAP run on?)-.25 E F0(It should run on most platfo\
rms supported by Python, which are quite a fe)144 177.6 Q -.65(w.)-.25 G
F2 .689(I'm using Mutt. Other IMAP sync pr)108 194.4 R .689(ograms r)
-.18 F(equir)-.18 E 3.189(em)-.18 G 3.189(et)-3.189 G 3.189(ou)-3.189 G
.689(se set maildir_trash=y)-3.189 F .688(es . Do I need to)-.1 F
(do that with Of\215ineIMAP?)108 206.4 Q F0(No.)144 218.4 Q F2
-3.184 F 3.183(ya)-.15 G .683(re enumer)-3.183 F(-)-.2 E(ated here.)108
434.4 Q F2(What platf)108 451.2 Q(orms does Of\215ineIMAP run on?)-.25 E
F0(It should run on most platforms supported by Python, which are quite\
a fe)144 463.2 Q -.65(w.)-.25 G F2 .688
(I'm using Mutt. Other IMAP sync pr)108 480 R .689(ograms r)-.18 F
(equir)-.18 E 3.189(em)-.18 G 3.189(et)-3.189 G 3.189(ou)-3.189 G .689
(se set maildir_trash=y)-3.189 F .689(es . Do I need to)-.1 F
(do that with Of\215ineIMAP?)108 492 Q F0(No.)144 504 Q F2
(Of\215ineIMAP)7.27 E F0 2.27
(is smart enough to \214gure out message deletion without this e)4.77 F
2.27(xtra crutch.)-.15 F -1.1(Yo)144 230.4 S(u')1.1 E
2.27(xtra crutch.)-.15 F -1.1(Yo)144 516 S(u')1.1 E
(ll get the best results if you don')-.1 E 2.5(tu)-.18 G
(se this setting, in f)-2.5 E(act.)-.1 E F2(Ho)108 247.2 Q 2.5(wd)-.1 G
(se this setting, in f)-2.5 E(act.)-.1 E F2(Ho)108 532.8 Q 2.5(wd)-.1 G
2.5(oIs)-2.5 G(pecify the names of my f)-2.5 E(olders?)-.25 E F0 -1.1
(Yo)144 259.2 S 3.55(ud)1.1 G 3.55(on)-3.55 G 1.05(ot need to.)-3.55 F
(Yo)144 544.8 S 3.55(ud)1.1 G 3.55(on)-3.55 G 1.05(ot need to.)-3.55 F
F2(Of\215ineIMAP)6.05 E F0 1.05
(is smart enough to automatically \214gure out what folders are)3.55 F
.679(present on the IMAP serv)144 271.2 R .679(er and synchronize them.)
-.15 F -1.1(Yo)5.679 G 3.178(uc)1.1 G .678(an use the)-3.178 F F2 -.25
(fo)3.178 G(lder\214lter).25 E F0(and)3.178 E F2 -.25(fo)3.178 G
.678(present on the IMAP serv)144 556.8 R .678(er and synchronize them.)
-.15 F -1.1(Yo)5.679 G 3.179(uc)1.1 G .679(an use the)-3.179 F F2 -.25
(fo)3.179 G(lder\214lter).25 E F0(and)3.179 E F2 -.25(fo)3.179 G
(ldertrans).25 E F0(con\214guration \214le options to request certain f\
olders and rename them as the)144 283.2 Q 2.5(yc)-.15 G
(ome in if you lik)-2.5 E(e.)-.1 E F2(Ho)108 300 Q 2.5(wc)-.1 G(an I pr)
-2.5 E -2.3 -.15(ev e)-.18 H(nt certain f).15 E(olders fr)-.25 E
(om being synced?)-.18 E F0(Use the)144 312 Q F2 -.25(fo)2.5 G
olders and rename them as the)144 568.8 Q 2.5(yc)-.15 G
(ome in if you lik)-2.5 E(e.)-.1 E F2(Ho)108 585.6 Q 2.5(wc)-.1 G
(an I pr)-2.5 E -2.3 -.15(ev e)-.18 H(nt certain f).15 E(olders fr)-.25
E(om being synced?)-.18 E F0(Use the)144 597.6 Q F2 -.25(fo)2.5 G
(lder\214lter).25 E F0(option in the con\214guration \214le.)2.5 E F2
(Ho)108 328.8 Q 2.5(wc)-.1 G(an I add or delete a f)-2.5 E(older?)-.25 E
(Of\215ineIMAP)144 340.8 Q F0 .503(does not currently pro)3.003 F .504
(vide this feature, b)-.15 F .504(ut if you create a ne)-.2 F 3.004(wf)
-.25 G .504(older on the IMAP)-3.004 F(serv)144 352.8 Q(er)-.15 E 2.5
(Ho)108 614.4 Q 2.5(wc)-.1 G(an I add or delete a f)-2.5 E(older?)-.25 E
(Of\215ineIMAP)144 626.4 Q F0 .504(does not currently pro)3.004 F .504
(vide this feature, b)-.15 F .504(ut if you create a ne)-.2 F 3.003(wf)
-.25 G .503(older on the IMAP)-3.003 F(serv)144 638.4 Q(er)-.15 E 2.5
(,i)-.4 G 2.5(tw)-2.5 G(ill be created locally automatically)-2.5 E(.)
-.65 E F2(Ar)108 369.6 Q 2.5(et)-.18 G(her)-2.5 E 2.5(ea)-.18 G
-.65 E F2(Ar)108 655.2 Q 2.5(et)-.18 G(her)-2.5 E 2.5(ea)-.18 G
(ny other war)-2.5 E(nings that I should be awar)-.15 E 2.5(eo)-.18 G
(f?)-2.5 E F0 -1(Ye)144 381.6 S(s; see the NO)1 E(TES section belo)-.4 E
-.65(w.)-.25 G F2(What is the mailbox name r)108 398.4 Q
(f?)-2.5 E F0 -1(Ye)144 667.2 S(s; see the NO)1 E(TES section belo)-.4 E
-.65(w.)-.25 G F2(What is the mailbox name r)108 684 Q
(ecorder \(mbnames\) f)-.18 E(or?)-.25 E F0 1.019(The Mutt mail reader \
is not capable of automatically determining the names of your mailbox)
144 410.4 R(es.)-.15 E(Of)144 422.4 Q .265
(\215ineIMAP can help it \(or man)-.25 F 2.765(yo)-.15 G .265
144 696 R(es.)-.15 E(Of)144 708 Q .266(\215ineIMAP can help it \(or man)
-.25 F 2.765(yo)-.15 G .265
(ther\) programs out be writing these names out in a format you)-2.765 F
(specify)144 434.4 Q 5(.S)-.65 G(ee the e)-5 E(xample of)-.15 E
(\215ineimap.conf \214le for details.)-.25 E F2(Can I synchr)108 451.2 Q
(onize multiple accounts with Of\215ineIMAP?)-.18 E F0 3.345(Sure. Just)
144 463.2 R .845(name them all in the accounts line in the general sect\
ion of the con\214g \214le, and add a)3.345 F(per)144 475.2 Q
(-account section for each one.)-.2 E F2
(Does Of\215ineIMAP support POP?)108 492 Q F0 4.076(No. POP)144 504 R
1.576(is not rob)4.076 F 1.576(ust enough to do a completely reliable m\
ulti-machine synchronization lik)-.2 F(e)-.1 E(Of)144 516 Q
(\215ineIMAP can do.)-.25 E(Of)5 E(\215ineIMAP will not support it.)-.25
E F2(Do y)108 532.8 Q(ou support mailbox f)-.25 E
(ormats other than Maildir?)-.25 E F0 .41(Not at present.)144 544.8 R
.41(There is no technical reason not to; just no demand yet.)5.41 F .409
(Maildir is a superior for)5.409 F(-)-.2 E(mat an)144 556.8 Q(yw)-.15 E
(ay)-.1 E(.)-.65 E F2([technical] Wh)108 573.6 Q 2.5(ya)-.15 G .36 -.18
(re y)-2.5 H(our Maildir message \214lenames so huge?)-.07 E
(Of\215ineIMAP)144 585.6 Q F0 .958(has tw)3.458 F 3.458(or)-.1 G(ele)
-3.458 E -.25(va)-.25 G .958(nt principles: 1\) ne).25 F -.15(ve)-.25 G
3.459(rm).15 G .959(odifying your messages in an)-3.459 F 3.459(yw)-.15
G .959(ay and 2\))-3.559 F .493
(ensuring 100% reliable synchronizations.)144 597.6 R .493
(In order to do a reliable sync,)5.493 F F2(Of\215ineIMAP)2.993 E F0
.493(must ha)2.993 F -.15(ve)-.2 G 3.094(aw)144 609.6 S .594
(ay to uniquely identify each e-mail.)-3.194 F .595
(Three pieces of information are required to do this: your)5.594 F .538
(account name, the folder name, and the message UID.)144 621.6 R .537
(The account name can be calculated from)5.537 F 1.081
(the path in which your messages are.)144 633.6 R 1.082
(The folder name can usually be as well, B)6.082 F 1.082(UT some mail)
-.1 F(clients mo)144 645.6 Q .3 -.15(ve m)-.15 H
(essages between folders by simply mo).15 E(ving the \214le, lea)-.15 E
(ving the name intact.)-.2 E(So,)144 662.4 Q F2(Of\215ineIMAP)3.2 E F0
.7(must store both a UID folder ID.)3.2 F .7
(The folder ID is necessary so)5.7 F F2(Of\215ineIMAP)3.2 E F0 .455
(can detect a message mo)144 674.4 R -.15(ve)-.15 G 2.955(dt).15 G 2.955
(oad)-2.955 G(if)-2.955 E .455(ferent folder)-.25 F(.)-.55 E F2
(Of\215ineIMAP)5.455 E F0 .456(stores the UID \(U= number\) and)2.955 F
(an md5sum of the foldername \(FMD5= number\) to f)144 686.4 Q
(acilitate this.)-.1 E F2(What is the speed of Of\215ineIMAP')108 703.2
Q 2.5(ss)-.37 G(ync?)-2.5 E(Of\215ineIMAP)144 715.2 Q F0 -.15(ve)2.891 G
.391(rsions 2.0 and abo).15 F .691 -.15(ve c)-.15 H .391
(ontain a multithreaded system.).15 F 2.891(Ag)5.391 G .39(ood w)-2.891
F .39(ay to e)-.1 F(xperiment)-.15 E(is by setting maxsyncaccounts to 3\
and maxconnections to 3 in each account clause.)144 727.2 Q
(John Goerzen)72 768 Q(July 12, 2002)151.655 E(4)201.915 E EP
(specify)144 720 Q 5(.S)-.65 G(ee the e)-5 E(xample of)-.15 E
(\215ineimap.conf \214le for details.)-.25 E(John Goerzen)72 768 Q
(July 12, 2002)151.655 E(4)201.915 E EP
%%Page: 5 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R
(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E .381(This lets Of)
144 84 R .381(\215ineIMAP open up multiple connections simultaneously)
-.25 F 5.382(.T)-.65 G .382(hat will let it process mul-)-5.382 F
(tiple folders and messages at once.)144 96 Q
(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10/Times-Bold@0
SF(Can I synchr)108 84 Q(onize multiple accounts with Of\215ineIMAP?)
-.18 E F0 3.344(Sure. Just)144 96 R .845(name them all in the accounts \
line in the general section of the con\214g \214le, and add a)3.344 F
(per)144 108 Q(-account section for each one.)-.2 E F1
(Does Of\215ineIMAP support POP?)108 124.8 Q F0 4.077(No. POP)144 136.8
R 1.576(is not rob)4.077 F 1.576(ust enough to do a completely reliable\
multi-machine synchronization lik)-.2 F(e)-.1 E(Of)144 148.8 Q
(\215ineIMAP can do.)-.25 E(Of)5 E(\215ineIMAP will not support it.)-.25
E F1(Do y)108 165.6 Q(ou support mailbox f)-.25 E
(ormats other than Maildir?)-.25 E F0 .409(Not at present.)144 177.6 R
.409(There is no technical reason not to; just no demand yet.)5.409 F
.41(Maildir is a superior for)5.41 F(-)-.2 E(mat an)144 189.6 Q(yw)-.15
E(ay)-.1 E(.)-.65 E F1([technical] Wh)108 206.4 Q 2.5(ya)-.15 G .36 -.18
(re y)-2.5 H(our Maildir message \214lenames so huge?)-.07 E
(Of\215ineIMAP)144 218.4 Q F0 .959(has tw)3.459 F 3.459(or)-.1 G(ele)
-3.459 E -.25(va)-.25 G .959(nt principles: 1\) ne).25 F -.15(ve)-.25 G
3.459(rm).15 G .958(odifying your messages in an)-3.459 F 3.458(yw)-.15
G .958(ay and 2\))-3.558 F .493
(ensuring 100% reliable synchronizations.)144 230.4 R .493
(In order to do a reliable sync,)5.493 F F1(Of\215ineIMAP)2.993 E F0
.494(must ha)2.993 F -.15(ve)-.2 G 3.095(aw)144 242.4 S .595
(ay to uniquely identify each e-mail.)-3.195 F .594
(Three pieces of information are required to do this: your)5.594 F .537
(account name, the folder name, and the message UID.)144 254.4 R .538
(The account name can be calculated from)5.537 F 1.082
(the path in which your messages are.)144 266.4 R 1.082
(The folder name can usually be as well, B)6.082 F 1.081(UT some mail)
-.1 F(clients mo)144 278.4 Q .3 -.15(ve m)-.15 H
(essages between folders by simply mo).15 E(ving the \214le, lea)-.15 E
(ving the name intact.)-.2 E(So,)144 295.2 Q F1(Of\215ineIMAP)3.2 E F0
.7(must store both a UID folder ID.)3.2 F .7
(The folder ID is necessary so)5.7 F F1(Of\215ineIMAP)3.2 E F0 .456
(can detect a message mo)144 307.2 R -.15(ve)-.15 G 2.956(dt).15 G 2.955
(oad)-2.956 G(if)-2.955 E .455(ferent folder)-.25 F(.)-.55 E F1
(Of\215ineIMAP)5.455 E F0 .455(stores the UID \(U= number\) and)2.955 F
(an md5sum of the foldername \(FMD5= number\) to f)144 319.2 Q
(acilitate this.)-.1 E F1(What is the speed of Of\215ineIMAP')108 336 Q
2.5(ss)-.37 G(ync?)-2.5 E(Of\215ineIMAP)144 348 Q F0 -.15(ve)2.89 G .39
(rsions 2.0 and abo).15 F .691 -.15(ve c)-.15 H .391
(ontain a multithreaded system.).15 F 2.891(Ag)5.391 G .391(ood w)-2.891
F .391(ay to e)-.1 F(xperiment)-.15 E(is by setting maxsyncaccounts to \
3 and maxconnections to 3 in each account clause.)144 360 Q .382
(This lets Of)144 376.8 R .382
(\215ineIMAP open up multiple connections simultaneously)-.25 F 5.381
(.T)-.65 G .381(hat will let it process mul-)-5.381 F
(tiple folders and messages at once.)144 388.8 Q
(In most cases, this will increase performance of the sync.)5 E(Don')144
112.8 Q 3.104(ts)-.18 G .604(et the number too high.)-3.104 F .603
(If you do that, things might actually slo)5.604 F 3.103(wd)-.25 G -.25
(ow)-3.103 G 3.103(na).25 G 3.103(sy)-3.103 G .603(our link gets)-3.103
F 2.632(saturated. Also,)144 124.8 R .132(too man)2.632 F 2.632(yc)-.15
G .132(onnections can cause mail serv)-2.632 F .132(ers to ha)-.15 F
.433 -.15(ve ex)-.2 H(cessi).15 E .433 -.15(ve l)-.25 H 2.633
(oad. Administra-).15 F .507(tors might tak)144 136.8 R 3.007(eu)-.1 G
.507(nkindly to this, and the serv)-3.007 F .506(er might bog do)-.15 F
3.006(wn. There)-.25 F .506(are man)3.006 F 3.006(yv)-.15 G .506
(ariables in the)-3.256 F(optimal setting; e)144 148.8 Q
405.6 Q 3.103(ts)-.18 G .603(et the number too high.)-3.103 F .603
(If you do that, things might actually slo)5.603 F 3.104(wd)-.25 G -.25
(ow)-3.104 G 3.104(na).25 G 3.104(sy)-3.104 G .604(our link gets)-3.104
F 2.633(saturated. Also,)144 417.6 R .133(too man)2.633 F 2.633(yc)-.15
G .132(onnections can cause mail serv)-2.633 F .132(ers to ha)-.15 F
.432 -.15(ve ex)-.2 H(cessi).15 E .432 -.15(ve l)-.25 H 2.632
(oad. Administra-).15 F .506(tors might tak)144 429.6 R 3.006(eu)-.1 G
.506(nkindly to this, and the serv)-3.006 F .507(er might bog do)-.15 F
3.007(wn. There)-.25 F .507(are man)3.007 F 3.007(yv)-.15 G .507
(ariables in the)-3.257 F(optimal setting; e)144 441.6 Q
(xperimentation may help.)-.15 E
(An informal benchmark yields these results for my setup:)144 165.6 Q
(10 minutes with MacOS X Mail.app "manual cache")144 182.4 Q 2.5(5m)144
194.4 S(inutes with GNUS agent sync)-2.5 E(20 seconds with Of)144 206.4
Q(\215ineIMAP 1.x)-.25 E 2.5(9s)144 218.4 S(econds with Of)-2.5 E
(\215ineIMAP 2.x)-.25 E 2.5(3s)144 230.4 S(econds with Of)-2.5 E
(\215ineIMAP 3.x "cold start")-.25 E 2.5(2s)144 242.4 S(econds with Of)
-2.5 E(\215ineIMAP 3.x "held connection")-.25 E/F1 10.95/Times-Bold@0 SF
(CONFORMING T)72 259.2 Q(O)-.197 E F0 32.5<8349>108 271.2 S
(An informal benchmark yields these results for my setup:)144 458.4 Q
(10 minutes with MacOS X Mail.app "manual cache")144 475.2 Q 2.5(5m)144
487.2 S(inutes with GNUS agent sync)-2.5 E(20 seconds with Of)144 499.2
Q(\215ineIMAP 1.x)-.25 E 2.5(9s)144 511.2 S(econds with Of)-2.5 E
(\215ineIMAP 2.x)-.25 E 2.5(3s)144 523.2 S(econds with Of)-2.5 E
(\215ineIMAP 3.x "cold start")-.25 E 2.5(2s)144 535.2 S(econds with Of)
-2.5 E(\215ineIMAP 3.x "held connection")-.25 E/F2 10.95/Times-Bold@0 SF
(CONFORMING T)72 552 Q(O)-.197 E F0 32.5<8349>108 564 S
(nternet Message Access Protocol v)-32.5 E(ersion 4re)-.15 E
(v1 \(IMAP 4re)-.25 E(v1\) as speci\214ed in RFC2060)-.25 E 32.5<834d>
108 288 S 8.92(aildir as speci\214ed in http://www)-32.5 F(.qmail.or)
108 580.8 S 8.92(aildir as speci\214ed in http://www)-32.5 F(.qmail.or)
-.65 E(g/qmail-manual-html/man5/maildir)-.18 E 8.92(.html and)-.55 F
(http://cr)144 300 Q(.yp.to/proto/maildir)-.55 E(.html.)-.55 E 32.5
<8353>108 316.8 S
(http://cr)144 592.8 Q(.yp.to/proto/maildir)-.55 E(.html.)-.55 E 32.5
<8353>108 609.6 S
(tandard Python 2.2.1 as implemented on POSIX-compliant systems.)-32.5 E
F1(NO)72 333.6 Q(TES)-.438 E/F2 10/Times-Bold@0 SF
(DELETING LOCAL FOLDERS)87 345.6 Q(Of\215ineIMAP)108 357.6 Q F0 .533
(does a tw)3.033 F(o-w)-.1 E .533(ay synchronization.)-.1 F .532
(That is, if you mak)5.532 F 3.032(eac)-.1 G .532
(hange to the mail on the serv)-3.032 F(er)-.15 E 3.032(,i)-.4 G(t)
-3.032 E .896(will be propog)108 369.6 R .896(ated to your local cop)
-.05 F 2.197 -.65(y, a)-.1 H .897(nd vise-v).65 F 3.397(ersa. Some)-.15
F .897(people might think that it w)3.397 F .897(ould be wise to)-.1 F
1.59(just delete all their local mail folders periodically)108 381.6 R
6.59(.I)-.65 G 4.09(fy)-6.59 G 1.59(ou do this with Of)-4.09 F
(\215ineIMAP)-.25 E 4.09(,r)-1.11 G 1.59(emember to also)-4.09 F(remo)
108 393.6 Q 1.67 -.15(ve y)-.15 H 1.37(our local status cache \(~/.of)
.15 F 1.37(\215ineimap by def)-.25 F 3.87(ault\). Otherwise,)-.1 F(Of)
3.87 E 1.37(\215ineIMAP will tak)-.25 F 3.87(et)-.1 G 1.37(his as an)
-3.87 F .416(intentional deletion of man)108 405.6 R 2.916(ym)-.15 G
.416(essages and will interpret your action as requesting them to be de\
leted from)-2.916 F(the serv)108 417.6 Q(er as well.)-.15 E
(\(If you don')5 E 2.5(tu)-.18 G(nderstand this, don')-2.5 E 2.5(tw)-.18
G(orry; you probably w)-2.6 E(on')-.1 E 2.5(te)-.18 G
(ncounter this situation\))-2.5 E F2(COPYING MESSA)87 434.4 Q
(GES BETWEEN FOLDERS)-.55 E F0(Normally)108 446.4 Q 5.858(,w)-.65 G
3.358(hen you cop)-5.858 F -8.357 5.858(ya m)-.1 H 3.359
(essage between folders or add a ne)-5.858 F 5.859(wm)-.25 G 3.359
(essage to a folder locally)-5.859 F(,)-.65 E F2(Of\215ineIMAP)108 458.4
Q F0 .853(will just do the right thing.)3.353 F(Ho)5.853 E(we)-.25 E
-.15(ve)-.25 G 1.653 -.4(r, s).15 H .853(ometimes this can be trick).4 F
3.353(y-)-.15 G 3.353(-i)-3.353 G 3.353(fy)-3.353 G .853(our IMAP serv)
-3.353 F(er)-.15 E .29(does not pro)108 470.4 R .29
(vide the SEARCH command, or does not return something useful,)-.15 F F2
(Of\215ineIMAP)2.79 E F0 .29(cannot deter)2.79 F(-)-.2 E .174
(mine the ne)108 482.4 R 2.674(wU)-.25 G .174(ID of the message.)-2.674
F .173(So, in these rare instances, Of)5.173 F .173
(\215ineIMAP will upload the message to the)-.25 F .64(IMAP serv)108
494.4 R .64(er and delete it from your local folder)-.15 F 5.64(.T)-.55
G .64(hen, on your ne)-5.64 F .64(xt sync, the message will be re-do)
-.15 F(wn-)-.25 E 1.473(loaded with the proper UID.)108 506.4 R F2
(Of\215ineIMAP)6.473 E F0(mak)3.973 E 1.473(es sure that the message w)
-.1 F 1.472(as properly uploaded before)-.1 F
(deleting it, so there should be no risk of data loss.)108 518.4 Q F2
(MAILING LIST)87 535.2 Q F0(There is an Of)108 547.2 Q
(\215ineIMAP mailing list a)-.25 E -.25(va)-.2 G(ilable.).25 E 2.447 -.8
(To s)108 564 T .847(ubscribe, send the te).8 F .847
(xt "Subscribe" in the subject of a mail to of)-.15 F
(\215ineimap-request@complete.or)-.25 E 3.348(g. T)-.18 F(o)-.8 E
(post, send the message to of)108 576 Q(\215ineimap@complete.or)-.25 E
(g.)-.18 E F1 -.11(BU)72 592.8 S(GS).11 E F0 4.42(Reports of b)108 604.8
R 4.419(ugs should be sent via e-mail to the)-.2 F F2(Of\215ineIMAP)
6.919 E F0 -.2(bu)6.919 G 4.419(g-tracking system \(BTS\) at).2 F(of)108
616.8 Q(\215ineimap@b)-.25 E(ugs.complete.or)-.2 E 2.5(go)-.18 G 2.5(rs)
-2.5 G(ubmitted on-line using the W)-2.5 E(eb interf)-.8 E
(ace at http://b)-.1 E(ugs.complete.or)-.2 E(g/.)-.18 E F1(COPYRIGHT)72
633.6 Q F0(Of)108 645.6 Q(\215ineIMAP is Cop)-.25 E
(yright \(C\) 2002 John Goerzen.)-.1 E .286(This program is free softw)
108 662.4 R .286(are; you can redistrib)-.1 F .287
(ute it and/or modify it under the terms of the GNU General)-.2 F .766
(Public License as published by the Free Softw)108 674.4 R .766(are F)
-.1 F .766(oundation; either v)-.15 F .766
(ersion 2 of the License, or \(at your)-.15 F(option\) an)108 686.4 Q
2.5(yl)-.15 G(ater v)-2.5 E(ersion.)-.15 E .579(This program is distrib)
108 703.2 R .579(uted in the hope that it will be useful, b)-.2 F .58
(ut WITHOUT ANY W)-.2 F(ARRANTY)-1.2 E 3.08(;w)-.92 G(ithout)-3.08 E
-2.15 -.25(ev e)108 715.2 T 2.73(nt).25 G .23(he implied w)-2.73 F .229
(arranty of MERCHANT)-.1 F .229(ABILITY or FITNESS FOR A P)-.93 F(AR)
-.92 E .229(TICULAR PURPOSE.)-.6 F(See)5.229 E
(the GNU General Public License for more details.)108 727.2 Q
(John Goerzen)72 768 Q(July 12, 2002)151.655 E(5)201.915 E EP
F2(NO)72 626.4 Q(TES)-.438 E F1(DELETING LOCAL FOLDERS)87 638.4 Q
(Of\215ineIMAP)108 650.4 Q F0 .532(does a tw)3.032 F(o-w)-.1 E .532
(ay synchronization.)-.1 F .532(That is, if you mak)5.532 F 3.032(eac)
-.1 G .532(hange to the mail on the serv)-3.032 F(er)-.15 E 3.033(,i)-.4
G(t)-3.033 E .897(will be propog)108 662.4 R .897
(ated to your local cop)-.05 F 2.197 -.65(y, a)-.1 H .897(nd vise-v).65
F 3.397(ersa. Some)-.15 F .896(people might think that it w)3.397 F .896
(ould be wise to)-.1 F 1.59
(just delete all their local mail folders periodically)108 674.4 R 6.59
(.I)-.65 G 4.09(fy)-6.59 G 1.59(ou do this with Of)-4.09 F(\215ineIMAP)
-.25 E 4.09(,r)-1.11 G 1.59(emember to also)-4.09 F(remo)108 686.4 Q
1.67 -.15(ve y)-.15 H 1.37(our local status cache \(~/.of).15 F 1.37
(\215ineimap by def)-.25 F 3.87(ault\). Otherwise,)-.1 F(Of)3.87 E 1.37
(\215ineIMAP will tak)-.25 F 3.87(et)-.1 G 1.37(his as an)-3.87 F .415
(intentional deletion of man)108 698.4 R 2.915(ym)-.15 G .416(essages a\
nd will interpret your action as requesting them to be deleted from)
-2.915 F(the serv)108 710.4 Q(er as well.)-.15 E(\(If you don')5 E 2.5
(tu)-.18 G(nderstand this, don')-2.5 E 2.5(tw)-.18 G
(orry; you probably w)-2.6 E(on')-.1 E 2.5(te)-.18 G
(ncounter this situation\))-2.5 E(John Goerzen)72 768 Q(July 12, 2002)
151.655 E(5)201.915 E EP
%%Page: 6 6
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R
(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E -1.1(Yo)108 84 S
2.77(us)1.1 G .27(hould ha)-2.77 F .57 -.15(ve r)-.2 H(ecei).15 E -.15
(ve)-.25 G 2.77(dac).15 G(op)-2.77 E 2.77(yo)-.1 G 2.77(ft)-2.77 G .27
(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10/Times-Bold@0
SF(COPYING MESSA)87 84 Q(GES BETWEEN FOLDERS)-.55 E F0(Normally)108 96 Q
5.859(,w)-.65 G 3.359(hen you cop)-5.859 F 5.859(yam)-.1 G 3.359
(essage between folders or add a ne)-5.859 F 5.859(wm)-.25 G 3.358
(essage to a folder locally)-5.859 F(,)-.65 E F1(Of\215ineIMAP)108 108 Q
F0 .853(will just do the right thing.)3.352 F(Ho)5.853 E(we)-.25 E -.15
(ve)-.25 G 1.653 -.4(r, s).15 H .853(ometimes this can be trick).4 F
3.353(y-)-.15 G 3.353(-i)-3.353 G 3.353(fy)-3.353 G .853(our IMAP serv)
-3.353 F(er)-.15 E .29(does not pro)108 120 R .29
(vide the SEARCH command, or does not return something useful,)-.15 F F1
(Of\215ineIMAP)2.79 E F0 .29(cannot deter)2.79 F(-)-.2 E .173
(mine the ne)108 132 R 2.673(wU)-.25 G .173(ID of the message.)-2.673 F
.173(So, in these rare instances, Of)5.173 F .174
(\215ineIMAP will upload the message to the)-.25 F .64(IMAP serv)108 144
R .64(er and delete it from your local folder)-.15 F 5.64(.T)-.55 G .64
(hen, on your ne)-5.64 F .64(xt sync, the message will be re-do)-.15 F
(wn-)-.25 E 1.472(loaded with the proper UID.)108 156 R F1
(Of\215ineIMAP)6.473 E F0(mak)3.973 E 1.473(es sure that the message w)
-.1 F 1.473(as properly uploaded before)-.1 F
(deleting it, so there should be no risk of data loss.)108 168 Q F1
(MAILING LIST)87 184.8 Q F0(There is an Of)108 196.8 Q
(\215ineIMAP mailing list a)-.25 E -.25(va)-.2 G(ilable.).25 E 2.448 -.8
(To s)108 213.6 T .847(ubscribe, send the te).8 F .847
(xt "Subscribe" in the subject of a mail to of)-.15 F
(\215ineimap-request@complete.or)-.25 E 3.347(g. T)-.18 F(o)-.8 E
(post, send the message to of)108 225.6 Q(\215ineimap@complete.or)-.25 E
(g.)-.18 E/F2 10.95/Times-Bold@0 SF -.11(BU)72 242.4 S(GS).11 E F0 4.419
(Reports of b)108 254.4 R 4.419(ugs should be sent via e-mail to the)-.2
F F1(Of\215ineIMAP)6.919 E F0 -.2(bu)6.92 G 4.42
(g-tracking system \(BTS\) at).2 F(of)108 266.4 Q(\215ineimap@b)-.25 E
(ugs.complete.or)-.2 E 3.397(go)-.18 G 3.397(rs)-3.397 G .897
(ubmitted on-line using the W)-3.397 F .896(eb interf)-.8 F .896
(ace at http://b)-.1 F(ugs.complete.or)-.2 E(g/.)-.18 E(The W)108 278.4
Q(eb site also lists all current b)-.8 E
(ugs, where you can check their status or contrib)-.2 E
(ute to \214xing them.)-.2 E F2(COPYRIGHT)72 295.2 Q F0(Of)108 307.2 Q
(\215ineIMAP is Cop)-.25 E(yright \(C\) 2002 John Goerzen.)-.1 E .286
(This program is free softw)108 324 R .286(are; you can redistrib)-.1 F
.287(ute it and/or modify it under the terms of the GNU General)-.2 F
.766(Public License as published by the Free Softw)108 336 R .766(are F)
-.1 F .766(oundation; either v)-.15 F .766
(ersion 2 of the License, or \(at your)-.15 F(option\) an)108 348 Q 2.5
(yl)-.15 G(ater v)-2.5 E(ersion.)-.15 E .579(This program is distrib)108
364.8 R .579(uted in the hope that it will be useful, b)-.2 F .58
(ut WITHOUT ANY W)-.2 F(ARRANTY)-1.2 E 3.08(;w)-.92 G(ithout)-3.08 E
-2.15 -.25(ev e)108 376.8 T 2.73(nt).25 G .23(he implied w)-2.73 F .229
(arranty of MERCHANT)-.1 F .229(ABILITY or FITNESS FOR A P)-.93 F(AR)
-.92 E .229(TICULAR PURPOSE.)-.6 F(See)5.229 E
(the GNU General Public License for more details.)108 388.8 Q -1.1(Yo)
108 405.6 S 2.77(us)1.1 G .27(hould ha)-2.77 F .57 -.15(ve r)-.2 H(ecei)
.15 E -.15(ve)-.25 G 2.77(dac).15 G(op)-2.77 E 2.77(yo)-.1 G 2.77(ft)
-2.77 G .27
(he GNU General Public License along with this program; if not, write)
-2.77 F(to:)108 96 Q(Free Softw)108 112.8 Q(are F)-.1 E(oundation, Inc.)
-.15 E(59 T)108 124.8 Q(emple Place)-.7 E(Suite 330)108 136.8 Q
(Boston, MA)108 148.8 Q(02111-1307)5 E(USA)108 160.8 Q/F1 10.95
/Times-Bold@0 SF -.548(AU)72 177.6 S(THOR).548 E/F2 10/Times-Bold@0 SF
(Of\215ineIMAP)108 189.6 Q(,)-.92 E F0 .488
-2.77 F(to:)108 417.6 Q(Free Softw)108 434.4 Q(are F)-.1 E
(oundation, Inc.)-.15 E(59 T)108 446.4 Q(emple Place)-.7 E(Suite 330)108
458.4 Q(Boston, MA)108 470.4 Q(02111-1307)5 E(USA)108 482.4 Q F2 -.548
(AU)72 499.2 S(THOR).548 E F1(Of\215ineIMAP)108 511.2 Q(,)-.92 E F0 .488
(its libraries, documentation, and all included \214les, e)2.988 F .488
(xcept where noted, w)-.15 F .487(as written by John)-.1 F
(Goerzen <jgoerzen@complete.or)108 201.6 Q(g> and cop)-.18 E
(yright is held as stated in the COPYRIGHT section.)-.1 E(Of)108 218.4 Q
(Goerzen <jgoerzen@complete.or)108 523.2 Q(g> and cop)-.18 E
(yright is held as stated in the COPYRIGHT section.)-.1 E(Of)108 540 Q
(\215ineIMAP may be do)-.25 E(wnloaded, and information found, from its\
homepage via either Gopher or HTTP:)-.25 E(gopher://quux.or)108 235.2 Q
homepage via either Gopher or HTTP:)-.25 E(gopher://quux.or)108 556.8 Q
(g/1/de)-.18 E -.15(ve)-.25 G(l/of).15 E(\215ineimap)-.25 E
(http://quux.or)108 247.2 Q(g/de)-.18 E -.15(ve)-.25 G(l/of).15 E
(\215ineimap)-.25 E(Of)108 264 Q 2.528(\215ineIMAP may also be do)-.25 F
2.528(wnloaded using Sub)-.25 F -.15(ve)-.15 G 5.028
(http://quux.or)108 568.8 Q(g/de)-.18 E -.15(ve)-.25 G(l/of).15 E
(\215ineimap)-.25 E(Of)108 585.6 Q 2.528(\215ineIMAP may also be do)-.25
F 2.528(wnloaded using Sub)-.25 F -.15(ve)-.15 G 5.028
(rsion. Additionally).15 F 5.028(,t)-.65 G 2.529(he distrib)-5.028 F
2.529(uted tar)-.2 F 2.529(.gz may be)-.55 F .718
(updated with a simple "svn update" command; it is ready to go.)108 276
R -.15(Fo)5.717 G 3.217(ri).15 G .717(nformation on getting Of)-3.217 F
(\215ineIMAP)-.25 E(with Sub)108 288 Q -.15(ve)-.15 G
(rsion, please visit:).15 E(http://svn.complete.or)108 304.8 Q(g/)-.18 E
F1(SEE ALSO)72 321.6 Q F2(mutt)108 333.6 Q F0(\(1\),)A F2(python)2.5 E
(updated with a simple "svn update" command; it is ready to go.)108
597.6 R -.15(Fo)5.717 G 3.217(ri).15 G .717(nformation on getting Of)
-3.217 F(\215ineIMAP)-.25 E(with Sub)108 609.6 Q -.15(ve)-.15 G
(rsion, please visit:).15 E(http://svn.complete.or)108 626.4 Q(g/)-.18 E
F2(SEE ALSO)72 643.2 Q F1(mutt)108 655.2 Q F0(\(1\),)A F1(python)2.5 E
F0(\(1\).)A(John Goerzen)72 768 Q(July 12, 2002)151.655 E(6)201.915 E EP
%%Trailer
end

235
offlineimap/head/manual.txt
View File

@ -223,54 +223,83 @@ EXAMPLES
That's it!
UW-IMAPD AND REFERENCES
Some users with a UW-IMAPD server need to use
OfflineIMAP's "reference" feature to get at their mail-
boxes, specifying a reference of "~/Mail" or "#mh/"
depending on the configuration. The below configuration
from docwhat@gerf.org shows using a reference of Mail, a
nametrans that strips the leading Mail/ off incoming
folder names, and a folderfilter that limits the folders
synced to just three.
[Gerf]
localfolders = ~/Mail
remotehost = gerf.org
ssl = yes
remoteuser = docwhat
reference = Mail
# Trims off the preceeding Mail on all the folder names.
nametrans = lambda foldername: \
re.sub('^Mail/', '', foldername)
# Yeah, you have to mention the Mail dir, even though it
# would seem intuitive that reference would trim it.
folderfilter = lambda foldername: foldername in [
'Mail/INBOX',
'Mail/list/zaurus-general',
'Mail/list/zaurus-dev',
]
maxconnections = 1
holdconnectionopen = no
ERRORS
If you get one of some frequently-encountered or confusing
errors, please check this section.
UID validity problem for folder
IMAP servers use a unique ID (UID) to refer to a specific
IMAP servers use a unique ID (UID) to refer to a specific
message. This number is guaranteed to be unique to a par-
ticular message FOREVER. No other message in the same
folder will ever get the same UID. UIDs are an integral
part of OfflineIMAP's synchronization scheme; they are
used to match up messages on your computer to messages on
ticular message FOREVER. No other message in the same
folder will ever get the same UID. UIDs are an integral
part of OfflineIMAP's synchronization scheme; they are
used to match up messages on your computer to messages on
the server.
Sometimes, the UIDs on the server might get reset. Usu-
ally this will happen if you delete and then recreate a
folder. When you create a folder, the server will often
start the UID back from 1. But OfflineIMAP might still
have the UIDs from the previous folder by the same name
stored. OfflineIMAP will detect this condition and skip
the folder. This is GOOD, because it prevents data loss.
Sometimes, the UIDs on the server might get reset. Usu-
ally this will happen if you delete and then recreate a
folder. When you create a folder, the server will often
start the UID back from 1. But OfflineIMAP might still
have the UIDs from the previous folder by the same name
stored. OfflineIMAP will detect this condition and skip
the folder. This is GOOD, because it prevents data loss.
You can fix it by removing your local folder and cache
data. For instance, if your folders are under ~/Folders
You can fix it by removing your local folder and cache
data. For instance, if your folders are under ~/Folders
and the folder with the problem is INBOX, you'd type this:
rm -r ~/Folders/INBOX
rm ~/.offlineimap/AccountName/INBOX
(replacing AccountName with the account name as specified
(replacing AccountName with the account name as specified
in ~/.offlineimaprc)
Next time you run OfflineIMAP, it will re-download the
folder with the new UIDs. Note that the procedure speci-
Next time you run OfflineIMAP, it will re-download the
folder with the new UIDs. Note that the procedure speci-
fied above will lose any local changes made to the folder.
Some IMAP servers are broken and do not support UIDs prop-
erly. If you continue to get this error for all your
folders even after performing the above procedure, it is
likely that your IMAP server falls into this category.
OfflineIMAP is incompatible with such servers. Using
OfflineIMAP with them will not destroy any mail, but at
erly. If you continue to get this error for all your
folders even after performing the above procedure, it is
likely that your IMAP server falls into this category.
OfflineIMAP is incompatible with such servers. Using
OfflineIMAP with them will not destroy any mail, but at
the same time, it will not actually synchronize it either.
(OfflineIMAP will detect this condition and abort prior to
synchronization)
OTHER FREQUENTLY ASKED QUESTIONS
There are some other FAQs that might not fit into another
There are some other FAQs that might not fit into another
section of this document, and they are enumerated here.
What platforms does OfflineIMAP run on?
@ -281,96 +310,96 @@ OTHER FREQUENTLY ASKED QUESTIONS
set maildir_trash=yes . Do I need to do that with
OfflineIMAP?
No. OfflineIMAP is smart enough to figure out mes-
sage deletion without this extra crutch. You'll
sage deletion without this extra crutch. You'll
get the best results if you don't use this setting,
in fact.
How do I specify the names of my folders?
You do not need to. OfflineIMAP is smart enough to
automatically figure out what folders are present
on the IMAP server and synchronize them. You can
use the folderfilter and foldertrans configuration
file options to request certain folders and rename
automatically figure out what folders are present
on the IMAP server and synchronize them. You can
use the folderfilter and foldertrans configuration
file options to request certain folders and rename
them as they come in if you like.
How can I prevent certain folders from being synced?
Use the folderfilter option in the configuration
Use the folderfilter option in the configuration
file.
How can I add or delete a folder?
OfflineIMAP does not currently provide this fea-
ture, but if you create a new folder on the IMAP
OfflineIMAP does not currently provide this
feature, but if you create a new folder on the IMAP
server, it will be created locally automatically.
Are there any other warnings that I should be aware of?
Yes; see the NOTES section below.
What is the mailbox name recorder (mbnames) for?
The Mutt mail reader is not capable of automati-
cally determining the names of your mailboxes.
OfflineIMAP can help it (or many other) programs
out be writing these names out in a format you
The Mutt mail reader is not capable of automati-
cally determining the names of your mailboxes.
OfflineIMAP can help it (or many other) programs
out be writing these names out in a format you
specify. See the example offlineimap.conf file for
details.
Can I synchronize multiple accounts with OfflineIMAP?
Sure. Just name them all in the accounts line in
the general section of the config file, and add a
Sure. Just name them all in the accounts line in
the general section of the config file, and add a
per-account section for each one.
Does OfflineIMAP support POP?
No. POP is not robust enough to do a completely
reliable multi-machine synchronization like
OfflineIMAP can do. OfflineIMAP will not support
No. POP is not robust enough to do a completely
reliable multi-machine synchronization like
OfflineIMAP can do. OfflineIMAP will not support
it.
Do you support mailbox formats other than Maildir?
Not at present. There is no technical reason not
Not at present. There is no technical reason not
to; just no demand yet. Maildir is a superior for-
mat anyway.
[technical] Why are your Maildir message filenames so
[technical] Why are your Maildir message filenames so
huge?
OfflineIMAP has two relevant principles: 1) never
modifying your messages in any way and 2) ensuring
100% reliable synchronizations. In order to do a
reliable sync, OfflineIMAP must have a way to
uniquely identify each e-mail. Three pieces of
information are required to do this: your account
name, the folder name, and the message UID. The
account name can be calculated from the path in
which your messages are. The folder name can usu-
ally be as well, BUT some mail clients move mes-
sages between folders by simply moving the file,
OfflineIMAP has two relevant principles: 1) never
modifying your messages in any way and 2) ensuring
100% reliable synchronizations. In order to do a
reliable sync, OfflineIMAP must have a way to
uniquely identify each e-mail. Three pieces of
information are required to do this: your account
name, the folder name, and the message UID. The
account name can be calculated from the path in
which your messages are. The folder name can usu-
ally be as well, BUT some mail clients move mes-
sages between folders by simply moving the file,
leaving the name intact.
So, OfflineIMAP must store both a UID folder ID.
The folder ID is necessary so OfflineIMAP can
detect a message moved to a different folder.
OfflineIMAP stores the UID (U= number) and an
md5sum of the foldername (FMD5= number) to facili-
So, OfflineIMAP must store both a UID folder ID.
The folder ID is necessary so OfflineIMAP can
detect a message moved to a different folder.
OfflineIMAP stores the UID (U= number) and an
md5sum of the foldername (FMD5= number) to facili-
tate this.
What is the speed of OfflineIMAP's sync?
OfflineIMAP versions 2.0 and above contain a multi-
threaded system. A good way to experiment is by
setting maxsyncaccounts to 3 and maxconnections to
threaded system. A good way to experiment is by
setting maxsyncaccounts to 3 and maxconnections to
3 in each account clause.
This lets OfflineIMAP open up multiple connections
simultaneously. That will let it process multiple
folders and messages at once. In most cases, this
This lets OfflineIMAP open up multiple connections
simultaneously. That will let it process multiple
folders and messages at once. In most cases, this
will increase performance of the sync.
Don't set the number too high. If you do that,
things might actually slow down as your link gets
saturated. Also, too many connections can cause
mail servers to have excessive load. Administra-
tors might take unkindly to this, and the server
might bog down. There are many variables in the
Don't set the number too high. If you do that,
things might actually slow down as your link gets
saturated. Also, too many connections can cause
mail servers to have excessive load. Administra-
tors might take unkindly to this, and the server
might bog down. There are many variables in the
optimal setting; experimentation may help.
An informal benchmark yields these results for my
An informal benchmark yields these results for my
setup:
10 minutes with MacOS X Mail.app "manual cache"
@ -388,19 +417,19 @@ CONFORMING TO
manual-html/man5/maildir.html and
http://cr.yp.to/proto/maildir.html.
o Standard Python 2.2.1 as implemented on POSIX-com-
o Standard Python 2.2.1 as implemented on POSIX-com-
pliant systems.
NOTES
DELETING LOCAL FOLDERS
OfflineIMAP does a two-way synchronization. That is, if
you make a change to the mail on the server, it will be
propogated to your local copy, and vise-versa. Some peo-
ple might think that it would be wise to just delete all
their local mail folders periodically. If you do this
with OfflineIMAP, remember to also remove your local sta-
tus cache (~/.offlineimap by default). Otherwise,
OfflineIMAP will take this as an intentional deletion of
OfflineIMAP does a two-way synchronization. That is, if
you make a change to the mail on the server, it will be
propogated to your local copy, and vise-versa. Some peo-
ple might think that it would be wise to just delete all
their local mail folders periodically. If you do this
with OfflineIMAP, remember to also remove your local sta-
tus cache (~/.offlineimap by default). Otherwise,
OfflineIMAP will take this as an intentional deletion of
many messages and will interpret your action as requesting
them to be deleted from the server as well. (If you don't
understand this, don't worry; you probably won't encounter
@ -408,47 +437,49 @@ NOTES
COPYING MESSAGES BETWEEN FOLDERS
Normally, when you copy a message between folders or add a
new message to a folder locally, OfflineIMAP will just do
new message to a folder locally, OfflineIMAP will just do
the right thing. However, sometimes this can be tricky --
if your IMAP server does not provide the SEARCH command,
or does not return something useful, OfflineIMAP cannot
determine the new UID of the message. So, in these rare
if your IMAP server does not provide the SEARCH command,
or does not return something useful, OfflineIMAP cannot
determine the new UID of the message. So, in these rare
instances, OfflineIMAP will upload the message to the IMAP
server and delete it from your local folder. Then, on
server and delete it from your local folder. Then, on
your next sync, the message will be re-downloaded with the
proper UID. OfflineIMAP makes sure that the message was
properly uploaded before deleting it, so there should be
proper UID. OfflineIMAP makes sure that the message was
properly uploaded before deleting it, so there should be
no risk of data loss.
MAILING LIST
There is an OfflineIMAP mailing list available.
To subscribe, send the text "Subscribe" in the subject of
To subscribe, send the text "Subscribe" in the subject of
a mail to offlineimap-request@complete.org. To post, send
the message to offlineimap@complete.org.
BUGS
Reports of bugs should be sent via e-mail to the
OfflineIMAP bug-tracking system (BTS) at
offlineimap@bugs.complete.org or submitted on-line using
the Web interface at http://bugs.complete.org/.
Reports of bugs should be sent via e-mail to the
OfflineIMAP bug-tracking system (BTS) at
offlineimap@bugs.complete.org or submitted on-line using
the Web interface at http://bugs.complete.org/. The Web
site also lists all current bugs, where you can check
their status or contribute to fixing them.
COPYRIGHT
OfflineIMAP is Copyright (C) 2002 John Goerzen.
This program is free software; you can redistribute it
This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any
License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any
later version.
This program is distributed in the hope that it will be
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more
details.
You should have received a copy of the GNU General Public
You should have received a copy of the GNU General Public
License along with this program; if not, write to:
Free Software Foundation, Inc.
@ -458,9 +489,9 @@ COPYRIGHT
USA
AUTHOR
OfflineIMAP, its libraries, documentation, and all
included files, except where noted, was written by John
Goerzen <jgoerzen@complete.org> and copyright is held as
OfflineIMAP, its libraries, documentation, and all
included files, except where noted, was written by John
Goerzen <jgoerzen@complete.org> and copyright is held as
stated in the COPYRIGHT section.
OfflineIMAP may be downloaded, and information found, from
@ -471,7 +502,7 @@ AUTHOR
OfflineIMAP may also be downloaded using Subversion.
Additionally, the distributed tar.gz may be updated with a
simple "svn update" command; it is ready to go. For
simple "svn update" command; it is ready to go. For
information on getting OfflineIMAP with Subversion, please
visit:

47
offlineimap/head/offlineimap.1
View File

@ -309,6 +309,51 @@ Add these lines to your
.B set spoolfile=+Personal/INBOX
.PP
That's it!
.SS UW-IMAPD AND REFERENCES
Some users with a UW-IMAPD server need to use
.B OfflineIMAP's
"reference" feature to get at their mailboxes, specifying a reference
of "~/Mail" or "#mh/" depending on the configuration. The below
configuration from docwhat@gerf.org
shows using a reference of Mail, a nametrans that strips
the leading Mail/ off incoming folder names, and a folderfilter that
limits the folders synced to just three.
.PP
.B [Gerf]
.br
.B localfolders = ~/Mail
.br
.B remotehost = gerf.org
.br
.B ssl = yes
.br
.B remoteuser = docwhat
.br
.B reference = Mail
.br
.B # Trims off the preceeding Mail on all the folder names.
.br
.B nametrans = lambda foldername: \\\\
.br
.B " re.sub('^Mail/', '', foldername)"
.br
.B # Yeah, you have to mention the Mail dir, even though it
.br
.B # would seem intuitive that reference would trim it.
.br
.B folderfilter = lambda foldername: foldername in [
.br
.B " 'Mail/INBOX',"
.br
.B " 'Mail/list/zaurus-general',"
.br
.B " 'Mail/list/zaurus-dev',"
.br
.B " ]"
.br
.B maxconnections = 1
.br
.B holdconnectionopen = no
.SH ERRORS
If you get one of some frequently-encountered or confusing errors,
please check this section.
@ -532,6 +577,8 @@ or submitted on-line using the Web interface at
.UR http://bugs.complete.org/
http://bugs.complete.org/.
.UE
The Web site also lists all current bugs, where you can check their
status or contribute to fixing them.
.SH COPYRIGHT
OfflineIMAP is Copyright (C) 2002 John Goerzen.
.PP