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

Regen docs

Browse Source
This commit is contained in:
John Goerzen 2005-09-28 18:17:13 +01:00
parent e2b37c5d69
commit 09234620eb
5 changed files with 505 additions and 404 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

67
manual.html
View File

@ -1475,11 +1475,48 @@ TARGET="_top"
> of the problem there. > of the problem there.
</P </P
></DIV ></DIV
><DIV
CLASS="REFSECT2"
><A
NAME="AEN382"
></A
><H3
>Use with MS Exchange server</H3
><P
> Several users have reported problems with Microsoft Exchange
servers in conjunction with OfflineIMAP. This generally
seems to be related to the Exchange servers not properly
following the IMAP standards.
</P
><P
> Mark Biggers has posted some <A
HREF="http://lists.complete.org/offlineimap@complete.org/2005/09/msg00011.html.gz"
TARGET="_top"
>information</A
>
to the <SPAN
CLASS="APPLICATION"
>OfflineIMAP</SPAN
> mailing list about how he made it work.
</P
><P
> Other users have indicated that older (5.5) releases of
Exchange are so bad that they will likely not work at all.
</P
><P
> I do not have access to Exchange servers for testing, so any
problems with it, if they can even be solved at all, will
require help from <SPAN
CLASS="APPLICATION"
>OfflineIMAP</SPAN
> users to find and fix.
</P
></DIV
></DIV ></DIV
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN382" NAME="AEN391"
></A ></A
><H2 ><H2
>Other Frequently Asked Questions</H2 >Other Frequently Asked Questions</H2
@ -1818,7 +1855,7 @@ CLASS="PROGRAMLISTING"
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN500" NAME="AEN509"
></A ></A
><H2 ><H2
>Conforming To</H2 >Conforming To</H2
@ -1857,14 +1894,14 @@ TARGET="_top"
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN513" NAME="AEN522"
></A ></A
><H2 ><H2
>Notes</H2 >Notes</H2
><DIV ><DIV
CLASS="REFSECT2" CLASS="REFSECT2"
><A ><A
NAME="AEN515" NAME="AEN524"
></A ></A
><H3 ><H3
>Deleting Local Folders</H3 >Deleting Local Folders</H3
@ -1896,7 +1933,7 @@ CLASS="APPLICATION"
><DIV ><DIV
CLASS="REFSECT2" CLASS="REFSECT2"
><A ><A
NAME="AEN522" NAME="AEN531"
></A ></A
><H3 ><H3
>Multiple Instances</H3 >Multiple Instances</H3
@ -1925,7 +1962,7 @@ CLASS="PROPERTY"
><DIV ><DIV
CLASS="REFSECT2" CLASS="REFSECT2"
><A ><A
NAME="AEN529" NAME="AEN538"
></A ></A
><H3 ><H3
>Copying Messages Between Folders</H3 >Copying Messages Between Folders</H3
@ -1955,7 +1992,7 @@ CLASS="APPLICATION"
><DIV ><DIV
CLASS="REFSECT2" CLASS="REFSECT2"
><A ><A
NAME="AEN535" NAME="AEN544"
></A ></A
><H3 ><H3
>Use with Evolution</H3 >Use with Evolution</H3
@ -1991,7 +2028,7 @@ CLASS="APPLICATION"
><DIV ><DIV
CLASS="REFSECT2" CLASS="REFSECT2"
><A ><A
NAME="AEN543" NAME="AEN552"
></A ></A
><H3 ><H3
>Use with KMail</H3 >Use with KMail</H3
@ -2025,7 +2062,7 @@ CLASS="APPLICATION"
><DIV ><DIV
CLASS="REFSECT2" CLASS="REFSECT2"
><A ><A
NAME="AEN551" NAME="AEN560"
></A ></A
><H3 ><H3
>Mailing List</H3 >Mailing List</H3
@ -2044,7 +2081,7 @@ TARGET="_top"
><DIV ><DIV
CLASS="REFSECT2" CLASS="REFSECT2"
><A ><A
NAME="AEN555" NAME="AEN564"
></A ></A
><H3 ><H3
>Bugs</H3 >Bugs</H3
@ -2126,12 +2163,12 @@ CLASS="APPLICATION"
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN573" NAME="AEN582"
></A ></A
><H2 ><H2
>Copyright</H2 >Copyright</H2
><P ><P
>OfflineIMAP, and this manual, are Copyright © 2002, 2003 John Goerzen.</P >OfflineIMAP, and this manual, are Copyright &copy; 2002, 2003 John Goerzen.</P
><P ><P
> This program is free software; you can redistribute it and/or modify > 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 it under the terms of the GNU General Public License as published by
@ -2164,7 +2201,7 @@ CLASS="APPLICATION"
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN582" NAME="AEN591"
></A ></A
><H2 ><H2
>Author</H2 >Author</H2
@ -2216,7 +2253,7 @@ TARGET="_top"
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN594" NAME="AEN603"
></A ></A
><H2 ><H2
>See Also</H2 >See Also</H2
@ -2234,7 +2271,7 @@ CLASS="APPLICATION"
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN599" NAME="AEN608"
></A ></A
><H2 ><H2
>History</H2 >History</H2

