[PATCHv5 7/7] Re: Create LocalStatus or LocalStatusSQLite folders

[Nicolas Sebrecht]

On Thu, May 05, 2011 at 03:59:29PM +0200, Sebastian Spaeth wrote:

> diff --git a/offlineimap.conf b/offlineimap.conf
> index 7018090..da92a30 100644
> --- a/offlineimap.conf
> +++ b/offlineimap.conf
> @@ -197,6 +197,18 @@ remoterepository = RemoteExample
>  # You can also specify parameters to the commands
>  # presynchook = imapfilter -c someotherconfig.lua
>  
> +# OfflineImap caches the status of your mails to e.g. be able to
> +# determine if a mail has been deleted on one side or added on the
> +# other. The default backend is 'plain' which writes out the status in
> +# plain text files. On Repositories with large numbers of mails, the
> +# performance might not be optimal, as we write out the complete file
> +# for each change. Another backend 'sqlite' is available which stores
> +# the status in sqlite databased. If you switch the backend, you will
> +# have to delete the old cache directory in
> +# ~/.offlineimap/Account-<account>/LocalStatus[-sqlite] manually.
> +
> +status_backend = plain
> +

Please, do update this as well. This is the only place where we have a
chance to catch the user attention. This IS EXPERIMENTAL STUFF!!!

Also, I won't recommend to remove anything for now. Ask users to make
an archive of the old cache. Plus, I don't think it's needed at all:
"you will have to" is not approppriated.

>  # If you have a limited amount of bandwidth available you can exclude larger
>  # messages (e.g. those with large attachments etc).  If you do this it
>  # will appear to offlineimap that these messages do not exist at all.  They

-- 
Nicolas Sebrecht