manual: add known issues entry about XOAUTH2 "invalid_grant"

- Split the manual asciidoc source file.
- Improve the Makefile to build the manuals.

Github-ref: https://github.com/OfflineIMAP/offlineimap/issues/374
Signed-off-by: Nicolas Sebrecht <nicolas.s-dev@laposte.net>
This commit is contained in:
Nicolas Sebrecht 2016-11-05 16:38:29 +01:00
parent d88b8d52e7
commit 0fe4562269
5 changed files with 188 additions and 136 deletions

View File

@ -18,11 +18,11 @@ $(HTML_TARGETS): %.html : %.rst
man: offlineimap.1 offlineimapui.7 man: offlineimap.1 offlineimapui.7
offlineimap.1: offlineimap.txt offlineimap.1: offlineimap.txt offlineimap.known_issues.txt
a2x -v -f manpage $? a2x -v -d manpage -f manpage $<
offlineimapui.7: offlineimapui.txt offlineimapui.7: offlineimapui.txt
a2x -v -f manpage $? a2x -v -d manpage -f manpage $<
api: api:
$(SPHINXBUILD) -b html -d html/doctrees doc-src html $(SPHINXBUILD) -b html -d html/doctrees doc-src html

View File

@ -0,0 +1,142 @@
* SSL3 write pending.
+
Users enabling SSL may hit a bug about "SSL3 write pending". If so, the
account(s) will stay unsynchronised from the time the bug appeared. Running
OfflineIMAP again can help. We are still working on this bug. Patches or
detailed bug reports would be appreciated. Please check you're running the
last stable version and send us a report to the mailing list including the
full log.
* IDLE support is incomplete and experimental. Bugs may be encountered.
- No hook exists for "run after an IDLE response".
+
Email will show up, but may not be processed until the next refresh cycle.
- nametrans may not be supported correctly.
- IMAP IDLE <-> IMAP IDLE doesn't work yet.
- IDLE might stop syncing on a system suspend/resume.
- IDLE may only work "once" per refresh.
+
If you encounter this bug, please send a report to the list!
* Maildir support in Windows drive.
+
Maildir uses colon character (:) in message file names. Colon is however
forbidden character in windows drives. There are several workarounds for that
situation:
. Enable file name character translation in windows registry (not tested).
- <http://support.microsoft.com/kb/289627>
. Use cygwin managed mount (not tested).
- not available anymore since cygwin 1.7
. Use "maildir-windows-compatible = yes" account OfflineIMAP configuration.
- That makes OfflineIMAP to use exclamation mark (!) instead of colon for
storing messages. Such files can be written to windows partitions. But
you will probably loose compatibility with other programs trying to
read the same Maildir.
+
- Exclamation mark was chosen because of the note in
http://docs.python.org/library/mailbox.html
+
- If you have some messages already stored without this option, you will
have to re-sync them again
* OfflineIMAP confused after system suspend.
+
When resuming a suspended session, OfflineIMAP does not cleanly handles the
broken socket(s) if socktimeout option is not set.
You should enable this option with a value like 10.
* OfflineIMAP confused when mails change while in a sync.
+
When OfflineIMAP is syncing, some events happening since the invocation on
remote or local side are badly handled. OfflineIMAP won't track for changes
during the sync.
* Sharing a maildir with multiple IMAP servers.
+
Generally a word of caution mixing IMAP repositories on the same Maildir root.
You have to be careful that you *never* use the same maildir folder for 2 IMAP
servers. In the best case, the folder MD5 will be different, and you will get
a loop where it will upload your mails to both servers in turn (infinitely!)
as it thinks you have placed new mails in the local Maildir. In the worst
case, the MD5 is the same (likely) and mail UIDs overlap (likely too!) and it
will fail to sync some mails as it thinks they are already existent.
+
I would create a new local Maildir Repository for the Personal Gmail and
use a different root to be on the safe side here. You could e.g. use
`~/mail/Pro' as Maildir root for the ProGmail and
`~/mail/Personal' as root for the personal one.
+
If you then point your local mutt, or whatever MUA you use to `~/mail/'
as root, it should still recognize all folders.
* Edge cases with maxage causing too many messages to be synced.
+
All messages from at most maxage days ago (+/- a few hours, depending on
timezones) are synced, but there are cases in which older messages can also be
synced. This happens when a message's UID is significantly higher than those of
other messages with similar dates, e.g. when messages are added to the local
folder behind offlineimap's back, causing them to get assigned a new UID, or
when offlineimap first syncs a pre-existing Maildir. In the latter case, it
could appear as if a noticeable and random subset of old messages are synced.
* Passwords in netrc.
+
Offlineimap doesn't know how to retrieve passwords when more than one account is
stored in the netrc file. See
<https://github.com/OfflineIMAP/offlineimap/issues/295>.
* XOAUTH2
+
XOAUTH2 might be a bit tricky to set up. Make sure you've followed the step to
step guide in 'offlineimap.conf'. The known bugs about Gmail are tracked at
<https://github.com/OfflineIMAP/offlineimap/labels/Gmail>.
+
Sometimes, you might hit one of the following error:
- [imap]: xoauth2handler: response "{u'error': u'invalid_grant'}"
- oauth2handler got: {u'error': u'invalid_grant'}
+
In such case, we had report that generating a new refesh token from the same
client ID and secret can help.
+
.Google documentation on "invalid_grant"
----
When you try to use a refresh token, the following returns you an
invalid_grant error:
- Your server's clock is not in sync with network time protocol - NTP.
- The refresh token limit has been exceeded.
----
+
.Token expiration
----
It is possible that a granted token might no longer work. A token might stop
working for one of these reasons:
- The user has revoked access.
- The token has not been used for six months.
- The user changed passwords and the token contains Gmail scopes.
- The user account has exceeded a certain number of token requests.
There is currently a limit of 50 refresh tokens per user account per client. If
the limit is reached, creating a new token automatically invalidates the oldest
token without warning. This limit does not apply to service accounts.
----
+
See <https://developers.google.com/analytics/devguides/config/mgmt/v3/authorization>
and <https://developers.google.com/identity/protocols/OAuth2#expiration>
to know more.

View File

@ -335,103 +335,7 @@ process core.
Known Issues Known Issues
------------ ------------
* SSL3 write pending. include::./offlineimap.known_issues.txt[]
+
Users enabling SSL may hit a bug about "SSL3 write pending". If so, the
account(s) will stay unsynchronised from the time the bug appeared. Running
OfflineIMAP again can help. We are still working on this bug. Patches or
detailed bug reports would be appreciated. Please check you're running the
last stable version and send us a report to the mailing list including the
full log.
* IDLE support is incomplete and experimental. Bugs may be encountered.
- No hook exists for "run after an IDLE response".
+
Email will show up, but may not be processed until the next refresh cycle.
- nametrans may not be supported correctly.
- IMAP IDLE <-> IMAP IDLE doesn't work yet.
- IDLE might stop syncing on a system suspend/resume.
- IDLE may only work "once" per refresh.
+
If you encounter this bug, please send a report to the list!
* Maildir support in Windows drive.
+
Maildir uses colon caracter (:) in message file names. Colon is however
forbidden character in windows drives. There are several workarounds for that
situation:
. Enable file name character translation in windows registry (not tested).
- <http://support.microsoft.com/kb/289627>
. Use cygwin managed mount (not tested).
- not available anymore since cygwin 1.7
. Use "maildir-windows-compatible = yes" account OfflineIMAP configuration.
- That makes OfflineIMAP to use exclamation mark (!) instead of colon for
storing messages. Such files can be written to windows partitions. But
you will probably loose compatibility with other programs trying to
read the same Maildir.
+
- Exclamation mark was chosen because of the note in
http://docs.python.org/library/mailbox.html
+
- If you have some messages already stored without this option, you will
have to re-sync them again
* OfflineIMAP confused after system suspend.
+
When resuming a suspended session, OfflineIMAP does not cleanly handles the
broken socket(s) if socktimeout option is not set.
You should enable this option with a value like 10.
* OfflineIMAP confused when mails change while in a sync.
+
When OfflineIMAP is syncing, some events happening since the invocation on
remote or local side are badly handled. OfflineIMAP won't track for changes
during the sync.
* Sharing a maildir with multiple IMAP servers.
+
Generally a word of caution mixing IMAP repositories on the same Maildir root.
You have to be careful that you *never* use the same maildir folder for 2 IMAP
servers. In the best case, the folder MD5 will be different, and you will get
a loop where it will upload your mails to both servers in turn (infinitely!)
as it thinks you have placed new mails in the local Maildir. In the worst
case, the MD5 is the same (likely) and mail UIDs overlap (likely too!) and it
will fail to sync some mails as it thinks they are already existent.
+
I would create a new local Maildir Repository for the Personal Gmail and
use a different root to be on the safe side here. You could e.g. use
`~/mail/Pro' as Maildir root for the ProGmail and
`~/mail/Personal' as root for the personal one.
+
If you then point your local mutt, or whatever MUA you use to `~/mail/'
as root, it should still recognize all folders.
* Edge cases with maxage causing too many messages to be synced.
+
All messages from at most maxage days ago (+/- a few hours, depending on
timezones) are synced, but there are cases in which older messages can also be
synced. This happens when a message's UID is significantly higher than those of
other messages with similar dates, e.g. when messages are added to the local
folder behind offlineimap's back, causing them to get assigned a new UID, or
when offlineimap first syncs a pre-existing Maildir. In the latter case, it
could appear as if a noticeable and random subset of old messages are synced.
* Passwords in netrc.
+
Offlineimap doesn't know how to retrieve passwords when more than one account is
stored in the netrc file. See
<https://github.com/OfflineIMAP/offlineimap/issues/295>.
Main authors Main authors

