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

/offlineimap/head: changeset 590

Browse Source 
Preparing 4.0.6
This commit is contained in:
jgoerzen 2004-07-26 21:47:36 +01:00
parent dd9f6475e6
commit e23d476f9c
11 changed files with 596 additions and 422 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
offlineimap/head/ChangeLog
View File

@ -1,4 +1,15 @@
------------------------------------------------------------------------ ------------------------------------------------------------------------
r589 | jgoerzen | 2004-07-26 10:37:45 -0500 (Mon, 26 Jul 2004) | 1 line
Changed paths:
M /offlineimap/head/ChangeLog
M /offlineimap/head/debian/changelog
M /offlineimap/head/offlineimap/folder/IMAP.py
M /offlineimap/head/offlineimap/ui/Curses.py
M /offlineimap/head/offlineimap/ui/Tk.py
M /offlineimap/head/offlineimap.sgml
Various bug fixes and enhancements
------------------------------------------------------------------------
r588 | jgoerzen | 2004-07-13 10:25:27 -0500 (Tue, 13 Jul 2004) | 1 line r588 | jgoerzen | 2004-07-13 10:25:27 -0500 (Tue, 13 Jul 2004) | 1 line
Changed paths: Changed paths:
M /offlineimap/head/bin/offlineimap M /offlineimap/head/bin/offlineimap

2
offlineimap/head/bin/offlineimap
View File

@ -18,4 +18,4 @@
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
from offlineimap import init from offlineimap import init
init.startup('4.0.5') init.startup('4.0.6')

2
offlineimap/head/debian/changelog
View File

@ -4,6 +4,8 @@ offlineimap (4.0.6) unstable; urgency=low
* Added version to generated header. Closes: #257893. * Added version to generated header. Closes: #257893.
* Fixed warn() in Tk (reported by Martin Pool). * Fixed warn() in Tk (reported by Martin Pool).
* Added Windows documentation from Chris Walker to the FAQ. * Added Windows documentation from Chris Walker to the FAQ.
* Added Build-Conflicts for docbook-ebnf; it can mess up the doc
building.
-- John Goerzen <jgoerzen@complete.org> Mon, 26 Jul 2004 10:04:06 -0500 -- John Goerzen <jgoerzen@complete.org> Mon, 26 Jul 2004 10:04:06 -0500

1
offlineimap/head/debian/control
View File

@ -3,6 +3,7 @@ Section: mail
Priority: optional Priority: optional
Maintainer: John Goerzen <jgoerzen@complete.org> Maintainer: John Goerzen <jgoerzen@complete.org>
Build-Depends-Indep: debhelper (>> 4.2.0), python2.3, python2.3-dev (>= 2.2.2), groff, docbook-utils, python (>= 2.3), python-dev (>= 2.3) Build-Depends-Indep: debhelper (>> 4.2.0), python2.3, python2.3-dev (>= 2.2.2), groff, docbook-utils, python (>= 2.3), python-dev (>= 2.3)
Build-Conflicts-Indep: docbook-ebnf
Standards-Version: 3.5.2 Standards-Version: 3.5.2
Package: offlineimap Package: offlineimap

87
offlineimap/head/manual.html
View File

