Next: Client-Side IMAP Splitting, Previous: Connecting to an IMAP Server, Up: Using IMAP

#### 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.
`nnimap-authenticator`
  Some IMAP servers allow anonymous logins. In that case, this should be set to `anonymous`.
`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.