The MH-E Manual Version 8.5 March, 2013
Total Page:16
File Type:pdf, Size:1020Kb
The MH-E Manual Version 8.5 March, 2013 Bill Wohler This is version 8.5 of The MH-E Manual, last updated 2013-03-02. Copyright c 1995, 2001{2003, 2005{2013 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of either: a. the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with the Front-Cover texts being \A GNU Manual," and with the Back- Cover Texts as in (a) below. A copy of the license is included in the section entitled \GNU Free Documentation License." (a) The FSF's Back-Cover Text is: \You have the freedom to copy and modify this GNU manual." b. the GNU General Public License as published by the Free Software Foun- dation; either version 3, or (at your option) any later version. A copy of the license is included in the section entitled \GNU General Public License." i Table of Contents Preface :::::::::::::::::::::::::::::::::::::::::::::: 1 1 GNU Emacs Terms and Conventions ::::::::: 2 2 Getting Started ::::::::::::::::::::::::::::::::: 4 3 Tour Through MH-E ::::::::::::::::::::::::::: 6 3.1 Sending Mail ::::::::::::::::::::::::::::::::::::::::::::::::::: 6 3.2 Receiving Mail ::::::::::::::::::::::::::::::::::::::::::::::::: 7 3.3 Processing Mail :::::::::::::::::::::::::::::::::::::::::::::::: 7 3.4 Leaving MH-E ::::::::::::::::::::::::::::::::::::::::::::::::: 9 3.5 More About MH-E ::::::::::::::::::::::::::::::::::::::::::::: 9 4 Using This Manual :::::::::::::::::::::::::::: 10 4.1 Options ::::::::::::::::::::::::::::::::::::::::::::::::::::::: 10 4.2 Ranges ::::::::::::::::::::::::::::::::::::::::::::::::::::::: 11 4.3 Folder Selection ::::::::::::::::::::::::::::::::::::::::::::::: 12 5 Incorporating Your Mail :::::::::::::::::::::: 13 6 Reading Your Mail :::::::::::::::::::::::::::: 15 6.1 Viewing Your Mail :::::::::::::::::::::::::::::::::::::::::::: 19 6.2 Viewing Attachments ::::::::::::::::::::::::::::::::::::::::: 21 6.3 HTML :::::::::::::::::::::::::::::::::::::::::::::::::::::::: 24 6.4 Digests ::::::::::::::::::::::::::::::::::::::::::::::::::::::: 25 6.5 Signed and Encrypted Messages ::::::::::::::::::::::::::::::: 25 6.6 Printing Your Mail :::::::::::::::::::::::::::::::::::::::::::: 27 6.7 Files and Pipes ::::::::::::::::::::::::::::::::::::::::::::::: 27 6.8 Navigating :::::::::::::::::::::::::::::::::::::::::::::::::::: 28 6.9 Miscellaneous Commands and Options :::::::::::::::::::::::: 29 7 Organizing Your Mail with Folders :::::::::: 31 8 Sending Mail::::::::::::::::::::::::::::::::::: 37 8.1 Composing:::::::::::::::::::::::::::::::::::::::::::::::::::: 38 8.2 Replying to Mail :::::::::::::::::::::::::::::::::::::::::::::: 39 8.3 Forwarding Mail :::::::::::::::::::::::::::::::::::::::::::::: 40 8.4 Redistributing Your Mail:::::::::::::::::::::::::::::::::::::: 41 8.5 Editing Old Drafts and Bounced Messages::::::::::::::::::::: 41 ii 9 Editing a Draft :::::::::::::::::::::::::::::::: 42 9.1 Editing the Message::::::::::::::::::::::::::::::::::::::::::: 45 9.2 Inserting Letter to Which You're Replying::::::::::::::::::::: 46 9.3 Inserting Messages :::::::::::::::::::::::::::::::::::::::::::: 48 9.4 Inserting Your Signature :::::::::::::::::::::::::::::::::::::: 48 9.5 Inserting Your Picture :::::::::::::::::::::::::::::::::::::::: 48 9.6 Adding Attachments :::::::::::::::::::::::::::::::::::::::::: 49 9.7 Signing and Encrypting Messages ::::::::::::::::::::::::::::: 52 9.8 Checking Recipients::::::::::::::::::::::::::::::::::::::::::: 53 9.9 Sending a Message :::::::::::::::::::::::::::::::::::::::::::: 53 9.10 Killing the Draft ::::::::::::::::::::::::::::::::::::::::::::: 53 10 Aliases :::::::::::::::::::::::::::::::::::::::: 54 11 Identities:::::::::::::::::::::::::::::::::::::: 58 12 The Speedbar::::::::::::::::::::::::::::::::: 61 13 The Menu Bar:::::::::::::::::::::::::::::::: 62 14 The Tool Bar ::::::::::::::::::::::::::::::::: 63 15 Searching Through Messages:::::::::::::::: 64 15.1 Configuring Indexed Searches :::::::::::::::::::::::::::::::: 67 15.1.1 swish++ :::::::::::::::::::::::::::::::::::::::::::::::: 67 15.1.2 swish ::::::::::::::::::::::::::::::::::::::::::::::::::: 67 15.1.3 mairix :::::::::::::::::::::::::::::::::::::::::::::::::: 68 15.1.4 namazu ::::::::::::::::::::::::::::::::::::::::::::::::: 68 15.1.5 pick::::::::::::::::::::::::::::::::::::::::::::::::::::: 69 15.1.6 grep :::::::::::::::::::::::::::::::::::::::::::::::::::: 69 16 Viewing Message Threads ::::::::::::::::::: 70 17 Limiting Display ::::::::::::::::::::::::::::: 72 18 Using Sequences:::::::::::::::::::::::::::::: 73 19 Dealing With Junk Mail::::::::::::::::::::: 75 20 Miscellaneous Commands, Variables, and Buffers :::::::::::::::::::::::::::::::::::::::: 80 Appendix A Scan Line Formats:::::::::::::::: 81 iii Appendix B Reading Mailing Lists Effectively :::::::::::::::::::::::::::::::::::::::::::::::: 87 Appendix C Odds and Ends ::::::::::::::::::: 89 C.1 Bug Reports:::::::::::::::::::::::::::::::::::::::::::::::::: 89 C.2 MH-E Mailing Lists :::::::::::::::::::::::::::::::::::::::::: 89 C.3 MH FAQ and Support :::::::::::::::::::::::::::::::::::::::: 89 C.4 Getting MH-E :::::::::::::::::::::::::::::::::::::::::::::::: 89 Appendix D History of MH-E ::::::::::::::::: 90 D.1 From Brian Reid ::::::::::::::::::::::::::::::::::::::::::::: 90 D.2 From Jim Larus :::::::::::::::::::::::::::::::::::::::::::::: 90 D.3 From Stephen Gildea ::::::::::::::::::::::::::::::::::::::::: 91 D.4 From Bill Wohler ::::::::::::::::::::::::::::::::::::::::::::: 91 Appendix E GNU Free Documentation License :::::::::::::::::::::::::::::::::::::::::::::::: 93 Appendix F GNU General Public License::: 101 Key (Character) Index :::::::::::::::::::::::::: 112 Command Index ::::::::::::::::::::::::::::::::: 115 Option (Variable) Index ::::::::::::::::::::::::: 117 Concept Index:::::::::::::::::::::::::::::::::::: 120 Preface 1 Preface This manual introduces another interface to the MH mail system that is accessible through the GNU Emacs editor, namely, MH-E. MH-E is easy to use. I don't assume that you know GNU Emacs or even MH at this point, since I didn't know either of them when I discovered MH-E. However, MH-E was the tip of the iceberg, and I discovered more and more niceties about GNU Emacs and MH. Now I'm fully hooked on both of them. The MH-E package is distributed with Emacs1, so you shouldn't have to do anything special to use it. Gnus is also required; version 5.10 or higher is recommended. This manual covers MH-E version 8.5. To help you decide which version you have, see Chapter 2 [Getting Started], page 4. If you don't already use GNU Emacs but want to learn more, you can read an online tutorial by starting GNU Emacs and typing C-h t (help-with-tutorial). (To learn about this notation, see Chapter 1 [Conventions], page 2.) If you want to take the plunge, consult the GNU Emacs Manual, from the Free Software Foundation. If more information is needed, you can go to the Unix manual pages of the individual MH commands. When the name is not obvious, I'll guide you to a relevant MH manual page that describes the action more fully. This manual is available in both Info and online formats. The Info version is distributed with Emacs and can be accessed with the info command (`info mh-e') or within Emacs (C-h i m mh-e RET). The online version is available at SourceForge. Another great online resource is the book MH & nmh: Email for Users & Programmers (also known as the MH book). I hope you enjoy this manual! If you have any comments, or suggestions for this docu- ment, please let me know. Bill Wohler <wohler at newt.com> 8 February 1995 24 February 2006 1 Version 8.5 of MH-E appeared in Emacs 24.4. It is supported in GNU Emacs 23 and higher, as well as XEmacs 21.4.22 and 21.5.31. MH-E is known not to work with GNU Emacs versions 20 and below, and XEmacs version 21.5.9{21.5.16. It is compatible with MH versions 6.8.4 and higher, all versions of nmh, and GNU mailutils 1.0 and higher Chapter 1: GNU Emacs Terms and Conventions 2 1 GNU Emacs Terms and Conventions If you're an experienced Emacs user, you can skip the following conventions and definition of terms and go directly to the next section (see Chapter 2 [Getting Started], page 4). In general, functions in this text refer to Emacs Lisp functions that one would call from within Emacs Lisp programs (for example, (mh-inc-folder)). On the other hand, commands are those things that are run by the user, such as i or M-x mh-inc-folder. Programs outside of Emacs are specifically called MH commands, shell commands, or Unix commands. The conventions for key names are as follows: C-x Hold down the CTRL (Control) key and press the x key. M-x Hold down the META or ALT key and press the x key. Since some keyboards don't have a META key, you can generate M-x, for example, by pressing ESC (Escape), releasing it, and then pressing the x key. RET Press the RETURN or ENTER key. This is normally used to complete a command. SPC Press the space bar. TAB Press the TAB key. DEL Press the DELETE key. BS Press the BACKSPACE key1. A prefix argument allows you to pass an argument to any Emacs function. To pass an argument, type C-u before the Emacs command or keystroke. Numeric arguments can be passed as well. For example, to insert five f's, use C-u 5 f. There is a default of four when using C-u, and you can use multiple prefix arguments to provide arguments of powers of four. To continue our example, you could insert four f's with C-u f, 16 f's with C-u C-u