@ -262,7 +262,7 @@ CLASS="FILENAME"
>offlineimap.conf.minimal</TT >offlineimap.conf.minimal</TT
> >
(Debian users (Debian users
may find this at may find this at
<TT <TT
CLASS="FILENAME" CLASS="FILENAME"
>/usr/share/doc/offlineimap/examples/offlineimap.conf.minimal</TT >/usr/share/doc/offlineimap/examples/offlineimap.conf.minimal</TT
@ -1470,7 +1470,8 @@ CLASS="APPLICATION"
><DD ><DD
><P ><P
> It should run on most platforms supported by Python, which are quite a > It should run on most platforms supported by Python, which are quite a
few. few. I do not support Windows myself, but some have made
it work there; see the FAQ entry for that platform.
</P </P
></DD ></DD
><DT ><DT
@ -1725,13 +1726,69 @@ CLASS="PROPERTY"
></LI ></LI
></UL ></UL
></DD ></DD
><DT
>Can I use <SPAN
CLASS="APPLICATION"
>OfflineIMAP</SPAN
> on Windows?</DT
><DD
><P
> These answers have been reported by <SPAN
CLASS="APPLICATION"
>OfflineIMAP</SPAN
>
users. I do not run <SPAN
CLASS="APPLICATION"
>OfflineIMAP</SPAN
> on Windows myself, so
I can't directly address their accuracy.
</P
><P
> The basic answer is that it's possible and doesn't
require hacking <SPAN
CLASS="APPLICATION"
>OfflineIMAP</SPAN
> source code. However,
it's not necessarily trivial. The information below is
based in instructions submitted by Chris Walker.
</P
><P
> First, you must run <SPAN
CLASS="APPLICATION"
>OfflineIMAP</SPAN
> in the <A
HREF="http://www.cygwin.com/"
TARGET="_top"
>Cygwin</A
>
environment.
</P
><P
> Next, you'll need to mount your Maildir directory in a
special way. There is information for doing that at
<A
HREF="http://barnson.org/node/view/295"
TARGET="_top"
>http://barnson.org/node/view/295</A
>.
That site gives this example:
</P
><PRE
CLASS="PROGRAMLISTING"
>mount -f -s -b -o managed "d:/tmp/mail" "/home/of/mail"
</PRE
><P
> That URL also has more details on making OfflineIMAP
work with Windows.
</P
></DD
></DL ></DL
></DIV ></DIV
></DIV ></DIV
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN484" NAME="AEN500"
></A ></A
><H2 ><H2
>Conforming To</H2 >Conforming To</H2
@ -1770,14 +1827,14 @@ TARGET="_top"
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN497" NAME="AEN513"
></A ></A
><H2 ><H2
>Notes</H2 >Notes</H2
><DIV ><DIV
CLASS="REFSECT2" CLASS="REFSECT2"
><A ><A
NAME="AEN499" NAME="AEN515"
></A ></A
><H3 ><H3
>Deleting Local Folders</H3 >Deleting Local Folders</H3
@ -1809,7 +1866,7 @@ CLASS="APPLICATION"
><DIV ><DIV
CLASS="REFSECT2" CLASS="REFSECT2"
><A ><A
NAME="AEN506" NAME="AEN522"
></A ></A
><H3 ><H3
>Multiple Instances</H3 >Multiple Instances</H3
@ -1838,7 +1895,7 @@ CLASS="PROPERTY"
><DIV ><DIV
CLASS="REFSECT2" CLASS="REFSECT2"
><A ><A
NAME="AEN513" NAME="AEN529"
></A ></A
><H3 ><H3
>Copying Messages Between Folders</H3 >Copying Messages Between Folders</H3
@ -1868,7 +1925,7 @@ CLASS="APPLICATION"
><DIV ><DIV
CLASS="REFSECT2" CLASS="REFSECT2"
><A ><A
NAME="AEN519" NAME="AEN535"
></A ></A
><H3 ><H3
>Use with Evolution</H3 >Use with Evolution</H3
@ -1904,7 +1961,7 @@ CLASS="APPLICATION"
><DIV ><DIV
CLASS="REFSECT2" CLASS="REFSECT2"
><A ><A
NAME="AEN527" NAME="AEN543"
></A ></A
><H3 ><H3
>Use with KMail</H3 >Use with KMail</H3
@ -1938,7 +1995,7 @@ CLASS="APPLICATION"
><DIV ><DIV
CLASS="REFSECT2" CLASS="REFSECT2"
><A ><A
NAME="AEN535" NAME="AEN551"
></A ></A
><H3 ><H3
>Mailing List</H3 >Mailing List</H3
@ -1957,7 +2014,7 @@ TARGET="_top"
><DIV ><DIV
CLASS="REFSECT2" CLASS="REFSECT2"
><A ><A
NAME="AEN539" NAME="AEN555"
></A ></A
><H3 ><H3
>Bugs</H3 >Bugs</H3
@ -2046,7 +2103,7 @@ CLASS="APPLICATION"
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN559" NAME="AEN575"
></A ></A
><H2 ><H2
>Copyright</H2 >Copyright</H2
@ -2084,7 +2141,7 @@ CLASS="APPLICATION"
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN568" NAME="AEN584"
></A ></A
><H2 ><H2
>Author</H2 >Author</H2
@ -2136,7 +2193,7 @@ TARGET="_top"
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN580" NAME="AEN596"
></A ></A
><H2 ><H2
>See Also</H2 >See Also</H2
@ -2154,7 +2211,7 @@ CLASS="APPLICATION"
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN585" NAME="AEN601"
></A ></A
><H2 ><H2
>History</H2 >History</H2

BIN
offlineimap/head/manual.pdf
View File

Binary file not shown.

779
offlineimap/head/manual.ps
View File

File diff suppressed because it is too large Load Diff

97
offlineimap/head/manual.txt
View File

@ -544,22 +544,23 @@ OTHER FREQUENTLY ASKED QUESTIONS
What platforms does OfflineIMAP run on? What platforms does OfflineIMAP run on?
It should run on most platforms supported by Python, which are It should run on most platforms supported by Python, which are
quite a few. quite a few. I do not support Windows myself, but some have
made it work there; see the FAQ entry for that platform.
I'm using Mutt. Other IMAP sync programs require me to use "set I'm using Mutt. Other IMAP sync programs require me to use "set
maildir_trash=yes". Do I need to do that with OfflineIMAP? maildir_trash=yes". Do I need to do that with OfflineIMAP?
No. OfflineIMAP is smart enough to figure out message deletion No. OfflineIMAP is smart enough to figure out message deletion
without this extra crutch. You'll get the best results if you without this extra crutch. You'll get the best results if you
don't use this setting, in fact. don't use this setting, in fact.
I've upgraded and now OfflineIMAP crashes when I start it up! Why? I've upgraded and now OfflineIMAP crashes when I start it up! Why?
You need to upgrade your configuration file. See [XRef to You need to upgrade your configuration file. See [XRef to
UPGRADING.4.0] at the end of this manual. UPGRADING.4.0] at the end of this manual.
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 automati- You do not need to. OfflineIMAP is smart enough to automati-
cally figure out what folders are present on the IMAP server and cally figure out what folders are present on the IMAP server and
synchronize them. You can use the folderfilter and foldertrans synchronize them. You can use the folderfilter and foldertrans
configuration file options to request certain folders and rename configuration file options to request certain folders and rename
them as they come in if you like. them as they come in if you like.
@ -567,69 +568,69 @@ OTHER FREQUENTLY ASKED QUESTIONS
Use the folderfilter option in the configuration file. Use the folderfilter option in the configuration file.
How can I add or delete a folder? How can I add or delete a folder?
OfflineIMAP does not currently provide this feature, but if you OfflineIMAP does not currently provide this feature, but if you
create a new folder on the IMAP server, it will be created create a new folder on the IMAP server, it will be created
locally automatically. 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?
Some mail readers, such as Mutt, are not capable of automati- Some mail readers, such as Mutt, are not capable of automati-
cally determining the names of your mailboxes. OfflineIMAP can cally determining the names of your mailboxes. OfflineIMAP can
help these programs by writing the names of the folders in a help these programs by writing the names of the folders in a
format you specify. See the example offlineimap.conf for format you specify. See the example offlineimap.conf 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 the general Sure. Just name them all in the accounts line in the general
section of the configuration file, and add a per-account section section of the configuration file, and add a per-account section
for each one. for each one.
Does OfflineIMAP support POP? Does OfflineIMAP support POP?
No. POP is not robust enough to do a completely reliable multi- No. POP is not robust enough to do a completely reliable multi-
machine synchronization like OfflineIMAP can do. OfflineIMAP machine synchronization like OfflineIMAP can do. OfflineIMAP
will not support it. will not support it.
Does OfflineIMAP support mailbox formats other than Maildir? Does OfflineIMAP support mailbox formats other than Maildir?
Not at present. There is no technical reason not to; just no Not at present. There is no technical reason not to; just no
demand yet. Maildir is a superior format anyway. However, demand yet. Maildir is a superior format anyway. However,
OfflineIMAP can sync between two IMAP servers, and some IMAP OfflineIMAP can sync between two IMAP servers, and some IMAP
servers support other formats. You could install an IMAP server servers support other formats. You could install an IMAP server
on your local machine and have OfflineIMAP sync to that. on your local machine and have OfflineIMAP sync to that.
[technical] Why are your Maildir message filenames so huge? [technical] Why are your Maildir message filenames so huge?
OfflineIMAP has two relevant principles: 1) never modifying your OfflineIMAP has two relevant principles: 1) never modifying your
messages in any way and 2) ensuring 100% reliable messages in any way and 2) ensuring 100% reliable
synchronizations. In order to do a reliable sync, OfflineIMAP synchronizations. In order to do a reliable sync, OfflineIMAP
must have a way to uniquely identify each e-mail. Three pieces must have a way to uniquely identify each e-mail. Three pieces
of information are required to do this: your account name, the of information are required to do this: your account name, the
folder name, and the message UID. The account name can be cal- folder name, and the message UID. The account name can be cal-
culated from the path in which your messages are. The folder culated from the path in which your messages are. The folder
name can usually be as well, BUT some mail clients move messages name can usually be as well, BUT some mail clients move messages
between folders by simply moving the file, leaving the name between folders by simply moving the file, leaving the name
intact. intact.
So, OfflineIMAP must store both a UID folder ID. The folder ID So, OfflineIMAP must store both a UID folder ID. The folder ID
is necessary so OfflineIMAP can detect a message moved to a dif- is necessary so OfflineIMAP can detect a message moved to a dif-
ferent folder. OfflineIMAP stores the UID (U= number) and an ferent folder. OfflineIMAP stores the UID (U= number) and an
md5sum of the foldername (FMD5= number) to facilitate this. md5sum of the foldername (FMD5= number) to facilitate 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 multithreaded sys- OfflineIMAP versions 2.0 and above contain a multithreaded sys-
tem. A good way to experiment is by setting maxsyncaccounts to tem. A good way to experiment is by setting maxsyncaccounts to
3 and maxconnections to 3 in each account clause. 3 and maxconnections to 3 in each account clause.
This lets OfflineIMAP open up multiple connections simultane- This lets OfflineIMAP open up multiple connections simultane-
ously. That will let it process multiple folders and messages ously. That will let it process multiple folders and messages
at once. In most cases, this will increase performance of the at once. In most cases, this will increase performance of the
sync. sync.
Don't set the number too high. If you do that, things might Don't set the number too high. If you do that, things might
actually slow down as your link gets saturated. Also, too many actually slow down as your link gets saturated. Also, too many
connections can cause mail servers to have excessive load. connections can cause mail servers to have excessive load.
Administrators might take unkindly to this, and the server might Administrators might take unkindly to this, and the server might
bog down. There are many variables in the optimal setting; bog down. There are many variables in the optimal setting;
experimentation may help. experimentation may help.
An informal benchmark yields these results for my setup: An informal benchmark yields these results for my setup:
@ -646,6 +647,30 @@ OTHER FREQUENTLY ASKED QUESTIONS
o 2 seconds with OfflineIMAP 3.x "held connection" o 2 seconds with OfflineIMAP 3.x "held connection"
Can I use OfflineIMAP on Windows?
These answers have been reported by OfflineIMAP users. I do not
run OfflineIMAP on Windows myself, so I can't directly address
their accuracy.
The basic answer is that it's possible and doesn't require hack-
ing OfflineIMAP source code. However, it's not necessarily
trivial. The information below is based in instructions submit-
ted by Chris Walker.
First, you must run OfflineIMAP in the Cygwin
<URL:http://www.cygwin.com/> environment.
Next, you'll need to mount your Maildir directory in a special
way. There is information for doing that at
<URL:http://barnson.org/node/view/295>. That site gives this
example:
mount -f -s -b -o managed "d:/tmp/mail" "/home/of/mail"
That URL also has more details on making OfflineIMAP work with
Windows.
CONFORMING TO CONFORMING TO
o Internet Message Access Protocol version 4rev1 (IMAP 4rev1) as speci- o Internet Message Access Protocol version 4rev1 (IMAP 4rev1) as speci-
fied in RFC2060 and RFC3501 fied in RFC2060 and RFC3501
@ -822,4 +847,4 @@ HISTORY
John Goerzen 04 June 2004 OFFLINEIMAP(1) John Goerzen 26 July 2004 OFFLINEIMAP(1)

