@dircategory Emacs * Mailcrypt: (mailcrypt). An Emacs/PGP interface.
Copyright (C) 1995 Patrick J. LoPresti
Copyright (C) 1998 Leonard R. Budney
Copyright (C) 2001 Brian Warner
The Mailcrypt program and this documentation are published as free software. You may redistribute and/or modify them under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.
Mailcrypt is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with GNU Emacs; see the file COPYING. If not, write to the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
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://mailcrypt.sourceforge.net 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 the following lines to your `.emacs' file:
(load-library "mailcrypt") ; provides "mc-setversion" (mc-setversion "2.6") ; for PGP 2.6 (default); also "5.0" and "gpg"
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)
To hook Mailcrypt into Mew, use the following lines:
(add-hook 'mew-message-mode-hook 'mc-install-read-mode) (add-hook 'mew-summary-mode-hook 'mc-install-read-mode) (add-hook 'mew-draft-mode-hook 'mc-install-write-mode)
Note that Mew already has extensive support for MIME-encoded encrypted and/or signed messages (using the "multipart/encrypted" and "application/pgp-encrypted" formats specified by RFC3156). Using MailCrypt within Mew is most useful for traditional "inline" armored encrypted/signed messages.
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.