Re: Setting up Gnus with IMAP

[Simon Josefsson <jas@extundo.com>]

Sebastian Kaps <seb-dated-1058345066.f5d54a@toyland.sauerland.de> writes:

> // Kai Großjohann writes:
>
>> IMHO it doesn't make sense to specify so many values which are the
>> default anyhow.  For example, should the port be "143" or 143?
>> Should the authenticator be "login" or login?  Etc pp.
>
> Yes, you're right. But shouldn't the documentation be more clearly about
> this issue?

The documentation says the following.  How can we improve it?

`nnimap-stream'
     The type of stream used to connect to your server.  By default,
     nnimap will detect and automatically use all of the below, with
     the exception of TLS/SSL.  (IMAP over TLS/SSL is being replaced by
     STARTTLS, which can be automatically detected, but it's not widely
     deployed yet.)

     Example server specification:

          (nnimap "mail.server.com"
                  (nnimap-stream ssl))

     Please note that the value of `nnimap-stream' is a symbol!
...