Go to the first, previous, next, last section, table of contents.
Mailcrypt is an Emacs Lisp package which provides a simple but powerful interface to cryptographic functions for mail and news. With Mailcrypt, encryption becomes a seamlessly integrated part of your mail and news handling environment.
This manual is long because it is complete. All of the information you need to get started is contained in this Introduction alone.
Mailcrypt requires version 19 or higher of GNU Emacs. Mailcrypt has been tested on a variety of systems under both FSF Emacs and XEmacs.
Mailcrypt requires Pretty Good (tm) Privacy, usually known as PGP. This document assumes that you have already obtained and installed PGP and that you are familiar with its basic functions. The best way to become familiar with these functions is to read the PGP User's Guide, at least Volume I.
For more information on obtaining and installing PGP, refer to the MIT PGP home page at http://web.mit.edu/network/pgp.html.
Although Mailcrypt may be used to process data in arbitrary Emacs buffers, it is most useful in conjunction with other Emacs packages for handling mail and news. Mailcrypt has specialized support for Rmail (see section `Reading Mail with Rmail' in The GNU Emacs Manual), VM (see section `Introduction' in The VM User's Manual), MH-E, and Gnus (see section `Overview' in The Gnus Manual). Information on the general use of these packages is beyond the scope of this manual.
If Mailcrypt is not installed on your system, obtain the latest version from the Mailcrypt home page at http://www.pobox.com/~lbudney/linux/software/mailcrypt.html and follow the instructions in the file `INSTALL'.
Next, decide what version of PGP you are using. Versions 3.5 and higher of Mailcrypt support multiple versions of PGP. To choose a version, add one of the following lines to your `.emacs' file:
(mc-setversion "pgp") ; for PGP 2.6.x (mc-setversion "pgp50") ; for PGP 5.x
Next, teach your Emacs how and when to load the Mailcrypt functions and install the Mailcrypt key bindings. Almost all Emacs major modes (including mail and news handling modes) have corresponding "hook" variables which hold functions to be run when the mode is entered. All you have to do is add the Mailcrypt installer functions to the appropriate hooks; then the installer functions will add the Mailcrypt key bindings when the respective mode is entered.
Specifically, begin by placing the following lines into your `.emacs' file (or the system-wide `default.el' file):
(autoload 'mc-install-write-mode "mailcrypt" nil t) (autoload 'mc-install-read-mode "mailcrypt" nil t) (add-hook 'mail-mode-hook 'mc-install-write-mode)
Then add additional lines for your own mail and news packages as described below.
To hook Mailcrypt into Rmail, use the following lines:
(add-hook 'rmail-mode-hook 'mc-install-read-mode) (add-hook 'rmail-summary-mode-hook 'mc-install-read-mode)
Using Emacs version 20.3 or higher, you should use the following lines instead:
(add-hook 'rmail-show-message-hook 'mc-install-read-mode) (add-hook 'rmail-summary-mode-hook 'mc-install-read-mode)
To hook Mailcrypt into VM, use the following lines:
(add-hook 'vm-mode-hook 'mc-install-read-mode) (add-hook 'vm-summary-mode-hook 'mc-install-read-mode) (add-hook 'vm-virtual-mode-hook 'mc-install-read-mode) (add-hook 'vm-mail-mode-hook 'mc-install-write-mode)
To hook Mailcrypt into MH-E, use the following lines:
(add-hook 'mh-folder-mode-hook 'mc-install-read-mode) (add-hook 'mh-letter-mode-hook 'mc-install-write-mode)
To hook Mailcrypt into Gnus, use the following lines:
(add-hook 'gnus-summary-mode-hook 'mc-install-read-mode) (add-hook 'message-mode-hook 'mc-install-write-mode) (add-hook 'news-reply-mode-hook 'mc-install-write-mode)
All Mailcrypt commands are (by default) activated by three-character key sequences which begin with C-c /. The most common operations are:
These functions and others are documented in detail in the following chapters.
Any time you are composing or reading mail or news, you can get a
summary of the available commands by typing C-h m. If you are
running Emacs under X, an even easier way to see the available commands
is to access the Mailcrypt pull-down menu.
Go to the first, previous, next, last section, table of contents.