BIN
manual.pdf
View File

Binary file not shown.

690
manual.ps
View File

File diff suppressed because it is too large Load Diff

132
manual.txt
View File

@ -538,29 +538,45 @@ ERRORS
plete.org/offlineimap@complete.org/2003/04/msg00012.html.gz> of the plete.org/offlineimap@complete.org/2003/04/msg00012.html.gz> of the
problem there. problem there.
USE WITH MS EXCHANGE SERVER
Several users have reported problems with Microsoft Exchange servers in
conjunction with OfflineIMAP. This generally seems to be related to
the Exchange servers not properly following the IMAP standards.
Mark Biggers has posted some information <URL:http://lists.com-
plete.org/offlineimap@complete.org/2005/09/msg00011.html.gz> to the
OfflineIMAP mailing list about how he made it work.
Other users have indicated that older (5.5) releases of Exchange are so
bad that they will likely not work at all.
I do not have access to Exchange servers for testing, so any problems
with it, if they can even be solved at all, will require help from
OfflineIMAP users to find and fix.
OTHER FREQUENTLY ASKED QUESTIONS OTHER FREQUENTLY ASKED QUESTIONS
There are some other FAQs that might not fit into another section of There are some other FAQs that might not fit into another section of
the document, so they are discussed here. the document, so they are discussed here.
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. I do not support Windows myself, but some have quite a few. I do not support Windows myself, but some have
made it work there; see the FAQ entry for that platform. 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 nametrans synchronize them. You can use the folderfilter and nametrans
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.
@ -568,48 +584,47 @@ 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 synchroniza-
synchronizations. In order to do a reliable sync, OfflineIMAP tions. In order to do a reliable sync, OfflineIMAP must have a
must have a way to uniquely identify each e-mail. Three pieces way to uniquely identify each e-mail. Three pieces of informa-
of information are required to do this: your account name, the tion are required to do this: your account name, the folder
folder name, and the message UID. The account name can be cal- name, and the message UID. The account name can be calculated
culated from the path in which your messages are. The folder from the path in which your messages are. The folder name can
name can usually be as well, BUT some mail clients move messages usually be as well, BUT some mail clients move messages between
between folders by simply moving the file, leaving the name 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-
@ -770,77 +785,78 @@ UPGRADING TO 4.0
from the server and then you can continue using it like normal. from the server and then you can continue using it like normal.
COPYRIGHT COPYRIGHT
OfflineIMAP, and this manual, are Copyright 2002, 2003 John Goerzen. OfflineIMAP, and this manual, are Copyright (C) 2002, 2003 John
Goerzen.
This program is free software; you can redistribute it and/or modify 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 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 Free Software Foundation; either version 2 of the License, or (at your
option) any later version. option) any later version.
This program is distributed in the hope that it will be useful, but This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MER- WITHOUT ANY WARRANTY; without even the implied warranty of MER-
CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
Public License for more details. Public License for more details.
You should have received a copy of the GNU General Public License along You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc., with this program; if not, write to the Free Software Foundation, Inc.,
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
imaplib.py comes from the Python dev tree and is licensed under the imaplib.py comes from the Python dev tree and is licensed under the
GPL-compatible PSF license as stated in the file COPYRIGHT in the GPL-compatible PSF license as stated in the file COPYRIGHT in the
OfflineIMAP distribution. OfflineIMAP distribution.
AUTHOR AUTHOR
OfflineIMAP, its libraries, documentation, and all included files, OfflineIMAP, its libraries, documentation, and all included files,
except where noted, was written by John Goerzen <jgoerzen@complete.org> except where noted, was written by John Goerzen <jgoerzen@complete.org>
and copyright is held as stated in the COPYRIGHT section. and copyright is held as stated in the COPYRIGHT section.
OfflineIMAP may be downloaded, and information found, from its homepage OfflineIMAP may be downloaded, and information found, from its homepage
via either Gopher <URL:gopher://quux.org/1/devel/offlineimap> or HTTP via either Gopher <URL:gopher://quux.org/1/devel/offlineimap> or HTTP
<URL:http://quux.org/devel/offlineimap>. <URL:http://quux.org/devel/offlineimap>.
OfflineIMAP may also be downloaded using Subversion. Additionally, the OfflineIMAP may also be downloaded using Subversion. Additionally, the
distributed tar.gz may be updated with a simple "svn update" command; distributed tar.gz may be updated with a simple "svn update" command;
it is ready to go. For information on getting OfflineIMAP with Subver- it is ready to go. For information on getting OfflineIMAP with Subver-
sion, please visit the complete.org Subversion page sion, please visit the complete.org Subversion page
<URL:http://svn.complete.org/>. <URL:http://svn.complete.org/>.
SEE ALSO SEE ALSO
mutt(1), python(1) mutt(1), python(1)
HISTORY HISTORY
Detailed history may be found in the file ChangeLog in the OfflineIMAP Detailed history may be found in the file ChangeLog in the OfflineIMAP
distribution. Feature and bug histories may be found in the file distribution. Feature and bug histories may be found in the file
debian/changelog which, despite its name, is not really Debian-spe- debian/changelog which, despite its name, is not really Debian-spe-
cific. This section provides a large overview. cific. This section provides a large overview.
Development on OfflineIMAP began on June 18, 2002. Version 1.0.0 was Development on OfflineIMAP began on June 18, 2002. Version 1.0.0 was
released three days later on June 21, 2002. Point releases followed, released three days later on June 21, 2002. Point releases followed,
including speed optimizations and some compatibility fixes. including speed optimizations and some compatibility fixes.
Version 2.0.0 was released on July 3, 2002, and represented the first Version 2.0.0 was released on July 3, 2002, and represented the first
time the synchronization became multithreaded and, to the best of my time the synchronization became multithreaded and, to the best of my
knowledge, the first multithreaded IMAP syncrhonizing application in knowledge, the first multithreaded IMAP syncrhonizing application in
existance. The last 2.0.x release, 2.0.8, was made on July 9. existance. The last 2.0.x release, 2.0.8, was made on July 9.
Version 3.0.0 was released on July 11, 2002, and introduced modular Version 3.0.0 was released on July 11, 2002, and introduced modular
user interfaces and the first GUI interface for OfflineIMAP. This man- user interfaces and the first GUI interface for OfflineIMAP. This man-
ual also was introduced with 3.0.0, along with many command-line ual also was introduced with 3.0.0, along with many command-line
options. Version 3.1.0 was released on July 21, adding the Noninterac- options. Version 3.1.0 was released on July 21, adding the Noninterac-
tive user interfaces, profiling support, and several bugfixes. 3.2.0 tive user interfaces, profiling support, and several bugfixes. 3.2.0
was released on July 24, adding support for the Blinkenlights GUI was released on July 24, adding support for the Blinkenlights GUI
interface. OfflineIMAP entered maintenance mode for awhile, as it had interface. OfflineIMAP entered maintenance mode for awhile, as it had
reached a feature-complete milestone in my mind. reached a feature-complete milestone in my mind.
The 3.99.x branch began in on October 7, 2002, to begin work for 4.0. The 3.99.x branch began in on October 7, 2002, to begin work for 4.0.
The Curses.Blinkenlights interface was added in 3.99.6, and many archi- The Curses.Blinkenlights interface was added in 3.99.6, and many archi-
tectural changes were made. tectural changes were made.
4.0.0 was released on July 18, 2003, including the ability to synchro- 4.0.0 was released on July 18, 2003, including the ability to synchro-
nize directly between two IMAP servers, the first re-architecting of nize directly between two IMAP servers, the first re-architecting of
the configuration file to refine the notion of an account, and the new the configuration file to refine the notion of an account, and the new
Curses interface. Curses interface.
John Goerzen 17 June 2005 OFFLINEIMAP(1) John Goerzen 28 September 2005 OFFLINEIMAP(1)

