2. Getting Started

At present, IMAIL has only a very simple mechanism for connecting to an IMAP server: it makes an unencrypted connection to the server, and logs in with a user name and a password. In the near future, we will implement CRAM-MD5 authentication (defined in RFC 2095). However, we have no plans to implement data-stream encryption for the connection.(1)

To use IMAIL, you must create an Edwin init file, called `~/.edwin' on unix machines or `edwin.ini' on Windows or OS/2 machines. This file contains arbitrary Scheme expressions that are evaluated in the Edwin environment when Edwin is started. In addition to any other customizations you put in this file, you must include the following expression:

(load-option 'imail)

Next, you must tell Edwin where to find your IMAP server, by setting some variables; the expression to do this must follow the call to load-option. Here is an example:

(load-option 'imail) (set-variable! imail-default-imap-server "imap.foo.org")

Note that this is syntactically similar to Scheme's set! special form, but that it modifies the value of an Edwin editor variable rather than a Scheme variable. There are several other variables that control how IMAIL connects to the server. See section 4.3 Multiple Folders, for a complete list. By default, IMAIL tries to connect to `localhost' using port 143, and to log in using the user name that you are logged in as. This is the right default if you are using stunnel on the client.

After you are finished creating the init file, you can either restart Edwin, or you can load the file using M-x load-file. At this point, you are ready to run IMAIL. To start IMAIL and read the mail in the `inbox' folder on your IMAP server, type M-x imail.