X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/926dbbb0533b676d17e208a688be418397ae0a5e..df7593dd91f21150a48a4faa01dcf9209fc902b1:/man/mh-e.texi diff --git a/man/mh-e.texi b/man/mh-e.texi index 180a093ceb..707e5e44b9 100644 --- a/man/mh-e.texi +++ b/man/mh-e.texi @@ -8,15 +8,15 @@ @c %**end of header @c Version of the software and manual. -@set VERSION 7.93 +@set VERSION 8.0.3 @c Edition of the manual. It is either empty for the first edition or @c has the form ", nth Edition" (without the quotes). -@set EDITION , 5th Edition -@set UPDATED 2006-03-19 -@set UPDATE-MONTH March, 2006 +@set EDITION +@set UPDATED 2006-11-12 +@set UPDATE-MONTH November, 2006 @c Other variables. -@set MH-BOOK-HOME http://www.ics.uci.edu/~mh/book/mh +@set MH-BOOK-HOME http://rand-mh.sourceforge.net/book/mh @set MH-E-HOME http://mh-e.sourceforge.net/ @c Copyright @@ -24,8 +24,8 @@ This is version @value{VERSION}@value{EDITION} of @cite{The MH-E Manual}, last updated @value{UPDATED}. -Copyright @copyright{} 1995, - 2001, 2002, 2003, 2005, 2006 Free Software Foundation, Inc. +Copyright @copyright{} 1995, 2001, 2002, 2003, 2005, 2006, 2007 Free +Software Foundation, Inc. @quotation The MH-E manual is free documentation; you can redistribute it and/or @@ -217,7 +217,7 @@ The MH-E package is distributed with GNU Emacs@footnote{Version @value{VERSION} of MH-E will appear in GNU Emacs 22.1. It is supported in GNU Emacs 21, as well as XEmacs 21 (except for versions 21.5.9-21.5.16). It is compatible with MH versions 6.8.4 and higher, -all versions of nmh, and GNU mailutils 0.4 and higher.}, so you +all versions of nmh, and GNU mailutils 1.0 and higher.}, so you shouldn't have to do anything special to use it. This manual covers MH-E version @value{VERSION}. To help you decide which version you have, see @ref{Getting Started}. @@ -245,6 +245,8 @@ If more information is needed, you can go to the Unix manual pages of the individual MH commands. When the name is not obvious, I'll guide you to a relevant MH manual page that describes the action more fully. +@cindex @cite{MH & nmh: Email for Users & Programmers} +@cindex MH book @cindex info @kindex C-h i @@ -536,12 +538,49 @@ quite easy. @xref{Getting MH-E}, for instructions for getting and installing MH-E. If the @code{mh-version} command displays @samp{No MH variant -detected}, then you need to install MH or tell MH-E where to find -MH@footnote{In very old versions of MH-E, you may get the error +detected}@footnote{In very old versions of MH-E, you may get the error message, @samp{Cannot find the commands `inc' and `mhl' and the file `components'} if MH-E can't find MH. In this case, you need to update 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.}. +MH-E are better at finding MH if it is on your system.}, then you need +to install MH or tell MH-E where to find MH. + +@cindex Debian +@cindex nmh +@cindex GNU mailutils + +If you don't have MH on your system already, you must install a +variant of MH. The Debian mh-e package does this for you automatically +(@pxref{Getting MH-E}). Most people use +@uref{http://www.nongnu.org/nmh/, nmh}, but you may be interested in +trying out @uref{http://www.gnu.org/software/mailutils/, GNU +mailutils}, which supports IMAP. Your GNU/Linux distribution probably +has packages for both of these. + +@cindex @command{install-mh} +@cindex MH commands, @command{install-mh} +@cindex MH book + +If you've never run MH before, you need to run @command{install-mh} +from the shell before you continue. This sets up your personal MH +environment@footnote{See the section +@uref{@value{MH-BOOK-HOME}/../overall/setup.html, Setting Up MH} in the +MH book.}. If you don't, you'll be greeted with the error message: +@samp{Install MH and run install-mh before running MH-E}. This is all +you need to know about MH to use MH-E, but the more you know about MH, +the more you can leverage its power. See the +@uref{@value{MH-BOOK-HOME}/../, MH book} to learn more about MH. + +@cindex @samp{Path:} MH profile component +@cindex MH profile +@cindex MH profile component +@cindex MH profile component, @samp{Path:} + +Your MH environment includes your @dfn{MH profile} which is found in +the file @file{~/.mh_profile}. This file contains a number of @dfn{MH +profile components}. For example, the @samp{Path:} MH profile +component contains the path to your mail directory, which is +@file{~/Mail} by default. @cindex @command{mhparam} @cindex MH commands, @command{mhparam} @@ -551,8 +590,9 @@ MH-E are better at finding MH if it is on your system.}. @vindex mh-variant @vindex 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 +There are several options MH-E uses to interact with your MH +installation. 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 first of nmh, MH, or GNU mailutils that it finds in the directories listed in @code{mh-path} (which you can customize), @@ -585,27 +625,6 @@ actually cause problems. @end quotation @sp 1 -@cindex @command{install-mh} -@cindex MH commands, @command{install-mh} - -If you've never run MH before, you need to run @command{install-mh} -from the shell before you continue. This sets up your personal MH -environment@footnote{See the section -@uref{@value{MH-BOOK-HOME}/setup.htm, Setting Up MH} in the MH book.}. -If you don't, you'll be greeted with the error message: @samp{Install -MH and run install-mh before running MH-E}. - -@cindex @samp{Path:} MH profile component -@cindex MH profile -@cindex MH profile component -@cindex MH profile component, @samp{Path:} - -Your MH environment includes your @dfn{MH profile} which is found in -the file @file{~/.mh_profile}. This file contains a number of @dfn{MH -profile components}. For example, the @samp{Path:} MH profile -component contains the path to your mail directory, which is -@file{~/Mail} by default. - @cindex MH profile component, @samp{Draft-Folder:} @cindex MH profile component, @samp{Path:} @cindex MH profile component, @samp{Previous-Sequence:} @@ -744,10 +763,10 @@ message. Type @kbd{C-c C-c} now. That's all there is to it! 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 @command{inc}@footnote{See the section -@uref{@value{MH-BOOK-HOME}/reapre.htm, Reading Mail: inc show next +@uref{@value{MH-BOOK-HOME}/reapre.html, Reading Mail: inc show next prev} in the MH book.} (called @dfn{scan lines} after the MH program @command{scan}@footnote{See the section -@uref{@value{MH-BOOK-HOME}/faswsprs.htm, Find and Specify with scan +@uref{@value{MH-BOOK-HOME}/faswsprs.html, Find and Specify with scan pick Ranges Sequences} in the MH book.} which prints a one-line summary of each message) into a buffer called @samp{+inbox} whose major mode is MH-Folder. @@ -1069,7 +1088,7 @@ i} to read this manual via Info. The online help is quite good; try running @kbd{C-h C-h}. This brings up a list of available help topics, one of which displays the documentation for a given key (like @kbd{C-h k C-n}). Another useful help feature is to view the manual section -that describes a given key (such as @kbd{C-h C-k i}). In addition, +that describes a given key (such as @kbd{C-h K i}). In addition, review @ref{Conventions}, if any of the GNU Emacs conventions are strange to you. @@ -1139,7 +1158,7 @@ mh-execute-commands @key{RET}}. If you write your own functions, please do not prefix your symbols (variables and functions) with @samp{mh-}. This prefix is reserved for the MH-E package. To avoid conflicts with existing MH-E symbols, use a prefix like @samp{my-} or -your initials. +your initials. (Unless, of course, your initials happen to be @emph{mh}!) @menu * Options:: @@ -1233,7 +1252,7 @@ Indicates all messages in the range to , inclusive. The range must be nonempty. @c ------------------------- @item :N -@item :+N +@itemx :+N @itemx :-N Up to N messages beginning with (or ending with) message num. Num may be any of the predefined symbols: first, prev, cur, next or last. @@ -1440,8 +1459,8 @@ is an absolute pathname, the file is assumed to be in the @code{mh-progs} directory (@pxref{Getting Started}). You may also link a file to @command{inc} that uses a different format (see @samp{mh-profile}(5), and sections -@uref{@value{MH-BOOK-HOME}/reapre.htm, Reading Mail: inc show next -prev} and @uref{@value{MH-BOOK-HOME}/mhstr.htm, MH Format Strings} in +@uref{@value{MH-BOOK-HOME}/reapre.html, Reading Mail: inc show next +prev} and @uref{@value{MH-BOOK-HOME}/mhstr.html, MH Format Strings} in the MH book). You'll then need to modify several variables appropriately (@pxref{Scan Line Formats}). @@ -1462,7 +1481,8 @@ use @command{procmail} to filter this mail into @file{~/mail/mh-e} with the following recipe in @file{.procmailrc}: @smallexample -MAILDIR=$HOME/mail +PATH=$PATH:/usr/bin/mh +MAILDIR=$HOME/`mhparam Path` :0: * ^From mh-e-devel-admin@@stop.mail-abuse.org mh-e @@ -1541,9 +1561,9 @@ the message numbers from outside of MH-E. @cindex modes, MH-Show @cindex reading mail @findex mh-rmail -@kindex M-x mh-rmail @kindex F r @kindex F v +@kindex M-x mh-rmail The MH-E entry point for reading mail is @kbd{M-x mh-rmail}. This command incorporates your mail and creates a buffer called @@ -1554,6 +1574,14 @@ into MH-E. Or, give a prefix argument to @code{mh-rmail} so it will 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}.}. +@findex display-time +@vindex read-mail-command + +There are some commands that need to read mail, such as @kbd{Mouse-2} +over the @samp{Mail} button that @code{display-time} adds to the mode +line. You can configure Emacs to have these commands use MH-E by +setting the option @code{read-mail-command} to @samp{mh-rmail}. + @cindex @command{scan} @cindex @samp{Message} menu @cindex MH commands, @command{scan} @@ -2150,7 +2178,7 @@ Default mhl Format} to get the same output as you would get if you ran @command{mhl} from the shell. If you have a format file that you want MH-E to use, you can set this option to @samp{Specify an mhl Format File} and enter the name of your format file (@command{mhl}(1) or -section @uref{@value{MH-BOOK-HOME}/shomes.htm#Usisho, Using mhl} in +section @uref{@value{MH-BOOK-HOME}/shomes.html#Usisho, Using mhl} in the MH book tells you how to write one). Your format file should specify a non-zero value for @samp{overflowoffset} to allow MH-E to parse the header. Note that @command{mhl} is always used for printing @@ -2272,9 +2300,9 @@ MH has the ability to display @dfn{@sc{mime}} (Multipurpose Internet Mail Extensions) messages which are simply messages with additional @dfn{body parts} or @dfn{attachments}. You can use the MH commands @command{show}@footnote{See the section -@uref{@value{MH-BOOK-HOME}/reapre.htm, Reading Mail: inc show next +@uref{@value{MH-BOOK-HOME}/reapre.html, Reading Mail: inc show next prev} in the MH book.} or @command{mhshow}@footnote{See the section -@uref{@value{MH-BOOK-HOME}/usimim.htm#ReMIMa, Reading MIME Mail} in +@uref{@value{MH-BOOK-HOME}/usimim.html#ReMIMa, Reading MIME Mail} in the MH book.} from the shell to read @sc{mime} messages@footnote{You can call them directly from Emacs if you're running the X Window System: type @kbd{M-! xterm -e mhshow @var{message-number}}. You can @@ -2457,6 +2485,13 @@ the option @code{mh-display-buttons-for-alternatives-flag} is on, then the preferred part is shown inline and buttons are shown for each of the other alternatives. +@vindex mm-discouraged-alternatives + +Many people prefer to see the @samp{text/plain} alternative rather +than the @samp{text/html} alternative. To do this in MH-E, customize +the option @code{mm-discouraged-alternatives}, and add +@samp{text/html}. The next best alternative, if any, will be shown. + @kindex K i @findex mh-folder-inline-mime-part @@ -2637,7 +2672,7 @@ use @kbd{D @key{BS}} (@code{mh-page-digest-backwards}). Another handy command is @kbd{D b} (@code{mh-burst-digest}). This command uses the MH command @command{burst}@footnote{See the section -@uref{@value{MH-BOOK-HOME}/burdig.htm, Bursting Messages} in the MH +@uref{@value{MH-BOOK-HOME}/burdig.html, Bursting Messages} in the MH book.} to break out each message in the digest into its own message. Using this command, you can quickly delete unwanted messages, like this: Once the digest is split up, toggle out of MH-Folder Show mode @@ -2848,7 +2883,7 @@ An alternative to using the @samp{ps-print} package is the command @kbd{P l} (@code{mh-print-msg}) (the @i{l} is for @i{l}ine printer or @i{l}pr). You can print all the messages in a range. The message is formatted with @command{mhl}@footnote{See the section -@uref{@value{MH-BOOK-HOME}/shomes.htm#Usisho, Using mhl} in the MH +@uref{@value{MH-BOOK-HOME}/shomes.html#Usisho, Using mhl} in the MH book.} and printed with the @command{lpr} command. @kindex P f @@ -3452,8 +3487,8 @@ bindings, for example: MH-E has analogies for each of the MH @command{folder} and @command{refile} commands@footnote{See the sections -@uref{@value{MH-BOOK-HOME}/fol.htm#Youfol, Your Current Folder: -folder} and @uref{@value{MH-BOOK-HOME}/fol.htm#Movref, Moving and +@uref{@value{MH-BOOK-HOME}/fol.html#Youfol, Your Current Folder: +folder} and @uref{@value{MH-BOOK-HOME}/fol.html#Movref, Moving and Linking Messages: refile} in the MH book.}. To refile a message in another folder, use the command @kbd{o} (@code{mh-refile-msg}) (mnemonic: ``output''). You are prompted for the folder name @@ -3701,7 +3736,7 @@ Use this hook with care. If there is a bug in your hook which returns The option @code{mh-sortm-args} holds extra arguments to pass on to the command @command{sortm}@footnote{See the section -@uref{@value{MH-BOOK-HOME}/sorsor.htm, Sorting Messages: sortm} in the +@uref{@value{MH-BOOK-HOME}/sorsor.html, Sorting Messages: sortm} in the MH book.} when a prefix argument is used with @kbd{F S}. Normally default arguments to @command{sortm} are specified in the MH profile. This option may be used to provide an alternate view. For example, @@ -3724,33 +3759,36 @@ again. @findex mh-execute-commands @kindex q @vindex mh-before-quit-hook +@vindex mh-before-quit-hook, example @vindex mh-quit-hook +@vindex mh-quit-hook, example The two hooks @code{mh-before-quit-hook} and @code{mh-quit-hook} are 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. - -@vindex mh-quit-hook, example +to modify the window setup. If you find that @kbd{q} buries a lot of +buffers that you would rather remove, you can use both +@code{mh-before-quit-hook} and @code{mh-quit-hook} to accomplish that. @smalllisp @group +(defvar my-mh-folder-buffer-to-delete nil + "Folder buffer that is being quit.") + +(defun my-mh-before-quit-hook () + "Save folder buffer that is to be deleted." + (setq my-mh-folder-buffer-to-delete (current-buffer))) + (defun my-mh-quit-hook () - "Clear window configuration variables as the MH window is gone." - (setq my-mh-screen-saved nil) - (setq my-mh-screen nil) - (if my-normal-screen - (set-window-configuration my-normal-screen)) - (setq my-normal-screen nil)) - -@i{Clean up window setup in mh-quit-hook} + "Kill folder buffer rather than just bury it." + (set-buffer my-mh-folder-buffer-to-delete) + (if (get-buffer mh-show-buffer) + (kill-buffer mh-show-buffer)) + (kill-buffer (current-buffer))) + +@i{Kill MH-Folder buffer instead of burying it} @end group @end smalllisp @@ -4081,7 +4119,7 @@ recipients. @vindex mh-reply-default-reply-to Depending on your answer, @command{repl}@footnote{See the section -@uref{@value{MH-BOOK-HOME}/reprep.htm, Replying to Messages: repl} in +@uref{@value{MH-BOOK-HOME}/reprep.html, Replying to Messages: repl} in the MH book.} is given a different argument to form your reply. Specifically, a choice of @kbd{from} or none at all runs @samp{repl -nocc all}, and a choice of @kbd{to} runs @samp{repl -cc to}. Finally, @@ -4111,7 +4149,7 @@ If you supply a prefix argument (as in @kbd{C-u r}), the message you are replying to is inserted in your reply after having first been run through @command{mhl} with the format file @file{mhl.reply}. See @command{mhl}(1) or the section -@uref{@value{MH-BOOK-HOME}/shomes.htm#Usisho, Using mhl} in the MH +@uref{@value{MH-BOOK-HOME}/shomes.html#Usisho, Using mhl} in the MH book to see how you can modify the default @file{mhl.reply} file. @vindex mh-yank-behavior @@ -4147,7 +4185,7 @@ To forward a message, use the @kbd{f} (@code{mh-forward}) command. You are prompted for the @samp{To:} and @samp{cc:} recipients. You are given a draft to edit that looks like it would if you had run the MH command @command{forw}@footnote{See the section -@uref{@value{MH-BOOK-HOME}/forfor.htm, Forwarding Messages: forw} in +@uref{@value{MH-BOOK-HOME}/forfor.html, Forwarding Messages: forw} in the MH book.}. You can then add some text (@pxref{Editing Drafts}). You can forward several messages by using a range (@pxref{Ranges}). All of the messages in the range are inserted into your draft. The @@ -4221,10 +4259,10 @@ For more information on redistributing messages, see The option @code{mh-redist-full-contents-flag} must be turned on if @command{dist}@footnote{See the section -@uref{@value{MH-BOOK-HOME}/disdis.htm, Distributing Messages with +@uref{@value{MH-BOOK-HOME}/disdis.html, Distributing Messages with dist} in the MH book.} requires the whole letter for redistribution, which is the case if @command{send}@footnote{See the section -@uref{@value{MH-BOOK-HOME}/sensen.htm, Sending Some Mail: comp send} +@uref{@value{MH-BOOK-HOME}/sensen.html, Sending Some Mail: comp send} in the MH book.} is compiled with the @sc{berk} option (which many people abhor). If you find that MH will not allow you to redistribute a message that has been redistributed before, turn off this option. @@ -5121,7 +5159,7 @@ although it provides a handful of commands prefixed with @kbd{C-c C-m} to insert the directives so you don't need to remember the syntax of them. Remember: you can always add MH-style directives by hand@footnote{See the section -@uref{@value{MH-BOOK-HOME}/usimim.htm#SeMIMa, Sending MIME Mail} in +@uref{@value{MH-BOOK-HOME}/usimim.html#SeMIMa, Sending MIME Mail} in the MH book.}. @cindex MIME Meta Language (MML) @@ -5410,7 +5448,7 @@ If you're using MH-style directives, use @kbd{C-c C-e} (@code{mh-mh-to-mime}) instead of @kbd{C-c C-m C-m}. This runs the command @command{mhbuild} (@command{mhn}) on the message which expands the tags@footnote{See the section -@uref{@value{MH-BOOK-HOME}/usimim.htm#SeMIMa, Sending MIME Mail} in +@uref{@value{MH-BOOK-HOME}/usimim.html#SeMIMa, Sending MIME Mail} in the MH book.}. This action can be undone by running @kbd{C-c C-m C-u} (@code{mh-mh-to-mime-undo}), which works by reverting to a backup file. You are prompted to confirm this action, but you can avoid the @@ -5543,7 +5581,7 @@ The command @kbd{C-c C-w} (@code{mh-check-whom}) expands aliases so you can check the actual address(es) in the alias. A new buffer named @samp{*MH-E Recipients*} is created with the output of @command{whom} (@pxref{Miscellaneous})@footnote{See the section -@uref{@value{MH-BOOK-HOME}/senove.htm#WhaPro, What now? -- and the +@uref{@value{MH-BOOK-HOME}/senove.html#WhaPro, What now? -- and the whatnow Program} in the MH book.}. @node Sending Message, Killing Draft, Checking Recipients, Editing Drafts @@ -5577,7 +5615,7 @@ spelling in your message before sending, add the function @vindex mh-send-prog In case the MH @command{send} program@footnote{See the section -@uref{@value{MH-BOOK-HOME}/sensen.htm, Sending Some Mail: comp send} +@uref{@value{MH-BOOK-HOME}/sensen.html, Sending Some Mail: comp send} in the MH book.} is installed under a different name, use @code{mh-send-prog} to tell MH-E the name. @@ -5758,7 +5796,7 @@ Recipients}. MH-E loads aliases for completion and folder name hints from various places. It uses the MH command @command{ali}@footnote{See the section -@uref{@value{MH-BOOK-HOME}/mh.htm, MH Aliases} in the MH book.} to +@uref{@value{MH-BOOK-HOME}/mh.html, MH Aliases} in the MH book.} to read aliases from the files listed in the profile component @samp{Aliasfile:} as well as system-wide aliases (for example, @file{/etc/nmh/MailAliases}). @@ -6231,7 +6269,7 @@ contains these items. Dismiss the speedbar with @kbd{C-x 5 0} @cindex customization group, @samp{mh-speedbar} The MH-E speedbar uses the MH command @command{flists}@footnote{See -the section @uref{@value{MH-BOOK-HOME}/morseq.htm#flist, Searching for +the section @uref{@value{MH-BOOK-HOME}/morseq.html#flist, Searching for Sequences with flist} in the MH book.} to generate the list of folders. The @samp{mh-speedbar} customization group contains the following option which controls how often the speedbar calls @@ -6359,7 +6397,7 @@ Function called by the tool bar search button (default: Tool bar location (default: @samp{Same As Default Tool Bar}). @c ------------------------- @item mh-xemacs-use-tool-bar-flag -If on, use tool bar (default: on, if supported). +If @samp{on}, use tool bar (default: @samp{on}, if supported). @end vtable In GNU Emacs, icons for some of MH-E's functions are added to the tool @@ -6929,7 +6967,7 @@ mknmz -f /home/user/Mail/.namazu/mknmzrc -O /home/user/Mail/.namazu \ This search method does not require any setup. Read @command{pick}(1) or the section -@uref{@value{MH-BOOK-HOME}/finpic.htm, Finding Messages with pick} in +@uref{@value{MH-BOOK-HOME}/finpic.html, Finding Messages with pick} in the MH book to find out more about how to enter the criteria. @subsection grep @@ -7158,7 +7196,7 @@ 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 view@footnote{See @command{pick}(1) or the section -@uref{@value{MH-BOOK-HOME}/finpic.htm, Finding Messages with pick} in +@uref{@value{MH-BOOK-HOME}/finpic.html, Finding Messages with pick} in the MH book.}. @cindex @samp{tick} sequence @@ -7190,7 +7228,7 @@ command. Give this command a prefix argument to remove all limits. For the whole scoop on MH sequences, refer to @samp{mh-sequence}(5)@footnote{See the section -@uref{@value{MH-BOOK-HOME}/morseq.htm, More About Sequences} in the MH +@uref{@value{MH-BOOK-HOME}/morseq.html, More About Sequences} in the MH book.}. As you've read, several of the MH-E commands can operate on a sequence, which is a shorthand for a range or group of messages. For example, you might want to forward several messages to a friend or @@ -7430,7 +7468,7 @@ from the unseen sequence. With the exceptions of @kbd{S n} and @kbd{S w}, the underlying MH command dealing with sequences is @command{mark}@footnote{See the -section @uref{@value{MH-BOOK-HOME}/mmbwm.htm, Make Message Bookmarks +section @uref{@value{MH-BOOK-HOME}/mmbwm.html, Make Message Bookmarks with mark} in the MH book.}. @node Junk, Miscellaneous, Sequences, Top @@ -7502,7 +7540,7 @@ Spam program that MH-E should use (default: @samp{Auto-detect}). @cindex spam filters, Spamassassin @cindex spam filters, bogofilter -MH-E depends on @uref{http://www.spamassassin.org/, SpamAssassin}, +MH-E depends on @uref{http://spamassassin.apache.org/, SpamAssassin}, @uref{http://bogofilter.sourceforge.net/, bogofilter}, or @uref{http://spamprobe.sourceforge.net/, SpamProbe} to throw the dreck away. This chapter describes briefly how to configure these programs @@ -7537,12 +7575,20 @@ 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. +@cindex @samp{*MH-E Log*} +@cindex buffers, @samp{*MH-E Log*} +@findex call-process @vindex 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 -turning on the option @code{mh-junk-background}. +turning on the option @code{mh-junk-background}. @footnote{Note that +the option @code{mh-junk-background} is used as the @code{display} +argument in the call to @code{call-process}. Therefore, turning on +this option means setting its value to @samp{0}. You can also set its +value to @samp{t} to direct the programs' output to the @samp{*MH-E +Log*} buffer; this may be useful for debugging.} The following sections discuss the various counter-spam measures that MH-E can work with. @@ -7557,7 +7603,7 @@ MH-E can work with. SpamAssassin is one of the more popular spam filtering programs. Get it from your local distribution or from the -@uref{http://spamassassin.org/, SpamAssassin web site}. +@uref{http://spamassassin.apache.org/, SpamAssassin web site}. To use SpamAssassin, add the following recipes to @file{~/.procmailrc}: @@ -7568,6 +7614,7 @@ To use SpamAssassin, add the following recipes to @file{~/.procmailrc}: @cindex header field, @samp{X-Spam-Status:} @smallexample +PATH=$PATH:/usr/bin/mh MAILDIR=$HOME/`mhparam Path` # Fight spam with SpamAssassin. @@ -7690,6 +7737,7 @@ To use bogofilter, add the following recipes to @file{~/.procmailrc}: @cindex header field, @samp{X-Bogosity:} @smallexample +PATH=$PATH:/usr/bin/mh MAILDIR=$HOME/`mhparam Path` # Fight spam with Bogofilter. @@ -7742,6 +7790,7 @@ To use SpamProbe, add the following recipes to @file{~/.procmailrc}: @cindex header field, @samp{X-SpamProbe:} @smallexample +PATH=$PATH:/usr/bin/mh MAILDIR=$HOME/`mhparam Path` # Fight spam with SpamProbe. @@ -7781,6 +7830,7 @@ can't read. @cindex header field, @samp{Subject:} @smallexample +PATH=$PATH:/usr/bin/mh MAILDIR=$HOME/`mhparam Path` # @@ -8028,7 +8078,7 @@ Unless this variable contains an absolute pathname, it is assumed to be in the @code{mh-progs} directory (@pxref{Getting Started}). You may link another program to @command{scan} (see @samp{mh-profile}(5)) to produce a different type of listing@footnote{See the section -@uref{@value{MH-BOOK-HOME}/faswsprs.htm, Find and Specify with scan +@uref{@value{MH-BOOK-HOME}/faswsprs.html, Find and Specify with scan pick Ranges Sequences} in the MH book.}. @cindex regular expressions, scan line formats @@ -8065,7 +8115,7 @@ The first variable has to do with pruning out garbage. This regular expression describes a valid scan line. This is used to eliminate error messages that are occasionally produced by @command{inc}@footnote{See the section -@uref{@value{MH-BOOK-HOME}/reapre.htm, Reading Mail: inc show next +@uref{@value{MH-BOOK-HOME}/reapre.html, Reading Mail: inc show next prev} in the MH book.} or @command{scan} (default: @code{"^ *[0-9]"}). @end vtable @@ -8506,6 +8556,7 @@ to the GnuCash mailing list, substitute one to which you are subscribed. @smallexample +PATH=$PATH:/usr/bin/mh MAILDIR=$HOME/`mhparam Path` # Place mail sent to the GnuCash mailing list in gnucash.spool, where # Gnus will pick it up. @@ -8542,12 +8593,12 @@ I also point out some additional sources of information. @kindex M-x mh-version Bug reports should be filed at -@uref{https://sourceforge.net/bugs/?group_id=13357, SourceForge}. You -need to be a SourceForge user to submit bug reports, but this is easy -enough to do that it shouldn't be a restriction for you. Please -include the output of @kbd{M-x mh-version} (@pxref{Miscellaneous}) in -any bug report you send unless you're 110% positive we won't ask for -it. +@uref{https://sourceforge.net/tracker/?group_id=13357&atid=113357, +SourceForge}. You need to be a SourceForge user to submit bug reports, +but this is easy enough to do that it shouldn't be a restriction for +you. Please include the output of @kbd{M-x mh-version} +(@pxref{Miscellaneous}) in any bug report you send unless you're 110% +positive we won't ask for it. @node Mailing Lists, MH FAQ and Support, Bug Reports, Odds and Ends @appendixsec MH-E Mailing Lists @@ -8577,10 +8628,10 @@ itself which you will find useful. @cindex support You can find FAQs on MH-E at the -@uref{https://sourceforge.net/support/?group_id=13357, Support -Requests} page on SourceForge. If you don't find the answer to your -question, file a support request and your question will become a new -FAQ! +@uref{https://sourceforge.net/tracker/?group_id=13357&atid=213357, +Support Requests} page on SourceForge. If you don't find the answer to +your question, file a support request and your question will become a +new FAQ! @node Getting MH-E, , MH FAQ and Support, Odds and Ends @appendixsec Getting MH-E @@ -8606,6 +8657,12 @@ change log to see if you are interested in what the given release of MH-E has to offer (although we have no doubt that you will be extremely interested in all new releases). +@cindex Debian + +If you use Debian, you can install the Debian +@uref{http://packages.debian.org/unstable/mail/mh-e, mh-e package} +instead. + @cindex files, @samp{MH-E-NEWS} @cindex files, @samp{README} @cindex news @@ -9260,7 +9317,7 @@ software---to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by -the GNU Library General Public License instead.) You can apply it to +the GNU Lesser General Public License instead.) You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not @@ -9577,7 +9634,7 @@ the ``copyright'' line and a pointer to where the full notice is found. @smallexample @var{one line to give the program's name and an idea of what it does.} -Copyright (C) 19@var{yy} @var{name of author} +Copyright (C) @var{yyyy} @var{name of author} This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License @@ -9600,7 +9657,7 @@ If the program is interactive, make it output a short notice like this when it starts in an interactive mode: @smallexample -Gnomovision version 69, Copyright (C) 20@var{yy} @var{name of author} +Gnomovision version 69, Copyright (C) @var{yyyy} @var{name of author} Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' @@ -9632,7 +9689,7 @@ Ty Coon, President of Vice This General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the -library. If this is what you want to do, use the GNU Library General +library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. @node Key Index, Command Index, GPL, Top