/offlineimap/head: changeset 158
Added UW IMAPD example from docwhat@gerf.org
This commit is contained in:
jgoerzen
parent
de9ea5c05c
commit
39060259d0
@ -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
|
* When uploading messages from a Maildir, now convert \r\n to \n in case
|
||||||
the message is stored weirdly. That way, everything is uniform.
|
the message is stored weirdly. That way, everything is uniform.
|
||||||
Fixes [complete.org #11].
|
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
|
-- John Goerzen <jgoerzen@complete.org> Sun, 21 Jul 2002 16:09:42 -0500
|
||||||
|
|
||||||
|
|||||||
@ -25,7 +25,7 @@
|
|||||||
|
|
||||||
<hr>
|
<hr>
|
||||||
<!-- Creator : groff version 1.17.2 -->
|
<!-- 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>
|
<a name="NAME"></a>
|
||||||
<h2>NAME</h2>
|
<h2>NAME</h2>
|
||||||
<table width="100%" border=0 rules="none" frame="void"
|
<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">
|
<tr valign="top" align="left">
|
||||||
<td width="10%"></td><td width="90%">
|
<td width="10%"></td><td width="90%">
|
||||||
That's it!</td></table>
|
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> "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.</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>
|
<a name="ERRORS"></a>
|
||||||
<h2>ERRORS</h2>
|
<h2>ERRORS</h2>
|
||||||
|
|
||||||
@ -923,7 +965,9 @@ offlineimap@complete.org.</td></table>
|
|||||||
Reports of bugs should be sent via e-mail to the
|
Reports of bugs should be sent via e-mail to the
|
||||||
<b>OfflineIMAP</b> bug-tracking system (BTS) at
|
<b>OfflineIMAP</b> bug-tracking system (BTS) at
|
||||||
offlineimap@bugs.complete.org or submitted on-line using the
|
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>
|
<a name="COPYRIGHT"></a>
|
||||||
<h2>COPYRIGHT</h2>
|
<h2>COPYRIGHT</h2>
|
||||||
|
|
||||||
|
|||||||
Binary file not shown.
@ -1,6 +1,6 @@
|
|||||||
%!PS-Adobe-3.0
|
%!PS-Adobe-3.0
|
||||||
%%Creator: groff version 1.17.2
|
%%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
|
%%DocumentNeededResources: font Times-Roman
|
||||||
%%+ font Times-Bold
|
%%+ font Times-Bold
|
||||||
%%+ font Times-Italic
|
%%+ 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)
|
(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
|
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
|
(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\
|
F1(UW)87 456 Q(-IMAPD AND REFERENCES)-.37 E F0 .493
|
||||||
tered or confusing errors, please check this section.)108 468 Q F1
|
(Some users with a UW)108 468 R .493(-IMAPD serv)-.65 F .493
|
||||||
(UID v)87 484.8 Q(alidity pr)-.1 E(oblem f)-.18 E(or f)-.25 E(older)-.25
|
(er need to use)-.15 F F1(Of\215ineIMAP')2.993 E(s)-.37 E F0 .493
|
||||||
E F0 1.637(IMAP serv)108 496.8 R 1.637
|
("reference" feature to get at their mail-)2.993 F(box)108 480 Q .46(es\
|
||||||
(ers use a unique ID \(UID\) to refer to a speci\214c message.)-.15 F
|
, specifying a reference of "~/Mail" or "#mh/" depending on the con\214\
|
||||||
1.638(This number is guaranteed to be)6.637 F 1.11
|
guration.)-.15 F .46(The belo)5.46 F 2.96(wc)-.25 G(on\214gura-)-2.96 E
|
||||||
(unique to a particular message FOREVER.)108 508.8 R 1.109
|
.465(tion from docwhat@gerf.or)108 492 R 2.965(gs)-.18 G(ho)-2.965 E
|
||||||
(No other message in the same folder will e)6.11 F -.15(ve)-.25 G 3.609
|
.465(ws using a reference of Mail, a nametrans that strips the leading \
|
||||||
(rg).15 G 1.109(et the same)-3.609 F 2.873(UID. UIDs)108 520.8 R .373
|
Mail/ of)-.25 F(f)-.25 E(incoming folder names, and a folder\214lter th\
|
||||||
(are an inte)2.873 F .373(gral part of Of)-.15 F(\215ineIMAP')-.25 E
|
at limits the folders synced to just three.)108 504 Q F1([Gerf])108
|
||||||
2.873(ss)-.55 G .373(ynchronization scheme; the)-2.873 F 2.873(ya)-.15 G
|
520.8 Q(localf)108 532.8 Q(olders = ~/Mail)-.25 E -.18(re)108 544.8 S
|
||||||
.373(re used to match up mes-)-2.873 F
|
(motehost = gerf).18 E(.or)-.15 E(g)-.1 E(ssl = y)108 556.8 Q(es)-.1 E
|
||||||
(sages on your computer to messages on the serv)108 532.8 Q(er)-.15 E(.)
|
-.18(re)108 568.8 S(moteuser = docwhat).18 E -.18(re)108 580.8 S(fer).18
|
||||||
-.55 E .108(Sometimes, the UIDs on the serv)108 549.6 R .108
|
E(ence = Mail)-.18 E 2.5(#T)108 592.8 S(rims off the pr)-3.24 E
|
||||||
(er might get reset.)-.15 F .108
|
(eceeding Mail on all the f)-.18 E(older names.)-.25 E
|
||||||
(Usually this will happen if you delete and then recreate)5.108 F 3.742
|
(nametrans = lambda f)108 604.8 Q(older)-.25 E(name: \\)-.15 E -.18(re)
|
||||||
(af)108 561.6 S(older)-3.742 E 6.242(.W)-.55 G 1.242
|
138 616.8 S(.sub\('^Mail/', ').18 E(', f)-.63 E(older)-.25 E(name\))-.15
|
||||||
(hen you create a folder)-6.242 F 3.742(,t)-.4 G 1.242(he serv)-3.742 F
|
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
|
||||||
1.242(er will often start the UID back from 1.)-.15 F(But)6.243 E F1
|
(om).1 G(ention the Mail dir)-2.5 E 2.5(,e)-.92 G -.1(ve)-2.65 G 2.5(nt)
|
||||||
(Of\215ineIMAP)3.743 E F0 .303(might still ha)108 573.6 R .603 -.15
|
.1 G(hough it)-2.5 E 2.5(#w)108 640.8 S(ould seem intuiti)-2.6 E .2 -.1
|
||||||
(ve t)-.2 H .303(he UIDs from the pre).15 F .302
|
(ve t)-.1 H(hat r).1 E(efer)-.18 E(ence w)-.18 E(ould trim it.)-.1 E
|
||||||
(vious folder by the same name stored.)-.25 F F1(Of\215ineIMAP)5.302 E
|
-.25(fo)108 652.8 S(lder\214lter = lambda f).25 E(older)-.25 E(name: f)
|
||||||
F0 .302(will detect this)2.802 F(condition and skip the folder)108 585.6
|
-.15 E(older)-.25 E(name in [)-.15 E('Mail/INBO)125.5 664.8 Q(X',)-.4 E
|
||||||
Q 5(.T)-.55 G(his is GOOD, because it pre)-5 E -.15(ve)-.25 G
|
('Mail/list/zaurus-general',)125.5 676.8 Q('Mail/list/zaurus-de)125.5
|
||||||
(nts data loss.).15 E -1.1(Yo)108 602.4 S 2.826(uc)1.1 G .326
|
688.8 Q(v',)-.15 E(])125.5 700.8 Q(maxconnections = 1)108 712.8 Q
|
||||||
(an \214x it by remo)-2.826 F .327
|
(holdconnectionopen = no)108 724.8 Q F0(John Goerzen)72 768 Q
|
||||||
(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
|
|
||||||
(July 12, 2002)151.655 E(3)201.915 E EP
|
(July 12, 2002)151.655 E(3)201.915 E EP
|
||||||
%%Page: 4 4
|
%%Page: 4 4
|
||||||
%%BeginPageSetup
|
%%BeginPageSetup
|
||||||
BP
|
BP
|
||||||
%%EndPageSetup
|
%%EndPageSetup
|
||||||
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R
|
/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
|
(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10.95
|
||||||
(ym)-.15 G .27(ail, b)-2.77 F .27
|
/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
|
(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
|
5.27(.\()-.55 G(Of)-5.27 E .27(\215ineIMAP will detect this con-)-.25 F
|
||||||
F(dition and abort prior to synchronization\))108 96 Q/F1 10.95
|
(dition and abort prior to synchronization\))108 381.6 Q F1 -.438(OT)72
|
||||||
/Times-Bold@0 SF -.438(OT)72 124.8 S(HER FREQ).438 E(UENTL)-.11 E 2.738
|
410.4 S(HER FREQ).438 E(UENTL)-.11 E 2.738(YA)-1.007 G(SKED Q)-2.738 E
|
||||||
(YA)-1.007 G(SKED Q)-2.738 E(UESTIONS)-.11 E F0 .683
|
(UESTIONS)-.11 E F0 .684(There are some other F)108 422.4 R -.55(AQ)-.74
|
||||||
(There are some other F)108 136.8 R -.55(AQ)-.74 G 3.184(st).55 G .684
|
G 3.184(st).55 G .684
|
||||||
(hat might not \214t into another section of this document, and the)
|
(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
|
-3.184 F 3.183(ya)-.15 G .683(re enumer)-3.183 F(-)-.2 E(ated here.)108
|
||||||
148.8 Q/F2 10/Times-Bold@0 SF(What platf)108 165.6 Q
|
434.4 Q F2(What platf)108 451.2 Q(orms does Of\215ineIMAP run on?)-.25 E
|
||||||
(orms does Of\215ineIMAP run on?)-.25 E F0(It should run on most platfo\
|
F0(It should run on most platforms supported by Python, which are quite\
|
||||||
rms supported by Python, which are quite a fe)144 177.6 Q -.65(w.)-.25 G
|
a fe)144 463.2 Q -.65(w.)-.25 G F2 .688
|
||||||
F2 .689(I'm using Mutt. Other IMAP sync pr)108 194.4 R .689(ograms r)
|
(I'm using Mutt. Other IMAP sync pr)108 480 R .689(ograms r)-.18 F
|
||||||
-.18 F(equir)-.18 E 3.189(em)-.18 G 3.189(et)-3.189 G 3.189(ou)-3.189 G
|
(equir)-.18 E 3.189(em)-.18 G 3.189(et)-3.189 G 3.189(ou)-3.189 G .689
|
||||||
.689(se set maildir_trash=y)-3.189 F .688(es . Do I need to)-.1 F
|
(se set maildir_trash=y)-3.189 F .689(es . Do I need to)-.1 F
|
||||||
(do that with Of\215ineIMAP?)108 206.4 Q F0(No.)144 218.4 Q F2
|
(do that with Of\215ineIMAP?)108 492 Q F0(No.)144 504 Q F2
|
||||||
(Of\215ineIMAP)7.27 E F0 2.27
|
(Of\215ineIMAP)7.27 E F0 2.27
|
||||||
(is smart enough to \214gure out message deletion without this e)4.77 F
|
(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
|
(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
|
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
|
F2(Of\215ineIMAP)6.05 E F0 1.05
|
||||||
(is smart enough to automatically \214gure out what folders are)3.55 F
|
(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.)
|
.678(present on the IMAP serv)144 556.8 R .678(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
|
-.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.178 G(lder\214lter).25 E F0(and)3.178 E F2 -.25(fo)3.178 G
|
(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\
|
(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
|
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 300 Q 2.5(wc)-.1 G(an I pr)
|
(ome in if you lik)-2.5 E(e.)-.1 E F2(Ho)108 585.6 Q 2.5(wc)-.1 G
|
||||||
-2.5 E -2.3 -.15(ev e)-.18 H(nt certain f).15 E(olders fr)-.25 E
|
(an I pr)-2.5 E -2.3 -.15(ev e)-.18 H(nt certain f).15 E(olders fr)-.25
|
||||||
(om being synced?)-.18 E F0(Use the)144 312 Q F2 -.25(fo)2.5 G
|
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
|
(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
|
(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 340.8 Q F0 .503(does not currently pro)3.003 F .504
|
(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.004(wf)
|
(vide this feature, b)-.15 F .504(ut if you create a ne)-.2 F 3.003(wf)
|
||||||
-.25 G .504(older on the IMAP)-3.004 F(serv)144 352.8 Q(er)-.15 E 2.5
|
-.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(.)
|
(,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
|
(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
|
(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 398.4 Q
|
-.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 \
|
(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)
|
is not capable of automatically determining the names of your mailbox)
|
||||||
144 410.4 R(es.)-.15 E(Of)144 422.4 Q .265
|
144 696 R(es.)-.15 E(Of)144 708 Q .266(\215ineIMAP can help it \(or man)
|
||||||
(\215ineIMAP can help it \(or man)-.25 F 2.765(yo)-.15 G .265
|
-.25 F 2.765(yo)-.15 G .265
|
||||||
(ther\) programs out be writing these names out in a format you)-2.765 F
|
(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
|
(specify)144 720 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
|
(\215ineimap.conf \214le for details.)-.25 E(John Goerzen)72 768 Q
|
||||||
(onize multiple accounts with Of\215ineIMAP?)-.18 E F0 3.345(Sure. Just)
|
(July 12, 2002)151.655 E(4)201.915 E EP
|
||||||
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
|
|
||||||
%%Page: 5 5
|
%%Page: 5 5
|
||||||
%%BeginPageSetup
|
%%BeginPageSetup
|
||||||
BP
|
BP
|
||||||
%%EndPageSetup
|
%%EndPageSetup
|
||||||
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R
|
/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)
|
(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10/Times-Bold@0
|
||||||
144 84 R .381(\215ineIMAP open up multiple connections simultaneously)
|
SF(Can I synchr)108 84 Q(onize multiple accounts with Of\215ineIMAP?)
|
||||||
-.25 F 5.382(.T)-.65 G .382(hat will let it process mul-)-5.382 F
|
-.18 E F0 3.344(Sure. Just)144 96 R .845(name them all in the accounts \
|
||||||
(tiple folders and messages at once.)144 96 Q
|
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
|
(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
|
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.604 F 3.103(wd)-.25 G -.25
|
(If you do that, things might actually slo)5.603 F 3.104(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
|
(ow)-3.104 G 3.104(na).25 G 3.104(sy)-3.104 G .604(our link gets)-3.104
|
||||||
F 2.632(saturated. Also,)144 124.8 R .132(too man)2.632 F 2.632(yc)-.15
|
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.632 F .132(ers to ha)-.15 F
|
G .132(onnections can cause mail serv)-2.633 F .132(ers to ha)-.15 F
|
||||||
.433 -.15(ve ex)-.2 H(cessi).15 E .433 -.15(ve l)-.25 H 2.633
|
.432 -.15(ve ex)-.2 H(cessi).15 E .432 -.15(ve l)-.25 H 2.632
|
||||||
(oad. Administra-).15 F .507(tors might tak)144 136.8 R 3.007(eu)-.1 G
|
(oad. Administra-).15 F .506(tors might tak)144 429.6 R 3.006(eu)-.1 G
|
||||||
.507(nkindly to this, and the serv)-3.007 F .506(er might bog do)-.15 F
|
.506(nkindly to this, and the serv)-3.006 F .507(er might bog do)-.15 F
|
||||||
3.006(wn. There)-.25 F .506(are man)3.006 F 3.006(yv)-.15 G .506
|
3.007(wn. There)-.25 F .507(are man)3.007 F 3.007(yv)-.15 G .507
|
||||||
(ariables in the)-3.256 F(optimal setting; e)144 148.8 Q
|
(ariables in the)-3.257 F(optimal setting; e)144 441.6 Q
|
||||||
(xperimentation may help.)-.15 E
|
(xperimentation may help.)-.15 E
|
||||||
(An informal benchmark yields these results for my setup:)144 165.6 Q
|
(An informal benchmark yields these results for my setup:)144 458.4 Q
|
||||||
(10 minutes with MacOS X Mail.app "manual cache")144 182.4 Q 2.5(5m)144
|
(10 minutes with MacOS X Mail.app "manual cache")144 475.2 Q 2.5(5m)144
|
||||||
194.4 S(inutes with GNUS agent sync)-2.5 E(20 seconds with Of)144 206.4
|
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 218.4 S(econds with Of)-2.5 E
|
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 230.4 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 242.4 S(econds with Of)
|
(\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/F1 10.95/Times-Bold@0 SF
|
-2.5 E(\215ineIMAP 3.x "held connection")-.25 E/F2 10.95/Times-Bold@0 SF
|
||||||
(CONFORMING T)72 259.2 Q(O)-.197 E F0 32.5<8349>108 271.2 S
|
(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
|
(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>
|
(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
|
-.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
|
(http://cr)144 592.8 Q(.yp.to/proto/maildir)-.55 E(.html.)-.55 E 32.5
|
||||||
<8353>108 316.8 S
|
<8353>108 609.6 S
|
||||||
(tandard Python 2.2.1 as implemented on POSIX-compliant systems.)-32.5 E
|
(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
|
F2(NO)72 626.4 Q(TES)-.438 E F1(DELETING LOCAL FOLDERS)87 638.4 Q
|
||||||
(DELETING LOCAL FOLDERS)87 345.6 Q(Of\215ineIMAP)108 357.6 Q F0 .533
|
(Of\215ineIMAP)108 650.4 Q F0 .532(does a tw)3.032 F(o-w)-.1 E .532
|
||||||
(does a tw)3.033 F(o-w)-.1 E .533(ay synchronization.)-.1 F .532
|
(ay synchronization.)-.1 F .532(That is, if you mak)5.532 F 3.032(eac)
|
||||||
(That is, if you mak)5.532 F 3.032(eac)-.1 G .532
|
-.1 G .532(hange to the mail on the serv)-3.032 F(er)-.15 E 3.033(,i)-.4
|
||||||
(hange to the mail on the serv)-3.032 F(er)-.15 E 3.032(,i)-.4 G(t)
|
G(t)-3.033 E .897(will be propog)108 662.4 R .897
|
||||||
-3.032 E .896(will be propog)108 369.6 R .896(ated to your local cop)
|
(ated to your local cop)-.05 F 2.197 -.65(y, a)-.1 H .897(nd vise-v).65
|
||||||
-.05 F 2.197 -.65(y, a)-.1 H .897(nd vise-v).65 F 3.397(ersa. Some)-.15
|
F 3.397(ersa. Some)-.15 F .896(people might think that it w)3.397 F .896
|
||||||
F .897(people might think that it w)3.397 F .897(ould be wise to)-.1 F
|
(ould be wise to)-.1 F 1.59
|
||||||
1.59(just delete all their local mail folders periodically)108 381.6 R
|
(just delete all their local mail folders periodically)108 674.4 R 6.59
|
||||||
6.59(.I)-.65 G 4.09(fy)-6.59 G 1.59(ou do this with Of)-4.09 F
|
(.I)-.65 G 4.09(fy)-6.59 G 1.59(ou do this with Of)-4.09 F(\215ineIMAP)
|
||||||
(\215ineIMAP)-.25 E 4.09(,r)-1.11 G 1.59(emember to also)-4.09 F(remo)
|
-.25 E 4.09(,r)-1.11 G 1.59(emember to also)-4.09 F(remo)108 686.4 Q
|
||||||
108 393.6 Q 1.67 -.15(ve y)-.15 H 1.37(our local status cache \(~/.of)
|
1.67 -.15(ve y)-.15 H 1.37(our local status cache \(~/.of).15 F 1.37
|
||||||
.15 F 1.37(\215ineimap by def)-.25 F 3.87(ault\). Otherwise,)-.1 F(Of)
|
(\215ineimap by def)-.25 F 3.87(ault\). Otherwise,)-.1 F(Of)3.87 E 1.37
|
||||||
3.87 E 1.37(\215ineIMAP will tak)-.25 F 3.87(et)-.1 G 1.37(his as an)
|
(\215ineIMAP will tak)-.25 F 3.87(et)-.1 G 1.37(his as an)-3.87 F .415
|
||||||
-3.87 F .416(intentional deletion of man)108 405.6 R 2.916(ym)-.15 G
|
(intentional deletion of man)108 698.4 R 2.915(ym)-.15 G .416(essages a\
|
||||||
.416(essages and will interpret your action as requesting them to be de\
|
nd will interpret your action as requesting them to be deleted from)
|
||||||
leted from)-2.916 F(the serv)108 417.6 Q(er as well.)-.15 E
|
-2.915 F(the serv)108 710.4 Q(er as well.)-.15 E(\(If you don')5 E 2.5
|
||||||
(\(If you don')5 E 2.5(tu)-.18 G(nderstand this, don')-2.5 E 2.5(tw)-.18
|
(tu)-.18 G(nderstand this, don')-2.5 E 2.5(tw)-.18 G
|
||||||
G(orry; you probably w)-2.6 E(on')-.1 E 2.5(te)-.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
|
(ncounter this situation\))-2.5 E(John Goerzen)72 768 Q(July 12, 2002)
|
||||||
(GES BETWEEN FOLDERS)-.55 E F0(Normally)108 446.4 Q 5.858(,w)-.65 G
|
151.655 E(5)201.915 E EP
|
||||||
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
|
|
||||||
%%Page: 6 6
|
%%Page: 6 6
|
||||||
%%BeginPageSetup
|
%%BeginPageSetup
|
||||||
BP
|
BP
|
||||||
%%EndPageSetup
|
%%EndPageSetup
|
||||||
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R
|
/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
|
(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10/Times-Bold@0
|
||||||
2.77(us)1.1 G .27(hould ha)-2.77 F .57 -.15(ve r)-.2 H(ecei).15 E -.15
|
SF(COPYING MESSA)87 84 Q(GES BETWEEN FOLDERS)-.55 E F0(Normally)108 96 Q
|
||||||
(ve)-.25 G 2.77(dac).15 G(op)-2.77 E 2.77(yo)-.1 G 2.77(ft)-2.77 G .27
|
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)
|
(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.)
|
-2.77 F(to:)108 417.6 Q(Free Softw)108 434.4 Q(are F)-.1 E
|
||||||
-.15 E(59 T)108 124.8 Q(emple Place)-.7 E(Suite 330)108 136.8 Q
|
(oundation, Inc.)-.15 E(59 T)108 446.4 Q(emple Place)-.7 E(Suite 330)108
|
||||||
(Boston, MA)108 148.8 Q(02111-1307)5 E(USA)108 160.8 Q/F1 10.95
|
458.4 Q(Boston, MA)108 470.4 Q(02111-1307)5 E(USA)108 482.4 Q F2 -.548
|
||||||
/Times-Bold@0 SF -.548(AU)72 177.6 S(THOR).548 E/F2 10/Times-Bold@0 SF
|
(AU)72 499.2 S(THOR).548 E F1(Of\215ineIMAP)108 511.2 Q(,)-.92 E F0 .488
|
||||||
(Of\215ineIMAP)108 189.6 Q(,)-.92 E F0 .488
|
|
||||||
(its libraries, documentation, and all included \214les, e)2.988 F .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
|
(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
|
(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 218.4 Q
|
(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\
|
(\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
|
(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
|
(http://quux.or)108 568.8 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
|
(\215ineimap)-.25 E(Of)108 585.6 Q 2.528(\215ineIMAP may also be do)-.25
|
||||||
2.528(wnloaded using Sub)-.25 F -.15(ve)-.15 G 5.028
|
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
|
(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
|
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
|
(updated with a simple "svn update" command; it is ready to go.)108
|
||||||
R -.15(Fo)5.717 G 3.217(ri).15 G .717(nformation on getting Of)-3.217 F
|
597.6 R -.15(Fo)5.717 G 3.217(ri).15 G .717(nformation on getting Of)
|
||||||
(\215ineIMAP)-.25 E(with Sub)108 288 Q -.15(ve)-.15 G
|
-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 304.8 Q(g/)-.18 E
|
(rsion, please visit:).15 E(http://svn.complete.or)108 626.4 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
|
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
|
F0(\(1\).)A(John Goerzen)72 768 Q(July 12, 2002)151.655 E(6)201.915 E EP
|
||||||
%%Trailer
|
%%Trailer
|
||||||
end
|
end
|
||||||
|
|||||||
@ -223,54 +223,83 @@ EXAMPLES
|
|||||||
|
|
||||||
That's it!
|
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
|
ERRORS
|
||||||
If you get one of some frequently-encountered or confusing
|
If you get one of some frequently-encountered or confusing
|
||||||
errors, please check this section.
|
errors, please check this section.
|
||||||
|
|
||||||
UID validity problem for folder
|
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-
|
message. This number is guaranteed to be unique to a par-
|
||||||
ticular message FOREVER. No other message in the same
|
ticular message FOREVER. No other message in the same
|
||||||
folder will ever get the same UID. UIDs are an integral
|
folder will ever get the same UID. UIDs are an integral
|
||||||
part of OfflineIMAP's synchronization scheme; they are
|
part of OfflineIMAP's synchronization scheme; they are
|
||||||
used to match up messages on your computer to messages on
|
used to match up messages on your computer to messages on
|
||||||
the server.
|
the server.
|
||||||
|
|
||||||
Sometimes, the UIDs on the server might get reset. Usu-
|
Sometimes, the UIDs on the server might get reset. Usu-
|
||||||
ally this will happen if you delete and then recreate a
|
ally this will happen if you delete and then recreate a
|
||||||
folder. When you create a folder, the server will often
|
folder. When you create a folder, the server will often
|
||||||
start the UID back from 1. But OfflineIMAP might still
|
start the UID back from 1. But OfflineIMAP might still
|
||||||
have the UIDs from the previous folder by the same name
|
have the UIDs from the previous folder by the same name
|
||||||
stored. OfflineIMAP will detect this condition and skip
|
stored. OfflineIMAP will detect this condition and skip
|
||||||
the folder. This is GOOD, because it prevents data loss.
|
the folder. This is GOOD, because it prevents data loss.
|
||||||
|
|
||||||
You can fix it by removing your local folder and cache
|
You can fix it by removing your local folder and cache
|
||||||
data. For instance, if your folders are under ~/Folders
|
data. For instance, if your folders are under ~/Folders
|
||||||
and the folder with the problem is INBOX, you'd type this:
|
and the folder with the problem is INBOX, you'd type this:
|
||||||
|
|
||||||
rm -r ~/Folders/INBOX
|
rm -r ~/Folders/INBOX
|
||||||
rm ~/.offlineimap/AccountName/INBOX
|
rm ~/.offlineimap/AccountName/INBOX
|
||||||
|
|
||||||
(replacing AccountName with the account name as specified
|
(replacing AccountName with the account name as specified
|
||||||
in ~/.offlineimaprc)
|
in ~/.offlineimaprc)
|
||||||
|
|
||||||
Next time you run OfflineIMAP, it will re-download the
|
Next time you run OfflineIMAP, it will re-download the
|
||||||
folder with the new UIDs. Note that the procedure speci-
|
folder with the new UIDs. Note that the procedure speci-
|
||||||
fied above will lose any local changes made to the folder.
|
fied above will lose any local changes made to the folder.
|
||||||
|
|
||||||
Some IMAP servers are broken and do not support UIDs prop-
|
Some IMAP servers are broken and do not support UIDs prop-
|
||||||
erly. If you continue to get this error for all your
|
erly. If you continue to get this error for all your
|
||||||
folders even after performing the above procedure, it is
|
folders even after performing the above procedure, it is
|
||||||
likely that your IMAP server falls into this category.
|
likely that your IMAP server falls into this category.
|
||||||
OfflineIMAP is incompatible with such servers. Using
|
OfflineIMAP is incompatible with such servers. Using
|
||||||
OfflineIMAP with them will not destroy any mail, but at
|
OfflineIMAP with them will not destroy any mail, but at
|
||||||
the same time, it will not actually synchronize it either.
|
the same time, it will not actually synchronize it either.
|
||||||
(OfflineIMAP will detect this condition and abort prior to
|
(OfflineIMAP will detect this condition and abort prior to
|
||||||
synchronization)
|
synchronization)
|
||||||
|
|
||||||
|
|
||||||
OTHER FREQUENTLY ASKED QUESTIONS
|
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.
|
section of this document, and they are enumerated here.
|
||||||
|
|
||||||
What platforms does OfflineIMAP run on?
|
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
|
set maildir_trash=yes . Do I need to do that with
|
||||||
OfflineIMAP?
|
OfflineIMAP?
|
||||||
No. OfflineIMAP is smart enough to figure out mes-
|
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,
|
get the best results if you don't use this setting,
|
||||||
in fact.
|
in fact.
|
||||||
|
|
||||||
How do I specify the names of my folders?
|
How do I specify the names of my folders?
|
||||||
You do not need to. OfflineIMAP is smart enough to
|
You do not need to. OfflineIMAP is smart enough to
|
||||||
automatically figure out what folders are present
|
automatically figure out what folders are present
|
||||||
on the IMAP server and synchronize them. You can
|
on the IMAP server and synchronize them. You can
|
||||||
use the folderfilter and foldertrans configuration
|
use the folderfilter and foldertrans configuration
|
||||||
file options to request certain folders and rename
|
file options to request certain folders and rename
|
||||||
them as they come in if you like.
|
them as they come in if you like.
|
||||||
|
|
||||||
How can I prevent certain folders from being synced?
|
How can I prevent certain folders from being synced?
|
||||||
Use the folderfilter option in the configuration
|
Use the folderfilter option in the configuration
|
||||||
file.
|
file.
|
||||||
|
|
||||||
How can I add or delete a folder?
|
How can I add or delete a folder?
|
||||||
OfflineIMAP does not currently provide this fea-
|
OfflineIMAP does not currently provide this
|
||||||
ture, but if you create a new folder on the IMAP
|
feature, but if you create a new folder on the IMAP
|
||||||
server, it will be created locally automatically.
|
server, it will be created locally automatically.
|
||||||
|
|
||||||
Are there any other warnings that I should be aware of?
|
Are there any other warnings that I should be aware of?
|
||||||
Yes; see the NOTES section below.
|
Yes; see the NOTES section below.
|
||||||
|
|
||||||
What is the mailbox name recorder (mbnames) for?
|
What is the mailbox name recorder (mbnames) for?
|
||||||
The Mutt mail reader is not capable of automati-
|
The Mutt mail reader is not capable of automati-
|
||||||
cally determining the names of your mailboxes.
|
cally determining the names of your mailboxes.
|
||||||
OfflineIMAP can help it (or many other) programs
|
OfflineIMAP can help it (or many other) programs
|
||||||
out be writing these names out in a format you
|
out be writing these names out in a format you
|
||||||
specify. See the example offlineimap.conf file for
|
specify. See the example offlineimap.conf file for
|
||||||
details.
|
details.
|
||||||
|
|
||||||
Can I synchronize multiple accounts with OfflineIMAP?
|
Can I synchronize multiple accounts with OfflineIMAP?
|
||||||
Sure. Just name them all in the accounts line in
|
Sure. Just name them all in the accounts line in
|
||||||
the general section of the config file, and add a
|
the general section of the config file, and add a
|
||||||
per-account section for each one.
|
per-account section for each one.
|
||||||
|
|
||||||
Does OfflineIMAP support POP?
|
Does OfflineIMAP support POP?
|
||||||
No. POP is not robust enough to do a completely
|
No. POP is not robust enough to do a completely
|
||||||
reliable multi-machine synchronization like
|
reliable multi-machine synchronization like
|
||||||
OfflineIMAP can do. OfflineIMAP will not support
|
OfflineIMAP can do. OfflineIMAP will not support
|
||||||
it.
|
it.
|
||||||
|
|
||||||
Do you support mailbox formats other than Maildir?
|
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-
|
to; just no demand yet. Maildir is a superior for-
|
||||||
mat anyway.
|
mat anyway.
|
||||||
|
|
||||||
[technical] Why are your Maildir message filenames so
|
[technical] Why are your Maildir message filenames so
|
||||||
huge?
|
huge?
|
||||||
OfflineIMAP has two relevant principles: 1) never
|
OfflineIMAP has two relevant principles: 1) never
|
||||||
modifying your messages in any way and 2) ensuring
|
modifying your messages in any way and 2) ensuring
|
||||||
100% reliable synchronizations. In order to do a
|
100% reliable synchronizations. In order to do a
|
||||||
reliable sync, OfflineIMAP must have a way to
|
reliable sync, OfflineIMAP must have a way to
|
||||||
uniquely identify each e-mail. Three pieces of
|
uniquely identify each e-mail. Three pieces of
|
||||||
information are required to do this: your account
|
information are required to do this: your account
|
||||||
name, the folder name, and the message UID. The
|
name, the folder name, and the message UID. The
|
||||||
account name can be calculated from the path in
|
account name can be calculated from the path in
|
||||||
which your messages are. The folder name can usu-
|
which your messages are. The folder name can usu-
|
||||||
ally be as well, BUT some mail clients move mes-
|
ally be as well, BUT some mail clients move mes-
|
||||||
sages between folders by simply moving the file,
|
sages between folders by simply moving the file,
|
||||||
leaving the name intact.
|
leaving the name intact.
|
||||||
|
|
||||||
So, OfflineIMAP must store both a UID folder ID.
|
So, OfflineIMAP must store both a UID folder ID.
|
||||||
The folder ID is necessary so OfflineIMAP can
|
The folder ID is necessary so OfflineIMAP can
|
||||||
detect a message moved to a different folder.
|
detect a message moved to a different folder.
|
||||||
OfflineIMAP stores the UID (U= number) and an
|
OfflineIMAP stores the UID (U= number) and an
|
||||||
md5sum of the foldername (FMD5= number) to facili-
|
md5sum of the foldername (FMD5= number) to facili-
|
||||||
tate this.
|
tate this.
|
||||||
|
|
||||||
What is the speed of OfflineIMAP's sync?
|
What is the speed of OfflineIMAP's sync?
|
||||||
OfflineIMAP versions 2.0 and above contain a multi-
|
OfflineIMAP versions 2.0 and above contain a multi-
|
||||||
threaded system. A good way to experiment is by
|
threaded system. A good way to experiment is by
|
||||||
setting maxsyncaccounts to 3 and maxconnections to
|
setting maxsyncaccounts to 3 and maxconnections to
|
||||||
3 in each account clause.
|
3 in each account clause.
|
||||||
|
|
||||||
This lets OfflineIMAP open up multiple connections
|
This lets OfflineIMAP open up multiple connections
|
||||||
simultaneously. That will let it process multiple
|
simultaneously. That will let it process multiple
|
||||||
folders and messages at once. In most cases, this
|
folders and messages at once. In most cases, this
|
||||||
will increase performance of the sync.
|
will increase performance of the sync.
|
||||||
|
|
||||||
Don't set the number too high. If you do that,
|
Don't set the number too high. If you do that,
|
||||||
things might actually slow down as your link gets
|
things might actually slow down as your link gets
|
||||||
saturated. Also, too many connections can cause
|
saturated. Also, too many connections can cause
|
||||||
mail servers to have excessive load. Administra-
|
mail servers to have excessive load. Administra-
|
||||||
tors might take unkindly to this, and the server
|
tors might take unkindly to this, and the server
|
||||||
might bog down. There are many variables in the
|
might bog down. There are many variables in the
|
||||||
optimal setting; experimentation may help.
|
optimal setting; experimentation may help.
|
||||||
|
|
||||||
An informal benchmark yields these results for my
|
An informal benchmark yields these results for my
|
||||||
setup:
|
setup:
|
||||||
|
|
||||||
10 minutes with MacOS X Mail.app "manual cache"
|
10 minutes with MacOS X Mail.app "manual cache"
|
||||||
@ -388,19 +417,19 @@ CONFORMING TO
|
|||||||
manual-html/man5/maildir.html and
|
manual-html/man5/maildir.html and
|
||||||
http://cr.yp.to/proto/maildir.html.
|
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.
|
pliant systems.
|
||||||
|
|
||||||
NOTES
|
NOTES
|
||||||
DELETING LOCAL FOLDERS
|
DELETING LOCAL FOLDERS
|
||||||
OfflineIMAP does a two-way synchronization. That is, if
|
OfflineIMAP does a two-way synchronization. That is, if
|
||||||
you make a change to the mail on the server, it will be
|
you make a change to the mail on the server, it will be
|
||||||
propogated to your local copy, and vise-versa. Some peo-
|
propogated to your local copy, and vise-versa. Some peo-
|
||||||
ple might think that it would be wise to just delete all
|
ple might think that it would be wise to just delete all
|
||||||
their local mail folders periodically. If you do this
|
their local mail folders periodically. If you do this
|
||||||
with OfflineIMAP, remember to also remove your local sta-
|
with OfflineIMAP, remember to also remove your local sta-
|
||||||
tus cache (~/.offlineimap by default). Otherwise,
|
tus cache (~/.offlineimap by default). Otherwise,
|
||||||
OfflineIMAP will take this as an intentional deletion of
|
OfflineIMAP will take this as an intentional deletion of
|
||||||
many messages and will interpret your action as requesting
|
many messages and will interpret your action as requesting
|
||||||
them to be deleted from the server as well. (If you don't
|
them to be deleted from the server as well. (If you don't
|
||||||
understand this, don't worry; you probably won't encounter
|
understand this, don't worry; you probably won't encounter
|
||||||
@ -408,47 +437,49 @@ NOTES
|
|||||||
|
|
||||||
COPYING MESSAGES BETWEEN FOLDERS
|
COPYING MESSAGES BETWEEN FOLDERS
|
||||||
Normally, when you copy a message between folders or add a
|
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 --
|
the right thing. However, sometimes this can be tricky --
|
||||||
if your IMAP server does not provide the SEARCH command,
|
if your IMAP server does not provide the SEARCH command,
|
||||||
or does not return something useful, OfflineIMAP cannot
|
or does not return something useful, OfflineIMAP cannot
|
||||||
determine the new UID of the message. So, in these rare
|
determine the new UID of the message. So, in these rare
|
||||||
instances, OfflineIMAP will upload the message to the IMAP
|
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
|
your next sync, the message will be re-downloaded with the
|
||||||
proper UID. OfflineIMAP makes sure that the message was
|
proper UID. OfflineIMAP makes sure that the message was
|
||||||
properly uploaded before deleting it, so there should be
|
properly uploaded before deleting it, so there should be
|
||||||
no risk of data loss.
|
no risk of data loss.
|
||||||
|
|
||||||
MAILING LIST
|
MAILING LIST
|
||||||
There is an OfflineIMAP mailing list available.
|
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
|
a mail to offlineimap-request@complete.org. To post, send
|
||||||
the message to offlineimap@complete.org.
|
the message to offlineimap@complete.org.
|
||||||
|
|
||||||
BUGS
|
BUGS
|
||||||
Reports of bugs should be sent via e-mail to the
|
Reports of bugs should be sent via e-mail to the
|
||||||
OfflineIMAP bug-tracking system (BTS) at
|
OfflineIMAP bug-tracking system (BTS) at
|
||||||
offlineimap@bugs.complete.org or submitted on-line using
|
offlineimap@bugs.complete.org or submitted on-line using
|
||||||
the Web interface at http://bugs.complete.org/.
|
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
|
COPYRIGHT
|
||||||
OfflineIMAP is Copyright (C) 2002 John Goerzen.
|
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
|
and/or modify it under the terms of the GNU General Public
|
||||||
License as published by the Free Software Foundation;
|
License as published by the Free Software Foundation;
|
||||||
either version 2 of the License, or (at your option) any
|
either version 2 of the License, or (at your option) any
|
||||||
later version.
|
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
|
useful, but WITHOUT ANY WARRANTY; without even the implied
|
||||||
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
||||||
PURPOSE. See the GNU General Public License for more
|
PURPOSE. See the GNU General Public License for more
|
||||||
details.
|
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:
|
License along with this program; if not, write to:
|
||||||
|
|
||||||
Free Software Foundation, Inc.
|
Free Software Foundation, Inc.
|
||||||
@ -458,9 +489,9 @@ COPYRIGHT
|
|||||||
USA
|
USA
|
||||||
|
|
||||||
AUTHOR
|
AUTHOR
|
||||||
OfflineIMAP, its libraries, documentation, and all
|
OfflineIMAP, its libraries, documentation, and all
|
||||||
included files, except where noted, was written by John
|
included files, except where noted, was written by John
|
||||||
Goerzen <jgoerzen@complete.org> and copyright is held as
|
Goerzen <jgoerzen@complete.org> and copyright is held as
|
||||||
stated in the COPYRIGHT section.
|
stated in the COPYRIGHT section.
|
||||||
|
|
||||||
OfflineIMAP may be downloaded, and information found, from
|
OfflineIMAP may be downloaded, and information found, from
|
||||||
@ -471,7 +502,7 @@ AUTHOR
|
|||||||
|
|
||||||
OfflineIMAP may also be downloaded using Subversion.
|
OfflineIMAP may also be downloaded using Subversion.
|
||||||
Additionally, the distributed tar.gz may be updated with a
|
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
|
information on getting OfflineIMAP with Subversion, please
|
||||||
visit:
|
visit:
|
||||||
|
|
||||||
|
|||||||
@ -309,6 +309,51 @@ Add these lines to your
|
|||||||
.B set spoolfile=+Personal/INBOX
|
.B set spoolfile=+Personal/INBOX
|
||||||
.PP
|
.PP
|
||||||
That's it!
|
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
|
.SH ERRORS
|
||||||
If you get one of some frequently-encountered or confusing errors,
|
If you get one of some frequently-encountered or confusing errors,
|
||||||
please check this section.
|
please check this section.
|
||||||
@ -532,6 +577,8 @@ or submitted on-line using the Web interface at
|
|||||||
.UR http://bugs.complete.org/
|
.UR http://bugs.complete.org/
|
||||||
http://bugs.complete.org/.
|
http://bugs.complete.org/.
|
||||||
.UE
|
.UE
|
||||||
|
The Web site also lists all current bugs, where you can check their
|
||||||
|
status or contribute to fixing them.
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
OfflineIMAP is Copyright (C) 2002 John Goerzen.
|
OfflineIMAP is Copyright (C) 2002 John Goerzen.
|
||||||
.PP
|
.PP
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user