31
offlineimap/head/offlineimap.1
View File

@ -3,7 +3,7 @@
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
.\" Please send any bug reports, improvements, comments, patches, .\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng <steve@ggi-project.org>. .\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "OFFLINEIMAP" "1" "04 June 2004" "John Goerzen" "OfflineIMAP Manual" .TH "OFFLINEIMAP" "1" "26 July 2004" "John Goerzen" "OfflineIMAP Manual"
.SH NAME .SH NAME
OfflineIMAP \- Powerful IMAP/Maildir synchronization and reader support OfflineIMAP \- Powerful IMAP/Maildir synchronization and reader support
@ -643,7 +643,8 @@ of the document, so they are discussed here.
.TP .TP
\fBWhat platforms does OfflineIMAP run on?\fR \fBWhat platforms does OfflineIMAP run on?\fR
It should run on most platforms supported by Python, which are quite a It should run on most platforms supported by Python, which are quite a
few. few. I do not support Windows myself, but some have made
it work there; see the FAQ entry for that platform.
.TP .TP
\fBI'm using Mutt. Other IMAP sync programs require me to use "set maildir_trash=yes". Do I need to do that with OfflineIMAP?\fR \fBI'm using Mutt. Other IMAP sync programs require me to use "set maildir_trash=yes". Do I need to do that with OfflineIMAP?\fR
No. \fBOfflineIMAP\fR is smart enough to figure out message deletion without this extra No. \fBOfflineIMAP\fR is smart enough to figure out message deletion without this extra
@ -753,6 +754,32 @@ An informal benchmark yields these results for my setup:
\(bu \(bu
2 seconds with OfflineIMAP 3.x "held connection" 2 seconds with OfflineIMAP 3.x "held connection"
.RE .RE
.TP
\fBCan I use OfflineIMAP on Windows?\fR
These answers have been reported by \fBOfflineIMAP\fR
users. I do not run \fBOfflineIMAP\fR on Windows myself, so
I can't directly address their accuracy.
The basic answer is that it's possible and doesn't
require hacking \fBOfflineIMAP\fR source code. However,
it's not necessarily trivial. The information below is
based in instructions submitted by Chris Walker.
First, you must run \fBOfflineIMAP\fR in the Cygwin <URL:http://www.cygwin.com/>
environment.
Next, you'll need to mount your Maildir directory in a
special way. There is information for doing that at
<URL:http://barnson.org/node/view/295>.
That site gives this example:
.nf
mount -f -s -b -o managed "d:/tmp/mail" "/home/of/mail"
.fi
That URL also has more details on making OfflineIMAP
work with Windows.
.SH "CONFORMING TO" .SH "CONFORMING TO"
.TP 0.2i .TP 0.2i
\(bu \(bu

2
offlineimap/head/offlineimap.py
View File

@ -18,4 +18,4 @@
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
from offlineimap import init from offlineimap import init
init.startup('4.0.5') init.startup('4.0.6')

6
offlineimap/head/offlineimap/version.py
View File

@ -1,8 +1,8 @@
productname = 'OfflineIMAP' productname = 'OfflineIMAP'
versionstr = "4.0.5" versionstr = "4.0.6"
revno = long('$Rev: 588 $'[6:-2]) revno = long('$Rev: 590 $'[6:-2])
revstr = "Rev %d" % revno revstr = "Rev %d" % revno
datestr = '$Date: 2004-07-13 10:25:27 -0500 (Tue, 13 Jul 2004) $' datestr = '$Date: 2004-07-26 10:47:36 -0500 (Mon, 26 Jul 2004) $'
versionlist = versionstr.split(".") versionlist = versionstr.split(".")
major = versionlist[0] major = versionlist[0]