[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/man/mh-e.texi
From: |
Bill Wohler |
Subject: |
[Emacs-diffs] Changes to emacs/man/mh-e.texi |
Date: |
Wed, 15 Mar 2006 00:26:14 +0000 |
Index: emacs/man/mh-e.texi
diff -u emacs/man/mh-e.texi:1.26 emacs/man/mh-e.texi:1.27
--- emacs/man/mh-e.texi:1.26 Sun Mar 12 03:57:54 2006
+++ emacs/man/mh-e.texi Wed Mar 15 00:26:11 2006
@@ -8,11 +8,11 @@
@c %**end of header
@c Version of the software and manual.
address@hidden VERSION 7.93+cvs
address@hidden EDITION of the manual. It is either empty for the first edition
or
address@hidden VERSION 7.93
address@hidden Edition of the manual. It is either empty for the first edition
or
@c has the form ", nth Edition" (without the quotes).
address@hidden EDITION
address@hidden UPDATED 2006-03-11
address@hidden EDITION , 3rd Edition
address@hidden UPDATED 2006-03-14
@set UPDATE-MONTH March, 2006
@c Other variables.
@@ -203,6 +203,7 @@
@cindex Emacs
@cindex Unix commands, Emacs
address@hidden preface
This manual introduces another interface to the MH mail system that is
accessible through the GNU Emacs editor, namely, @emph{MH-E}. MH-E is
@@ -221,6 +222,9 @@
MH-E version @value{VERSION}. To help you decide which version you
have, see @ref{Getting Started}.
address@hidden help-with-tutorial
address@hidden C-h t
+
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 @kbd{C-h t}
(@code{help-with-tutorial}). (To learn about this notation, see
@@ -241,10 +245,13 @@
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.
address@hidden info
address@hidden C-h i
+
This manual is available in both Info and online formats. The Info
version is distributed with Emacs and can be accessed with the
address@hidden command (@samp{info mh-e}) or within Emacs (@kbd{M-x
-info @key{RET} m mh-e @key{RET}}). The online version is available at
address@hidden command (@samp{info mh-e}) or within Emacs (@kbd{C-h i
+m mh-e @key{RET}}). The online version is available at
@uref{http://mh-e.sourceforge.net/manual/, SourceForge}. Another great
online resource is the book @uref{http://www.ics.uci.edu/~mh/book/,
@cite{MH & nmh: Email for Users & Programmers}} (also known as
@@ -265,8 +272,11 @@
@chapter GNU Emacs Terms and Conventions
@cindex Emacs
address@hidden Emacs, terms and conventions
address@hidden Emacs, conventions
address@hidden Emacs, terms
@cindex Unix commands, Emacs
address@hidden conventions, Emacs
address@hidden terms, Emacs
If you're an experienced Emacs user, you can skip the following
conventions and definition of terms and go directly to the next
@@ -325,6 +335,7 @@
@cindex Emacs, prefix argument
@cindex prefix argument
address@hidden C-u
A @dfn{prefix argument} allows you to pass an argument to any Emacs
function. To pass an argument, type @kbd{C-u} before the Emacs command
@@ -348,8 +359,11 @@
@end quotation
@sp 1
address@hidden @file{.emacs}
@cindex Emacs, variables
address@hidden files, @file{.emacs}
@cindex variables
address@hidden setq
Emacs uses @dfn{variables} to hold values. These can be changed via
calls to the function @code{setq} in @file{~/.emacs}.
@@ -392,9 +406,11 @@
Face Customization} in @cite{The GNU Emacs Manual}.
@end ifhtml
address@hidden abnormal hooks
@cindex hooks
@cindex normal hooks
address@hidden abnormal hooks
address@hidden add-hook
address@hidden customize-option
Commands often offer @dfn{hooks} which enable you to extend or modify
the way a command works.
@@ -409,10 +425,11 @@
@end ifhtml
for a description about @dfn{normal hooks} and @dfn{abnormal hooks}.
MH-E uses normal hooks in nearly all cases, so you can assume that we
-are talking about normal hooks unless we explicitly mention that a hook
-is abnormal. We also follow the conventions described in that section:
-the name of the abnormal hooks end in @code{-hooks} and all the rest
-of the MH-E hooks end in @code{-hook}.
+are talking about normal hooks unless we explicitly mention that a
+hook is abnormal. We also follow the conventions described in that
+section: the name of the abnormal hooks end in @code{-hooks} and all
+the rest of the MH-E hooks end in @code{-hook}. You can add hooks with
+either @code{customize-option} or @code{add-hook}.
@cindex Emacs, mark
@cindex Emacs, point
@@ -420,6 +437,8 @@
@cindex mark
@cindex point
@cindex region
address@hidden C-@@
address@hidden address@hidden
There are several other terms that are used in Emacs that you should
know. The @dfn{point} is where the cursor currently is. You can save
@@ -430,14 +449,16 @@
filling paragraphs. A mark can be set with @kbd{C-@@} (or
@address@hidden).
address@hidden completion
@cindex Emacs, completion
@cindex Emacs, file completion
@cindex Emacs, folder completion
@cindex Emacs, minibuffer
address@hidden completion
@cindex file completion
@cindex folder completion
@cindex minibuffer
address@hidden SPC
address@hidden TAB
The @dfn{minibuffer} is the bottom line of the Emacs window, where all
prompting and multiple-character input is directed. You can use
@@ -456,6 +477,10 @@
Note that @key{SPC} cannot be used for completing filenames and
folders.
address@hidden help-with-tutorial
address@hidden C-h t
address@hidden M-x
+
The minibuffer is also where you enter Emacs function names after
typing @kbd{M-x}. For example, in the preface, I mentioned that you
could obtain help with @kbd{C-h t} (@code{help-with-tutorial}). What
@@ -518,6 +543,14 @@
MH-E, and you may need to install MH too. However, newer versions of
MH-E are better at finding MH if it is on your system.}.
address@hidden @command{mhparam}
address@hidden MH commands, @command{mhparam}
address@hidden exec-path
address@hidden mh-path
address@hidden mh-sys-path
address@hidden mh-variant
address@hidden mh-variant-in-use
+
The option @code{mh-variant} specifies the variant used by MH-E
(@pxref{Options}). The default setting of this option is
@samp{Auto-detect} which means that MH-E will automatically choose the
@@ -525,15 +558,23 @@
listed in @code{mh-path} (which you can customize),
@code{mh-sys-path}, and @code{exec-path}. If MH-E can't find MH at
all, you may have to customize @code{mh-path} and add the directory in
-which the command @code{mhparam} is located. If, on the other hand,
+which the command @command{mhparam} is located. If, on the other hand,
you have both nmh and mailutils installed (for example) and
@code{mh-variant-in-use} was initialized to nmh but you want to use
mailutils, then you can set @code{mh-variant} to @samp{mailutils}.
address@hidden mh-flists-present-flag
address@hidden mh-lib
address@hidden mh-lib-progs
address@hidden mh-progs
+
When @code{mh-variant} is changed, MH-E resets @code{mh-progs},
@code{mh-lib}, @code{mh-lib-progs}, @code{mh-flists-present-flag}, and
@code{mh-variant-in-use} accordingly.
address@hidden @file{.emacs}
address@hidden files, @file{.emacs}
+
@sp 1
@center @strong{NOTE}
@@ -565,14 +606,14 @@
component contains the path to your mail directory, which is
@file{~/Mail} by default.
address@hidden @samp{Draft-Folder:} MH profile component
address@hidden @samp{Path:} MH profile component
address@hidden @samp{Previous-Sequence:} MH profile component
address@hidden @samp{Unseen-Sequence:} MH profile component
@cindex MH profile component, @samp{Draft-Folder:}
@cindex MH profile component, @samp{Path:}
@cindex MH profile component, @samp{Previous-Sequence:}
@cindex MH profile component, @samp{Unseen-Sequence:}
address@hidden @samp{Draft-Folder:} MH profile component
address@hidden @samp{Path:} MH profile component
address@hidden @samp{Previous-Sequence:} MH profile component
address@hidden @samp{Unseen-Sequence:} MH profile component
@findex mh-find-path
@vindex mh-draft-folder
@vindex mh-find-path-hook
@@ -597,6 +638,10 @@
@node Tour Through MH-E, Using This Manual, Getting Started, Top
@chapter Tour Through MH-E
address@hidden introduction
address@hidden tour
address@hidden tutorial
+
This chapter introduces some of the terms you'll need to know and then
takes you on a tour of address@hidden keys mentioned in these
chapters refer to the default key bindings. If you've changed the
@@ -621,6 +666,7 @@
@cindex sending mail
@findex mh-smail
address@hidden M-x mh-smail
Let's start our tour by sending ourselves a message which we can later
read and process. Enter @kbd{M-x mh-smail} to invoke the MH-E program
@@ -671,7 +717,10 @@
the header.
@cindex help
address@hidden describe-mode
address@hidden C-c ?
@kindex C-c C-c
address@hidden C-h m
There are several commands specific to MH-Letter address@hidden can
get quick help for the commands used most often with @kbd{C-c ?} or
@@ -690,6 +739,7 @@
@cindex modes, MH-Folder
@cindex reading mail
@findex mh-rmail
address@hidden M-x mh-rmail
To read the mail you've just sent yourself, enter @kbd{M-x mh-rmail}.
This incorporates the new mail and puts the output from
@@ -702,10 +752,15 @@
summary of each message) into a buffer called @samp{+inbox} whose
major mode is MH-Folder.
address@hidden mh-rmail
address@hidden F r
address@hidden M-x mh-rmail
+
@sp 1
@center @strong{NOTE}
@quotation
+
The @kbd{M-x mh-rmail} command will show you only new mail, not mail
you have already read. If you were to run this tour again, you would
use @kbd{F r} to pull all your messages into MH-E.
@@ -753,6 +808,7 @@
@section Processing Mail
@cindex processing mail
address@hidden @key{RET}
@kindex r
The first thing we want to do is reply to the message that we sent
@@ -789,8 +845,17 @@
@end cartouche
@i{Composition window during reply}
address@hidden backward-char
address@hidden forward-char
address@hidden next-line
address@hidden previous-line
address@hidden C-b
@kindex C-c C-c
@kindex C-c C-f C-t
address@hidden C-f
address@hidden C-n
address@hidden C-p
address@hidden @key{BS}
By default, MH will not add you to the address list of your replies,
so if you find that the @samp{To:} header field is missing, don't
@@ -802,7 +867,10 @@
delete the previous character with @key{BS}. When you're finished
editing your message, send it with @kbd{C-c C-c} as before.
address@hidden @command{refile}
address@hidden MH commands, @command{refile}
@cindex folders
address@hidden @key{SPC}
@kindex o
You'll often want to save messages that were sent to you in an
@@ -820,9 +888,11 @@
@cindex MH-Folder mode
@cindex modes, MH-Folder
address@hidden @key{RET}
@kindex d
@kindex i
address@hidden @key{RET}
address@hidden n
address@hidden p
@kindex x
Your previous reply is now waiting in the system mailbox. You
@@ -837,6 +907,7 @@
@findex mh-smail
@kindex m
address@hidden M-x mh-smail
If you want to send another message you can use @kbd{m} instead of
@kbd{M-x mh-smail}. So go ahead, send some mail to your friends!
@@ -846,6 +917,7 @@
@findex describe-mode
@kindex ?
@kindex C-h m
address@hidden F ?
You can get a quick reminder about these commands by typing @kbd{?}.
This lists several @dfn{prefix characters}. To list the commands
@@ -858,6 +930,8 @@
@cindex Emacs, quitting
@cindex quitting
address@hidden C-x C-c
address@hidden x
You may now wish to exit @command{emacs} entirely. Use @kbd{C-x C-c}
to exit @command{emacs}. If you exited without running @kbd{x} in the
@@ -866,6 +940,9 @@
perform any refiles and deletes that you did there.
@findex mh-rmail
address@hidden C-x b
address@hidden C-x k
address@hidden M-x mh-rmail
@kindex q
If you don't want to leave Emacs, you can type @kbd{q} to bury (hide)
@@ -968,6 +1045,10 @@
@findex mh-help
@kindex ?
@kindex C-c ?
address@hidden C-h C-h
address@hidden C-h C-k i
address@hidden C-h i
address@hidden C-h m
There are many commands, but don't get intimidated. There are command
summaries at the beginning of each chapter. In case you have or would
@@ -998,7 +1079,8 @@
GNU Emacs. Note that MH-E does not provide hooks for customizations
that can be done in MH; this omission is intentional.
address@hidden Emacs, Emacs Lisp manual
address@hidden Emacs Lisp Manual
address@hidden Emacs, Emacs Lisp Manual
@cindex Emacs, info
@cindex Emacs, online help
@cindex info
@@ -1080,6 +1162,12 @@
Sessions}. To read more about @code{mh-lpr-command-format}, see
@ref{Printing}.
address@hidden nil
address@hidden off, option
address@hidden on, option
address@hidden option, turning on and off
address@hidden t
address@hidden customize-option
@vindex mh-bury-show-buffer-flag, example
Options can also hold boolean values. In Emacs Lisp, the boolean
@@ -1095,14 +1183,16 @@
default, which places the MH-Show buffer at the bottom of the buffer
stack.
address@hidden mh-mhl-format-file, example
+
The text usually says to turn on an option by setting it to a
@address@hidden value, because sometimes values other than
@samp{on} are meaningful. An example of this is the variable
@code{mh-mhl-format-file} (@pxref{Viewing}). Other options, such as
hooks, involve a little more Emacs Lisp programming expertise.
address@hidden @samp{mh} customization group
@cindex customization group, @samp{mh}
address@hidden @samp{mh} customization group
@findex customize-group
@findex mh-customize
@@ -1117,14 +1207,16 @@
@c Sync with mh-folder-mode docstring.
address@hidden ranges
@cindex message abbreviations
@cindex message ranges
address@hidden ranges
Many commands that operate on individual messages, such as
@code{mh-forward} or @code{mh-refile-msg} take a @code{RANGE}
argument. This argument can be used in several ways.
address@hidden C-u, with ranges
+
If you provide the prefix argument @kbd{C-u} to these commands, then
you will be prompted for the message range. This can be any valid MH
range which can include messages, sequences (@pxref{Sequences}), and
@@ -1156,9 +1248,9 @@
@vindex transient-mark-mode
-If the option @code{transient-mark-mode} is set to @code{t} and you
-set a region in the MH-Folder buffer, then the MH-E command will
-perform the operation on all messages in that region.
+If the option @code{transient-mark-mode} is turned on and you set a
+region in the MH-Folder buffer, then the MH-E command will perform the
+operation on all messages in that region.
@cindex @samp{mh-range} customization group
@cindex customization group, @samp{mh-range}
@@ -1171,6 +1263,8 @@
On means interpret a number as a range (default: @samp{on}).
@end vtable
address@hidden mh-interpret-number-as-range-flag
+
Since one of the most frequent ranges used is @samp{last:N}, MH-E will
interpret input such as @samp{200} as @samp{last:200} if the
@code{mh-interpret-number-as-range-flag} option is on (which is the
@@ -1180,6 +1274,8 @@
@node Folder Selection, , Ranges, Using This Manual
@section Folder Selection
address@hidden completion, folders
address@hidden folders, completion
@cindex folders, selecting
When you choose a folder in MH-E via a command such as @kbd{o}
@@ -1195,8 +1291,8 @@
In addition, MH-E has several ways of choosing a suitable default so
that the folder can often be selected with a single @key{RET} key.
address@hidden @samp{mh-folder-selection} customization group
@cindex customization group, @samp{mh-folder-selection}
address@hidden @samp{mh-folder-selection} customization group
The @samp{mh-folder-selection} customization group contains some
options which are used to help with this.
@@ -1217,6 +1313,8 @@
Prefix used for folder names generated from aliases (default: @code{""}).
@end vtable
address@hidden mh-default-folder-for-message-function
+
You can set the option @code{mh-default-folder-for-message-function}
to a function that provides a default folder for the message to be
refiled. When this function is called, the current buffer contains the
@@ -1230,6 +1328,7 @@
sender as follows:
@enumerate
address@hidden mh-default-folder-list
@item
The folder name associated with the first address found in the list
@code{mh-default-folder-list} is used. Each element in this list
@@ -1237,12 +1336,15 @@
then the address is checked against the recipient instead of the
sender. This is useful for mailing lists.
@c -------------------------
address@hidden mh-default-folder-prefix
@item
An alias prefixed by @code{mh-default-folder-prefix} corresponding to
the address is used. The prefix is used to prevent clutter in your
mail directory. @xref{Aliases}.
@end enumerate
address@hidden mh-default-folder-must-exist-flag
+
If the derived folder does not exist, and
@code{mh-default-folder-must-exist-flag} is @code{t}, then the last
folder name used is suggested. This is useful if you get mail from
@@ -1252,7 +1354,9 @@
@node Incorporating Mail, Reading Mail, Using This Manual, Top
@chapter Incorporating Your Mail
address@hidden @samp{Folder} menu
@cindex incorporating
address@hidden menu, @samp{Folder}
This chapter talks about getting mail from your system mailbox into
your MH @samp{+inbox} folder. The following command accomplishes that
@@ -1284,11 +1388,16 @@
The following hook is available.
@vtable @code
address@hidden mh-inc-folder
@item mh-inc-folder-hook
-Hook run by @samp{mh-inc-folder} after incorporating mail into a
+Hook run by @code{mh-inc-folder} after incorporating mail into a
folder (default: @code{nil}).
@end vtable
address@hidden @samp{+inbox}
address@hidden mh-inc-folder
address@hidden i
+
If at any time you receive new mail, incorporate the new mail into
your @samp{+inbox} buffer with @kbd{i} (@code{mh-inc-folder}). Note
that @kbd{i} will display the @samp{+inbox} buffer, even if there
@@ -1305,7 +1414,7 @@
Emacs can notify you when you have new mail by displaying @samp{Mail}
in the mode line. To enable this behavior, and to have a clock in the
-mode line besides, add the following to @file{~/.emacs}:
+mode line as well, add the following to @file{~/.emacs}:
@findex display-time
@@ -1314,8 +1423,9 @@
@end lisp
@cindex @command{inc}
address@hidden MH commands, @command{inc}
@cindex incorporating
address@hidden MH commands, @command{inc}
address@hidden mh-inc-prog
@vindex mh-progs
The name of the program that incorporates new mail is stored in
@@ -1330,6 +1440,8 @@
the MH book). You'll then need to modify several variables
appropriately (@pxref{Scan Line Formats}).
address@hidden mh-inc-spool-list
+
You can use the @code{mh-inc-spool-list} variable to direct MH-E to
retrieve mail from arbitrary spool files other than your system
mailbox, file it in folders other than your @samp{+inbox}, and assign
@@ -1351,6 +1463,9 @@
mh-e
@end smallexample
address@hidden mh-inc-spool-*
address@hidden I *
+
In order to incorporate @file{~/mail/mh-e} into @samp{+mh-e} with an
@kbd{I m} (@code{mh-inc-spool-mh-e}) command, customize this option,
and click on the @samp{INS} button. Enter a @samp{Spool File} of
@@ -1380,6 +1495,10 @@
In XEmacs, the command @command{gnuclient} is used in a similar
fashion.
address@hidden mh-inc-folder
address@hidden i
address@hidden mh-inc-folder-hook
+
You can set the hook @code{mh-inc-folder-hook}, which is called after
new mail is incorporated by the @kbd{i} (@code{mh-inc-folder})
command. A good use of this hook is to rescan the whole folder either
@@ -1410,13 +1529,16 @@
@node Reading Mail, Folders, Incorporating Mail, Top
@chapter Reading Your Mail
address@hidden @samp{+inbox}
@cindex MH-Folder mode
@cindex MH-Show mode
@cindex modes, MH-Folder
@cindex modes, MH-Show
@cindex reading mail
address@hidden scan lines
@findex mh-rmail
address@hidden M-x mh-rmail
address@hidden F r
address@hidden F v
The MH-E entry point for reading mail is @kbd{M-x mh-rmail}. This
command incorporates your mail and creates a buffer called
@@ -1427,6 +1549,12 @@
prompt you for folder to visit like @kbd{F v} (for example, @kbd{C-u
M-x mh-rmail @key{RET} bob @key{RET}}). @xref{Folders}.}.
address@hidden @command{scan}
address@hidden @samp{Message} menu
address@hidden MH commands, @command{scan}
address@hidden menu, @samp{Message}
address@hidden scan lines
+
The @samp{+inbox} buffer contains @dfn{scan lines}, which are one-line
summaries of each incorporated message. You can perform most MH
commands on these messages via one- or two-letter commands in either
@@ -1880,6 +2008,8 @@
all of them, use the command @kbd{,} (comma;
@code{mh-header-display}).
address@hidden mh-show-maximum-size
+
The option @code{mh-show-maximum-size} provides an opportunity to skip
over large messages which may be slow to load. The default value of 0
means that all message are shown regardless of size.
@@ -1901,8 +2031,8 @@
@cindex regular expressions, @code{mh-invisible-header-fields}
@vindex mh-clean-message-header-flag
address@hidden mh-invisible-header-fields-default
@vindex mh-invisible-header-fields
address@hidden mh-invisible-header-fields-default
Normally messages are delivered with a handful of uninteresting header
fields. These are hidden by turning on the option
@@ -1918,12 +2048,12 @@
header field should be generally ignored, report a bug (@pxref{Bug
Reports}).
address@hidden @samp{Face:} header field
address@hidden @samp{X-Face:} header field
address@hidden @samp{X-Image-URL:} header field
@cindex header field, @samp{Face:}
@cindex header field, @samp{X-Face:}
@cindex header field, @samp{X-Image-URL:}
address@hidden @samp{Face:} header field
address@hidden @samp{X-Face:} header field
address@hidden @samp{X-Image-URL:} header field
@vindex mh-show-use-xface-flag
MH-E can display the content of @samp{Face:}, @samp{X-Face:}, and
@@ -2022,9 +2152,9 @@
and forwarding; in this case, the value of @code{mh-mhl-format-file}
is consulted if you have specified a format file.
address@hidden mh-highlight-citation-style
@cindex citations, highlighting
@cindex highlighting citations
address@hidden mh-highlight-citation-style
If the sender of the message has cited other messages in his message,
then MH-E will highlight these citations to emphasize the sender's
@@ -2047,9 +2177,9 @@
Email addresses and URLs in the message are highlighted if the option
@code{goto-address-highlight-p} is on, which it is by default. To view
the web page for a highlighted URL or to send a message using a
-highlighted email address, use @kbd{Mouse-2} or @kbd{C-c @key{RET}}.
-See @ref{Sending Mail}, to see how to configure Emacs to send the
-message using MH-E.
+highlighted email address, use @kbd{Mouse-2} or @kbd{C-c @key{RET}}
+(@code{goto-address-at-point}). @xref{Sending Mail}, to see how to
+configure Emacs to send the message using MH-E.
@cindex boldface, showing
@cindex emphasis
@@ -2106,9 +2236,9 @@
behavior of MH-E in general or when @code{mh-show-mode-hook} is too
early.
address@hidden mh-show-buffer-mode-line-buffer-id
@cindex MH-Show mode
@cindex modes, MH-Show
address@hidden mh-show-buffer-mode-line-buffer-id
For those who like to modify their mode lines, use
@code{mh-show-buffer-mode-line-buffer-id} to modify the mode line in
@@ -2124,13 +2254,13 @@
@node Viewing Attachments, HTML, Viewing, Reading Mail
@section Viewing Attachments
address@hidden attachments
address@hidden body parts
@cindex @command{mhshow}
@cindex @command{show}
@cindex MH commands, @command{mhshow}
@cindex MH commands, @command{show}
@cindex MIME
address@hidden attachments
address@hidden body parts
@cindex multimedia mail
MH has the ability to display @address@hidden (Multipurpose Internet
@@ -2164,21 +2294,22 @@
other graphical widgets. @xref{Viewing}.
@cindex buttons
address@hidden Mouse-1
address@hidden Mouse-2
address@hidden @key{RET}
address@hidden mh-press-button
address@hidden mh-next-button
address@hidden mh-prev-button
address@hidden K @key{TAB}
address@hidden K address@hidden
-Attachments in MH-E are indicated by buttons like this:
+Attachments in MH-E are indicated by @dfn{buttons} like this:
@example
[1. image/jpeg; foo.jpg]...
@end example
address@hidden mh-next-button
address@hidden mh-press-button
address@hidden mh-prev-button
address@hidden @key{RET}
address@hidden K @key{TAB}
address@hidden K address@hidden
address@hidden Mouse-1
address@hidden Mouse-2
+
To view the contents of the button, use either @kbd{Mouse-1} or
@kbd{Mouse-2} on the button or @key{RET} (@code{mh-press-button}) when
the cursor is over the button. This command is a toggle so if you use
@@ -2231,7 +2362,6 @@
@cindex attachments, saving
@cindex saving attachments
-
@findex mh-folder-save-mime-part
@kindex K o
@@ -2261,6 +2391,8 @@
components, since this function calls on @command{mhstore}
(@command{mhn}) to do the work.
address@hidden mh-mime-save-parts-default-directory
+
The default value for the option
@code{mh-mime-save-parts-default-directory} is @samp{Prompt Always} so
that you are always prompted for the directory in which to save the
@@ -2292,9 +2424,9 @@
MH-E cannot display all attachments inline however. It can display
text (including @sc{html}) and images.
address@hidden @samp{Content-Disposition:} header field
@cindex header field, @samp{Content-Disposition:}
@cindex inline images
address@hidden @samp{Content-Disposition:} header field
@vindex mh-max-inline-image-height
@vindex mh-max-inline-image-width
@@ -2348,7 +2480,6 @@
@cindex HTML
@cindex Gnus
address@hidden mm-text-html-renderer
MH-E can display messages that have been sent in address@hidden
feature depends on a version of Gnus that is at least 5.10.}. The
@@ -2364,6 +2495,8 @@
To see how to read the contents of this body part, see @ref{Viewing
Attachments}.
address@hidden mm-text-html-renderer
+
The browser that MH-E uses is determined by the option
@code{mm-text-html-renderer}. The default setting is set automatically
based upon the presence of a known browser on your system. If you wish
@@ -2373,12 +2506,17 @@
images as this can tip off spammers that the email address they have
used is valid.
address@hidden mm-text-html-renderer
+
If you're confused about which @code{mm-text-html-renderer} to use,
here's a brief description of each, sorted by popularity, that
includes the results of a quick poll of MH-E users from 2005-12-23.
@table @asis
-
address@hidden browser, @samp{w3m}
address@hidden @samp{w3m}
address@hidden Mouse-2
address@hidden S-Mouse-2
@item @samp{w3m} 7
The @samp{w3m} browser requires an external program. It's quick,
produces pretty nice output, and best of all, it's the only browser
@@ -2389,6 +2527,8 @@
(which can cause text to wrap if the author didn't anticipate that the
page would be viewed in Emacs).
@c -------------------------
address@hidden browser, @samp{w3m-standalone}
address@hidden @samp{w3m-standalone}
@item @samp{w3m-standalone} 3
This browser, along with @samp{nil} for the external browser, are the
only choices that work without having to download a separate lisp
@@ -2398,6 +2538,8 @@
handle the escape @samp{–} (it printed a @samp{?}), but it did
render @samp{®}.
@c -------------------------
address@hidden browser, @samp{links}
address@hidden @samp{links}
@item @samp{links} 1
The @samp{links} browser requires an external program. It's quick, and
produces nicer output than @samp{lynx} on single column mails in
@@ -2406,6 +2548,8 @@
columns and thus seems better than @samp{w3} and
@samp{w3m-standalone}. Converts escapes such as @samp{®} to (R).
@c -------------------------
address@hidden browser, @samp{lynx}
address@hidden @samp{lynx}
@item @samp{lynx} 1
The @samp{lynx} browser requires an external program. It's quick and
produces pretty decent output but it doesn't show links. It doesn't
@@ -2419,6 +2563,8 @@
HTML messages have a button for the body part which you can view with
@kbd{K v} (@code{mh-folder-toggle-mime-part}).
@c -------------------------
address@hidden browser, @samp{w3}
address@hidden @samp{w3}
@item @samp{w3} 0
This choice does not require an external program as all of the
rendering is done in lisp. You do need to get the package separately.
@@ -2431,6 +2577,8 @@
highlighted. Performs well on single-column tables and handles escapes
such as @samp{®}.
@c -------------------------
address@hidden browser, @samp{html2text}
address@hidden @samp{html2text}
@item @samp{html2text} 0
The @samp{html2text} browser requires an external program. I noticed
that it can do some nasty things with simple HTML mails (like filling
@@ -2439,6 +2587,8 @@
reason.
@end table
address@hidden mm-text-html-renderer
+
For a couple more sources of information about
@code{mm-text-html-renderer},
@ifinfo
@@ -2459,10 +2609,10 @@
@cindex digests
@findex mh-page-digest
@findex mh-page-digest-backwards
address@hidden @key{BS}
address@hidden @key{SPC}
@kindex D @key{BS}
@kindex D @key{SPC}
address@hidden @key{BS}
address@hidden @key{SPC}
A digest is a message that contains other messages. Special MH-E
commands let you read digests conveniently. You can use @key{SPC} and
@@ -2476,8 +2626,8 @@
@cindex MH-Folder Show mode
@cindex modes, MH-Folder Show
@findex mh-burst-digest
address@hidden D b
@kindex d
address@hidden D b
@kindex t
Another handy command is @kbd{D b} (@code{mh-burst-digest}). This
@@ -2639,6 +2789,8 @@
@findex mh-ps-print-msg-file
@kindex P f
@kindex P p
address@hidden mh-lpr-command-format
address@hidden mh-print-background-flag
To print messages in MH-E, use the command @kbd{P p}
(@code{mh-ps-print-msg}). You can print all the messages in a range
@@ -2694,6 +2846,9 @@
@address@hidden/shomes.htm#Usisho, Using mhl} in the MH
book.} and printed with the @command{lpr} command.
address@hidden P f
address@hidden P l
address@hidden P p
@vindex mh-lpr-command-format
@vindex mh-print-background-flag
@@ -2716,11 +2871,10 @@
@cindex files
@cindex pipes
-
@findex mh-refile-or-write-again
@findex mh-write-msg-to-file
address@hidden !
@kindex >
address@hidden !
MH-E does offer a couple of commands that are not a part of address@hidden The
first one, @kbd{>} (@code{mh-write-msg-to-file}), writes a message to
@@ -2733,6 +2887,7 @@
@findex mh-pipe-msg
@kindex |
address@hidden l
You can also pipe the message through a Unix shell command with the
command @kbd{|} (@code{mh-pipe-msg}). You are prompted for the Unix
@@ -2761,6 +2916,8 @@
directory for storing the content of these messages.
@findex mh-store-buffer
address@hidden @key{RET}
address@hidden X s
By the way, @kbd{X s} calls the Emacs Lisp function
@code{mh-store-buffer}. I mention this because you can use it directly
@@ -2781,11 +2938,11 @@
@findex mh-next-unread-msg
@findex mh-previous-undeleted-msg
@findex mh-previous-unread-msg
address@hidden g
@kindex M-<
@kindex M->
@kindex M-n
@kindex M-p
address@hidden g
@kindex n
@kindex p
@@ -2809,6 +2966,7 @@
@findex previous-line
@kindex C-n
@kindex C-p
address@hidden @key{RET}
You can also use the Emacs commands @kbd{C-p} (@code{previous-line})
and @kbd{C-n} (@code{next-line}) to move up and down the scan lines in
@@ -2818,6 +2976,8 @@
@cindex deleting messages
@findex mh-delete-msg
@kindex d
address@hidden n
address@hidden p
To mark a message for deletion, use the command @kbd{d}
(@code{mh-delete-msg}). A @samp{D} is placed by the message in the
@@ -2839,7 +2999,11 @@
@findex mh-delete-subject
@findex mh-delete-subject-or-thread
address@hidden mh-thread-delete
address@hidden mh-undo
@kindex k
address@hidden T d
address@hidden u
And to delete more messages faster, you can use @kbd{k}
(@code{mh-delete-subject-or-thread}) to delete all the messages with
@@ -2878,6 +3042,8 @@
an editable buffer. When you are done editing, save and kill the
buffer as you would any other.
address@hidden mh-kill-folder
address@hidden mh-pack-folder
@vindex mh-do-not-confirm-flag
Commands such as @code{mh-pack-folder} prompt to confirm whether to
@@ -2977,7 +3143,11 @@
@node Folders, Sending Mail, Reading Mail, Top
@chapter Organizing Your Mail with Folders
address@hidden @samp{Folder} menu
address@hidden @samp{Message} menu
@cindex folders
address@hidden menu, @samp{Folder}
address@hidden menu, @samp{Message}
@cindex using folders
This chapter discusses the things you can do with folders within MH-E.
@@ -3231,6 +3401,8 @@
@samp{To:} face.
@end vtable
address@hidden mh-folder-mode-hook
+
The hook @code{mh-folder-mode-hook} is called when visiting a new
folder in MH-Folder mode. This could be used to set your own key
bindings, for example:
@@ -3285,6 +3457,9 @@
be prompted to create it. The hook @code{mh-refile-msg-hook} is called
after a message is marked to be refiled.
address@hidden mh-write-msg-to-file
address@hidden !
+
If you are refiling several messages into the same folder, you can use
the command @kbd{!} (@code{mh-refile-or-write-again}) to repeat the
last refile or write (for the description of @kbd{>}
@@ -3294,6 +3469,8 @@
@cindex expunging refiles and deletes
@cindex undoing refiles and deletes
address@hidden mh-undo
address@hidden u
If you've deleted a message or refiled it, but changed your mind, you
can cancel the action before you've executed it. Use @kbd{u}
@@ -3301,9 +3478,15 @@
You can also undo refiles and deletes for messages that are found in a
given range (@pxref{Ranges}).
address@hidden mh-undo-folder
address@hidden F u
+
Alternatively, you can use @kbd{F u} (@code{mh-undo-folder}) to undo
all refiles and deletes in the current folder.
address@hidden mh-execute-commands
address@hidden x
+
If you've marked messages to be deleted or refiled and you want to go
ahead and delete or refile the messages, use @kbd{x}
(@code{mh-execute-commands}). Many MH-E commands that may affect the
@@ -3312,6 +3495,10 @@
@kbd{x} for you or undo the pending refiles and deletes, which are
lost.
address@hidden x
address@hidden mh-after-commands-processed-hook
address@hidden mh-before-commands-processed-hook
+
The command @kbd{x} runs @code{mh-before-commands-processed-hook}
before the commands are processed and
@code{mh-after-commands-processed-hook} after the commands are
@@ -3323,6 +3510,10 @@
affected by deletes and refiles. This list will always include the
current folder @code{mh-current-folder}.
address@hidden mh-copy-msg
address@hidden c
address@hidden o
+
If you wish to copy a message to another folder, you can use the
command @kbd{c} (@code{mh-copy-msg}) (see the @option{-link} argument
to @command{refile}(1)). Like the command @kbd{o}, this command
@@ -3331,12 +3522,14 @@
takes place immediately. The original copy remains in the current
folder.
address@hidden MH-Folder Show mode
address@hidden MH-Folder mode
@cindex junk mail
address@hidden MH-Folder mode
address@hidden MH-Folder Show mode
@cindex modes, MH-Folder
@cindex modes, MH-Folder Show
@cindex spam
address@hidden mh-toggle-showing
address@hidden t
The command @kbd{t} (@code{mh-toggle-showing}) switches between
MH-Folder mode and MH-Folder Show address@hidden you Emacs wizards,
@@ -3351,6 +3544,7 @@
@cindex modes, MH-Folder
@cindex modes, MH-Show
@cindex moving between messages
address@hidden t
@vindex mh-recenter-summary-flag
When you use @kbd{t} to toggle between show mode and scan mode, the
@@ -3360,6 +3554,10 @@
cursor at the middle. The effect of @code{mh-recenter-summary-flag} is
rather useful, but it can be annoying on a slow network connection.
address@hidden mh-visit-folder
address@hidden F v
address@hidden mh-large-folder
+
When you want to read the messages that you have refiled into folders,
use the command @kbd{F v} (@code{mh-visit-folder}) to visit the
folder. You are prompted for the folder name. The folder buffer will
@@ -3373,15 +3571,18 @@
this command can also be used to create folders. If you specify a
folder that does not exist, you will be prompted to create it.
address@hidden mh-search
address@hidden F s
+
If you forget where you've refiled your messages, you can find them
using @kbd{F s} (@code{mh-search}). @xref{Searching}.
@cindex @command{procmail}
@cindex @command{rcvstore}
address@hidden @samp{unseen} sequence
@cindex MH commands, @command{rcvstore}
address@hidden Unix commands, @command{procmail}
address@hidden @samp{unseen} sequence
@cindex sequence, @samp{unseen}
address@hidden Unix commands, @command{procmail}
@cindex unseen messages, viewing
@findex mh-index-new-messages
@kindex F n
@@ -3399,6 +3600,9 @@
@cindex @samp{tick} sequence
@cindex sequence, @samp{tick}
@cindex ticked messages, viewing
address@hidden mh-index-ticked-messages
address@hidden F '
address@hidden mh-ticked-messages-folders
If you have ticked messages (@pxref{Sequences}), you can display them
using the command @kbd{F '} (@code{mh-index-ticked-messages}). All
@@ -3417,14 +3621,28 @@
With a prefix argument, enter a space-separated list of folders at the
prompt, or nothing to search all folders.
address@hidden mh-new-messages-folders
address@hidden mh-recursive-folders-flag
address@hidden mh-ticked-messages-folders
+
Set the options @code{mh-new-messages-folders} and
@code{mh-ticked-messages-folders} to @samp{Inbox} to search the
@samp{+inbox} folder or @samp{All} to search all of the top level
folders. Otherwise, list the folders that should be searched with the
@samp{Choose Folders} menu item. See @code{mh-recursive-folders-flag}.
address@hidden @samp{*MH-E Folders*}
@cindex buffers, @samp{*MH-E Folders*}
address@hidden @samp{*MH-E Folders*}
address@hidden mh-kill-folder
address@hidden mh-list-folders
address@hidden mh-pack-folder
address@hidden mh-rescan-folder
address@hidden mh-sort-folder
address@hidden F k
address@hidden F l
address@hidden F p
address@hidden F r
address@hidden F S
Other commands you can perform on folders include: @kbd{F l}
(@code{mh-list-folders}), to place a listing of all the folders in
@@ -3439,11 +3657,16 @@
you don't want to rescan the entire folder, the commands @kbd{F r} or
@kbd{F p} will accept a range (@pxref{Ranges}).
address@hidden @key{TAB}
address@hidden mh-recursive-folders-flag
+
By default, operations on folders work only one level at a time. Set
@code{mh-recursive-folders-flag} to address@hidden to operate on all
folders. This mostly means that you'll be able to see all your folders
when you press @key{TAB} when prompted for a folder name.
address@hidden mh-search-p
address@hidden k
@vindex mh-kill-folder-suppress-prompt-hooks
The hook @code{mh-kill-folder-suppress-prompt-hooks} is an abnormal
@@ -3466,10 +3689,12 @@
@cindex @command{sortm}
@cindex @file{.mh_profile}
address@hidden @samp{sortm:} MH profile component
address@hidden files, @file{.mh_profile}
@cindex MH commands, @command{sortm}
@cindex MH profile component, @samp{sortm:}
address@hidden files, @file{.mh_profile}
address@hidden @samp{sortm:} MH profile component
address@hidden F S
address@hidden mh-sortm-args
The option @code{mh-sortm-args} holds extra arguments to pass on to
the command @address@hidden the section
@@ -3481,7 +3706,8 @@
@cindex exiting
@cindex quitting
address@hidden mh-rmail
address@hidden mh-quit
address@hidden q
When you want to quit using MH-E and go back to editing, you can use
the @kbd{q} (@code{mh-quit}) command. This buries the buffers of the
@@ -3492,18 +3718,20 @@
selecting the @samp{+inbox} buffer or by running @kbd{M-x mh-rmail}
again.
address@hidden mh-execute-commands
address@hidden q
@vindex mh-before-quit-hook
@vindex mh-quit-hook
The two hooks @code{mh-before-quit-hook} and @code{mh-quit-hook} are
-called by @kbd{q} (@code{mh-quit}). The former one is called before
-the quit occurs, so you might use it to perform any MH-E operations;
-you could perform some query and abort the quit or call
address@hidden, for example. The latter is not run in an
-MH-E context, so you might use it to modify the window setup. For
-example, if the window configuration was saved as in the example in
address@hidden Commands and Options}, you would also want to set
address@hidden to the following:
+called by @kbd{q}. The former one is called before the quit occurs, so
+you might use it to perform any MH-E operations; you could perform
+some query and abort the quit or call @code{mh-execute-commands}, for
+example. The latter is not run in an MH-E context, so you might use it
+to modify the window setup. For example, if the window configuration
+was saved as in the example in @ref{Miscellaneous Commands and
+Options}, you would also want to set @code{mh-quit-hook} to the
+following:
@c XXX Replace this with my example for killing the mail buffers.
@@ -3525,8 +3753,8 @@
@cindex folders, renaming
@cindex renaming folders
address@hidden dired
@findex dired-do-rename
address@hidden R
You can use dired to manipulate the folders themselves. For example, I
renamed my @samp{+out} folder to the more common @samp{+outbox} by
@@ -3539,6 +3767,7 @@
@cindex sending mail
@findex mh-smail
address@hidden M-x mh-smail
You can send a mail message in several ways. You can call @kbd{M-x
mh-smail} directly, or from the command line like this:
@@ -3557,6 +3786,9 @@
commands use MH-E by setting the option @code{mail-user-agent} to
@samp{Emacs interface to MH}.
address@hidden @samp{Message} menu
address@hidden menu, @samp{Message}
+
From within MH-E's MH-Folder mode, other methods of sending mail are
available as well. These can also be found in the @samp{Message} menu.
@@ -3688,6 +3920,8 @@
@cindex sending mail
@findex mh-smail
@findex mh-smail-other-window
address@hidden M-x mh-smail
address@hidden M-x mh-smail-other-window
Outside of an MH-Folder buffer, you must call either @kbd{M-x
mh-smail} or @kbd{M-x mh-smail-other-window} to compose a new message.
@@ -3701,8 +3935,8 @@
(global-set-key "\C-x4m" 'mh-smail-other-window)
@end smalllisp
address@hidden MH-Letter mode
@cindex draft folder
address@hidden MH-Letter mode
@cindex modes, MH-Letter
@findex mh-send
@kindex m
@@ -3726,8 +3960,8 @@
before the MH-Letter buffer appears, turn on the option
@code{mh-compose-prompt-flag}.
address@hidden @samp{X-Mailer:} header field
@cindex header field, @samp{X-Mailer:}
address@hidden @samp{X-Mailer:} header field
@vindex mh-insert-x-mailer-flag
MH-E adds an @samp{X-Mailer:} header field to the header that includes
@@ -3738,8 +3972,10 @@
@cindex @command{repl}
@cindex @file{components}
@cindex MH commands, @command{repl}
address@hidden MH-Letter mode
@cindex Mail mode
@cindex files, @file{components}
address@hidden modes, MH-Letter
@cindex modes, Mail
@vindex mail-mode-hook
@vindex mh-letter-mode-hook
@@ -3754,9 +3990,7 @@
to modify the header after @command{repl} has done its work, or you
may have a complicated @file{components} file and need to tell MH-E
where the cursor should go. Here's an example of how you would use
-this hook. You can add the hook using @code{add-hook} or by running
address@hidden customize-option @key{RET} mh-letter-mode-hook
address@hidden of the other hooks are set in a similar fashion.
+this hook.
@findex mh-insert-signature, example
@@ -3780,8 +4014,6 @@
(goto-char (point-max)) ; @r{go to end of message to}
(mh-insert-signature))) ; @r{insert signature}
-(add-hook 'mh-letter-mode-hook 'my-mh-letter-mode-hook)
-
@i{Prepare draft for editing via mh-letter-mode-hook}
@end group
@@ -3791,6 +4023,7 @@
@ref{Adding Attachments}.
@vindex mh-compose-letter-function
address@hidden mh-letter-mode-hook
The second hook, a function really, is
@code{mh-compose-letter-function}. Like @code{mh-letter-mode-hook}, it
@@ -3869,6 +4102,8 @@
Another way to include the message automatically in your draft is to
use @samp{repl: -filter repl.filter} in your MH profile.
address@hidden mh-reply-show-message-flag
+
If you include the message automatically, you can hide the MH-Show
buffer by turning off the option @code{mh-reply-show-message-flag}.
@@ -3888,9 +4123,9 @@
@section Forwarding Mail
@cindex @command{forw}
address@hidden MH commands, @command{forw}
@cindex draft
@cindex forwarding
address@hidden MH commands, @command{forw}
@findex mh-forward
@kindex f
@vindex mh-forward-hook
@@ -3906,9 +4141,9 @@
hook @code{mh-forward-hook} is called on the draft.
@cindex @file{.mh_profile}
address@hidden @samp{forw:} MH profile component
address@hidden MH profile component, @samp{forw:}
@cindex files, @file{.mh_profile}
address@hidden MH profile component, @samp{forw:}
address@hidden @samp{forw:} MH profile component
@vindex mh-compose-forward-as-mime-flag
By default, the option @code{mh-compose-forward-as-mime-flag} is on
@@ -3959,6 +4194,9 @@
the recipient as if the message had come from the original sender.
When you run this command, you are prompted for the recipients.
address@hidden mh-edit-again
address@hidden e
+
For more information on redistributing messages, see
@command{dist}(1). Also investigate the command @kbd{e}
(@code{mh-edit-again}) for another way to redistribute messages
@@ -3985,7 +4223,9 @@
@cindex files, @file{draft}
@cindex re-editing drafts
@findex mh-edit-again
address@hidden F v drafts
@kindex e
address@hidden n
If you don't complete a draft for one reason or another, and if the
draft buffer is no longer available, you can pick your draft up again
@@ -3995,11 +4235,14 @@
@key{RET}}, use @kbd{n} to move to the appropriate message, and then
use @kbd{e} to prepare the message for editing.
address@hidden e
+
The @kbd{e} command can also be used to take messages that were sent
to you and to send them to more people.
@cindex Mailer-Daemon
@findex mh-extract-rejected-mail
address@hidden C-c C-c
@kindex E
Don't use @kbd{e} to re-edit a message from a @i{Mailer-Daemon} who
@@ -4012,9 +4255,11 @@
@node Editing Drafts, Aliases, Sending Mail, Top
@chapter Editing a Draft
address@hidden @samp{Letter} menu
@cindex MH-Letter mode
@cindex draft
@cindex editing draft
address@hidden menu, @samp{Letter}
@cindex modes, MH-Letter
When you edit a message that you want to send (called a @dfn{draft} in
@@ -4449,8 +4694,8 @@
@findex indent-relative
@findex mh-letter-next-header-field-or-indent
@findex mh-letter-previous-header-field
address@hidden address@hidden
@kindex @key{TAB}
address@hidden address@hidden
@vindex mh-compose-skipped-header-fields
@vindex mh-letter-header-field
@@ -4476,8 +4721,10 @@
@findex mh-letter-complete-or-space
@findex mh-letter-confirm-address
@kindex , (comma)
address@hidden address@hidden
@kindex @key{SPC}
address@hidden address@hidden
address@hidden mh-alias-flash-on-comma
address@hidden mh-compose-space-does-completion-flag
@vindex mh-letter-complete-function
If the field contains addresses (for example, @samp{To:} or
@@ -4496,10 +4743,11 @@
the alias expansion in the minibuffer if
@code{mh-alias-flash-on-comma} is turned on.
address@hidden C-c C-t
address@hidden mh-letter-toggle-header-field-display
@c XXX Document the replacement for the inaccessible 'long argument.
address@hidden mh-letter-toggle-header-field-display
address@hidden C-c C-t
+
Use the command @kbd{C-c C-t}
@code{mh-letter-toggle-header-field-display} to display truncated
header fields. This command is a toggle so entering it again will hide
@@ -4582,6 +4830,7 @@
@cindex yanking messages
@findex mh-yank-cur-msg
@kindex C-c C-y
address@hidden mh-ins-buf-prefix
It is often useful to insert a snippet of text from a letter that
someone mailed to provide some context for your reply. The command
@@ -4608,7 +4857,9 @@
@samp{wrote:}, @samp{a écrit:}, and @samp{schrieb:}. You can also use
the @samp{Custom String} menu item to enter your own verb.
address@hidden mail-citation-hook
@vindex mh-ins-buf-prefix
address@hidden mh-yank-behavior
The prefix @code{"> "} is the default setting for the option
@code{mh-ins-buf-prefix}. I suggest that you not modify this option
@@ -4624,10 +4875,12 @@
option to delete the window containing the original message after
yanking it to make more room on your screen for your reply.
address@hidden mh-yank-behavior
@cindex Emacs, packages, supercite
@cindex supercite package
-
address@hidden r
address@hidden mail-citation-hook
address@hidden mh-yank-behavior
+
You can control how the message to which you are replying is yanked
into your reply using @code{mh-yank-behavior}. To include the entire
message, including the entire header, use @samp{Body and
@@ -4644,11 +4897,16 @@
full-bodied, full-featured, citation package that comes standard with
Emacs.} to pass the entire message and header through supercite.
address@hidden mh-extract-from-attribution-verb
+
If the @samp{Body With Attribution} setting is used, then the message
minus the header is yanked and a simple attribution line is added at
the top using the value of the option
@code{mh-extract-from-attribution-verb}. This is the default.
address@hidden C-c C-y
address@hidden mh-delete-yanked-msg-window-flag
+
If the @samp{Invoke supercite} or @samp{Body With Attribution}
settings are used, the @samp{-noformat} argument is passed to the
@command{repl} program to override a @samp{-filter} or @samp{-format}
@@ -4660,12 +4918,16 @@
@code{mh-delete-yanked-msg-window-flag} as well so that the show
window is never displayed.
address@hidden mh-yank-behavior
+
If the show buffer has a region, the option @code{mh-yank-behavior} is
ignored unless its value is one of @samp{Attribution} variants in
which case the attribution is added to the yanked region.
@findex trivial-cite
@vindex mail-citation-hook
address@hidden mh-ins-buf-prefix
address@hidden mh-yank-behavior
If this isn't enough, you can gain full control over the appearance of
the included text by setting @code{mail-citation-hook} to a function
@@ -4677,6 +4939,10 @@
for the next hook function. The standard prefix
@code{mh-ins-buf-prefix} is not added if this hook is set.
address@hidden Emacs, packages, trivial-cite
address@hidden trivial-cite package
address@hidden mh-yank-behavior
+
For example, if you use the hook function
@uref{http://shasta.cs.uiuc.edu/~lrclause/tc.html,
@code{trivial-cite}} (which is NOT part of Emacs), set
@@ -4691,6 +4957,7 @@
@kindex C-c C-i
@vindex mh-ins-buf-prefix
@vindex mh-invisible-header-fields-compiled
address@hidden mh-yank-behavior
Messages can be inserted with @kbd{C-c C-i} (@code{mh-insert-letter}).
This command prompts you for the folder and message number, which
@@ -4717,8 +4984,8 @@
You can insert your signature at the current cursor location with the
command @kbd{C-c C-s} (@code{mh-insert-signature}).
address@hidden @file{.signature}
@cindex files, @file{.signature}
address@hidden @file{.signature}
@cindex vCard
@vindex mh-signature-file-name
@@ -4728,6 +4995,7 @@
@dfn{vCard} in which case an attachment is added with the vCard.
@findex mh-signature-separator-p
address@hidden mh-signature-file-name
@vindex mh-signature-separator
@vindex mh-signature-separator-regexp
@@ -4751,6 +5019,7 @@
yanking a letter into a draft.
@vindex mh-insert-signature-hook
address@hidden mh-signature-file-name
The hook @code{mh-insert-signature-hook} is run after the signature is
inserted. Hook functions may access the actual name of the file or the
@@ -4802,6 +5071,8 @@
The URL of any image can be used for the @samp{X-Image-URL:} field and
no processing of the image is required.
address@hidden mh-x-face-file
+
To prevent the setting of any of these header fields, either set
@code{mh-x-face-file} to @code{nil}, or simply ensure that the file
defined by this option doesn't exist.
@@ -4826,6 +5097,8 @@
binary files, and even commands that fetch a file with @samp{ftp} when
your recipient reads the message!
address@hidden C-c C-m
+
If you were to create a multimedia message with plain MH commands, you
would insert @command{mhbuild} or @command{mhn} directives (henceforth
called @dfn{MH-style directives} into your draft and use the
@@ -4871,8 +5144,8 @@
@cindex @command{file}
@cindex @file{/etc/mime.types}
address@hidden Unix commands, @command{file}
@cindex files, @file{/etc/mime.types}
address@hidden Unix commands, @command{file}
@findex mailcap-mime-types
In the cases where MH-E can do so, it will determine the media type
@@ -4952,16 +5225,17 @@
@subheading Including Files
address@hidden attachments, inserting
address@hidden images
@cindex MIME, images
@cindex MIME, sound
@cindex MIME, video
address@hidden attachments, inserting
address@hidden images
@cindex sound
@cindex video
@findex mh-compose-insertion
@kindex C-c C-m C-i
@kindex C-c C-m i
address@hidden mh-compose-insertion
Binaries, images, sound, and video can be inserted in your message
with the command @kbd{C-c C-m C-i} (@code{mh-compose-insertion}). You
@@ -5004,7 +5278,9 @@
@cindex MIME, @command{tar}
@cindex Unix commands, @command{ftp}
@cindex Unix commands, @command{tar}
address@hidden mh-mh-compose-anon-ftp
@findex mh-mh-compose-external-compressed-tar
address@hidden C-c C-m C-g
@kindex C-c C-m C-t
@kindex C-c C-m t
@@ -5065,6 +5341,9 @@
Typically, you send a message with attachments just like any other
message (@pxref{Sending Message}).
address@hidden mh-mml-to-mime
address@hidden C-c C-m C-m
+
However, you may take a sneak preview of the @sc{mime} encoding if you
wish by running the command @kbd{C-c C-m C-m} (@code{mh-mml-to-mime}).
The following screen shows the @sc{mime} encoding specified by the
@@ -5097,15 +5376,19 @@
@end cartouche
@i{MH-E @sc{mime} draft ready to send}
address@hidden undo effects of mh-mml-to-mime
+
This action can be undone by running @kbd{C-_} (@code{undo}).
@cindex @command{mhbuild}
@cindex @command{mhn}
@cindex MH commands, @command{mhbuild}
@cindex MH commands, @command{mhn}
address@hidden undo effects of mh-mh-to-mime
@findex mh-mh-to-mime
@findex mh-mh-to-mime-undo
@kindex C-c C-e
address@hidden C-c C-m C-m
@kindex C-c C-m C-u
@kindex C-c C-m u
@@ -5120,6 +5403,7 @@
confirmation by adding an argument (for example, @kbd{C-u C-c C-m
C-u}).
address@hidden C-c C-e
@vindex mh-mh-to-mime-args
If you wish to pass additional arguments to @command{mhbuild}
@@ -5129,13 +5413,14 @@
@samp{-check}. The recipient of your message can then run
@samp{mhbuild -check} on the address@hidden
(@command{mhn}) will complain if the message has been corrupted on the
-way. The command @kbd{C-c C-e} (@code{mh-mh-to-mime}) only consults
-this option when given a prefix argument (as in @kbd{C-u C-c C-e}).
+way. The command @kbd{C-c C-e} only consults this option when given a
+prefix argument (as in @kbd{C-u C-c C-e}).
address@hidden C-c C-e
@vindex mh-mh-to-mime-hook
The hook @code{mh-mh-to-mime-hook} is called after the message has
-been formatted by @kbd{C-c C-e} (@code{mh-mh-to-mime})
+been formatted by @kbd{C-c C-e}.
@node Sending PGP, Checking Recipients, Adding Attachments, Editing Drafts
@section Signing and Encrypting Messages
@@ -5185,6 +5470,7 @@
@findex mh-mml-unsecure-message
@kindex C-c C-m C-n
@kindex C-c C-m n
address@hidden mh-mml-method-default
This is used to sign and encrypt your message. In each of these cases,
a proper multipart message is created for you when you send the
@@ -5218,8 +5504,8 @@
@cite{The PGG Manual}}.
@end ifhtml
address@hidden @samp{Fcc:} header field
@cindex header field, @samp{Fcc:}
address@hidden @samp{Fcc:} header field
@vindex pgg-encrypt-for-me
In particular, I turn on the option @code{pgg-encrypt-for-me} so that
@@ -5249,8 +5535,8 @@
@node Sending Message, Killing Draft, Checking Recipients, Editing Drafts
@section Sending a Message
address@hidden @samp{*MH-E Mail Delivery*}
@cindex buffers, @samp{*MH-E Mail Delivery*}
address@hidden @samp{*MH-E Mail Delivery*}
@cindex sending mail
@findex mh-send-letter
@kindex C-c C-c
@@ -5263,6 +5549,8 @@
@cindex sending mail
@cindex spell check
address@hidden ispell-message
address@hidden C-c C-c
@vindex mh-before-send-letter-hook
The hook @code{mh-before-send-letter-hook} is run at the beginning of
@@ -5381,12 +5669,14 @@
@code{nil}).
@end vtable
address@hidden Adding Addresses to Draft
address@hidden Adding Addresses to Draft
You can use aliases when you are adding recipients to a message.
@findex minibuffer-complete
@kindex @key{TAB}
address@hidden mh-alias-expand-aliases-flag
address@hidden mh-compose-prompt-flag
In order to use minibuffer prompting for recipients and the subject
line in the minibuffer, turn on the option
@@ -5396,10 +5686,17 @@
on the option @code{mh-alias-expand-aliases-flag} if you want these
aliases to be expanded to their respective addresses in the draft.
address@hidden mh-letter-complete
address@hidden mh-letter-complete-or-space
address@hidden @key{SPC}
address@hidden address@hidden
+
Otherwise, you can complete aliases in the header of the draft with
@address@hidden (@code{mh-letter-complete}) or @key{SPC}
(@code{mh-letter-complete-or-space}).
address@hidden mh-alias-completion-ignore-case-flag
+
As MH ignores case in the aliases, so too does MH-E. However, you may
turn off the option @code{mh-alias-completion-ignore-case-flag} to
make case significant which can be used to segregate completion of
@@ -5418,6 +5715,11 @@
only. If you were to enter @kbd{Mark.Baushke}, it would still be
identified with your @samp{mark.baushke} alias.
address@hidden mh-alias-minibuffer-confirm-address
address@hidden mh-letter-confirm-address
address@hidden mh-alias-flash-on-comma
address@hidden mh-compose-prompt-flag
+
To verify that the alias you've entered is valid, the alias will be
displayed in the minibuffer when you type a comma
(@code{mh-letter-confirm-address} or
@@ -5431,7 +5733,7 @@
For another way to verify the alias expansion, see @ref{Checking
Recipients}.
address@hidden Loading Aliases
address@hidden Loading Aliases
@cindex @command{ali}
@cindex @file{/etc/nmh/MailAliases}
@@ -5457,6 +5759,8 @@
name is present in the password file. Otherwise, the alias will have
the form @address@hidden
address@hidden mh-alias-local-users-prefix
+
The prefix @samp{local.} can be modified via the option
@code{mh-alias-local-users-prefix}. This option can also be set to
@samp{Use Login}.
@@ -5467,6 +5771,8 @@
psg:x:1000:1000:Peter S Galbraith,,,:/home/psg:/bin/tcsh
@end example
address@hidden mh-alias-local-users-prefix
+
The following settings of option @code{mh-alias-local-users-prefix}
will produce the associated aliases:
@@ -5481,6 +5787,8 @@
psg
@end table
address@hidden mh-alias-passwd-gecos-comma-separator-flag
+
In the example above, commas are used to separate different values
within the so-called GECOS field. This is a fairly common usage.
However, in the rare case that the GECOS field in your password file
@@ -5488,8 +5796,9 @@
can turn the option @code{mh-alias-passwd-gecos-comma-separator-flag}
off.
address@hidden @samp{ypcat passwd}
@cindex NIS, obtaining local aliases from
address@hidden @samp{ypcat passwd}
address@hidden mh-alias-local-users
If you're on a system with thousands of users you don't know, and the
loading of local aliases slows MH-E down noticeably, then the local
@@ -5498,18 +5807,25 @@
executed to generate the password file. For example, use @samp{ypcat
passwd} to obtain the NIS password file.
address@hidden mh-alias-reload
address@hidden M-x mh-alias-reload
address@hidden mh-alias-reloaded-hook
+
Since aliases are updated frequently, MH-E reloads aliases
automatically whenever an alias lookup occurs if an alias source has
changed. However, you can reload your aliases manually by calling the
command @kbd{M-x mh-alias-reload} directly. This command runs
@code{mh-alias-reloaded-hook} after the aliases have been loaded.
address@hidden Adding Aliases
address@hidden Adding Aliases
In the past, you have manually added aliases to your alias file(s)
listed in your @samp{Aliasfile:} profile component. MH-E provides
other methods for maintaining your alias file(s).
address@hidden mh-alias-add-alias
address@hidden M-x mh-alias-add-alias
+
You can use the @kbd{M-x mh-alias-add-alias} command which will prompt
you for the alias and address that you would like to add. If the alias
exists already, you will have the choice of inserting the new alias
@@ -5541,6 +5857,9 @@
completion. If you forget the name of an old dive buddy, you can enter
@samp{div} and then @key{SPC} to get a listing of all your dive buddies.
address@hidden M-x mh-alias-add-address-under-point
address@hidden M-x mh-alias-grab-from-field
+
An alias for the sender of the current message is added automatically
by clicking on the @samp{Grab From alias} tool bar button or by running
the @kbd{M-x mh-alias-grab-from-field} command. Aliases for other
@@ -5548,24 +5867,33 @@
over the desired recipient and giving the @kbd{M-x
mh-alias-add-address-under-point} command.
address@hidden mh-alias-insert-file
address@hidden mh-alias-insertion-location
+
The options @code{mh-alias-insert-file} and
@code{mh-alias-insertion-location} controls how and where these aliases
are inserted.
-The default setting of this option is @samp{Use Aliasfile Profile
-Component}. This option can also hold the name of a file or a list a
-file names. If this option is set to a list of file names, or the
address@hidden:} profile component contains more than one file name,
-MH-E will prompt for one of them.
address@hidden mh-alias-insert-file
+
+The default setting of option @code{mh-alias-insert-file} is @samp{Use
+Aliasfile Profile Component}. This option can also hold the name of a
+file or a list a file names. If this option is set to a list of file
+names, or the @samp{Aliasfile:} profile component contains more than
+one file name, MH-E will prompt for one of them.
+
address@hidden mh-alias-insertion-location
The option @code{mh-alias-insertion-location} is set to
@samp{Alphabetical} by default. If you organize your alias file in
other ways, then the settings @samp{Top} and @samp{Bottom} might be
more appropriate.
address@hidden Querying Aliases
address@hidden Querying Aliases
@cindex regular expressions, @code{mh-alias-apropos}
address@hidden mh-alias-apropos
address@hidden M-x mh-alias-apropos
If you can't quite remember an alias, you can use @kbd{M-x
mh-alias-apropos} to show all aliases or addresses that match a
@@ -5591,6 +5919,9 @@
This means that you can easily have a different header and signature
at home and at work.
address@hidden @samp{Identity} menu
address@hidden menu, @samp{Identity}
+
A couple of commands are used to insert identities in MH-Letter mode
which are also found in the @samp{Identity} menu.
@@ -5639,6 +5970,8 @@
context are the @samp{From:} and @samp{Organization:} fields, as well
as the signature.
address@hidden mh-identity-list
+
This is done by customizing the option @code{mh-identity-list}. In the
customization buffer for this option, click on the @samp{INS} button
and enter a label such as @samp{Home} or @samp{Work}. Then click on
@@ -5682,18 +6015,21 @@
@cindex Identity menu
@cindex menu, Identity
address@hidden mh-insert-identity
address@hidden C-c C-d
You can select the identities you have added via the menu called
@samp{Identity} in the MH-Letter buffer. You can also use @kbd{C-c
C-d} (@code{mh-insert-identity}). To clear the fields and signature
added by the identity, select the @samp{None} identity.
address@hidden @samp{Identity > Save as Default} menu item
address@hidden menu item, @samp{Identity > Customize Identities}
@cindex menu item, @samp{Identity > Save as Default}
address@hidden @samp{Identity > Set Default for Session} menu item
@cindex menu item, @samp{Identity > Set Default for Session}
@cindex @samp{Identity > Customize Identities} menu item
address@hidden menu item, @samp{Identity > Customize Identities}
address@hidden @samp{Identity > Save as Default} menu item
address@hidden @samp{Identity > Set Default for Session} menu item
address@hidden mh-identity-default
The @samp{Identity} menu contains two other items to save you from
having to set the identity on every message. The menu item @samp{Set
@@ -5706,6 +6042,7 @@
Identities} is available for your convenience.
@cindex regular expressions, @code{mh-auto-fields-list}
address@hidden mh-auto-fields-list
The option @code{mh-auto-fields-list} can also be used to set the
identity depending on the recipient to provide even more control. To
@@ -5754,6 +6091,10 @@
Other header fields may be added using this menu item.
@end table
address@hidden mh-insert-auto-fields
address@hidden C-c M-d
address@hidden mh-auto-fields-prompt-flag
+
These fields can only be added after the recipient is known. Because
you can continue to add recipients as you edit the draft, MH-E waits
until the message is sent to perform the auto-insertions. This seems
@@ -5770,10 +6111,16 @@
manually. However, if you use this command, the automatic insertion
when the message is sent is disabled.
address@hidden mh-auto-fields-list
address@hidden mh-identity-list
+
You should avoid using the same header field in
@code{mh-auto-fields-list} and @code{mh-identity-list} definitions
that may apply to the same message as the result is undefined.
address@hidden mh-identity-handlers
address@hidden mh-identity-list
+
The option @code{mh-identity-handlers} is used to change the way that
fields, signatures, and attributions in @code{mh-identity-list} are
added. To customize @code{mh-identity-handlers}, replace the name of
@@ -5782,6 +6129,8 @@
click on an @samp{INS} button and insert a field of your choice and
the name of the function you have written to handle it.
address@hidden mh-identity-list
+
The @samp{Field} field can be any field that you've used in your
@code{mh-identity-list}. The special fields @samp{:attribution-verb},
@samp{:signature}, or @samp{:pgg-default-user-id} are used for the
@@ -5802,6 +6151,10 @@
@cindex folder navigation
@cindex speedbar
address@hidden mh-visit-folder
address@hidden F v
address@hidden M-x speedbar
address@hidden Mouse-2
You can also use the speedbar
@ifnothtml
@@ -5848,6 +6201,10 @@
count before the next automatic update (@code{mh-speed-refresh}).
@end table
address@hidden delete-frame
address@hidden C-x 5 0
address@hidden Mouse-3
+
You can click on @kbd{Mouse-3} to bring up a context menu that
contains these items. Dismiss the speedbar with @kbd{C-x 5 0}
(@code{delete-frame}).
@@ -5890,8 +6247,12 @@
@node Menu Bar, Tool Bar, Speedbar, Top
@chapter The Menu Bar
address@hidden menu bar
-
address@hidden @samp{Folder} menu
address@hidden @samp{Identity} menu
address@hidden @samp{Letter} menu
address@hidden @samp{Message} menu
address@hidden @samp{Search} menu
address@hidden @samp{Sequence} menu
@cindex Folder menu
@cindex Identity menu
@cindex Letter menu
@@ -5901,12 +6262,19 @@
@cindex Message menu
@cindex Search menu
@cindex Sequence menu
address@hidden menu bar
@cindex menu, Folder
@cindex menu, Identity
@cindex menu, Letter
@cindex menu, Message
@cindex menu, Search
@cindex menu, Sequence
address@hidden menu, @samp{Folder}
address@hidden menu, @samp{Identity}
address@hidden menu, @samp{Letter}
address@hidden menu, @samp{Message}
address@hidden menu, @samp{Search}
address@hidden menu, @samp{Sequence}
@cindex modes, MH-Folder
@cindex modes, MH-Letter
@cindex modes, MH-Search
@@ -5940,8 +6308,6 @@
@chapter The Tool Bar
@cindex tool bar
address@hidden @samp{mh-tool-bar} customization group
address@hidden customization group, @samp{mh-tool-bar}
Emacs also provides a graphical tool bar. For a description of the
tool bar, please
@@ -5954,6 +6320,9 @@
Tool Bars} in @cite{The GNU Emacs Manual}.
@end ifhtml
address@hidden @samp{mh-tool-bar} customization group
address@hidden customization group, @samp{mh-tool-bar}
+
MH-E adds several icons to this tool bar; you can modify the MH-E
aspects of the tool bar via the @samp{mh-tool-bar} customization group.
@@ -5981,6 +6350,9 @@
bar. In XEmacs, you have the opportunity to create a separate tool bar for
the MH-E icons.
address@hidden mh-tool-bar-folder-buttons
address@hidden mh-tool-bar-letter-buttons
+
In either case, you can select which of these functions you'd like to
see by customizing the options @code{mh-tool-bar-folder-buttons} and
@code{mh-tool-bar-letter-buttons}. As you probably guessed, the former
@@ -5989,18 +6361,25 @@
check the functions whose icons you want to see and clear the check
boxes for those you don't.
address@hidden mh-search
address@hidden mh-tool-bar-search-function
+
The function associated with the searching icon can be set via the
option @code{mh-tool-bar-search-function}. By default, this is set to
@code{mh-search}. @xref{Searching}. You can also choose @samp{Other
Function} from the @samp{Value Menu} and enter a function of your own
choosing.
address@hidden mh-xemacs-use-tool-bar-flag
+
XEmacs provides a couple of extra options. The first,
@code{mh-xemacs-use-tool-bar-flag}, controls whether to show the MH-E
icons at all. By default, this option is turned on if the window
system supports tool bars. If your system doesn't support tool bars,
then you won't be able to turn on this option.
address@hidden mh-xemacs-tool-bar-position
+
The second extra option is @code{mh-xemacs-tool-bar-position} which
controls the placement of the tool bar along the four edges of the
frame. You can choose from one of @samp{Same As Default Tool Bar},
@@ -6012,8 +6391,9 @@
@node Searching, Threading, Tool Bar, Top
@chapter Searching Through Messages
address@hidden @samp{Search} menu
address@hidden menu, @samp{Search}
@cindex searching
-
@findex mh-search
@kindex F s
@@ -6157,12 +6537,18 @@
Folder heading face in MH-Folder buffers created by searches.
@end vtable
address@hidden mh-search-folder
address@hidden F s
+
The command @kbd{F s} (@code{mh-search-folder}) helps you find
messages in your entire corpus of mail. You can search for messages to
or from a particular person or about a particular subject. In fact,
you can also search for messages containing selected strings in any
arbitrary header field or any string found within the messages.
address@hidden @command{pick}
address@hidden MH commands, @command{pick}
+
Out of the box, MH-E uses @command{pick} to find messages. With a
little extra effort, you can set an indexing program which rewards you
with extremely quick results. The drawback is that sometimes the index
@@ -6229,26 +6615,25 @@
@end group
@end smallexample
address@hidden mh-to-field
address@hidden C-c C-f C-t
+
As with MH-Letter mode, MH-Search provides commands like @kbd{C-c C-f
C-t} (@code{mh-to-field}) to help you fill in the blanks.
@xref{Editing Message}.
address@hidden F s
address@hidden mh-search-mode-hook
+
If you find that you do the same thing over and over when editing the
search template, you may wish to bind some shortcuts to keys. This can
be done with the variable @code{mh-search-mode-hook}, which is called
when @kbd{F s} is run on a new pattern.
address@hidden @samp{+mhe-index}
address@hidden folders, @samp{+mhe-index}
@findex mh-index-do-search
address@hidden mh-index-next-folder
address@hidden mh-index-previous-folder
@findex mh-pick-do-search
address@hidden @key{TAB}
@kindex C-c C-c
address@hidden F s
address@hidden address@hidden
address@hidden mh-search-folder
address@hidden C-c C-p
To perform the search, type @kbd{C-c C-c} (@code{mh-index-do-search}).
Sometimes you're searching for text that is either not indexed, or
@@ -6256,6 +6641,14 @@
method with the pick method by running the command @kbd{C-c C-p}
(@code{mh-pick-do-search}).
address@hidden folders, @samp{+mhe-index}
address@hidden @samp{+mhe-index}
address@hidden mh-index-next-folder
address@hidden mh-index-previous-folder
address@hidden @key{TAB}
address@hidden address@hidden
address@hidden mh-search-folder
+
The messages that are found are put in a temporary sub-folder of
@samp{+mhe-index} and are displayed in an MH-Folder buffer. This
buffer is special because it displays messages from multiple folders;
@@ -6266,6 +6659,11 @@
(@code{mh-index-next-folder}) and @address@hidden
(@code{mh-index-previous-folder}).
address@hidden mh-index-visit-folder
address@hidden mh-rescan-folder
address@hidden F r
address@hidden v
+
In addition, the command @kbd{v} (@code{mh-index-visit-folder}) can be
used to visit the folder of the message at point. Initially, only the
messages that matched the search criteria are displayed in the folder.
@@ -6275,10 +6673,15 @@
interesting message, or to view surrounding messages with the command
@kbd{F r} @code{mh-rescan-folder}. @xref{Folders}.
address@hidden mh-kill-folder
address@hidden F k
+
Because this folder is temporary, you'll probably get in the habit of
killing it when you're done with @kbd{F k} (@code{mh-kill-folder}).
@xref{Folders}.
address@hidden F s
+
You can regenerate the results by running @kbd{F s} with a prefix
argument.
@@ -6434,7 +6837,7 @@
daily from cron:
@smallexample
- swish-e -c /home/user/Mail/.swish/config
+swish-e -c /home/user/Mail/.swish/config
@end smallexample
@subsection mairix
@@ -6536,6 +6939,10 @@
limiting (@pxref{Limits}) or using full-text indexed searches
(@pxref{Searching}).
address@hidden root, in threads
address@hidden siblings, in threads
address@hidden ancestor, in threads
+
A thread begins with a single message called a @dfn{root}. All replies
to the same message are @dfn{siblings} of each other. Any message that
has replies to it is an @dfn{ancestor} of those replies.
@@ -6581,6 +6988,9 @@
Display ancestor of current message (@code{mh-thread-ancestor}).
@end table
address@hidden @samp{mh-thread} customization group
address@hidden customization group, @samp{mh-thread}
+
The @samp{mh-thread} customization group contains one option.
@vtable @code
@@ -6588,6 +6998,11 @@
On means new folders start in threaded mode (default: @samp{off}).
@end vtable
address@hidden mh-toggle-threads
address@hidden T t
address@hidden mh-large-folder
address@hidden mh-show-threads-flag
+
Threading large number of messages can be time consuming so the option
@code{mh-show-threads-flag} is turned off by default. If you turn on
this option, then threading will be done only if the number of
@@ -6595,6 +7010,13 @@
event, threading can be turned on (and off) with the command @kbd{T t}
(@code{mh-toggle-threads}).
address@hidden mh-thread-ancestor
address@hidden mh-thread-next-sibling
address@hidden mh-thread-previous-sibling
address@hidden T n
address@hidden T p
address@hidden T u
+
There are a few commands to help you navigate threads. If you do not
care for the way a particular thread has turned, you can move up the
chain of messages with the command @kbd{T u}
@@ -6604,6 +7026,13 @@
sibling, skipping the sub-threads. The command @kbd{T u} can also take
a prefix argument to jump to the message that started everything.
address@hidden mh-delete-subject-or-thread
address@hidden mh-thread-delete
address@hidden mh-thread-refile
address@hidden k
address@hidden T d
address@hidden T o
+
There are threaded equivalents for the commands that delete and refile
messages. For example, @kbd{T o} (@code{mh-thread-refile}) refiles the
current message and all its children. Similarly, the command @kbd{T d}
@@ -6612,11 +7041,13 @@
@xref{Navigating}, for a description of the similar command @kbd{k}
(@code{mh-delete-subject-or-thread}).
address@hidden mh-large-folder
+
If you find that threading is too slow, it may be that you have
address@hidden set too high. Threading is one of the few
address@hidden set too high. Also, threading is one of the few
features of MH-E that really benefits from compiling. If you haven't
-compiled MH-E, I encourage you to do address@hidden you're not sure
-if MH-E has been byte-compiled, you could try running @samp{locate
+compiled MH-E, I encourage you to do address@hidden you're not sure if
+MH-E has been byte-compiled, you could try running @samp{locate
mh-thread.elc} or otherwise find MH-E on your system and ensure that
@file{mh-thread.elc} exists. If you have multiple versions and you
find that one is compiled but the other is not, then go into your
@@ -6695,18 +7126,32 @@
@cindex @command{pick}
@cindex MH commands, @command{pick}
address@hidden mh-narrow-to-cc
address@hidden mh-narrow-to-from
address@hidden mh-narrow-to-subject
address@hidden mh-narrow-to-to
address@hidden / c
address@hidden / m
address@hidden / s
address@hidden / t
-The commands @kbd{/ c}, @code{/ m}, @code{/ s}, and @code{/ t}
-restrict the display to messages matching the content of the
-respective field in the current message. However, you can give any of
-these a prefix argument to edit the @command{pick} expression used to
-narrow the address@hidden @command{pick}(1) or the section
+The commands @kbd{/ c} (@code{mh-narrow-to-cc}), @kbd{/ m}
+(@code{mh-narrow-to-from}), @kbd{/ s} (@code{mh-narrow-to-subject}),
+and @kbd{/ t} (@code{mh-narrow-to-to}) restrict the display to
+messages matching the content of the respective field in the current
+message. However, you can give any of these a prefix argument to edit
+the @command{pick} expression used to narrow the address@hidden
address@hidden(1) or the section
@address@hidden/finpic.htm, Finding Messages with pick} in
the MH book.}.
@cindex @samp{tick} sequence
@cindex sequence, @samp{tick}
@cindex ticked messages, viewing
address@hidden mh-narrow-to-range
address@hidden mh-narrow-to-tick
address@hidden / '
address@hidden / g
You can also limit the display to messages in the @samp{tick} sequence
with the command @kbd{/ '} (@code{mh-narrow-to-tick}).
@@ -6714,12 +7159,17 @@
@samp{tick} sequence. Use the @kbd{/ g} (@code{mh-narrow-to-range})
command to limit the display to messages in a range (@pxref{Ranges}).
address@hidden mh-widen
address@hidden / w
+
Each limit can be undone in turn with the @kbd{/ w} (@code{mh-widen})
command. Give this command a prefix argument to remove all limits.
@node Sequences, Junk, Limits, Top
@chapter Using Sequences
address@hidden @samp{Sequence} menu
address@hidden menu, @samp{Sequence}
@cindex sequences
For the whole scoop on MH sequences, refer to
@@ -6835,6 +7285,8 @@
@cindex @command{pick}
@cindex MH commands, @command{pick}
address@hidden mh-put-msg-in-seq
address@hidden S p
To place a message in a sequence, use @kbd{S p}
(@code{mh-put-msg-in-seq}). Give @kbd{S p} a range and you can add all
@@ -6844,11 +7296,18 @@
@cindex @samp{tick} sequence
@cindex sequence, @samp{tick}
@cindex ticking messages
address@hidden mh-index-ticked-messages
address@hidden mh-toggle-tick
address@hidden '
address@hidden F '
address@hidden S p
One specific use of the @kbd{S p} command is @kbd{'}
(@code{mh-toggle-tick}) which adds messages to the @samp{tick}
-sequence. This sequence can be viewed later with the @kbd{F '} command
-(@pxref{Folders}).
+sequence. This sequence can be viewed later with the @kbd{F '}
+(@code{mh-index-ticked-messages}) command (@pxref{Folders}).
+
address@hidden mh-tick-seq
You can customize the option @code{mh-tick-seq} if you already use the
@samp{tick} sequence for your own use. You can also disable all of the
@@ -6857,6 +7316,12 @@
@cindex MH-Folder mode
@cindex modes, MH-Folder
address@hidden mh-narrow-to-seq
address@hidden mh-narrow-to-tick
address@hidden mh-widen
address@hidden S '
address@hidden S n
address@hidden S w
Once you've placed some messages in a sequence, you may wish to narrow
the field of view to just those messages in the sequence you've
@@ -6869,8 +7334,12 @@
widen the view to all your messages again, use @kbd{S w}
(@code{mh-widen}).
address@hidden @samp{*MH-E Sequences*}
@cindex buffers, @samp{*MH-E Sequences*}
address@hidden @samp{*MH-E Sequences*}
address@hidden mh-list-sequences
address@hidden mh-msg-is-in-seq
address@hidden S l
address@hidden S s
You can see which sequences in which a message appears with the
command @kbd{S s} (@code{mh-msg-is-in-seq}). Use a prefix argument to
@@ -6880,11 +7349,12 @@
(@code{mh-list-sequences}). The list appears in a buffer named
@samp{*MH-E Sequences*} (@pxref{Miscellaneous}).
address@hidden @samp{Previous-Sequence:} MH profile component
address@hidden @samp{cur} sequence
@cindex MH profile component, @samp{Previous-Sequence:}
address@hidden sequence, @samp{Previous-Sequence}
address@hidden @samp{cur} sequence
address@hidden @samp{Previous-Sequence:} MH profile component
@cindex sequence, @samp{cur}
address@hidden sequence, @samp{Previous-Sequence}
address@hidden mh-refile-preserves-sequences-flag
If a message is in any sequence (except
@samp{Previous-Sequence:address@hidden @samp{mh-profile}(5)).} and
@@ -6892,6 +7362,12 @@
sequences in the destination folder. If this behavior is not desired,
then turn off the option @code{mh-refile-preserves-sequences-flag}.
address@hidden mh-delete-msg-from-seq
address@hidden mh-delete-seq
address@hidden d
address@hidden S d
address@hidden S k
+
If you want to remove a message (or range, @pxref{Ranges}) from a
sequence, use @kbd{S d} (@code{mh-delete-msg-from-seq}). If you want
to delete an entire sequence, use @kbd{S k} (@code{mh-delete-seq}). In
@@ -6901,8 +7377,18 @@
Mail}).
@cindex @samp{Unseen-Sequence:} MH profile component
address@hidden @samp{cur} sequence
address@hidden @samp{tick} sequence
@cindex MH profile component, @samp{Unseen-Sequence:}
@cindex sequence, @samp{Unseen-Sequence}
address@hidden sequence, @samp{cur}
address@hidden sequence, @samp{tick}
address@hidden mh-update-sequences
address@hidden M-x mh-update-sequences
address@hidden q
address@hidden x
address@hidden mh-tick-seq
address@hidden mh-update-sequences-after-mh-show-flag
Three sequences are maintained internally by MH-E and pushed out to MH
when a message is shown. They include the sequence specified by your
@@ -6923,6 +7409,8 @@
@cindex @command{mark}
@cindex MH commands, @command{mark}
address@hidden S n
address@hidden S w
With the exceptions of @kbd{S n} and @kbd{S w}, the underlying MH
command dealing with sequences is @address@hidden the
@@ -7005,6 +7493,8 @@
to work well with MH-E and how to use MH-E's interface that provides
continuing education for these programs.
address@hidden mh-junk-program
+
The default setting of the option @code{mh-junk-program} is
@samp{Auto-detect} which means that MH-E will automatically choose one
of SpamAssassin, bogofilter, or SpamProbe in that order. If, for
@@ -7012,6 +7502,10 @@
want to use bogofilter, then you can set this option to
@samp{Bogofilter}.
address@hidden mh-junk-blacklist
address@hidden J b
address@hidden mh-junk-disposition
+
The command @kbd{J b} (@code{mh-junk-blacklist}) trains the spam
program in use with the content of the range (@pxref{Ranges}) and then
handles the message(s) as specified by the option
@@ -7019,11 +7513,16 @@
@samp{Delete Spam} but you can also specify the name of the folder
which is useful for building a corpus of spam for training purposes.
address@hidden mh-junk-whitelist
address@hidden J w
+
In contrast, the command @kbd{J w} (@code{mh-junk-whitelist})
reclassifies a range of messages (@pxref{Ranges}) as ham if it were
incorrectly classified as spam. It then refiles the message into the
@file{+inbox} folder.
address@hidden mh-junk-background
+
By default, the programs are run in the foreground, but this can be
slow when junking large numbers of messages. If you have enough memory
or don't junk that many messages at the same time, you might try
@@ -7035,7 +7534,10 @@
@cindex @file{.procmailrc}
@cindex files, @file{.procmailrc}
address@hidden SpamAssassin
address@hidden SpamAssassin
+
address@hidden Spamassassin
address@hidden spam filters, Spamassassin
SpamAssassin is one of the more popular spam filtering programs. Get
it from your local distribution or from the
@@ -7088,6 +7590,11 @@
rules-based filters is a plethora of false positives so it is
worthwhile to check.
address@hidden mh-junk-blacklist
address@hidden mh-junk-whitelist
address@hidden J b
address@hidden J w
+
If SpamAssassin classifies a message incorrectly, or is unsure, you can
use the MH-E commands @kbd{J b} (@code{mh-junk-blacklist}) and
@kbd{J w} (@code{mh-junk-whitelist}).
@@ -7133,7 +7640,10 @@
0 * * * * sa-learn --rebuild > /dev/null 2>&1
@end smallexample
address@hidden Bogofilter
address@hidden Bogofilter
+
address@hidden bogofilter
address@hidden spam filters, bogofilter
Bogofilter is a Bayesian spam filtering program. Get it from your
local distribution or from the
@@ -7179,6 +7689,11 @@
spam/unsure/.
@end smallexample
address@hidden mh-junk-blacklist
address@hidden mh-junk-whitelist
address@hidden J b
address@hidden J w
+
If bogofilter classifies a message incorrectly, or is unsure, you can
use the MH-E commands @kbd{J b} (@code{mh-junk-blacklist}) and @kbd{J
w} (@code{mh-junk-whitelist}) to update bogofilter's training.
@@ -7195,7 +7710,10 @@
The @cite{Bogofilter tuning HOWTO} describes how you can fine-tune
bogofilter.
address@hidden SpamProbe
address@hidden SpamProbe
+
address@hidden SpamProbe
address@hidden spam filters, SpamProbe
SpamProbe is a Bayesian spam filtering program. Get it from your local
distribution or from the @uref{http://spamprobe.sourceforge.net,
@@ -7222,11 +7740,16 @@
spam/.
@end smallexample
address@hidden mh-junk-blacklist
address@hidden mh-junk-whitelist
address@hidden J b
address@hidden J w
+
If SpamProbe classifies a message incorrectly, you can use the MH-E
commands @kbd{J b} (@code{mh-junk-blacklist}) and @kbd{J w}
(@code{mh-junk-whitelist}) to update SpamProbe's training.
address@hidden Other Things You Can Do
address@hidden Other Things You Can Do
There are a couple of things that you can add to @file{~/.procmailrc}
in order to filter out a lot of spam and viruses. The first is to
@@ -7286,10 +7809,11 @@
system.
@end ftable
address@hidden @samp{*MH-E Info*}
address@hidden MH-E version
@cindex buffers, @samp{*MH-E Info*}
address@hidden MH-E version
address@hidden @samp{*MH-E Info*}
@cindex version
address@hidden M-x mh-version
One command worth noting is @kbd{M-x mh-version}. You can compare the
version this command prints to the latest release (@pxref{Getting
@@ -7297,7 +7821,7 @@
@samp{*MH-E Info*}, should usually be included with any bug report you
submit (@pxref{Bug Reports}).
address@hidden MH-E Buffers
address@hidden MH-E Buffers
Besides the MH-Folder, MH-Show, and MH-Letter buffers, MH-E creates
several other buffers. They are:
@@ -7354,7 +7878,7 @@
@c -------------------------
@cindex @samp{*mh-temp*}
@cindex buffers, @samp{*mh-temp*}
address@hidden *mh-temp
address@hidden *mh-temp*
This is a scratch, ephemeral, buffer used by MH-E functions. Note that
it is hidden because the first character in the name is a space.
You'll generally not have any need for this buffer.
@@ -7389,9 +7913,7 @@
Program used to scan messages (default: @code{"scan"}).
@end vtable
address@hidden mh-set-cmd-note
@vindex mh-adaptive-cmd-note-flag
address@hidden mh-scan-format-file
There are a couple of caveats when creating your own scan format file.
First, MH-E will not work if your scan lines do not include message
@@ -7401,6 +7923,9 @@
(@pxref{Threading}).
@cindex message numbers
address@hidden mh-set-cmd-note
address@hidden mh-adaptive-cmd-note-flag
address@hidden mh-scan-format-file
If you've created your own format to handle long message numbers,
you'll be pleased to know you no longer need it since MH-E adapts its
@@ -7411,8 +7936,10 @@
format file (see @code{mh-scan-format-file}). For example, the default
width is 4, so you would use @samp{(mh-set-cmd-note 4)}.
address@hidden mh-scan-format-nmh
address@hidden mh-adaptive-cmd-note-flag
address@hidden mh-scan-format-file
@vindex mh-scan-format-mh
address@hidden mh-scan-format-nmh
The default setting for @code{mh-scan-format-file} is @samp{Use MH-E
scan Format}. This means that the format string will be taken from the
@@ -7425,6 +7952,10 @@
you can set this option to @samp{Specify a scan Format File} and enter
the name of your format file.
address@hidden mh-scan-format-file
address@hidden mh-scan-format-mh
address@hidden mh-scan-format-nmh
+
The scan format that MH-E uses when @code{mh-scan-format-file} is set
to its default of @samp{Use MH-E scan Format} is held in the variables
@code{mh-scan-format-nmh} and @code{mh-scan-format-mh} depending on
@@ -7448,8 +7979,9 @@
"%(address@hidden@})%<@address@hidden<<address@hidden@}%>")
@end smallexample
address@hidden RFC 2047, decoding
@cindex decoding RFC 2047
address@hidden RFC 2047, decoding
address@hidden mh-scan-format-mh
The setting for @code{mh-scan-format-mh} is similar, except that MH
doesn't have the function @code{decode} (which is used to decode RFC
@@ -7484,6 +8016,8 @@
pick Ranges Sequences} in the MH book.}.
@cindex regular expressions, scan line formats
address@hidden mh-set-cmd-note
address@hidden setq
If you change the format of the scan lines you'll need to tell MH-E
how to parse the new format. As you will see, quite a lot of variables
@@ -7521,8 +8055,6 @@
Next, many variables control how the scan lines are parsed.
address@hidden mh-folder-font-lock-keywords
-
@vtable @code
@vindex mh-folder-body
@vindex mh-folder-font-lock-keywords
@@ -7693,6 +8225,8 @@
the scan lines.
@vtable @code
address@hidden mh-set-cmd-note
address@hidden mh-adaptive-cmd-note-flag
@item mh-cmd-note
Column for notations (default: 4). This variable should be set with
the function @code{mh-set-cmd-note}. This variable may be updated
@@ -7704,10 +8238,12 @@
Messages that have been copied are marked by this character (default:
@code{?C}).
@c -------------------------
address@hidden mh-scan-cur-msg-number-regexp
@item mh-note-cur
The current message (in MH, not in MH-E) is marked by this character
(default: @code{?+}). See also @code{mh-scan-cur-msg-number-regexp}.
@c -------------------------
address@hidden mh-scan-deleted-msg-regexp
@item mh-note-deleted
Messages that have been deleted are marked by this character (default:
@code{?D}). See also @code{mh-scan-deleted-msg-regexp}.
@@ -7724,6 +8260,7 @@
Messages that have been printed are marked by this character (default:
@code{?P}).
@c -------------------------
address@hidden mh-scan-refiled-msg-regexp
@item mh-note-refiled
Messages that have been refiled are marked by this character (default:
@code{?^}). See also @code{mh-scan-refiled-msg-regexp}.
@@ -7747,6 +8284,8 @@
%20(decode(address@hidden@})) %50(address@hidden@}) %4(msg)%<(cur)+%| %>
@end example
address@hidden mh-adaptive-cmd-note-flag
address@hidden mh-scan-format-file
@vindex mh-scan-format-file, example
The first thing you have to do is tell MH-E to use this file.
@@ -7931,9 +8470,10 @@
@samp{Path} box and enter @file{~/Mail} to tell Gnus where to find
your mail.
@c -------------------------
address@hidden mail-user-agent
@item message-mail-user-agent
In order to send mail within Gnus using MH-E, set this option to
address@hidden and set the @samp{mail-user-agent} option to
address@hidden and set the @code{mail-user-agent} option to
@samp{Emacs interface to MH}.
@c -------------------------
@item nnmail-keep-last-article
@@ -7981,8 +8521,9 @@
@node Bug Reports, Mailing Lists, Odds and Ends, Odds and Ends
@appendixsec Bug Reports
address@hidden SourceForge
@cindex bugs
address@hidden SourceForge
address@hidden M-x mh-version
Bug reports should be filed at
@uref{https://sourceforge.net/bugs/?group_id=13357, SourceForge}. You
@@ -8040,7 +8581,6 @@
@cindex change log
@cindex release notes
address@hidden intentionally wordy to avoid overfull hbox
New MH-E releases are always available for downloading at
@uref{https://sourceforge.net/project/showfiles.php?group_id=13357,
SourceForge} before they appear in an Emacs release. You can read the
@@ -8050,11 +8590,12 @@
MH-E has to offer (although we have no doubt that you will be
extremely interested in all new releases).
address@hidden @samp{MH-E-NEWS}
address@hidden @samp{README}
@cindex files, @samp{MH-E-NEWS}
@cindex files, @samp{README}
@cindex news
address@hidden @samp{MH-E-NEWS}
address@hidden @samp{README}
address@hidden M-x mh-version
After you download and extract the MH-E tarball, read the
@file{README} file and @file{MH-E-NEWS}. These correspond to the
@@ -8247,20 +8788,24 @@
After a long break, Stephen handed the reins over to me in 2000. I
moved the project to a new site called SourceForge and organized a
great team of developers. Our first release in late 2001 was version
-6. It appeared in Emacs 21.2 and had menus and tool bar buttons.
+6. It appeared around the time of Emacs 21.2 and had menus and tool
+bar buttons.
Then, indexed searches, improved MIME handling, a speedbar, multiple
identities, alias completion, an index view of unseen messages, spam
software support, Face and X-Image-URL header field support, Fcc
completion, arbitrary range handling, and draft form editing were
-introduced in the version 7 series in Emacs 21.4 (2004).
+introduced in the version 7 series around the time of Emacs 21.4
+(2004). Still, Emacs itself contained version 5 of MH-E released back
+in 1994.
Version 8 development was mostly driven by the rewrite of the manual.
It also brought mailutils support, S/MIME support, picon support, and
an improved interface for hiding header fields. The CVS repository was
migrated from SourceForge to Savannah (only for those files that were
already part of Emacs) and the software was completely reorganized to
-push back two decades of entropy. It appeared in Emacs 22.1 (2006).
+push back two decades of entropy. Version 8 will appear in Emacs 22.1,
+expected to be released in 2006.
Bill Wohler, February 2006
- [Emacs-diffs] Changes to emacs/man/mh-e.texi, Bill Wohler, 2006/03/06
- [Emacs-diffs] Changes to emacs/man/mh-e.texi, Miles Bader, 2006/03/06
- [Emacs-diffs] Changes to emacs/man/mh-e.texi, Bill Wohler, 2006/03/11
- [Emacs-diffs] Changes to emacs/man/mh-e.texi, Bill Wohler, 2006/03/11
- [Emacs-diffs] Changes to emacs/man/mh-e.texi,
Bill Wohler <=
- [Emacs-diffs] Changes to emacs/man/mh-e.texi, Bill Wohler, 2006/03/17
- [Emacs-diffs] Changes to emacs/man/mh-e.texi, Bill Wohler, 2006/03/19
- [Emacs-diffs] Changes to emacs/man/mh-e.texi, Bill Wohler, 2006/03/19
- [Emacs-diffs] Changes to emacs/man/mh-e.texi, Bill Wohler, 2006/03/19
- [Emacs-diffs] Changes to emacs/man/mh-e.texi, Bill Wohler, 2006/03/21
- [Emacs-diffs] Changes to emacs/man/mh-e.texi, Karl Berry, 2006/03/25