View File

@ -10,10 +10,10 @@
# The default configuration file is "~/.offlineimaprc". # The default configuration file is "~/.offlineimaprc".
# #
# OfflineIMAP ships with a file named "offlineimap.conf" that you should copy to # Offlineimap ships with a file named "offlineimap.conf" that you should copy to
# that location and then edit. # that location and then edit.
# #
# OfflineIMAP also ships a file named "offlineimap.conf.minimal" that you can # Offlineimap also ships a file named "offlineimap.conf.minimal" that you can
# also try. It's useful if you want to get started with the most basic feature # also try. It's useful if you want to get started with the most basic feature
# set, and you can read about other features later with "offlineimap.conf". # set, and you can read about other features later with "offlineimap.conf".
# #
@ -56,7 +56,7 @@
[general] [general]
# This specifies where OfflineIMAP is to store its metadata. # This specifies where Offlineimap is to store its metadata.
# This directory will be created if it does not already exist. # This directory will be created if it does not already exist.
# #
# Tilde and environment variable expansions will be performed. # Tilde and environment variable expansions will be performed.
@ -91,7 +91,7 @@ accounts = Test
# This option stands in the [general] section. # This option stands in the [general] section.
# #
# You can specify one or more user interface. OfflineIMAP will try the first in # You can specify one or more user interface. Offlineimap will try the first in
# the list, and if it fails, the second, and so forth. # the list, and if it fails, the second, and so forth.
# #
# The pre-defined options are: # The pre-defined options are:
@ -113,11 +113,11 @@ accounts = Test
# This option stands in the [general] section. # This option stands in the [general] section.
# #
# If you try to synchronize messages to a folder which the IMAP server # If you try to synchronize messages to a folder which the IMAP server
# considers read-only, OfflineIMAP will generate a warning. If you want # considers read-only, Offlineimap will generate a warning. If you want
# to suppress these warnings, set ignore-readonly to yes. Read-only # to suppress these warnings, set ignore-readonly to yes. Read-only
# IMAP folders allow reading but not modification, so if you try to # IMAP folders allow reading but not modification, so if you try to
# change messages in the local copy of such a folder, the IMAP server # change messages in the local copy of such a folder, the IMAP server
# will prevent OfflineIMAP from propagating those changes to the IMAP # will prevent Offlineimap from propagating those changes to the IMAP
# server. Note that ignore-readonly is UNRELATED to the "readonly" # server. Note that ignore-readonly is UNRELATED to the "readonly"
# setting which prevents a repository from being modified at all. # setting which prevents a repository from being modified at all.
# #
@ -141,7 +141,7 @@ accounts = Test
# This option is in the [general] section. # This option is in the [general] section.
# #
# By default, OfflineIMAP will not exit due to a network error until the # By default, Offlineimap will not exit due to a network error until the
# operating system returns an error code. Operating systems can sometimes take # operating system returns an error code. Operating systems can sometimes take
# forever to notice this. Here you can activate a timeout on the socket. This # forever to notice this. Here you can activate a timeout on the socket. This
# timeout applies to individual socket reads and writes, not to an overall sync # timeout applies to individual socket reads and writes, not to an overall sync
@ -157,10 +157,10 @@ accounts = Test
# This option stands in the [general] section. # This option stands in the [general] section.
# #
# By default, OfflineIMAP will use fsync() to force data out to disk at # By default, Offlineimap will use fsync() to force data out to disk at
# opportune times to ensure consistency. This can, however, reduce performance. # opportune times to ensure consistency. This can, however, reduce performance.
# Users where /home is on SSD (Flash) may also wish to reduce write cycles. # Users where /home is on SSD (Flash) may also wish to reduce write cycles.
# Therefore, you can disable OfflineIMAP's use of fsync(). Doing so will come # Therefore, you can disable Offlineimap's use of fsync(). Doing so will come
# at the expense of greater risk of message duplication in the event of a system # at the expense of greater risk of message duplication in the event of a system
# crash or power loss. Default is true. Set it to false to disable fsync. # crash or power loss. Default is true. Set it to false to disable fsync.
# #
@ -176,7 +176,7 @@ accounts = Test
[mbnames] [mbnames]
# OfflineIMAP can record your mailbox names in a format you specify. # Offlineimap can record your mailbox names in a format you specify.
# You can define the header, each mailbox item, the separator, # You can define the header, each mailbox item, the separator,
# and the footer. Here is an example for Mutt. # and the footer. Here is an example for Mutt.
# If enabled is yes, all settings except incremental must be specified, even if # If enabled is yes, all settings except incremental must be specified, even if
@ -253,7 +253,7 @@ remoterepository = RemoteExample
# This option stands in the [Account Test] section. # This option stands in the [Account Test] section.
# #
# You can have OfflineIMAP continue running indefinitely, automatically syncing # You can have Offlineimap continue running indefinitely, automatically syncing
# your mail periodically. If you want that, specify how frequently to do that # your mail periodically. If you want that, specify how frequently to do that
# (in minutes) here. Fractional minutes (ie, 3.25) is allowed. # (in minutes) here. Fractional minutes (ie, 3.25) is allowed.
# #
@ -310,7 +310,7 @@ remoterepository = RemoteExample
# #
# If you have a limited amount of bandwidth available you can exclude larger # 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 # 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 will not # appear to Offlineimap that these messages do not exist at all. They will not
# be copied, have flags changed etc. For this to work on an IMAP server the # be copied, have flags changed etc. For this to work on an IMAP server the
# server must have server side search enabled. This works with Gmail and most # server must have server side search enabled. This works with Gmail and most
# imap servers (e.g. cyrus etc) # imap servers (e.g. cyrus etc)
@ -328,7 +328,7 @@ remoterepository = RemoteExample
# messages later than that date will be synced. # messages later than that date will be synced.
# #
# Messages older than the cutoff will not be synced, their flags will not be # Messages older than the cutoff will not be synced, their flags will not be
# changed, they will not be deleted, etc. For OfflineIMAP it will be like these # changed, they will not be deleted, etc. For Offlineimap it will be like these
# messages do not exist. This will perform an IMAP search in the case of IMAP or # messages do not exist. This will perform an IMAP search in the case of IMAP or
# Gmail and therefore requires that the server support server side searching. # Gmail and therefore requires that the server support server side searching.
# #
@ -348,7 +348,7 @@ remoterepository = RemoteExample
# #
# Maildir file format uses colon (:) separator between uniq name and info. # Maildir file format uses colon (:) separator between uniq name and info.
# Unfortunatelly colon is not allowed character in windows file name. If you # Unfortunatelly colon is not allowed character in windows file name. If you
# enable maildir-windows-compatible option, OfflineIMAP will be able to store # enable maildir-windows-compatible option, Offlineimap will be able to store
# messages on windows drive, but you will probably loose compatibility with # messages on windows drive, but you will probably loose compatibility with
# other programs working with the maildir. # other programs working with the maildir.
# #
@ -396,7 +396,7 @@ remoterepository = RemoteExample
# This option stands in the [Account Test] section. # This option stands in the [Account Test] section.
# #
# OfflineIMAP can strip off some headers when your messages are propagated # Offlineimap can strip off some headers when your messages are propagated
# back to the IMAP server. This option carries the comma-separated list # back to the IMAP server. This option carries the comma-separated list
# of headers to trim off. Header name matching is case-sensitive. # of headers to trim off. Header name matching is case-sensitive.
# #
@ -432,7 +432,7 @@ type = Maildir
# This option stands in the [Repository LocalExample] section. # This option stands in the [Repository LocalExample] section.
# #
# Specify local repository. Your IMAP folders will be synchronized # Specify local repository. Your IMAP folders will be synchronized
# to maildirs created under this path. OfflineIMAP will create the # to maildirs created under this path. Offlineimap will create the
# maildirs for you as needed. # maildirs for you as needed.
# #
localfolders = ~/Test localfolders = ~/Test
@ -479,7 +479,7 @@ localfolders = ~/Test
# This option stands in the [Repository LocalExample] section. # This option stands in the [Repository LocalExample] section.
# #
# Some users may not want the atime (last access time) of folders to be # Some users may not want the atime (last access time) of folders to be
# modified by OfflineIMAP. If 'restoreatime' is set to yes, OfflineIMAP # modified by Offlineimap. If 'restoreatime' is set to yes, Offlineimap
# will restore the atime of the "new" and "cur" folders in each maildir # will restore the atime of the "new" and "cur" folders in each maildir
# folder to their original value after each sync. # folder to their original value after each sync.
# #
@ -560,7 +560,7 @@ localfolders = ~/Test
# some extra overhead which sometimes may be significant. We look for # some extra overhead which sometimes may be significant. We look for
# modified tags in local messages by looking only to the files # modified tags in local messages by looking only to the files
# modified since last run. This is usually rather fast, but the first # modified since last run. This is usually rather fast, but the first
# time OfflineIMAP runs with synclabels enabled, it will have to check # time Offlineimap runs with synclabels enabled, it will have to check
# the contents of all individual messages for labels and this may take # the contents of all individual messages for labels and this may take
# a while. # a while.
# #
@ -635,7 +635,7 @@ remotehost = examplehost
# #
# Note: be care to configure the 'remotehost' line with the domain name defined # Note: be care to configure the 'remotehost' line with the domain name defined
# in the certificate. E.g., if you trust your provider and want to use the # in the certificate. E.g., if you trust your provider and want to use the
# certificate it provides on a shared server. Otherwise, OfflineIMAP will stop # certificate it provides on a shared server. Otherwise, Offlineimap will stop
# and say that the domain is not named in the certificate. # and say that the domain is not named in the certificate.
# #
# Default is yes. # Default is yes.
@ -671,10 +671,10 @@ remotehost = examplehost
# #
# Tilde and environment variable expansions will be performed. # Tilde and environment variable expansions will be performed.
# #
# Special value OS-DEFAULT makes OfflineIMAP to automatically # Special value OS-DEFAULT makes Offlineimap to automatically
# determine system-wide location of standard trusted CA roots file # determine system-wide location of standard trusted CA roots file
# for known OS distributions and use the first bundle encountered # for known OS distributions and use the first bundle encountered
# (if any). If no system-wide CA bundle is found, OfflineIMAP # (if any). If no system-wide CA bundle is found, Offlineimap
# will refuse to continue; this is done to prevent creation # will refuse to continue; this is done to prevent creation
# of false security expectations ("I had configured CA bundle, # of false security expectations ("I had configured CA bundle,
# thou certificate verification shalt be present"). # thou certificate verification shalt be present").
@ -688,15 +688,15 @@ remotehost = examplehost
# This option stands in the [Repository RemoteExample] section. # This option stands in the [Repository RemoteExample] section.
# #
# If you connect via SSL/TLS (ssl = yes) and you have no CA certificate # If you connect via SSL/TLS (ssl = yes) and you have no CA certificate
# specified, OfflineIMAP will refuse to sync as it connects to a server # specified, Offlineimap will refuse to sync as it connects to a server
# with an unknown "fingerprint". If you are sure you connect to the # with an unknown "fingerprint". If you are sure you connect to the
# correct server, you can then configure the presented server # correct server, you can then configure the presented server
# fingerprint here. OfflineIMAP will verify that the server fingerprint # fingerprint here. Offlineimap will verify that the server fingerprint
# has not changed on each connect and refuse to connect otherwise. # has not changed on each connect and refuse to connect otherwise.
# #
# You can also configure fingerprint validation in addition to # You can also configure fingerprint validation in addition to
# CA certificate validation above and it will check both: # CA certificate validation above and it will check both:
# OfflineIMAP fill verify certificate first and if things will be fine, # Offlineimap fill verify certificate first and if things will be fine,
# fingerprint will be validated. # fingerprint will be validated.
# #
# Multiple fingerprints can be specified, separated by commas. # Multiple fingerprints can be specified, separated by commas.
@ -795,7 +795,7 @@ remoteuser = username
# This option stands in the [Repository RemoteExample] section. # This option stands in the [Repository RemoteExample] section.
# #
# Specify which authentication/authorization mechanisms we should try and the # Specify which authentication/authorization mechanisms we should try and the
# order in which OfflineIMAP will try them. # order in which Offlineimap will try them.
# #
# NOTE: any given mechanism will be tried ONLY if it is supported by the remote # NOTE: any given mechanism will be tried ONLY if it is supported by the remote
# IMAP server. # IMAP server.
@ -809,7 +809,7 @@ remoteuser = username
# This option stands in the [Repository RemoteExample] section. # This option stands in the [Repository RemoteExample] section.
# #
# XOAuth2 authentication (for instance, to use with Gmail). # XOAUTH2 authentication (for instance, to use with Gmail).
# #
# This option was tested on Gmail only, but should work # This option was tested on Gmail only, but should work
# with type = IMAP for compatible servers. # with type = IMAP for compatible servers.
@ -859,11 +859,14 @@ remoteuser = username
# If the type of the remote is IMAP, oauth2_request_url MUST be defined. # If the type of the remote is IMAP, oauth2_request_url MUST be defined.
# For Gmail, the default URL is https://accounts.google.com/o/oauth2/token. # For Gmail, the default URL is https://accounts.google.com/o/oauth2/token.
# #
# If you're experiencing issues, please read the "Known issues" section of the
# manual.
#
#oauth2_access_token = ACCESS_TOKEN #oauth2_access_token = ACCESS_TOKEN
#oauth2_request_url = https://accounts.google.com/o/oauth2/token #oauth2_request_url = https://accounts.google.com/o/oauth2/token
#oauth2_refresh_token = REFRESH_TOKEN #oauth2_refresh_token = REFRESH_TOKEN
# #
# The return values must be bytes. # The returned values must be bytes.
#oauth2_access_token_eval = get_access_token("accountname") #oauth2_access_token_eval = get_access_token("accountname")
#oauth2_refresh_token_eval = get_refresh_token("accountname") #oauth2_refresh_token_eval = get_refresh_token("accountname")
@ -877,7 +880,7 @@ remoteuser = username
# allows one entry per hostname. If there is no ~/.netrc file but # allows one entry per hostname. If there is no ~/.netrc file but
# there is an /etc/netrc file, the password will instead be taken # there is an /etc/netrc file, the password will instead be taken
# from there. Otherwise you will be prompted for the password when # from there. Otherwise you will be prompted for the password when
# OfflineIMAP starts when using a UI that supports this. # Offlineimap starts when using a UI that supports this.
# #
# 2. The remote password stored in this file with the remotepass # 2. The remote password stored in this file with the remotepass
# option. Save this file with the UTF-8 encoding if your server expect UTF-8 # option. Save this file with the UTF-8 encoding if your server expect UTF-8
@ -901,7 +904,7 @@ remoteuser = username
# #
# 5. If you are using Kerberos and have the Python Kerberos package # 5. If you are using Kerberos and have the Python Kerberos package
# installed, you should not specify a remotepass. If the user has a # installed, you should not specify a remotepass. If the user has a
# valid Kerberos TGT, OfflineIMAP will figure out the rest all by # valid Kerberos TGT, Offlineimap will figure out the rest all by
# itself, and fall back to password authentication if needed. # itself, and fall back to password authentication if needed.
# #
# 6. Using arbitrary python code. With this method, you invoke a # 6. Using arbitrary python code. With this method, you invoke a
@ -981,7 +984,7 @@ remoteuser = username
# This option stands in the [Repository RemoteExample] section. # This option stands in the [Repository RemoteExample] section.
# #
# In between synchronisations, OfflineIMAP can monitor mailboxes for new # In between synchronisations, Offlineimap can monitor mailboxes for new
# messages using the IDLE command. If you want to enable this, specify here the # messages using the IDLE command. If you want to enable this, specify here the
# folders you wish to monitor. IMAP protocol requires a separate connection for # folders you wish to monitor. IMAP protocol requires a separate connection for
# each folder monitored in this way, so setting this option will force settings # each folder monitored in this way, so setting this option will force settings
@ -1005,7 +1008,7 @@ remoteuser = username
# This option stands in the [Repository RemoteExample] section. # This option stands in the [Repository RemoteExample] section.
# #
# OfflineIMAP can use a compressed connection to the IMAP server. # Offlineimap can use a compressed connection to the IMAP server.
# This can result in faster downloads for some cases. # This can result in faster downloads for some cases.
# #
#usecompression = yes #usecompression = yes
@ -1013,7 +1016,7 @@ remoteuser = username
# This option stands in the [Repository RemoteExample] section. # This option stands in the [Repository RemoteExample] section.
# #
# OfflineIMAP can use multiple connections to the server in order # Offlineimap can use multiple connections to the server in order
# to perform multiple synchronization actions simultaneously. # to perform multiple synchronization actions simultaneously.
# This may place a higher burden on the server. In most cases, # This may place a higher burden on the server. In most cases,
# setting this value to 2 or 3 will speed up the sync, but in some # setting this value to 2 or 3 will speed up the sync, but in some
@ -1039,7 +1042,7 @@ remoteuser = username
# This option stands in the [Repository RemoteExample] section. # This option stands in the [Repository RemoteExample] section.
# #
# OfflineIMAP normally closes IMAP server connections between refreshes if # Offlineimap normally closes IMAP server connections between refreshes if
# the global option autorefresh is specified. If you wish it to keep the # the global option autorefresh is specified. If you wish it to keep the
# connection open, set this to true. If not specified, the default is # connection open, set this to true. If not specified, the default is
# false. Keeping the connection open means a faster sync start the # false. Keeping the connection open means a faster sync start the
@ -1061,8 +1064,8 @@ remoteuser = username
# This option stands in the [Repository RemoteExample] section. # This option stands in the [Repository RemoteExample] section.
# #
# Normally, OfflineIMAP will expunge deleted messages from the server. You can # Normally, Offlineimap will expunge deleted messages from the server. You can
# disable that if you wish. This means that OfflineIMAP will mark them deleted # disable that if you wish. This means that Offlineimap will mark them deleted
# on the server, but not actually delete them. You must use some other IMAP # on the server, but not actually delete them. You must use some other IMAP
# client to delete them if you use this setting; otherwise, the messages will # client to delete them if you use this setting; otherwise, the messages will
# just pile up there forever. Therefore, this setting is definitely NOT # just pile up there forever. Therefore, this setting is definitely NOT
@ -1248,6 +1251,8 @@ remoteuser = username
# #
# http://mail.google.com/support/bin/answer.py?answer=78799&topic=12814 # http://mail.google.com/support/bin/answer.py?answer=78799&topic=12814
# #
# This means ssl is enabled and must be configured correcly.
#
# To enable GMail labels synchronisation, set the option "synclabels" in the # To enable GMail labels synchronisation, set the option "synclabels" in the
# corresponding "Account" section. # corresponding "Account" section.
# #

View File

@ -415,7 +415,8 @@ class IMAPServer(object):
"failed:\n\t%s"% msg, OfflineImapError.ERROR.REPO) "failed:\n\t%s"% msg, OfflineImapError.ERROR.REPO)
if not tried_to_authn: if not tried_to_authn:
methods = ", ".join([x[5:] for x in [x for x in imapobj.capabilities if x[0:5] == "AUTH="]]) methods = ", ".join([x[5:] for x in
[x for x in imapobj.capabilities if x[0:5] == "AUTH="]])
raise OfflineImapError(u"Repository %s: no supported " raise OfflineImapError(u"Repository %s: no supported "
"authentication mechanisms found; configured %s, " "authentication mechanisms found; configured %s, "
"server advertises %s"% (self.repos, "server advertises %s"% (self.repos,