After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 730460 - Update docs for IMAPx changes
Update docs for IMAPx changes
Status: RESOLVED FIXED
Product: evolution
Classification: Applications
Component: User Documentation
3.12.x (obsolete)
Other Linux
: Normal normal
: ---
Assigned To: evolution-user-docs
Evolution QA team
Depends on:
Blocks:
 
 
Reported: 2014-05-20 15:43 UTC by Milan Crha
Modified: 2015-03-09 00:29 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Milan Crha 2014-05-20 15:43:44 UTC
This is per request for inclusion of commit [1] in 3.12.3+ of eds.
I'd suggest to write to the doc [1] a small paragraph into Receiving Options with a text along these lines:

   Since 3.12.1 are enabled concurrent connections to a server, which helps
   with response of user actions in UI. The amount of available connections
   can be influenced here too, or even completely turned off (set to one
   connection only), for cases when server doesn't allow multiple concurrent
   connections.

[1] https://git.gnome.org/browse/evolution-data-server/commit/?id=8c3d0d4b29
[2] https://help.gnome.org/users/evolution/3.12/mail-receiving-options-imap-plus.html
Comment 1 André Klapper 2014-05-20 16:14:35 UTC
So what is *recommended* to users here? 
When to change the setting to which value? How to find out if the "server doesn't allow multiple concurrent connections"? And shouldn't Evolution find out itself from a server response and automatically change that setting?

I'm not after explaining implementation details (no user should care how many connections Evolution creates) and "enter random numbers here if things vaguely don't work whatever 'things' means" won't be helpful.
Comment 2 Milan Crha 2014-05-21 08:15:32 UTC
3.12.2 uses "adaptive" concurrent connection count, if it fails to open a new connection and more are already opened, then it will not try to open more than there are alive at the moment of the failure. In some corner cases it can fail even with two connections, when a user has two accounts on the same server (I had such case reported), where helped to disable the concurrent connections, by setting 1 to it. IMAPx cannot manage multiple connections between accounts, being it on the same server or not.
Comment 3 André Klapper 2014-05-21 12:56:02 UTC
(In reply to comment #2)
> where helped to disable the concurrent connections, by
> setting 1 to it. IMAPx cannot manage multiple connections between accounts,
> being it on the same server or not.

So from a user point of view who does not care about implementation but wants to access her mail without problems, what's going to be the explanation for this setting in the user docs, and when to change the setting to which value?
Comment 4 Milan Crha 2014-05-21 16:21:54 UTC
I cannot give you anything better than the above, I'm sorry. I can tell you internal things in the background and some samples when things did break and were reported by users (see above) recently, but probably nothing more without feeling like repeating myself.
Comment 5 André Klapper 2015-02-15 23:19:56 UTC
@mcrha: So I have two Gmail accounts configured. I set that value for one account in Evolution to "1" and for the other account in Evolution to "5". 
Now which account wins?

Anyway, for the time being: https://git.gnome.org/browse/evolution/commit/?id=d793747eda8cb5e028fc74fcafea3144f49ba66f
Comment 6 Milan Crha 2015-02-16 17:18:46 UTC
(In reply to André Klapper from comment #5)
> @mcrha: So I have two Gmail accounts configured. I set that value for one
> account in Evolution to "1" and for the other account in Evolution to "5". 
> Now which account wins?

Both will work, if GMail allows at least 2 connections and the later account will not use all the connections before the former account. If the GMail allows only one connection, then I cannot tell which account will win and will acquire the only provided connection by the server.
Comment 7 André Klapper 2015-03-09 00:29:54 UTC
Works for me (don't really want to understand this and not sure users want to understand this either).