Removed more FAQ stuff from the manual
This commit is contained in:
John Goerzen
parent
8dbfbb7ed9
commit
612e89964f
168
offlineimap.sgml
168
offlineimap.sgml
@ -801,145 +801,6 @@ rm -r ~/.offlineimap/Repository-<replaceable>RepositoryName</></programlisting>
|
||||
</para>
|
||||
</refsect2>
|
||||
</refsect1>
|
||||
<refsect1>
|
||||
<title>Other Frequently Asked Questions</title>
|
||||
<para>There are some other FAQs that might not fit into another section
|
||||
of the document, so they are discussed here.
|
||||
</para>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry><term>I'm using Mutt. Other IMAP sync programs require me to use "set maildir_trash=yes". Do I need to do that with &OfflineIMAP;?</term>
|
||||
<listitem><para>
|
||||
No. &OfflineIMAP; is smart enough to figure out message deletion without this extra
|
||||
crutch. You'll get the best results if you don't use this setting, in
|
||||
fact.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry><term>I've upgraded and now &OfflineIMAP;
|
||||
crashes when I start it up! Why?</term>
|
||||
<listitem><para>You need to upgrade your configuration
|
||||
file. See <xref linkend="upgrading.4.0"> at the end of this
|
||||
manual.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry><term>How do I specify the names of my folders?</term>
|
||||
<listitem><para>
|
||||
You do not need to. &OfflineIMAP; is smart
|
||||
enough to automatically figure out what folders are present
|
||||
on the IMAP server and synchronize them. You can use the
|
||||
<property>folderfilter</property> and <property>nametrans</property>
|
||||
configuration file options to request certain folders and rename them
|
||||
as they come in if you like.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry><term>How can I prevent certain folders from being synced?</term>
|
||||
<listitem><para>
|
||||
Use the <property>folderfilter</property> option in the configuration file.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry><term>How can I add or delete a folder?</term>
|
||||
<listitem><para>
|
||||
&OfflineIMAP; does not currently provide this feature, but if you create a new
|
||||
folder on the IMAP server, it will be created locally automatically.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry><term>Are there any other warnings that I should be aware of?</term>
|
||||
<listitem><para>
|
||||
Yes; see the Notes section below.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry><term>What is the mailbox name recorder (mbnames) for?</term>
|
||||
<listitem><para>Some mail readers, such as Mutt, are not capable
|
||||
of automatically determining the names of your mailboxes.
|
||||
&OfflineIMAP; can help these programs by writing the names
|
||||
of the folders in a format you specify. See the example
|
||||
<filename>offlineimap.conf</filename> for details.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry><term>Can I synchronize multiple accounts with &OfflineIMAP?</term>
|
||||
<listitem><para>Sure. Just name them all in the
|
||||
<property>accounts</property> line in the <property>general</property>
|
||||
section of the configuration file, and add a per-account section
|
||||
for each one.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry><term>Does &OfflineIMAP; support POP?</term>
|
||||
<listitem><para>No. POP is not robust enough to do a completely reliable
|
||||
multi-machine synchronization like &OfflineIMAP; can do. &OfflineIMAP;
|
||||
will not support it.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry><term>Does &OfflineIMAP; support mailbox formats other than Maildir?</term>
|
||||
<listitem><para>Not at present. There is no technical reason not to; just no
|
||||
demand yet. Maildir is a superior format anyway.
|
||||
However, &OfflineIMAP; can sync between two IMAP
|
||||
servers, and some IMAP servers support other formats. You
|
||||
could install an IMAP server on your local machine and have
|
||||
&OfflineIMAP sync to that.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry><term>[technical] Why are your Maildir message filenames so huge?</term>
|
||||
<listitem><para>&OfflineIMAP; has two relevant principles: 1) never modifying your
|
||||
messages in any way and 2) ensuring 100% reliable synchronizations.
|
||||
In order to do a reliable sync, &OfflineIMAP;
|
||||
must have a way to
|
||||
uniquely identify each e-mail. Three pieces of information are
|
||||
required to do this: your account name, the folder name, and the
|
||||
message UID. The account name can be calculated from the path in
|
||||
which your messages are. The folder name can usually be as well, BUT
|
||||
some mail clients move messages between folders by simply moving the
|
||||
file, leaving the name intact.
|
||||
</para>
|
||||
<para>
|
||||
So, &OfflineIMAP; must store both a UID folder ID. The folder ID is
|
||||
necessary so &OfflineIMAP; can detect a message moved to a different
|
||||
folder. &OfflineIMAP; stores the UID (U= number) and an md5sum of the
|
||||
foldername (FMD5= number) to facilitate this.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry><term>What is the speed of &OfflineIMAP;'s sync?</term>
|
||||
<listitem><para>OfflineIMAP
|
||||
versions 2.0 and above contain a multithreaded system. A good way to
|
||||
experiment is by setting <property>maxsyncaccounts</property> to 3 and <property>maxconnections</property> to 3
|
||||
in each account clause.
|
||||
</para>
|
||||
<para>This lets OfflineIMAP open up multiple connections simultaneously.
|
||||
That will let it process multiple folders and messages at once. In
|
||||
most cases, this will increase performance of the sync.
|
||||
</para>
|
||||
<para>Don't set the number too high. If you do that, things might actually
|
||||
slow down as your link gets saturated. Also, too many connections can
|
||||
cause mail servers to have excessive load. Administrators might take
|
||||
unkindly to this, and the server might bog down. There are many
|
||||
variables in the optimal setting; experimentation may help.
|
||||
</para>
|
||||
<para>An informal benchmark yields these results for my setup:
|
||||
</para>
|
||||
<itemizedlist>
|
||||
<listitem><para>10 minutes with MacOS X Mail.app "manual cache"
|
||||
</para></listitem>
|
||||
<listitem><para>5 minutes with GNUS agent sync</para></listitem>
|
||||
<listitem><para>20 seconds with OfflineIMAP 1.x</para></listitem>
|
||||
<listitem><para>9 seconds with OfflineIMAP 2.x</para></listitem>
|
||||
<listitem><para>3 seconds with OfflineIMAP 3.x "cold start"</para></listitem>
|
||||
<listitem><para>2 seconds with OfflineIMAP 3.x "held connection"</para></listitem>
|
||||
</itemizedlist>
|
||||
</listitem></varlistentry>
|
||||
</variablelist>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
<title>Conforming To</title>
|
||||
<itemizedlist>
|
||||
@ -999,35 +860,6 @@ rm -r ~/.offlineimap/Repository-<replaceable>RepositoryName</></programlisting>
|
||||
</para>
|
||||
</refsect2>
|
||||
|
||||
<refsect2>
|
||||
<title>Use with Evolution</title>
|
||||
<para>&OfflineIMAP; can work with Evolution. To do so, first configure
|
||||
your &OfflineIMAP; account to have
|
||||
<option>sep = /</option> in its configuration. Then, configure
|
||||
Evolution with the
|
||||
"Maildir-format mail directories" server type. For the path, you will need to
|
||||
specify the name of the top-level folder
|
||||
<emphasis>inside</emphasis> your &OfflineIMAP; storage location.
|
||||
You're now set!
|
||||
</para>
|
||||
</refsect2>
|
||||
|
||||
<refsect2>
|
||||
<title>Use with KMail</title>
|
||||
<para>At this time, I believe that &OfflineIMAP; with Maildirs
|
||||
is not compatible
|
||||
with KMail. KMail cannot work in any mode other than to move
|
||||
all messages out of all folders immediately, which (besides being annoying
|
||||
and fundamentally broken) is incompatible with
|
||||
&OfflineIMAP;.
|
||||
</para>
|
||||
<para>
|
||||
However, I have made KMail version 3 work well with
|
||||
&OfflineIMAP; by installing an IMAP server on my local
|
||||
machine, having &OfflineIMAP; sync to that, and pointing
|
||||
KMail at the same server.
|
||||
</para>
|
||||
</refsect2>
|
||||
|
||||
<refsect2>
|
||||
<title>Mailing List</title>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user