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.