-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>OfflineIMAP Manual</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFERENCE"
BGCOLOR="#FFFFFF"
><DIV
CLASS="REFNAMEDIV"
><A
-NAME="AEN15"
+NAME="AEN14"
></A
><H2
>Name</H2
><DIV
CLASS="REFSYNOPSISDIV"
><A
-NAME="AEN18"
+NAME="AEN17"
></A
><H2
>Synopsis</H2
><B
CLASS="COMMAND"
>offlineimap</B
-> [-1] [-P <VAR
+> [-1] [-P <TT
CLASS="REPLACEABLE"
->profiledir</VAR
->] [-a <VAR
+><I
+>profiledir</I
+></TT
+>] [-a <TT
CLASS="REPLACEABLE"
->accountlist</VAR
->] [-c <VAR
+><I
+>accountlist</I
+></TT
+>] [-c <TT
CLASS="REPLACEABLE"
->configfile</VAR
->] [-d <VAR
+><I
+>configfile</I
+></TT
+>] [-d <TT
CLASS="REPLACEABLE"
->debugtype[,...]</VAR
->] [-l <VAR
+><I
+>debugtype[,...]</I
+></TT
+>] [-l <TT
CLASS="REPLACEABLE"
->filename</VAR
->] [-o] [-u <VAR
+><I
+>filename</I
+></TT
+>] [-o] [-u <TT
CLASS="REPLACEABLE"
->interface</VAR
+><I
+>interface</I
+></TT
>]</P
><P
><B
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN40"
+NAME="AEN39"
></A
><H2
>Description</H2
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN58"
+NAME="AEN57"
></A
><H3
>Method of Operation</H3
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN67"
+NAME="AEN66"
></A
><H2
>Quick Start</H2
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN89"
+NAME="AEN88"
></A
><H2
>Installation</H2
>OfflineIMAP</SPAN
> from
<A
-HREF="http://quux.org/devel/offlineimap/"
+HREF="http://software.complete.org/offlineimap/"
TARGET="_top"
>the <SPAN
CLASS="APPLICATION"
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN95"
+NAME="AEN94"
></A
><H3
>Prerequisites</H3
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN109"
+NAME="AEN108"
></A
><H3
>System-Wide Installation, Debian</H3
><P
> If you are not tracking Debian unstable, download the Debian .deb
package from the <A
-HREF="http://quux.org/devel/offlineimap/"
+HREF="http://software.complete.org/offlineimap/"
TARGET="_top"
><SPAN
CLASS="APPLICATION"
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN121"
+NAME="AEN120"
></A
><H3
>System-Wide Installation, Other</H3
><P
> Download the tar.gz version of the package from the
<A
-HREF="http://quux.org/devel/offlineimap/"
+HREF="http://software.complete.org/offlineimap/"
TARGET="_top"
>website</A
>.
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN131"
+NAME="AEN130"
></A
><H3
>Single-Account Installation</H3
><P
> Download the tar.gz version of the package from the
<A
-HREF="http://quux.org/devel/offlineimap/"
+HREF="http://software.complete.org/offlineimap/"
TARGET="_top"
>website</A
>.
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN152"
+NAME="AEN151"
></A
><H2
>Options</H2
</P
></DD
><DT
->-P <VAR
+>-P <TT
CLASS="REPLACEABLE"
->profiledir</VAR
+><I
+>profiledir</I
+></TT
></DT
><DD
><P
CLASS="APPLICATION"
>OfflineIMAP</SPAN
> into profile mode. The program
- will create <VAR
+ will create <TT
CLASS="REPLACEABLE"
->profiledir</VAR
+><I
+>profiledir</I
+></TT
>
(it must not already exist). As it runs, Python profiling
information
is present for debugging and optimization only, and should NOT be used
unless you have a specific reason to do so. It will significantly
slow program performance, may reduce reliability, and can generate
- huge amounts of data. You must use the <VAR
+ huge amounts of data. You must use the <CODE
CLASS="OPTION"
->-1</VAR
+>-1</CODE
> option when
- you use <VAR
+ you use <CODE
CLASS="OPTION"
->-P</VAR
+>-P</CODE
>.
</P
></DD
><DT
->-a <VAR
+>-a <TT
CLASS="REPLACEABLE"
->accountlist</VAR
+><I
+>accountlist</I
+></TT
></DT
><DD
><P
</P
></DD
><DT
->-c <VAR
+>-c <TT
CLASS="REPLACEABLE"
->configfile</VAR
+><I
+>configfile</I
+></TT
></DT
><DD
><P
</P
></DD
><DT
->-d <VAR
+>-d <TT
CLASS="REPLACEABLE"
->debugtype[,...]</VAR
+><I
+>debugtype[,...]</I
+></TT
></DT
><DD
><P
>Enables debugging for OfflineIMAP. This is useful if
you are trying to track down a malfunction or figure out what is going
on under the hood. I suggest that you use this with
- <VAR
+ <CODE
CLASS="OPTION"
->-1</VAR
+>-1</CODE
> to make the results more sensible.</P
><P
-><VAR
+><CODE
CLASS="OPTION"
->-d</VAR
+>-d</CODE
> requires one or more debugtypes,
separated by commas. These define what exactly will be
debugged, and include three options: <SPAN
></DD
><DT
>-l
- <VAR
+ <TT
CLASS="REPLACEABLE"
->filename</VAR
+><I
+>filename</I
+></TT
></DT
><DD
><P
>Show summary of options.</P
></DD
><DT
->-u <VAR
+>-u <TT
CLASS="REPLACEABLE"
->interface</VAR
+><I
+>interface</I
+></TT
></DT
><DD
><P
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN219"
+NAME="AEN218"
></A
><H2
>User Interfaces</H2
CLASS="PROPERTY"
>ui</SPAN
> option in the configuration file specifies
- user interface preferences. The <VAR
+ user interface preferences. The <CODE
CLASS="OPTION"
->-u</VAR
+>-u</CODE
> command-line
option can override the configuration file setting. The available
values for the configuration file or command-line are described
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN225"
+NAME="AEN224"
></A
><H3
>Tk.Blinkenlights</H3
>, in part, as:
</P
><A
-NAME="AEN288"
+NAME="AEN287"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN294"
+NAME="AEN293"
></A
><H3
>Curses.Blinkenlights</H3
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN298"
+NAME="AEN297"
></A
><H3
>Tk.VerboseUI</H3
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN301"
+NAME="AEN300"
></A
><H3
>TTY.TTYUI</H3
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN304"
+NAME="AEN303"
></A
><H3
>Noninteractive.Basic</H3
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN308"
+NAME="AEN307"
></A
><H3
>Noninteractive.Quiet</H3
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN311"
+NAME="AEN310"
></A
><H2
>Examples</H2
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN314"
+NAME="AEN313"
></A
><H3
>Multiple Accounts with Mutt</H3
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN333"
+NAME="AEN332"
></A
><H3
>UW-IMAPD and References</H3
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN341"
+NAME="AEN340"
></A
><H3
>pythonfile Configuration File Option</H3
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN354"
+NAME="AEN353"
></A
><H2
>Errors</H2
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN357"
+NAME="AEN356"
></A
><H3
>UID validity problem for folder</H3
><PRE
CLASS="PROGRAMLISTING"
>rm -r ~/Folders/INBOX
-rm -r ~/.offlineimap/Account-<VAR
+rm -r ~/.offlineimap/Account-<TT
CLASS="REPLACEABLE"
->AccountName</VAR
+><I
+>AccountName</I
+></TT
>
-rm -r ~/.offlineimap/Repository-<VAR
+rm -r ~/.offlineimap/Repository-<TT
CLASS="REPLACEABLE"
->RepositoryName</VAR
+><I
+>RepositoryName</I
+></TT
></PRE
><P
> (Of course, replace AccountName and RepositoryName
> of the problem there.
</P
></DIV
+><DIV
+CLASS="REFSECT2"
+><A
+NAME="AEN381"
+></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
CLASS="REFSECT1"
><A
-NAME="AEN382"
+NAME="AEN390"
></A
><H2
>Other Frequently Asked Questions</H2
>folderfilter</SPAN
> and <SPAN
CLASS="PROPERTY"
->foldertrans</SPAN
+>nametrans</SPAN
>
configuration file options to request certain folders and rename them
as they come in if you like.
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN500"
+NAME="AEN508"
></A
><H2
>Conforming To</H2
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN513"
+NAME="AEN521"
></A
><H2
>Notes</H2
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN515"
+NAME="AEN523"
></A
><H3
>Deleting Local Folders</H3
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN522"
+NAME="AEN530"
></A
><H3
>Multiple Instances</H3
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN529"
+NAME="AEN537"
></A
><H3
>Copying Messages Between Folders</H3
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN535"
+NAME="AEN543"
></A
><H3
>Use with Evolution</H3
CLASS="APPLICATION"
>OfflineIMAP</SPAN
> account to have
- <VAR
+ <CODE
CLASS="OPTION"
->sep = /</VAR
+>sep = /</CODE
> in its configuration. Then, configure
Evolution with the
"Maildir-format mail directories" server type. For the path, you will need to
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN543"
+NAME="AEN551"
></A
><H3
>Use with KMail</H3
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN551"
+NAME="AEN559"
></A
><H3
>Mailing List</H3
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN555"
+NAME="AEN563"
></A
><H3
>Bugs</H3
<SPAN
CLASS="APPLICATION"
>OfflineIMAP</SPAN
-> bug-tracking system (BTS) at
- offlineimap@bugs.complete.org or submitted online using
- the <A
-HREF="http://bugs.complete.org/"
-TARGET="_top"
->web interface</A
->.
- </P
-><P
-> The Web site also lists all current bugs, where you can check their
- status or contribute to fixing them.
+> mailing list at offlineimap at complete
+ dot org. Debian users are encouraged to instead use the
+ Debian
+ bug-tracking system.
</P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN575"
+NAME="AEN581"
></A
><H2
>Copyright</H2
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN584"
+NAME="AEN590"
></A
><H2
>Author</H2
CLASS="APPLICATION"
>OfflineIMAP</SPAN
> may be downloaded, and information found, from its
- homepage via either <A
-HREF="gopher://quux.org/1/devel/offlineimap"
-TARGET="_top"
->Gopher</A
->
- or <A
-HREF="http://quux.org/devel/offlineimap"
+ <A
+HREF="http://software.complete.org/offlineimap"
TARGET="_top"
->HTTP</A
+>homepage</A
>.
</P
><P
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN596"
+NAME="AEN601"
></A
><H2
>See Also</H2
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN601"
+NAME="AEN606"
></A
><H2
>History</H2