20
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" "17 June 2005" "John Goerzen" "OfflineIMAP Manual" .TH "OFFLINEIMAP" "1" "28 September 2005" "John Goerzen" "OfflineIMAP Manual"
.SH NAME .SH NAME
OfflineIMAP \- Powerful IMAP/Maildir synchronization and reader support OfflineIMAP \- Powerful IMAP/Maildir synchronization and reader support
@ -636,6 +636,22 @@ This question comes up frequently on the
mailing list <URL:http://lists.complete.org/offlineimap@complete.org/>\&. You can find a mailing list <URL:http://lists.complete.org/offlineimap@complete.org/>\&. You can find a
detailed detailed
discussion <URL:http://lists.complete.org/offlineimap@complete.org/2003/04/msg00012.html.gz> of the problem there. discussion <URL:http://lists.complete.org/offlineimap@complete.org/2003/04/msg00012.html.gz> of the problem there.
.SS "USE WITH MS EXCHANGE SERVER"
.PP
Several users have reported problems with Microsoft Exchange
servers in conjunction with OfflineIMAP. This generally
seems to be related to the Exchange servers not properly
following the IMAP standards.
.PP
Mark Biggers has posted some information <URL:http://lists.complete.org/offlineimap@complete.org/2005/09/msg00011.html.gz>
to the \fBOfflineIMAP\fR mailing list about how he made it work.
.PP
Other users have indicated that older (5.5) releases of
Exchange are so bad that they will likely not work at all.
.PP
I do not have access to Exchange servers for testing, so any
problems with it, if they can even be solved at all, will
require help from \fBOfflineIMAP\fR users to find and fix.
.SH "OTHER FREQUENTLY ASKED QUESTIONS" .SH "OTHER FREQUENTLY ASKED QUESTIONS"
.PP .PP
There are some other FAQs that might not fit into another section There are some other FAQs that might not fit into another section
@ -898,7 +914,7 @@ your mail from the server and then you can continue using it
like normal. like normal.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.PP .PP
OfflineIMAP, and this manual, are Copyright © 2002, 2003 John Goerzen. OfflineIMAP, and this manual, are Copyright (C) 2002, 2003 John Goerzen.
.PP .PP
This program is free software; you can redistribute it and/or modify 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 it under the terms of the GNU General Public License as published by