gnus: Customizing the IMAP Connection
6.3.2 Customizing the IMAP Connection
-------------------------------------
Here’s an example method that’s more complex:
(nnimap "imap.gmail.com"
(nnimap-inbox "INBOX")
(nnimap-split-methods default)
(nnimap-expunge t)
(nnimap-stream ssl))
‘nnimap-address’
The address of the server, like ‘imap.gmail.com’.
‘nnimap-server-port’
If the server uses a non-standard port, that can be specified here.
A typical port would be ‘"imap"’ or ‘"imaps"’.
‘nnimap-stream’
How ‘nnimap’ should connect to the server. Possible values are:
‘undecided’
This is the default, and this first tries the ‘ssl’ setting,
and then tries the ‘network’ setting.
‘ssl’
This uses standard TLS/SSL connections.
‘network’
Non-encrypted and unsafe straight socket connection, but will
upgrade to encrypted STARTTLS if both Emacs and the server
supports it.
‘starttls’
Encrypted STARTTLS over the normal IMAP port.
‘shell’
If you need to tunnel via other systems to connect to the
server, you can use this option, and customize
‘nnimap-shell-program’ to be what you need.
‘plain’
Non-encrypted and unsafe straight socket connection. STARTTLS
will not be used even if it is available.
‘nnimap-authenticator’
Some IMAP servers allow anonymous logins. In that case, this
should be set to ‘anonymous’. If this variable isn’t set, the
normal login methods will be used. If you wish to specify a
specific login method to be used, you can set this variable to
either ‘login’ (the traditional IMAP login method), ‘plain’ or
‘cram-md5’.
‘nnimap-expunge’
If non-‘nil’, expunge articles after deleting them. This is always
done if the server supports UID EXPUNGE, but it’s not done by
default on servers that doesn’t support that command.
‘nnimap-streaming’
Virtually all IMAP server support fast streaming of data. If you
have problems connecting to the server, try setting this to ‘nil’.
‘nnimap-fetch-partial-articles’
If non-‘nil’, fetch partial articles from the server. If set to a
string, then it’s interpreted as a regexp, and parts that have
matching types will be fetched. For instance, ‘"text/"’ will fetch
all textual parts, while leaving the rest on the server.
‘nnimap-record-commands’
If non-‘nil’, record all IMAP commands in the ‘"*imap log*"’
buffer.