I've installed K-9 (the latest version, AFAIK, v. 5.403) for the first 
time, and I had a bit of a hard slog setting it up. I posted a couple of 
questions here about manually syncing email and the meaning of "poll" and 
"push." I've since deleted those posts, since I've largely solved my own 
problems, and don't want to trouble anyone else with them.

The problems came because, when I first installed K-9 and set up my Comcast 
email account (the only one I'll use), K-9 automatically defaulted to 
setting it up as IMAP, with which I'm unfamiliar, and which doesn't respond 
well to my limited needs for an email app on my phone. Only after I'd gone 
through a long process of trying to figure out settings did I manage to go 
back and manually set Comcast up as POP3. I've now got it working the way I 
want, which again is probably much simpler than many K-9 users need, 
especially those who are engaged in this forum.

WRT "poll" and "push", IMAP terms I didn't recognize, I finally found the 
page in the documentation on "Reading E-mail" (
https://k9mail.github.io/documentation/reading.html), which does explain 
clearly what these terms mean. It's regrettable that they aren't explained 
in the pages on settings, such as 
https://k9mail.github.io/documentation/settings/folder.html. Apparently 
what that page calls "Folder sync class" is now called "Folder poll class" 
in the current version. But the statement regarding "Folder push class" 
("the push class ... setting is only available for IMAP accounts") remains 
incomprehensible, since it doesn't explain for what purpose the setting is 
available; and the link to "How to use K-9’s folder class system" (
https://k9mail.github.io/documentation/settings/WorkingWithClasses) is 
broken (error 404).

There are other places where the online documentation seems to refer to an 
earlier version. For instance, in 
https://k9mail.github.io/documentation/folders.html I find:

Perhaps most confusing aspect of K-9 is the use of Classes to control the 
display and synchronization behavior of accounts and folders.... If you do 
not make any Class setting changes, K-9 will display all of your folders, 
but will not perform automatic synchronization on any of them, until you 
change the 'Email check frequency' in the Account settings.

This *is* confusing, and the fact that the setting "Email check frequency" 
does not seem to exist in the Account settings doesn't help. This page also 
refers to "Display mode" and "Sync mode" in Account settings. I found 
"Folders to display" under Account settings > Folders, which seems to be 
the same as "Display mode"; but I can't find "Sync mode" anywhere.

I'm looking forward to using K-9 now that I have it properly set up. I 
would like to suggest respectfully that (a) defaulting to IMAP in an 
initial, automated setup can create problems for users who are not 
expecting it; and (b) while I understand that as an open-source, free app 
K-9's documentation may not always be up-to-date in relation to current 
features, at least the setting sections, which is where new users are 
likely to go first IMHO, ought to be revised.

Thanks for listening!

PS. WRT the automatic IMAP setup, I discovered that, for Comcast, the 
incoming server should be imap.email.comcast.net (per the information on 
Comcast's Web email settings); in K-9 the incoming server is automatically 
set up as imap.comcast.net.

-- 
You received this message because you are subscribed to the Google Groups "K-9 
Mail" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
For more options, visit https://groups.google.com/d/optout.

Reply via email to