From: John Goerzen Date: Sat, 2 Dec 2006 11:39:49 +0000 (+0100) Subject: Removed more FAQ stuff from the manual X-Git-Tag: DEBIAN_offlineimap_4.0.16~10 X-Git-Url: https://code.delx.au/offlineimap/commitdiff_plain/612e89964f0344744a54ca6bae244cd7675bafb4 Removed more FAQ stuff from the manual --- diff --git a/offlineimap.sgml b/offlineimap.sgml index c8d7119..960a01a 100644 --- a/offlineimap.sgml +++ b/offlineimap.sgml @@ -801,145 +801,6 @@ rm -r ~/.offlineimap/Repository-RepositoryName - - Other Frequently Asked Questions - There are some other FAQs that might not fit into another section - of the document, so they are discussed here. - - - - I'm using Mutt. Other IMAP sync programs require me to use "set maildir_trash=yes". Do I need to do that with &OfflineIMAP;? - - 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. - - - - I've upgraded and now &OfflineIMAP; - crashes when I start it up! Why? - You need to upgrade your configuration - file. See at the end of this - manual. - - - - - How do I specify the names of my folders? - - 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 - folderfilter and nametrans - configuration file options to request certain folders and rename them - as they come in if you like. - - - - How can I prevent certain folders from being synced? - - Use the folderfilter option in the configuration file. - - - - How can I add or delete a folder? - - &OfflineIMAP; does not currently provide this feature, but if you create a new - folder on the IMAP server, it will be created locally automatically. - - - - Are there any other warnings that I should be aware of? - - Yes; see the Notes section below. - - - - What is the mailbox name recorder (mbnames) for? - 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 - offlineimap.conf for details. - - - - Can I synchronize multiple accounts with &OfflineIMAP? - Sure. Just name them all in the - accounts line in the general - section of the configuration file, and add a per-account section - for each one. - - - - Does &OfflineIMAP; support POP? - No. POP is not robust enough to do a completely reliable - multi-machine synchronization like &OfflineIMAP; can do. &OfflineIMAP; - will not support it. - - - - Does &OfflineIMAP; support mailbox formats other than Maildir? - 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. - - - - [technical] Why are your Maildir message filenames so huge? - &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. - - - 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. - - - - What is the speed of &OfflineIMAP;'s sync? - OfflineIMAP - versions 2.0 and above contain a multithreaded system. A good way to - experiment is by setting maxsyncaccounts to 3 and maxconnections to 3 - in each account clause. - - 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. - - 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. - - An informal benchmark yields these results for my setup: - - - 10 minutes with MacOS X Mail.app "manual cache" - - 5 minutes with GNUS agent sync - 20 seconds with OfflineIMAP 1.x - 9 seconds with OfflineIMAP 2.x - 3 seconds with OfflineIMAP 3.x "cold start" - 2 seconds with OfflineIMAP 3.x "held connection" - - - - - Conforming To @@ -999,35 +860,6 @@ rm -r ~/.offlineimap/Repository-RepositoryName - - Use with Evolution - &OfflineIMAP; can work with Evolution. To do so, first configure - your &OfflineIMAP; account to have - 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 - inside your &OfflineIMAP; storage location. - You're now set! - - - - - Use with KMail - 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;. - - - 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. - - Mailing List