3.1 IMAP Folder

A folder to access e-mails via IMAP4rev1 protocol (RFC 2060).

Format:

`%' mailbox [`:' username [`/' authenticate-type]][`@' hostname][`:' port][`!']

You can specify login (encoded password transmission), cram-md5 (CRAM-MD5 authentication), digest-md5 (DIGEST-MD5 authentication) or clear (or nil, plain password transmission) as authenticate-type.

default:

username  -> The value of elmo-imap4-default-user.
             Initial setting is USER environment variable or
             LOGNAME environment variable or return value of
             (user-login-name).
authenticate-type -> The value of elmo-imap4-default-authenticate-type.
             Initial setting is "auth".
hostname  -> The value of elmo-imap4-default-server.
             Initial setting is "localhost".
port -> The value of elmo-imap4-default-port.
             Initial setting is 143.

You can omit the hostname from folder names if you set elmo-imap4-default-server as your main IMAP server. For example, you can specify a folder as `foo%imap@gateway' even if you have to go through a firewall.

;; Example: imap4.exaple.org as main IMAP server
(setq elmo-imap4-default-server "imap4.example.org")

SSL (Secure Socket Layer) connection will be used if a folder name ends with `!'. If a folder name ends with `!!', STARTTLS connection will be established.

If the value of elmo-imap4-default-stream-type is ssl, SSL will be the default connection, i.e. you can omit `!'. If it is is starttls, STARTTLS will be the default connection. To use normal connection in these cases, add `!direct' at the end of folder name.

;; Example: Use SSL connection
(setq elmo-imap4-default-stream-type 'ssl)

If you specify login, cram-md5 or digest-md5 as authentication method, the password is sent in encoded form. But, if your server is unable to receive an encoded password, authentication will fall back to clear (that is, sending password in raw format) after confirmation to user. If elmo-imap4-force-login is non-nil, authentication will fall back to clear without confirmation (default value is nil).

;; Example: password in raw format
(setq elmo-imap4-default-authenticate-type 'clear)

Example:

%inbox     -> IMAP mailbox "inbox"
%#mh/inbox -> IMAP mailbox "#mh/inbox"

%inbox:hoge -> IMAP mailbox "inbox" of user "hoge".
%inbox:hoge/clear@server1
            -> server1's IMAP mailbox "inbox"
               of user "hoge", with plain password authentication
               ('clear).