* dbusbind.c (Fdbus_register_signal): Add match rule to
[emacs.git] / etc / MH-E-NEWS
blob2e93b5c3f42cad7654388b4f2ac05803cd0b7ded
1 * COPYRIGHT
3 Copyright (C) 2001-2011  Free Software Foundation, Inc.
4 See the end of the file for license conditions.
6 * Changes in MH-E 8.3
8 In 2010, the version control system (VCS) of Emacs was upgraded from
9 CVS to Bazaar. In 2011, the MH-E team followed suit and upgraded the
10 MH-E repository at SourceForge from CVS to Bazaar as well. The result
11 is version 8.3 of MH-E, which includes needed changes to the build
12 scripts.
14 Otherwise, this is a small release that includes mostly internal
15 changes from the Emacs team. One of these changes manifests itself in
16 the user interface--you can now complete folders with abbreviations,
17 meaning that `+f/b/b TAB' can complete to `+foo/bar/baz'.
19 Also, RFC 2047-encoded Subject header fields in replies are now
20 decoded.
22 It also fixes compilation warnings in XEmacs 21.5.31, as
23 well as an error when running XEmacs 21.5.31 in a terminal.
25 Another implication of the VCS change is that users who download MH-E
26 from SourceForge and explicitly load MH-E will have to be change their
27 `load-path' to "/path/to/mh-e/emacs/trunk/lisp/mh-e" instead. Note the
28 addition of "trunk."
30 This version of MH-E is packaged with GNU Emacs 24.1
32 ** Bug Fixes in MH-E 8.3
34 *** Make mh-showing a legitimate minor mode
36 The `mh-showing-mode' variable is now defined with `define-minor-mode'
37 (closes SF #482666).
41 * Changes in MH-E 8.2
43 Version 8.2 of MH-E appeared in GNU Emacs 23.1.  This is a small
44 release that includes internal changes from the Emacs team. A new
45 hook, `mh-pack-folder-hook', has been added.
47 There is a known bug where you can't attach attachments in Emacs 21.
48 This will be fixed in 8.2.1.
50 ** New Variables in MH-E 8.2
52 *** mh-pack-folder-hook
54 The `mh-pack-folder-hook' is run by `F p' (`mh-pack-folder') after
55 renumbering the messages. Hook functions can access the current folder
56 name with `mh-current-folder'.
58 ** Bug Fixes in MH-E 8.2
60 *** New version of mh-mm-save-part
62 Several functions have been updated with code from Gnus 5.11 (closes
63 SF #2235022).
67 * Changes in MH-E 8.1
69 Version 8.1 fixes some issues with forwarding messages, respects the
70 MH environment variable, adds the abilities to use aliases with GPG
71 and show HTML even though it is discouraged. A new hook,
72 `mh-annotate-msg-hook', has been added.
74 ** New Features in MH-E 8.1
76 *** Showing HTML When Text Is the Preferred Alternative
78 The `:' (`mh-show-preferred-alternative') function displays the
79 message with the default preferred alternative. This is as if
80 `mm-discouraged-alternatives' was set to nil (closes SF #1777321).
82 ** New Variables in MH-E 8.1
84 *** mh-annotate-msg-hook
86 The `mh-annotate-msg-hook' hook is run whenever a message is sent and
87 after the scan lines and message are annotated. Hook functions can
88 access the current folder name with `mh-current-folder' and obtain the
89 message numbers of the annotated messages with `mh-annotate-list'
90 (closes SF #2032269).
92 ** Bug Fixes in MH-E 8.1
94 *** Can't Use Aliases with GPG
96 GPG requires e-mail addresses, not aliases. So resolve aliases before
97 passing addresses to GPG/PGP (closes SF #649226).
99 *** mh-mml-forward-message: Disposition Should Be Inline
101 The `f' (`mh-forward') function now forwards messages as inline
102 attachments (closes SF #1378993).
104 *** Illegal Filename Characters on Windows Filesystems
106 The X-Image-URL cache created filenames with invalid characters on
107 Windows. This has been fixed with assistance from Darel Henman (closes
108 SF #1396499).
110 *** Make Many Header Fields Invisible
112 A vast landscape of header fields are now invisible. You may wish to
113 browse `mh-invisible-header-fields-default' and clean up your
114 `mh-invisible-header-fields' option. A permanent bug (SF #1916032) has
115 been created where you can submit header fields that should be
116 rendered invisible (closes SF #1701231).
118 *** mh-forward Includes Messages in Reverse Order
120 The `f' (`mh-forward') function now includes messages in ascending
121 order (closes SF #1730393).
123 *** Compile Fails on XEmacs 21.5 beta 28
125 This has been fixed with help from Henrique Martins (closes SF
126 #1749774).
128 *** Rename Variant mu-mh to gnu-mh
130 The GNU mailutils MH variant was named inconsistently. The variant has
131 been renamed to gnu-mh throughout. Thanks to Darel Henman (closes SF
132 #1768928).
134 *** Respect MH environment Variable
136 Even if the MH environment variable was set, an error was generated if
137 "~/.mh_profile" was missing. This has been fixed thanks to Xavier
138 Maillard (closes SF #1946861).
140 *** Enhance mh-mairix-regexp-builder
142 Additional items have been added to the Mairix search string in order
143 to support org-mode. Thanks to Nick Dokos (closes SF #1965704).
145 *** mh-mh-to-mime and mh-mh-to-mime-undo Reset Modes
147 The functions `mh-mh-to-mime' and `mh-mh-to-mime-undo' would reset the
148 buffer to fundamental mode. This has been fixed thanks to Sergey
149 Poznyakoff (closes SF #1966722).
153 * Changes in MH-E 8.0.3
155 Version 8.0.3 fixes errors in sending messages and in running spam
156 filter commands in certain circumstances.
158 ** Bug Fixes in MH-E 8.0.3
160 *** mh-send-args Cannot Be nil
162 If `mh-send-uses-spost-flag' was set, an error would prevent the
163 sending of messages. This has been fixed (closes SF #1564742).
165 *** Missing Quotes in sa-learn Command Line
167 This has been fixed (closes SF #1565460).
169 *** Errors Associated with mh-junk-background
171 The Spamassassin filter commands were used inconsistently and
172 incorrectly; if `mh-junk-background' were nil, not all of the updating
173 would happen correctly. In the other back-ends such as bogofilter and
174 SpamProbe, a value of t for `mh-junk-background' would cause the
175 commands associated with these filters to fail. These problems have
176 been fixed (closes SF #1594802).
180 * Changes in MH-E 8.0.2
182 Version 8.0.2 fixes the tool bar and `F n' on XEmacs, and `K a' on GNU
183 mailutils.
185 ** Bug Fixes in MH-E 8.0.2
187 *** Tool Bar Not Displayed in XEmacs
189 The MH-E tool bar didn't show up in XEmacs; now it does. Thanks to Ted
190 Phelps <phelps@gnusto.com> (closes SF #1506846).
192 *** mh-mime-save-parts Assumes -store Default
194 It was assumed that -store was the default for both mhn and mhstore.
195 This has been fixed by using -store except when using nmh. Thanks to
196 Sergey Poznyakoff <gray@Mirddin.farlep.net> (closes SF #1513140).
198 *** F-n Doesn't Work
200 The fix for SF #1499712 broke `F n' (`mh-index-new-messages') on
201 XEmacs since a regular expression that XEmacs could not handle was
202 added. This regexp has been fixed (closes SF #1514424).
206 * Changes in MH-E 8.0.1
208 Version 8.0.1 works around a couple of bugs in GNU mailutils, spost,
209 and Windows. MH-E now requires the use of version 1.0 of mailutils due
210 to a bug in the folder command.
212 ** Bug Fixes in MH-E 8.0.1
214 *** Infinite Loop When Searching (mailutils)
216 The GNU mailutils folder command displays output when a folder doesn't
217 exist. MH-E didn't expect this and responded with an infinite loop
218 during searches. While this bug has since been fixed in mailutils,
219 MH-E has been modified to work anyway (closes SF #1499712).
221 *** spost Doesn't Have -msgid or -mime Flags
223 The post replacement spost does not support the -msgid or -mime flags.
224 A new variable `mh-send-uses-spost-flag' was added to control the use
225 of these flags (closes SF #1486726).
227 *** <2> in Search Folders Illegal in Windows
229 The <2> suffix to the search folder names contain illegal filename
230 characters in Windows. These cause searches to fail on Windows. This
231 has been fixed by changing the suffix to -2 (closes SF #1507002).
235 * Changes in MH-E 8.0
237 Version 8.0 supports GNU mailutils, S/MIME, picons, which-func-mode,
238 sports an improved interface for hiding header fields, improves upon
239 the MH variant detection, improves folder completion, makes the pick
240 search equivalent to the other types of searches, spruces up the tool
241 bar, creates the correct MIME type when including OpenOffice
242 documents, works on a Mac, adds colors to buttons for signed or
243 encrypted messages, incorporates new features introduced in
244 Emacs 22.1, fixes a bunch of bugs, and best of all, comes with an
245 updated manual!
247 Internally, MH-E now sports a new software organization which will
248 help future maintainability. As a side-effect, the number of XEmacs
249 compilation warnings has plummeted from hundreds to just three. CVS
250 users will notice that MH-E has been migrated from the CVS repository
251 from SourceForge to Savannah (but only for those files that were
252 already part of Emacs). As a result, the location of MH-E in the
253 load-path has changed, and mh-e-autoloads.el was renamed to
254 mh-autoloads.el. See section INSTALL in the README for details. While
255 this migration will benefit maintainers, it will also benefit users:
256 CVS Emacs users will not have to check out MH-E separately and welcome
257 faster MH-E updates, and CVS MH-E users will welcome faster MH-E
258 updates from Emacs developers. Read section CVS MH-E INSTALL in the
259 README for details.
261 While not related to this release, the MH-E mailing lists are now
262 gatewayed at gmane.org (closes SF #979308).
264 If you want to see the release notes for the alpha and beta releases
265 leading up this release, please see:
267   http://cvs.savannah.gnu.org/viewvc/emacs/emacs/etc/MH-E-NEWS?revision=1.25&view=markup
271 ** New Features in MH-E 8.0
273 *** GNU mailutils Support
275 MH-E now supports GNU mailutils 0.4 and higher versions.
277 *** S/MIME Support
279 MH-E now supports S/MIME using Gnus 5.10.6 or higher.
281 *** Picon Support
283 In addition to the other methods of displaying an icon for the sender
284 of a message, MH-E can now display images from a picon directory. The
285 directory search path is found in the `mh-picon-directory-list'
286 variable. More documentation is found in the "facedb" sections in the
287 xfaces man page.
289 *** Catchup Command
291 There is a new `F c' (`mh-catchup') command that marks all unread
292 messages in the current folder as read.
294 *** Use which-func-mode to Display Folder in Index Mode
296 Turning on `which-func-mode' displays the folder name of the message
297 under the cursor in index folders (closes SF #855520).
299 *** Quick Key Help
301 The `?' (`mh-help') function now displays the help in its own buffer
302 called *MH-E Help* (closes SF #493740 and SF #656631).
304 *** Search Unification
306 The old `F s' behavior of adding messages to the search sequence has
307 been removed. The `F i' keybinding was deprecated and the new `F s'
308 (`mh-search') command is used to initiate either indexed or pick
309 searches. Within the MH-Search buffer (renamed from MH-Pick), the
310 command `C-c C-p' (`mh-pick-do-search') now runs pick on the given
311 folder recursively and displays the results in a search folder like
312 the other search methods (closes SF #829207).
314 *** Entry Points Have Moved
316 Emacs 21 users must now add `(require 'mh-autoloads)' because the
317 entry points (such as `mh-rmail' and `mh-smail') have moved to
318 different files which have made the autoloads that come with Emacs
319 inaccurate. This change was necessary because the code was reorganized
320 to remove circular dependencies, to make the code more stable and
321 maintainable, and to reduce the time to load MH-E.
323 *** MH-Folder Keymap Changes
325 There is now a keymap for the printing functions whose prefix is `P'.
326 The command `l' (`mh-print-msg') has been replaced with `P l' although
327 we suggest you use the new `P p' instead.
329 Key          7.4.4                         8.0
331 ;            -                             mh-toggle-mh-decode-mime-flag
332 l            mh-print-msg                  -
333 / f          mh-narrow-to-from             -
334 / r          mh-narrow-to-range            -
335 / g          -                             mh-narrow-to-range
336 / m          -                             mh-narrow-to-from
337 F c          -                             mh-catchup
338 F i          mh-index-search               -
339 F s          mh-search-folder              mh-search
340 K e          -                             mh-display-with-external-viewer
341 K t          -                             mh-toggle-mime-buttons
342 P ?          -                             mh-prefix-help
343 P C          -                             mh-ps-print-toggle-color
344 P F          -                             mh-ps-print-toggle-faces
345 P f          -                             mh-ps-print-msg-file
346 P l          -                             mh-print-msg
347 P p          -                             mh-ps-print-msg
349 *** MH-Letter Keymap Changes
351 The change where `mh-letter-mode' derives from `mail-mode' adds a few
352 keybindings. Some are interesting: experiment! Only the keybinding
353 changes for MH-E functions are listed here.
355 Most of the changes have to do with the renaming of the functions with
356 "mhn" in them to "mh" because nmh doesn't use `mhn'. The names were
357 also made consistent with the family of "mml" functions.
359 The type of signing or encryption has been generalized so the method
360 is now an option rather than a part of the function's name. The option
361 is `mh-mml-method-default' and choices include PGP (MIME), PGP,
362 S/MIME, or none.
364 Key          7.4.4                         8.0
366 C-c C-e      mh-edit-mhn                   mh-mh-to-mime
367 C-c RET C-e  mh-mml-secure-message-encrypt-pgpmime
368                                            mh-mml-secure-message-encrypt
369 C-c RET C-g  -                             mh-mh-compose-anon-ftp
370 C-c RET C-n  -                             mh-mml-unsecure-message
371 C-c RET C-s  mh-mml-secure-message-sign-pgpmime
372                                            mh-mml-secure-message-sign
373 C-c RET C-t  -                             mh-mh-compose-external-compressed-tar
374 C-c RET C-u  mh-revert-mhn-edit            mh-mh-to-mime-undo
375 C-c RET C-x  -                             mh-mh-compose-external-type
376 C-c RET e    mh-mml-secure-message-encrypt-pgpmime
377                                            Prefix Command
378 C-c RET e e  -                             mh-mml-secure-message-encrypt
379 C-c RET e s  -                             mh-mml-secure-message-signencrypt
380 C-c RET g    -                             mh-mh-compose-anon-ftp
381 C-c RET n    -                             mh-mml-unsecure-message
382 C-c RET s    -                             Prefix Command
383 C-c RET s e  -                             mh-mml-secure-message-signencrypt
384 C-c RET s s  -                             mh-mml-secure-message-sign
385 C-c RET t    -                             mh-mh-compose-external-compressed-tar
386 C-c RET u    mh-revert-mhn-edit            mh-mh-to-mime-undo
387 C-c RET x    -                             mh-mh-compose-external-type
389 C-c C-f C-a  -                             mh-to-field
390 C-c C-f C-l  -                             mh-to-field
391 C-c C-f RET  -                             mh-to-field
392 C-c C-f a    -                             mh-to-field
393 C-c C-f l    -                             mh-to-field
394 C-c C-f m    -                             mh-to-field
396 *** MH-Search Keymap Changes
398 These are the changes associated with the new search mode. The command
399 `C-c C-c' (`mh-index-do-search') now performs the standard indexed
400 search, while `C-c C-p' (`mh-pick-do-search') runs pick as before,
401 only better!
403 The `mh-to-field' keybindings were adjusted to be consistent with
404 those in the MH-Letter mode.
406 Key          7.4.4                         8.0
408 C-c C-c      mh-do-search                  mh-index-do-search
409 C-c C-f C-d  mh-to-field                   -
410 C-c C-f C-f  mh-to-field                   -
411 C-c C-f C-r  mh-to-field                   -
412 C-c C-f RET  -                             mh-to-field
413 C-c C-f d    mh-to-field                   -
414 C-c C-f f    mh-to-field                   -
415 C-c C-f m    -                             mh-to-field
416 C-c C-f r    mh-to-field                   -
417 C-c TAB      mh-index-do-search            -
419 *** Updates to X-Image-URL
421 Now support the use of `curl' and `fetch' as alternatives to `wget' to
422 obtain the image. The display of images are controlled with the
423 `mh-show-use-xface-flag' option while the `mh-fetch-x-image-url'
424 option controls how the images are fetched.
426 The default of `mh-fetch-x-image-url' has been changed to "Never
427 Fetch." Those of you who like the value of "Ask Before Fetching" will
428 have to customize this option (closes SF #831278).
430 WARNING: There are security concerns with this feature. Please read
431 the documentation for these options carefully before changing the
432 default.
434 *** Updates to mh-identity-list
436 Note that the field names found in `mh-identity-list' that refer to
437 the fields in `mh-identity-handlers' have changed in an incompatible
438 way from 7.4.4. In general, the symbolic names now have a ":" prefix
439 to avoid collisions with header fields. Before starting Emacs, edit
440 your .emacs and insert ":" before "signature" if you have defined it.
442 You can change your attribution in replies with the new "Attribution
443 Verb" field, and you can set your default GPG user ID with the "GPG
444 key ID" field.
446 Signatures can now be read from the `mh-signature-file-name' variable,
447 or come from a function, in addition to a named file. If you write
448 your own function, variables that you can use include
449 `mh-signature-separator-regexp', `mh-signature-separator',
450 and `mh-signature-separator-p'.
452 The handling of these fields has been moved into a new
453 `mh-identity-handlers' option, an alist of fields (strings) and
454 handlers (functions). Strings are lowercase. Use ":signature" for
455 Signature and ":pgg-default-user-id" for GPG Key ID. The function
456 associated with the string "default" is used if no other functions are
457 appropriate. For this reason, don't name a header field "Default".
459 If you point your signature at a vCard file with a vcf suffix, then it
460 will be incorporated as a vCard body part (closes SF #802723).
462 *** Updates to Speedbar
464 The speedbar now renders the folders with unseen messages in boldface
465 which makes them easier to identify (closes SF #623369).
467 *** Updates to mh-msg-is-in-seq
469 Can now specify an alternate message number to `S s'
470 (`mh-msg-is-in-seq') with a prefix argument.
472 *** Updates to mh-to-field-choices
474 In MH-Letter mode, you can use the `C-c C-f' (`mh-to-field') prefix to
475 go to and insert fields. The fields `Reply-To:', `Mail-Reply-To:',
476 `Mail-Followup-To:' can now be created via the `C-r', `C-a' (for
477 author), and `C-l' keys respectively. The key for the `From:' field
478 has been renamed from `C-r' to `C-m' for consistency with `mail-mode'
479 (closes SF #1400139).
481 *** Change Content-Type Renderer on the Fly in MH-Show Buffer
483 This has been implemented by adding the key binding `K e'
484 (`mh-display-with-external-viewer'). For inline text/html parts,
485 buttons aren't displayed by default. In that case use `K t'
486 (`mh-toggle-mime-buttons') to display the button before viewing it
487 with an external browser (closes SF #839318).
489 *** MH-E No Longer Calls install-mh
491 The new variant detection code makes use of `mhparam' which assumes
492 that your MH environment has already been set up. The code to call
493 `install-mh', which could no longer be run anyway, was removed.
495 *** Add :package-version Keyword to Options
497 This `defcustom', `defgroup', and `defface' keyword was introduced in
498 Emacs 22.1. MH-E has been extended to take advantage of it. With this
499 keyword, you can now use `M-x customize-changed-options' to see what
500 options in MH-E have changed between versions of Emacs. In a future
501 version of Emacs, you'll be able to see changes between MH-E versions
502 as well (closes SF #1452724).
504 *** Render Signature and vCard in Italics
506 This has been implemented.  Use `mh-show-signature-face' to customize
507 the face used (closes SF #802722).
509 *** Derive mh-letter-mode from mail-mode
511 MH-Letter mode is now derived from `mail-mode'. We were able to delete
512 a lot of code. In return, there are a few `mail-mode' commands that
513 are available that may or may not be useful and the `mail-mode-hook'
514 is run (closes SF #1385571).
516 *** Remove Emacs 20 Support
518 As it turns out, we had already added some code that didn't work on
519 Emacs 20. However, now we've formalized it and removed code that was
520 present solely for Emacs 20 support (closes SF #1359240).
522 *** Glimpse Support Removed
524 Since glimpse isn't free, we cannot mention it. Glimpse has been
525 removed from the option `mh-indexer-choices' (closes SF #831276).
527 *** Use run-hook-with-args
529 We use normal hooks whenever possible and do not use
530 `run-hook-with-args' (with one documented exception) (closes SF
531 #643702).
535 ** New Variables in MH-E 8.0
537 *** mh-after-commands-processed-hook
539 Hook run by `x' (`mh-execute-commands') after performing outstanding
540 refile and delete requests.
542 *** mh-alias-reloaded-hook
544 Invoked by `mh-alias-reload' after reloading aliases.
546 *** mh-auto-fields-prompt-flag
548 On means to prompt before sending if fields in `mh-auto-fields-list'
549 are inserted.
551 *** mh-before-commands-processed-hook
553 Renamed from `mh-folder-updated-hook'. It wasn't clear whether
554 `mh-folder-updated-hook' was run before or after the commands were
555 executed. We now provide both with clear names.
557 *** mh-compose-forward-as-mime-flag
559 On means that messages are forwarded as attachments (closes SF
560 #827203).
562 *** mh-default-folder-for-message-function
564 Function to select a default folder for refiling or `Fcc:'.
566 *** mh-forward-hook
568 Invoked on the forwarded letter by `f' (`mh-forward').
570 *** mh-highlight-citation-style
572 Renamed from `mh-highlight-citation-p' since it wasn't a boolean. The
573 new name is also more descriptive.
575 *** mh-identity-handlers
577 Handler functions for fields in `mh-identity-list'.
579 *** mh-insert-signature-hook
581 Renamed from `mh-letter-insert-signature-hook' since most of the other
582 hooks do not carry the mode in the prefix and because the new name is
583 equally clear.
585 *** mh-invisible-header-fields-default
587 List of hidden header fields. The header fields listed in this option
588 are hidden, although you can check off any field that you would like
589 to see. Header fields that you would like to hide that aren't listed
590 can be added to the `mh-invisible-header-fields' option (closes SF
591 #752045).
593 The option `mh-visible-header-fields' has been deleted.
595 *** mh-junk-background
597 If on, spam programs are run in background. This used to be the
598 default behavior but this could overwhelm a system if many messages
599 were black- or whitelisted at once. The spam programs are now run in
600 the foreground, but this option can be used to put them back in the
601 background.
603 *** mh-junk-disposition
605 Renamed from `mh-junk-mail-folder' since this variable can accept
606 values other than folder names.
608 *** mh-kill-folder-suppress-prompt-hooks
610 Renamed from `mh-kill-folder-suppress-prompt-hook'. By convention,
611 abnormal hooks, which this is, either have a -function or -hooks
612 suffix.
614 *** mh-mhl-format-file
616 Renamed from `mhl-formfile' to put it in the MH-E namespace and to be
617 consistent with other similar options.
619 *** mh-mh-to-mime-hook
621 Renamed from `mh-edit-mhn-hook'. We have a family of `mh-mml-to-mime'
622 functions and variables; the older mhn functions and variables were
623 renamed to have a consistent `mh-mh-to-mime' prefix.
625 *** mh-mml-method-default
627 Default method to use in security tags.
629 *** mh-new-messages-folders
631 Renamed from `mh-index-new-messages-folders' for clarity.
633 *** mh-path
635 Additional list of directories to search for MH.
637 *** mh-redist-full-contents-flag
639 On means the `dist' command needs entire letter for redistribution.
640 This was previously a variable. It's now an option.
642 *** mh-search-mode-hook
644 Renamed from `mh-pick-mode-hook' as part of the
645 `mh-index.el'/`mh-pick.el' merge into `mh-search.el'.
647 *** mh-search-program
649 Renamed from `mh-index-program' as part of the
650 `mh-index.el'/`mh-pick.el' merge into `mh-search.el'.
652 *** mh-signature-separator-flag
654 On means a signature separator should be inserted. It is not
655 recommended that you change this option since various mail user
656 agents, including MH-E, use the separator to present the signature
657 differently, and to suppress the signature when replying or yanking a
658 letter into a draft.
660 *** mh-sortm-args
662 Additional arguments for `sortm'. This was previously an internal
663 variable. It's now an user-customizable option.
665 *** mh-speed-update-interval
667 Renamed from `mh-speed-flists-interval' for clarity.
669 *** mh-ticked-messages-folders
671 Renamed from `mh-index-ticked-messages-folders' for clarity.
673 *** mh-variant
675 Specifies the variant used by MH-E. The default setting of this option
676 is `Auto-detect' which means that MH-E will automatically choose the
677 first of nmh, MH, or GNU mailutils that it finds in the directories
678 listed in `mh-path', `mh-sys-path', and `exec-path'. If, for example,
679 you have both nmh and mailutils installed and `mh-variant-in-use' was
680 initialized to nmh but you want to use mailutils, then you can set
681 this option to `mailutils'.
683 When this variable is changed, MH-E resets `mh-progs', `mh-lib',
684 `mh-lib-progs', `mh-flists-present-flag', and `mh-variant-in-use'
685 accordingly.
687 If you've set these variables in your .emacs, it is strongly suggested
688 that you comment them out. The MH detection code has been completely
689 rewritten and it is very likely that you no longer to set them and
690 their setting may confuse other MH-E settings.
692 *** mh-xemacs-tool-bar-position
694 Renamed from `mh-xemacs-toolbar-position' per GNU Emacs naming conventions.
696 *** mh-xemacs-use-tool-bar-flag
698 Renamed from `mh-xemacs-use-toolbar-flag' per GNU Emacs naming conventions.
700 *** mh-yank-behavior
702 Renamed from `mh-yank-from-start-of-msg' for clarity.
706 ** Variables Deleted in MH-E 8.0
708 *** mh-alias-system-aliases
710 System definitions should not be a user option.
712 *** mh-edit-mhn-hook
714 Renamed to `mh-mh-to-mime-hook'.
716 *** mh-folder-updated-hook
718 Renamed to `mh-before-commands-processed-hook'.
720 *** mh-highlight-citation-p
722 Renamed to `mh-highlight-citation-style'.
724 *** mh-index-new-messages-folders
726 Renamed to `mh-new-messages-folders'.
728 *** mh-index-program
730 Renamed to `mh-search-program'.
732 *** mh-index-ticked-messages-folders
734 Renamed to `mh-ticked-messages-folders'.
736 *** mh-junk-mail-folder
738 Since this variable can accept values other than folder names, it was
739 renamed to `mh-junk-disposition' to more accurately reflect the content.
741 *** mh-kill-folder-suppress-prompt-hook
743 Renamed to `mh-kill-folder-suppress-prompt-hooks'.
745 *** mh-letter-insert-signature-hook
747 Renamed to `mh-insert-signature-hook'.
749 *** mh-pick-mode-hook
751 Renamed to `mh-search-mode-hook'.
753 *** mh-show-use-goto-addr-flag
755 This flag was redundant with and inconsistent with
756 `goto-address-highlight-p' at the same time, so we removed it. Please
757 customize `goto-address-highlight-p' if you wish to turn off email
758 address and URL highlighting.
760 *** mh-speed-flists-interval
762 Renamed to `mh-speed-update-interval'.
764 *** mh-speed-run-flists-flag
766 Deleted since setting `mh-speed-flists-interval' to 0 accomplishes the
767 same thing.
769 *** mh-visible-header-fields
771 Deleted since it would hide new header fields you might want to see.
773 *** mh-xemacs-toolbar-position
775 Renamed to `mh-xemacs-tool-bar-position'.
777 *** mh-xemacs-use-toolbar-flag
779 Renamed to `mh-xemacs-use-tool-bar-flag'.
781 *** mh-yank-from-start-of-msg
783 Renamed to `mh-yank-behavior'.
785 *** mhl-formfile
787 Renamed to `mh-mhl-format-file'.
791 ** New Faces in MH-E 8.0
793 *** mh-folder-address
795 Renamed from `mh-folder-address-face' per new Emacs conventions.
797 *** mh-folder-body
799 Renamed from `mh-folder-body-face' per new Emacs conventions.
801 *** mh-folder-cur-msg-number
803 Renamed from `mh-folder-cur-msg-number-face' per new Emacs conventions.
805 *** mh-folder-date
807 Renamed from `mh-folder-date-face' per new Emacs conventions.
809 *** mh-folder-deleted
811 Renamed from `mh-folder-deleted-face' per new Emacs conventions.
813 *** mh-folder-followup
815 Renamed from `mh-folder-followup-face' per new Emacs conventions.
817 *** mh-folder-msg-number
819 Renamed from `mh-folder-msg-number-face' per new Emacs conventions.
821 *** mh-folder-refiled
823 Renamed from `mh-folder-refiled-face' per new Emacs conventions.
825 *** mh-folder-sent-to-me-hint
827 Fontification hint face in messages sent directly to us.
829 *** mh-folder-sent-to-me-sender
831 Sender face in messages sent directly to us.
833 *** mh-folder-subject
835 Renamed from `mh-folder-subject-face' per new Emacs conventions.
837 *** mh-folder-tick
839 Renamed from `mh-folder-tick-face' per new Emacs conventions.
841 *** mh-folder-to
843 Renamed from `mh-folder-to-face' per new Emacs conventions.
845 *** mh-letter-header-field
847 Renamed from `mh-letter-header-field-face' per new Emacs conventions.
849 *** mh-search-folder
851 Renamed from `mh-index-folder-face'.
853 *** mh-show-cc
855 Renamed from `mh-show-cc-face' per new Emacs conventions.
857 *** mh-show-date
859 Renamed from `mh-show--face' per new Emacs conventions.
861 *** mh-show-from
863 Renamed from `mh-show-from-face' per new Emacs conventions.
865 *** mh-show-header
867 Renamed from `mh-show-header-face' per new Emacs conventions.
869 *** mh-show-pgg-bad
871 Face used to highlight a bad PGG signature.
873 *** mh-show-pgg-good
875 Face used to highlight a good PGG signature.
877 *** mh-show-pgg-unknown
879 Face used to highlight a PGG signature whose status is unknown. This
880 face is also used for a signature when the signer is untrusted.
882 *** mh-show-signature
884 Face used to highlight the signature.
886 *** mh-show-subject
888 Renamed from `mh-show-subject-face' per new Emacs conventions.
890 *** mh-show-to
892 Renamed from `mh-show-to-face' per new Emacs conventions.
894 *** mh-show-xface
896 Renamed from `mh-show-xface-face' per new Emacs conventions.
898 *** mh-speedbar-folder
900 Renamed from `mh-speedbar-folder-face' per new Emacs conventions.
902 *** mh-speedbar-folder-with-unseen-messages
904 Renamed from `mh-speedbar-folder-with-unseen-messages-face' per new
905 Emacs conventions.
907 *** mh-speedbar-selected-folder
909 Renamed from `mh-speedbar-selected-folder-face' per new Emacs conventions.
911 *** mh-speedbar-selected-folder-with-unseen-messages
913 Renamed from `mh-speedbar-selected-folder-with-unseen-messages-face'
914 per new Emacs conventions. 
918 ** Faces Deleted in MH-E 8.0
920 *** mh-folder-address-face
922 Renamed to `mh-folder-address' per new Emacs conventions.
924 *** mh-folder-body-face
926 Renamed to `mh-folder-body' per new Emacs conventions.
928 *** mh-folder-cur-msg-face
930 Deleted. Not used.
932 *** mh-folder-cur-msg-number-face
934 Renamed to `mh-folder-cur-msg-number' per new Emacs conventions.
936 *** mh-folder-date-face
938 Renamed to `mh-folder-date' per new Emacs conventions.
940 *** mh-folder-deleted-face
942 Renamed to `mh-folder-deleted' per new Emacs conventions.
944 *** mh-folder-followup-face
946 Renamed to `mh-folder-followup' per new Emacs conventions.
948 *** mh-folder-msg-number-face
950 Renamed to `mh-folder-msg-number' per new Emacs conventions.
952 *** mh-folder-refiled-face
954 Renamed to `mh-folder-refiled' per new Emacs conventions.
956 *** mh-folder-subject-face
958 Renamed to `mh-folder-subject' per new Emacs conventions.
960 *** mh-folder-tick-face
962 Renamed to `mh-folder-tick' per new Emacs conventions.
964 *** mh-folder-to-face
966 Renamed to `mh-folder-to' per new Emacs conventions.
968 *** mh-index-folder-face
970 Renamed to `mh-search-folder'.
972 *** mh-letter-header-field-face
974 Renamed to `mh-letter-header-field' per new Emacs conventions.
976 *** mh-show-cc-face
978 Renamed to `mh-show-cc' per new Emacs conventions.
980 *** mh-show-date-face
982 Renamed to `mh-show-date' per new Emacs conventions.
984 *** mh-show-from-face
986 Renamed to `mh-show-from' per new Emacs conventions.
988 *** mh-show-header-face
990 Renamed to `mh-show-header' per new Emacs conventions.
992 *** mh-show-subject-face
994 Renamed to `mh-show-subject' per new Emacs conventions.
996 *** mh-show-to-face
998 Renamed to `mh-show-to' per new Emacs conventions.
1000 *** mh-show-xface-face
1002 Renamed to `mh-show-xface' per new Emacs conventions.
1004 *** mh-speedbar-folder-face
1006 Renamed to `mh-speedbar-folder' per new Emacs conventions.
1008 *** mh-speedbar-folder-with-unseen-messages-face
1010 Renamed to `mh-speedbar-folder-with-unseen-messages' per new Emacs conventions.
1012 *** mh-speedbar-selected-folder-face
1014 Renamed to `mh-speedbar-selected-folder' per new Emacs conventions.
1016 *** mh-speedbar-selected-folder-with-unseen-messages-face
1018 Renamed to `mh-speedbar-selected-folder-with-unseen-messages' per new
1019 Emacs conventions.
1023 ** Bug Fixes in MH-E 8.0
1025 *** Face Variable Names Now Follow Current Conventions
1027 The -face suffix has been dropped from all face names. 
1029 *** Swish Fixes
1031 Items in swish indexes that aren't mail messages are now handled more
1032 gracefully.
1034 *** Spamassassin Fixes
1036 If you use spamassassin, there was an error when you tried to junk
1037 mail if the option `mh-junk-background' was set. This has been fixed.
1039 *** Mairix Support
1041 Indexing now compatible with Mairix version 0.12 and later.
1043 *** mh-extract-rejected-mail Can't Do MIME (and Other Formats)
1045 Now handles qmail and exim bounces (addresses SF #404965).
1047 *** mh-rmail Hangs in XEmacs
1049 We've determined that MH-E is incompatible with some versions of
1050 XEmacs (21.5.9-21.5.16). More recent versions work fine. If you think
1051 our list is too broad, please let us know which version of XEmacs you
1052 are using (closes SF #644321).
1054 *** Completions Offered by mh-refile-message Are Not Sorted
1056 This behavior is no longer observed (closes SF #698734).
1058 *** Add Message-ID to Outgoing Messages
1060 If you replied to a message in your `+outbox', an `In-Reply-To:'
1061 header field was created that broke threading at the recipient's end.
1062 We now add a `Message-ID:' to outgoing messages which fixes this
1063 (closes SF #725425).
1065 *** Inconsistent Prompts
1067 Emacs changed their defaults in prompts from "Prompt: [value]" to
1068 "Prompt (default value): ". All MH-E prompts have been updated to
1069 comply with the new standard and are therefore now consistent
1070 throughout the application (closes SF #730470, SF #1275933).
1072 *** Empty Shell Comments Confuse mh-mhn-directive-present-p
1074 If you had a string that matched the regexp "^# $" in your draft, it
1075 would cause an error. This has been fixed (closes SF #762458).
1077 *** Quote Hashes When mhbuild Directives Used
1079 A related bug, if you had empty shell comments but inserted your own
1080 directives, you'd get another error from mhbuild. This has been fixed
1081 by quoting the hash ("^# $") like this "##" before submitting to
1082 mhbuild (closes SF #762464).
1084 *** Inconsistent Usage in Scan Formatting Variables
1086 The variables:
1088     mh-note-cur
1089     mh-note-deleted
1090     mh-note-dist
1091     mh-note-forw
1092     mh-note-refiled
1093     mh-note-repl
1094     mh-note-seq
1096 used to contain strings. Although only the first character was read,
1097 the entire string would be inserted which may have caused problems.
1098 These variables have been converted to character constants so that
1099 only a single character can be inserted into the scan line (closes SF
1100 #770772).
1102 *** Bad Handling of Aliases That Conflict With Local User Names
1104 If a user name existed both locally and in the aliases file, the local
1105 user would be flashed, but the alias would be used when sending. This
1106 has been fixed so that the user name that is flashed is the same as
1107 the name that is sent (closes SF #772595).
1109 *** Initialization Fails If ~/Mail Exists
1111 MH-E no longer calls `install-mh' so this issue has gone away (closes
1112 SF #835192).
1114 *** Not Re-prompted to Sign After Pass Phrase Typo
1116 If there were errors when sending a signed message (like getting the
1117 pass phrase wrong), the MML markup remained in the draft buffer. The
1118 draft buffer is now restored if there is an error (closes SF #839303).
1120 *** Font-lock Gets Confused in MH-Letter Buffer
1122 If a user manually moved the cursor to the end of the header field
1123 separator line (by mouse click or keyboard navigation) and hit Enter
1124 to start typing their message, any line in the body with a colon would
1125 be fontified with a gray background. This has been fixed (closes SF
1126 #855479).
1128 *** RETURN Causes Infinite Loop in mh-letter
1130 This behavior is no longer observed (closes SF #887346).
1132 *** mh-refile-msg Fails to Suggest Folder for Empty Message
1134 If you received a message with an empty body from someone who is
1135 listed in your aliases file, `o' (`mh-refile-msg') failed to suggest
1136 the correct folder. This has been fixed (closes SF #917096).
1138 *** Missing Headers When Replying to All
1140 User needed to edit `replgroupcomps' (closes SF #918194).
1142 *** Error Visiting Folder With no Unseen Messages
1144 If you visited a folder without unseen messages and the option "flist:
1145 -noshowzero" is present in your `~/.mh_profile', you'd get an error.
1146 This has been fixed (closes SF #933954).
1148 *** Error Message When Trying to Send Using MH-E
1150 This behavior is no longer observed (closes SF #1002103).
1152 *** mh-find-path Doesn't Use mhparam
1154 MH-E no longer peeks into the MH profile `~/.mh_profile' directly. It
1155 uses `mhparam' instead (closes SF #1016027).
1157 *** rmmproc Refile Complains No Such Message
1159 MH-E would get confused about which folder to delete messages from if
1160 you were refiling and deleting messages at the same time. This has
1161 been fixed (closes SF #1023959).
1163 *** auto-mode-alist Updated
1165 MH-E originally updated auto-mode-alist to set the major mode of
1166 drafts. Now that we explicitly set the mode, there is no reason to do
1167 this, and this behavior caused problems for people who didn't use MH-E
1168 who were editing files that looked like MH message files (closes SF
1169 #1032353).
1171 *** ! Doesn't Do Regions
1173 Now it does (closes SF #1046330).
1175 *** mh-show-unquote-From Fails (read-only buffer)
1177 MH-E quotes the `From ' header field that is inserted by MTAs.
1178 However, it was trying to do this in a read-only buffer. This has been
1179 fixed (closes SF #1089870).
1181 *** Whitespace in pick Expressions
1183 The `C-u / s RET' command now works. In addition, you can now add
1184 whitespace to any of the limiting (/) commands (closes SF #1122655).
1186 *** mh-index-previous-folder Does Not Work Correctly
1188 If your cursor was on an item below a folder heading and you used
1189 `M-TAB' (`mh-index-previous-folder'), you would move to the previous
1190 folder heading. This has been fixed (closes SF #1126188).
1192 *** Default Identity Prevents Insertion of Auto Fields
1194 Auto insertion of an identity now occurs even when the default
1195 identity is used (closes SF #1204506).
1197 *** mh-compose-forward and Default Message Number
1199 `mh-compose-forward' will now default to the sent message in the sent
1200 folder and the `cur' message in other folders. It also takes ranges of
1201 messages and can include multiple messages at a time (closes SF
1202 #1205890).
1204 *** Better Handling of Empty cur Sequence
1206 If you refiled a message into a folder and then used `F r'
1207 (`mh-rescan-folder') in that folder, your cursor would be taken to the
1208 first message. The cursor now stays where it was (closes SF #1207247).
1210 *** mh-customize Uses Group mh, Not mh-e
1212 The `mh' customization group alias has been deleted to avoid some
1213 problems that were found (closes SF #1213716).
1215 *** "Args out of range" Error in Displaying Message
1217 This behavior is no longer observed (closes SF #1227504).
1219 *** Front-and-back Truncation in mailto: Rendering
1221 This behavior is no longer observed (closes SF #1227510).
1223 *** Name of the Draft File in mh-comp.el
1225 MH is documented to use the draft file. If you use a draft file for
1226 something else (like Sylpheed), then use draft folders (closes SF
1227 #1231483).
1229 *** font-lock Error in mh-letter-mode
1231 An error in MH-E was introduced as a result of a change in CVS Emacs.
1232 This has been fixed (closes SF #1241017).
1234 *** Msg Display Broken After Displaying Msg with Inline Image
1236 Messages with inline images no longer trim certain message header
1237 fields (closes SF #1306141).
1239 *** mh-visit-folder Munges font-lock-keywords
1241 MH-E broke highlighting in Gnus buffers. This was actually a problem
1242 in CVS Emacs 22 and has been fixed there (closes SF #1393879).
1244 *** Illegal Filename Chars for W32 Filesystems
1246 Windows users who view `X-Image-URL:' images could not cache the
1247 images since the cached image file names had illegal characters. This
1248 has been fixed (closes SF #1396499).
1250 *** mh-send Doesn't Handle mml Insertions Via mail-user-agent
1252 Can now forward messages in Gnus if MH-E is your `mail-user-agent'
1253 (closes SF #1399307).
1255 *** Can't Narrow to Subject with Regexp Chars
1257 The command `/ s' could not limit subjects that had special pick
1258 characters (such as [, *, $, .). This has been fixed (closes SF
1259 #1432548).
1261 *** `/ s' Can Miss the Original Mail
1263 The command `/ s' failed to include the message with the "Re:" in the
1264 Subject. This has been fixed (closes SF #1438369).
1266 *** mhparam -components Fails on mailutils
1268 This error prevented MH-E from loading when using GNU mailutils. GNU
1269 mailutils drops the `s' in this argument, so we did too since
1270 -component still works in nmh and MH (closes SF #1446985).
1272 *** `/ s' Still Has Problems With []'d Mail
1274 On XEmacs, subjects that had special characters would prevent `/ s'
1275 from narrowing to the given subject. These characters are now quoted
1276 correctly in XEmacs (closes SF #1447598).
1278 *** Variable mh-send-args Is a String, Not a List
1280 This was causing errors when sending under GNU mailutils. The internal
1281 variable `mh-send-args' is now a list which fixes the problem (closes
1282 SF #1448604).
1284 *** Update Icons
1286 Most of the tool bar icons have been replaced by GTK or GNOME 2 icons
1287 (closes SF #1452715).
1289 *** Strip Build Number From emacs-version in X-Mailer
1291 This has been done (closes SF #1466481).
1293 *** Rename Function and Variable Definers
1295 If you had ever shown help for an MH-E symbol that was both a function
1296 or variable, you might have found that the hyperlink to the file
1297 brought you to the wrong definition. This has been fixed by renaming
1298 the macros `mh-defgroup', `mh-defcustom', `mh-defface',
1299 `mh-defun-compat', and `mh-defmacro-compat' to `defgroup-mh',
1300 `defcustom-mh', `defface-mh', `defun-mh', `defmacro-mh' respectively
1301 (closes SF #1472029).
1303 *** mh-insert-letter Uses Wrong Default
1305 If you had used `C-c TAB' (`mh-insert-letter') to insert a letter into
1306 your draft, specified a different folder, and chose the default
1307 message number, you got the wrong message. This has been fixed (closes
1308 SF #1473729).
1312 * Changes in MH-E 7.4.4
1314 Version 7.4.4 addresses programmatic issues from the FSF and prepares
1315 MH-E for inclusion into an impending GNU Emacs release (22.1). There
1316 are no user-visible changes (unless you are using XEmacs on DOS or
1317 don't have the cl package installed). Filenames are now unique in
1318 their first 8 characters (DOS 8.3 requirement). The runtime dependency
1319 on the cl package has been removed. Desktop saving and restoration
1320 code moved here from desktop.el.
1322 * Changes in MH-E 7.4.3
1324 Version 7.4.3 fixes the problem where `mh-identity-list' was not getting
1325 set from .emacs.
1327 * Changes in MH-E 7.4.2
1329 Version 7.4.2 fixes the accidental dependence on nmh (closes SF
1330 #791021).
1332 * Changes in MH-E 7.4.1
1334 Version 7.4.1 fixes the Makefile so it no longer tries to compile
1335 mh-unit.el.
1337 * Changes in MH-E 7.4
1339 Version 7.4 contains many new useful features including arbitrary MH
1340 range handling, new draft features such as draft form editing, as well
1341 as sequence propagation and manipulation. We've also fixed bugs and
1342 added a handful of new variables.
1344 ** New Features in MH-E 7.4
1346 *** Add Arbitrary Ranges to MH-E UI
1348 MH-E now handles any legal MH range (such as last:5 or 4 8 10-12)
1349 wherever you're prompted for a message number or sequence (closes SF
1350 #728638).
1352 *** Remove Prompting in mh-send
1354 Brian Reid's original mhe didn't do prompting anywhere but used forms
1355 instead. While we won't go that far, we eliminated prompting where a
1356 form is already involved, such as in composing a message.
1358 The new customization variable `mh-compose-prompt-flag' can be set to
1359 t to get the original behavior (closes SF #745622).
1361 *** Use TAB to Switch Fields in Header
1363 When composing a message, TAB and SHIFT-TAB can be used to move
1364 quickly between header fields. The new customization variable,
1365 `mh-compose-skipped-header-fields', contains a list of header fields
1366 that are skipped and truncated if they are too long (closes SF
1367 #745627).
1369 *** Alias Completion in Composition Buffer
1371 Aliases can be completed in the draft with "M-TAB
1372 (mh-letter-complete)". Or, if the customization variable
1373 `mh-compose-space-does-completion-flag' is set to t, then a "SPC
1374 (mh-letter-complete-or-space)" with do the same thing. If
1375 `mh-alias-flash-on-comma' is non-nil, ", (mh-letter-confirm-address)"
1376 will show the alias expansion in the minibuffer (closes SF #745634).
1378 *** Auto Fields Should be Inserted During Send
1380 Fields that were inserted by the multiple personality code when the
1381 draft was sent now insert the header fields when the draft is composed
1382 to give you a chance to edit them (closes SF #747890).
1384 *** mh-index-tick-messages
1386 The command "F ' (mh-index-ticked-messages)" creates a buffer with all
1387 messages ticked with "' (mh-toggle-tick)" in the folders listed in the
1388 new customization variable `mh-index-ticked-messages-folders'. Chances
1389 are that if you set `mh-index-new-messages-folders', you'll want to
1390 set `mh-index-ticked-messages-folders' accordingly.
1392 In addition, a general function, "F q (mh-index-sequenced-messages)"
1393 has been provided that displays messages in the `mh-unseen-seq' in the
1394 folders listed `mh-index-new-messages-folders', unless a prefix
1395 argument is given, in which case you can provide both a list of
1396 folders and a sequence (closes SF #718833).
1398 *** Narrow to Region
1400 If there is a region, "/ r (mh-narrow-to-range)" will only consider
1401 those messages in the region. In addition, there is now a stack of
1402 folder limits which can be popped with "/ w (mh-widen)". With a prefix
1403 arg, all the restrictions are popped off of the stack (closes SF
1404 #732823).
1406 *** Narrow to Ticked Sequence
1408 The buffer can now be narrowed to ticked messages with "S '
1409 (mh-narrow-to-tick)" (closes SF #732825).
1411 *** Display Multiple Buttons for multipart/alternative
1413 A new customizable variable,
1414 `mh-display-buttons-for-alternatives-flag', was added to display
1415 buttons for the alternatives. The default value is nil to retain the
1416 current behavior (closes SF #741288).
1418 *** Identity Menu Changes
1420 A menu item has been added that inserts custom fields if the To or Cc
1421 header fields match `mh-auto-fields-list'.
1423 ** New Variables in MH-E 7.4
1425 *** mh-alias-local-users-prefix
1427 This string is prepended to the real names of users from the passwd
1428 file. If nil, use the username string unmodified instead of the real
1429 name from the gecos field of the passwd file.
1431 *** mh-alias-passwd-gecos-comma-separator-flag
1433 Non-nil means the gecos field in the passwd file uses comma as a
1434 separator. Used to construct aliases for users in the passwd file."
1436 *** mh-interpret-number-as-range-flag
1438 Non-nil means interpret a number as a range. If the variable is
1439 non-nil, and you use an integer, N, when asked for a range to scan,
1440 then MH-E uses the range "last:N".
1442 *** mh-kill-folder-suppress-prompt-hook
1444 This new hook is invoked at the beginning of the `F k
1445 (mh-kill-folder)' command. It is a list of functions to be called,
1446 with no arguments, which should return a value of non-nil if you
1447 should not be asked if you're sure that you want to remove the folder.
1448 This is useful for folders that are easily regenerated.
1450 The default value of `mh-index-p' suppresses the prompt on folders
1451 generated by an index search.
1453 WARNING: Use this hook with care. If there is a bug in your hook which
1454 returns t on +inbox and you hit `F k' by accident in the +inbox
1455 buffer, you will not be happy.
1457 *** mh-refile-preserves-sequences-flag
1459 Non-nil means that sequences are preserved when messages are refiled.
1460 If this variable is non-nil and a message belonging to a sequence
1461 other than cur or Previous-Sequence (see mh-profile 5) is refiled then
1462 it is put in the same sequence in the destination folder. Additional
1463 sequences that should not to be preserved can be specified by setting
1464 `mh-unpropagated-sequences' appropriately.
1466 *** mh-visible-header-fields
1468 Customize this instead of `mh-visible-headers', which is now a defvar.
1469 This was done to mimic the relationship between
1470 `mh-invisible-header-fields' and `mh-invisible-fields'.
1472 ** Variables Deleted in MH-E 7.4
1474 *** mh-visible-headers
1476 See the paragraph for `mh-visible-header-fields' above.
1478 ** Bug Fixes in MH-E 7.4
1480 *** Aliases Constantly Reloaded
1482 The system aliases are not loaded as often as they were, so the
1483 completion speed has been dramatically improved if your passwd file is
1484 large (closes SF #693859).
1486 *** Folders in MH-Index View Not Saved
1488 When you perform a search to produce an MH-Index buffer, the folders
1489 that contain the messages are shown. If the MH-Index buffer was
1490 deleted, or Emacs was restarted and the corresponding folder
1491 rescanned, the folder information would be lost. This has been fixed
1492 by saving the information in a file called ".mhe_index" (closes SF
1493 #701762).
1495 *** Ticking Messages in +mhe-index/new
1497 If a new message in a buffer created by "F n" was ticked (with "'"),
1498 the message would not be added to the tick sequence in the source
1499 folder. This has been fixed so that any sequence changes in any index
1500 folder (from within MH-E of course) are now reflected back to the
1501 corresponding source folder (closes SF #709664).
1503 *** Custom Vars Set by a Function
1505 The default setting of customization variable `mh-summary-height' is
1506 now `nil' which means MH-E will change the size dynamically according
1507 to the size of the frame (closes SF #723267).
1509 *** Folder Completion Slow
1511 The first folder completion was very slow. This has been fixed (closes
1512 SF #730426).
1514 *** Tick Sequence Persistent When Refiled
1516 Sequences are now preserved when messages are refiled (closes SF
1517 #737128).
1519 *** Auto-inserted Header Fields Inconsistent
1521 For consistency, all automatically inserted header fields (such as
1522 X-Mailer and X-Face) are added when the draft is first presented to
1523 you. This also gives you a chance to edit or delete them if necessary
1524 (closes SF #745624). Note that we would be distressed if you deleted
1525 the X-Mailer field.
1527 *** Toolbar Spec Error
1529 The following message appeared when displaying a message in XEmacs:
1531   Signaling: (error "Toolbar spec must be list or nil" )
1533 This has been fixed (closes SF #745655).
1535 *** mh-index-search Doesn't Find Short Acronyms
1537 Swish typically ignores words with fewer than four letters, but will
1538 still look for acronyms. Unfortunately, MH-E was downcasing the input
1539 words which defeated this feature. This has been fixed (closes SF
1540 #755718).
1544 * Changes in MH-E 7.3
1546 This release includes the new features of an index view of unseen
1547 messages in all folders, spam software support, relative folder
1548 specification @ support, marking messages, recipient handling by
1549 mh-default-folder-list, Face and X-Image-URL header field support, and
1550 Fcc completion. Function arguments have been unified. Bugs have been
1551 fixed.
1553 ** New Features in MH-E 7.3
1555 *** Unified Function Arguments
1557 Any function with MSG-OR-SEQ in its docstring uses the displayed
1558 message by default for this argument. However, if a prefix argument is
1559 provided, then the user is prompted for a message sequence. If the
1560 variable `transient-mark-mode' is non-nil and the mark is active, then
1561 the function operates on the messages in the selected region. In a
1562 program, MSG-OR-SEQ can be a message number, a list of message
1563 numbers, a region in a cons cell, or a sequence.
1565 *** MH-Index View of Unseen Messages
1567 Use "F n (mh-index-new-messages)" or Folder -> View New Messages menu
1568 item to display messages in the `mh-unseen-seq' sequence in folders
1569 specified by `mh-index-new-messages-folders'. With a prefix argument,
1570 enter a space-separated list of folders, or nothing to search all
1571 folders.
1573 Like other MH-Index folders, use "v (mh-index-visit-folder)" if you
1574 wish to visit the original folder with the unseen message. This is
1575 usually not necessary since the original message is annotated if you
1576 reply, deleted if you delete the message, or refiled if you refile the
1577 message (closes SF #701756).
1579 *** Spam Software Support
1581 MH-E now supports several spam filters including Bogofilter,
1582 SpamProbe, and SpamAssassin. Spam that is mistakenly considered to be
1583 good mail can be reclassified as spam with "J b (mh-junk-blacklist)".
1584 Conversely, good mail that is accidently considered to be spam can be
1585 reclassified with "J w (mh-junk-whitelist)" (closes SF #669518).
1587 If a message is blacklisted, and `mh-junk-mail-folder' is a string,
1588 then the message is refiled to that folder. If this variable is nil,
1589 the message is deleted. If a message is whitelisted, then the message
1590 is refiled to `mh-inbox'.
1592 To change the spam program being used, customize `mh-junk-program'.
1593 This should only be necessary if you have multiple filters on your
1594 system and MH-E picked the wrong one. These customization variables
1595 are found in the new customization group `mh-junk'.
1597 The documentation for the following functions describes what setup is
1598 needed for the different spam fighting programs:
1600   - `mh-bogofilter-blacklist'
1601   - `mh-spamprobe-blacklist'
1602   - `mh-spamassassin-blacklist'
1604 *** Relative Folder Specification @ Supported
1606 You can now use the relative folder marker @ in folder names (closes
1607 SF #666774).
1609 *** Marking Messages
1611 Messages can now be highlighted with "' (mh-toggle-tick)", Sequence ->
1612 Toggle Tick Mark menu item or the "Toggle tick mark" button. These
1613 messages are added to the "tick" sequence, although this sequence can
1614 be changed in `mh-tick-seq'. The highlighting effect can be modified
1615 by customizing `mh-folder-tick-face' (closes SF #623367).
1617 There is also a new keybinding "/ ' (mh-narrow-to-tick)" and menu item
1618 Sequence -> Narrow to Tick Sequence to narrow the view to the
1619 highlighted messages.
1621 *** mh-default-folder-list Now Takes Recipients
1623 If you wish to file a message based upon the recipient of a message
1624 (such as a mailing list), you can now indicate that when filling out
1625 the address in the `mh-default-folder-list' customization variable.
1627 *** Face Header Field Supported
1629 In addition to the X-Face header field, the Face header field, which
1630 can display color images, is now supported. As a bonus, the external
1631 xface-e21 library is no longer required.
1633 *** X-Image-URL Support
1635 Images specified in X-Image-URL header fields are now supported.
1636 See the customization variable `mh-fetch-x-image-url' to enable this
1637 support.
1639 *** Fcc Completion
1641 Folders in Fcc fields in message drafts can now be completed with
1642 M-TAB.
1644 ** New Variables in MH-E 7.3
1646 Variables that have been added to MH-E that have not been discussed
1647 elsewhere are listed here.
1649 *** mh-auto-fields-list
1651 Alist of addresses for which header lines are automatically inserted.
1652 When a regular expression matches in the To or cc fields of a message,
1653 the corresponding header field is automatically inserted in the
1654 message header. It also allows the automatic setting of an identity
1655 (using `mh-insert-identity') to set an alternate identity when sending
1656 messages to a certain person or mailing list.
1658 Since this is a more general use of `mh-insert-mail-followup-to-flag'
1659 and `mh-insert-mail-followup-to-list', these variables have been removed.
1661 *** mh-show-xface-face
1663 Face for displaying the X-Face image.
1665 *** mh-xemacs-toolbar-position
1667 This customization variable allows the user to place the toolbar on
1668 the four edges of the frame.
1670 *** mh-xemacs-use-toolbar-flag
1672 This customization variable is used to enable or disable the toolbar
1673 under XEmacs.
1675 ** Variables Deleted in MH-E 7.3
1677 Variables that have been removed from MH-E that have not been
1678 discussed elsewhere are listed here.
1680 *** mh-decode-content-transfer-encoded-message-flag
1682 No longer needed since the external program mimencode is no longer
1683 used.
1685 *** mh-index-show-hook
1687 This hook was never used, so it was removed.
1689 *** mh-tool-bar-reply-3-buttons-flag
1691 Obsolete. This functionality is present `mh-tool-bar-folder-buttons'.
1693 ** Bug Fixes in MH-E 7.3
1695 *** Can't Refile Message
1697 Messages with invalid addresses were causing errors in ali which
1698 prevented the refiling of messages. The ali error is now shown in the
1699 "*MH-E Log*" buffer and refiling suggests the last folder used (closes
1700 SF #680388).
1702 *** Empty Body Triggers Duped Header
1704 If the body was empty the header would be treated like the body and
1705 was therefore displayed twice. This has been fixed (closes SF
1706 #681162).
1708 *** mml or mhl Directives Not Always Processed
1710 The mml and mhl directives used to create body parts were not
1711 processed if one re-edited a draft, or if they added the directives
1712 manually. The directives are now always processed upon sending the
1713 letter. You may still, of course, use "C-c C-m m (mh-mml-to-mime)" or
1714 "C-c C-e (mh-edit-mhn)" to manually create the MIME body parts from
1715 the directives and then send the draft.
1717 *** mh-alias-grab-from-field Fails
1719 MH-E was adding aliases with angle brackets around the address when
1720 there wasn't a phrase (usually, the user's name), to go with it. This
1721 caused ali to fail which caused problems in MH-E. This is probably a
1722 bug in ali, but MH-E no longer inserts angle brackets around the
1723 address unless there is a phrase, which avoids the problem (closes SF
1724 #690216).
1726 *** XEmacs Fixes
1728 MH-E is now fully supported under XEmacs and compiles without any
1729 warnings.
1731 In particular, the following now work under XEmacs:
1733 - X-Face, Face, and X-Image-URL header fields
1734 - MH-E logo in mode line
1735 - Emphasis (bold, italics, etc.)
1736 - Smilies
1737 - Toolbar
1739 *** Indexed Folders Should Respect mh-show-threads-flag
1741 Indexed folders are now threaded if `mh-show-threads-flag' is non-nil
1742 (closes SF #709667).
1744 *** Threading Index View Loses Folder Info
1746 This has been fixed (closes SF #709672).
1748 *** No Undo Information When Re-editing Drafts
1750 Undo is turned on in the draft buffer when using "e (mh-edit-again)"
1751 (closes SF #712777).
1753 *** Forwarded base64-encoded Messages Are Incorrectly Displayed
1755 This has been fixed (closes SF #681518).
1757 *** Append to *MH-E Log* Buffer
1759 The last 100 lines of log messages are kept in the *MH-E Log* buffer.
1760 Previously, the buffer was erased every time it was written (closes SF
1761 #685476). In addition, many of the MH-E commands now send their output
1762 into this buffer instead of a plethora of other special-purpose
1763 buffers.
1765 *** mh-inc-folder Complains if No Mail and No Current Message
1767 The function `mh-inc-folder' no longer calls `mh-show' if point is not
1768 on a valid scan line. This keeps `mh-inc-folder' from complaining
1769 (closes SF #678115).
1771 *** Folder Normalization Strips Leading Slash
1773 Leading "/" characters in folder names entered by the user were being
1774 lost. This has been fixed (closes SF #676890).
1776 *** Print Header Doesn't Show Message
1778 When printing a sequence, the header simply indicated that a sequence,
1779 but not which one, was being printed and did not show the message
1780 number. This has been fixed. If more than one message is printed, a
1781 page of the scan lines is printed and its header indicates the
1782 sequence or message range. The pages with the actual messages all set
1783 the header to the folder and message displayed on that page.
1785 *** Aliases Constantly Reloaded
1787 Empty lists are now handled properly (closes SF #693859).
1789 *** Remove RCS Keywords
1791 Removed RCS keywords per Emacs conventions (closes SF #680731).
1793 *** Replace Mimencode
1795 MH-E was enhanced to decode message based on charset and
1796 Content-Transfer-Encoding. This eliminates the need for the external
1797 program mimencode (closes SF #674857).
1801 * Changes in MH-E 7.2
1803 This release includes the new features of filing hints, hierarchical
1804 file name completion, indexed search and pick integration, unification
1805 between `mh-visit-folder' and the speedbar, a displayed message
1806 indicator, buffer name organization, support for mairix indexed
1807 search, and last but not least, the MH-E logo has been added to the
1808 mode line. Code that handles sequences and message regions runs
1809 faster. Bugs have been fixed.
1811 ** New Features in MH-E 7.2
1813 *** Filing Hints
1815 When you file a message, MH-E now looks for an alias corresponding to
1816 the address of the sender and offers that as a default folder (closes
1817 SF #657096). The new variable `mh-default-folder-prefix' can be used
1818 to put these folders in a sub-folder. The new variable
1819 `mh-default-folder-must-exist-flag' means to suppress the suggested
1820 folder (thereby providing the previous folder used) if the folder
1821 doesn't already exist. The new variable `mh-default-folder-list' can
1822 be used to map additional addresses and folders.
1824 *** Hierarchical File Name Completion
1826 When you completed filenames in the past, you were presented with a
1827 list of all your folders at all depths in the tree. Now you are
1828 presented with only one level at a time (closes SF #664821).
1829 As a result, the variables `mh-auto-folder-collect-flag' and
1830 `mh-folder-list-change-hook' are obsolete.
1832 *** Indexed Search and Pick Integration
1834 The indexed and pick searches have been integrated (closes SF
1835 #664816). Both "F s (mh-search-folder)" and "F i (mh-index-search)"
1836 use the pick template for forming queries. To submit the query, use
1837 "C-c C-c (mh-do-search)" which will use the query method you selected.
1838 If you change your mind while forming the query, you can use "C-c C-i
1839 (mh-index-do-search)" or "C-c C-p (mh-pick-do-search)" to submit the
1840 query using the respective method.
1842 Second, the results from a pick search are now saved in a sub-folder
1843 of +mhe-index like an indexed search.
1845 Third, `pick' is now a valid choice for `mh-index-program'.
1847 *** mh-visit-folder Metamorphosis Continues
1849 When visiting a folder from the speedbar, only the unseen messages are
1850 shown if there are unseen messages. If there aren't any unseen
1851 messages, all of the messages are shown if there are fewer than
1852 `mh-large-folder' messages; otherwise, the user is prompted for the
1853 range of messages to display. The "F v (mh-visit-folder)" command has
1854 been modified to mimic this behavior. Use a prefix arg to force the
1855 message range prompt.
1857 *** Displayed Message Indicator
1859 In graphical Emacs, the message that is shown is marked by a triangle
1860 in the fringe. In textual Emacs, there is a ">" in the first column
1861 (closes SF #664824).
1863 *** Buffer Name Organization
1865 All ephemeral buffer names start with " *mh" while all interesting
1866 buffers start with "*MH-E ". The "*Folders*", "*Sequences*", and
1867 "*Recipients*" buffers were therefore renamed to "*MH-E Folders*",
1868 "*MH-E Sequences*" and "*MH-E Recipients*" respectively (programmers
1869 should see mh-utils.el for the names of the new constants). Also, the
1870 output of MH commands is saved in the "*MH-E Log*" buffer.
1872 *** mh-index-program
1874 Add choices for `mairix' and `pick'.
1876 *** Logo Displayed on Mode Line
1878 ** New Variables in MH-E 7.2
1880 The new variables have been discussed elsewhere.
1882 ** Bug Fixes in MH-E 7.2
1884 *** mh-decode-content-transfer-encoded-message
1886 Messages that had been encoded with base64 were not decoded. This has
1887 been fixed with this new function (closes SF #674190). As a result,
1888 the variable `mh-decode-quoted-printable-flag' has been renamed to
1889 `mh-decode-content-transfer-encoded-message-flag'.
1891 *** mh-kill-folder
1893 Now restores previous window configuration (closes SF #664828).
1895 *** mh-mime-display
1897 MH-E was not using the charset defined in the content-type
1898 header. This meant that mail in a different charset would not
1899 be properly displayed. This has been fixed (closes SF #655123).
1901 *** mh-read-address
1903 In XEmacs and Emacs20, this function would always prompt using "To: "
1904 instead of using the command argument. This has been fixed (closes SF
1905 #670913).
1907 *** mh-rmail
1909 Unseen messages are now shown in addition to new ones (closes SF
1910 #667542).
1912 *** mh-scan-msg-overflow-regexp
1914 Change the variable so that a space is always maintained in the
1915 beginning of the scan line.
1917 *** mh-swish-execute-search
1919 The example configuration file in the docstring didn't show the
1920 backslash in the FileRules filename. If the example had been used
1921 literally by the user, no files would be indexed! This has been fixed
1922 (closes SF #665888).
1924 *** mh-thread-refile
1926 The "T o (mh-thread-refile)" command did not provide refiling hints
1927 like `mh-refile-msg'. This has been fixed (closes SF #664829).
1929 *** mh-toggle-threads
1931 If the threaded view was modified and then toggled, the standard view
1932 may not have been accurate (as it contained a potentially old first
1933 message to last message range). This has been fixed (closes SF
1934 #626117).
1936 *** mh-tool-bar-show-set, mh-tool-bar-letter-set, mh-tool-bar-folder-set
1938 Clicking the customize and help buttons now deletes the other windows
1939 in the frame.
1941 *** mh-version
1943 The "M-x mh-version" command displayed "Aliasfile: aliases". This has
1944 been fixed (closes SF #664467). See Buffer Name Organization above.
1948 * Changes in MH-E 7.1
1950 This release includes the new features of multiple identities and
1951 alias completion. In addition, indexed searching has been revamped.
1952 Various other features have been added and a few bugs were fixed.
1954 ** New Features in MH-E 7.1
1956 *** Multiple Identities
1958 MH-E now supports multiple identities (closes SF #628782). That means
1959 that you can have different From and Organization header fields (or
1960 any other header field of your choice) as well as different signatures
1961 depending on your context. Usually, the contexts are home and work.
1963 Add your identities to the variable `mh-identity-list' and set the
1964 default identity with the variable `mh-identity-default'. Your
1965 identity can be switched on the fly by using the Identity menu or by
1966 calling "M-x mh-insert-identity RET".
1968 This functionality can be customized within the mh-identity group.
1970 *** Alias Completion and Harvesting
1972 The contributed file mh-alias.el has been rewritten and incorporated
1973 into MH-E.
1975 By default, aliases are culled from the system files
1976 "/etc/nmh/MailAliases," "/usr/lib/mh/MailAliases," and "/etc/passwd"
1977 (see `mh-alias-system-aliases') and from your "AliasFile" MH profile
1978 component. These aliases are then used for completion in the
1979 minibuffer when entering addresses. Within the header of the message
1980 draft, "M-TAB (mh-letter-complete)" is used to do alias completion.
1982 The package also provides for alias creation based upon the From
1983 header field of the current message. Use the lasso button
1984 (mh-alias-grab-from-field).
1986 This functionality can be customized within the mh-alias group.
1988 *** Index Folder Updates
1990 The results of an index search "F i (mh-index-search)" are now stored
1991 in a bona fide folder so that you can refile messages and reply to
1992 messages directly from the result folder. This folder is a sub-folder
1993 of +mhe-index and the name is based upon the search string (closes SF
1994 #623321).
1996 If a prefix argument is given then the search in the current index
1997 buffer is redone.
1999 The index folder lists the names of the source folders as before.
2000 However, instead of using RET on the name of the folder to visit the
2001 folder, use "v (mh-show-index-visit-folder)" anywhere within the
2002 results to visit that folder narrowed to the results of the search.
2003 Additional functions have been added to navigate including "TAB
2004 (mh-index-next-folder)", and "SHIFT-TAB (mh-index-previous-folder)."
2006 *** mh-visit-folder Interface Updated
2008 A change was made to the prompting of the message range. In general,
2009 you can use the same format for messages and sequences as you can in
2010 MH with a single exception: a single number means to scan that many
2011 messages, rather than scan that message number. This turns out to be
2012 much more useful than visiting a single message and is consistent with
2013 Gnus and the MH-E speedbar (closes SF #655891).
2015 If mh-visit-folder is called non-interactively and RANGE is nil then
2016 all messages are displayed. This behavior is now documented and
2017 provides backwards compatibility.
2019 *** Threading Improvements
2021 After incorporating new mail into a threaded folder, unseen messages
2022 can be spread about. Two new functions have been added to make it
2023 easier to find them: these are "M-n (mh-next-unread-msg)" and "M-p
2024 (mh-previous-unread-msg)" (closes SF #630328)
2026 Two new functions were added to delete and refile threads. They are "T
2027 d (mh-thread-delete)" and "T o (mh-thread-refile)" respectively
2028 (closes SF #630493).
2030 In addition, the key "k" used to be bound to the function
2031 `mh-delete-subject': it is now bound to
2032 `mh-show-delete-subject-or-thread'.
2034 New functions to navigate threads include "T u (mh-thread-ancestor)",
2035 which can jump to the root message of the current thread given an
2036 optional argument, "T n (mh-thread-next-sibling)", and "T p
2037 (mh-thread-previous-sibling)"
2039 *** Refiling of Messages in Region
2041 If mark is active and `transient-mark-mode' is enabled then all the
2042 messages in the region are refiled.
2044 *** vCard Handling
2046 If a signature cannot be identified, but there is a vCard attachment,
2047 then that vCard will be presented as a signature (closes SF #649216).
2049 *** New Info Added to mh-version
2051 Information about Gnus versions available at both compile time and run
2052 time has been added.
2054 ** New Variables in MH-E 7.1
2056 The defcustom groups were reorganized. Rather than iterate the
2057 specific changes here, you are invited to browse the groups with "M-x
2058 mh-customize RET".
2060 *** mh-alias-completion-ignore-case-flag
2062 Non-nil means don't consider case significant in MH alias completion.
2063 This is the default in plain MH, so it is the default here as well. It
2064 can be useful to set this to t if, for example, you use lowercase
2065 aliases for people and uppercase for mailing lists.
2067 *** mh-alias-expand-aliases-flag
2069 Non-nil means to expand aliases entered in the minibuffer. In other
2070 words, aliases entered in the minibuffer will be expanded to the full
2071 address in the message draft. By default, this expansion is not
2072 performed.
2074 *** mh-alias-flash-on-comma
2076 Specify whether to flash the translation of the alias or warn if there
2077 isn't a translation of the alias.
2079 *** mh-alias-insert-file
2081 Filename to use to store new MH-E aliases. This variable can also be a
2082 list of filenames, in which case MH-E will prompt for one of them. If
2083 nil, the default, then MH-E will use the first file found in the
2084 "AliasFile" component of the MH profile.
2086 *** mh-alias-insertion-location
2088 Specifies where new aliases are entered in alias files. Options are
2089 sorted alphabetically (the default), at the top of the file or at the
2090 bottom.
2092 *** mh-alias-local-users
2094 If t, local users are completed in MH-E To: and Cc: prompts.
2096 If you set this variable to a string, it will be executed to generate
2097 a password file. A value of "ypcat passwd" is helpful if NIS is in
2098 use.
2100 *** mh-alias-system-aliases
2102 A list of system files from which to cull aliases. If these files are
2103 modified, they are automatically reread. This list need include only
2104 system aliases and the passwd file, since personal alias files listed
2105 in your "AliasFile" MH profile component are automatically included.
2107 *** mh-identity-default
2109 Default identity to use when `mh-letter-mode' is called.
2111 *** mh-identity-list
2113 List holding MH-E identity.
2115 *** mh-invisible-header-fields
2117 Simple user interface to change `mh-invisible-headers'.
2119 *** mh-letter-complete-function
2121 Function to call when completing outside of fields specific to
2122 aliases. By default, it is bound to 'ispell-complete-word.
2124 *** mh-show-threads-flag
2126 Non-nil means new folders start in threaded mode. Threading large
2127 number of messages can be time consuming. So if the flag is non-nil
2128 then threading will be done only if the number of messages being
2129 threaded is less than `mh-large-folder' (closes SF #646794).
2131 *** mh-tool-bar-folder-buttons
2133 Buttons to include in MH-E folder/show toolbar.
2135 *** mh-tool-bar-letter-buttons
2137 Buttons to include in MH-E letter toolbar.
2139 ** Bug Fixes in MH-E 7.1
2141 *** mh-get-new-mail
2143 Call new function `mh-add-cur-notation' to undo the work of
2144 `mh-remove-cur-notation' if there was no new mail (closes SF #647681).
2146 *** mh-set-cmd-note
2148 No longer updates the default `mh-cmd-note' value. This resulted in
2149 the misplacement of the current mark when the message number width
2150 changed (closes SF #643701).
2154 * Changes in MH-E 7.0
2156 This is a major release which includes a lot of new features including
2157 improved MIME handling, speedbar folder browsing, and indexed
2158 searching. In this version, MH-E runs under XEmacs, passes checkdoc,
2159 and compiles clean under all supported platforms.
2161 The "passes checkdoc" feature above required changing the name of
2162 several user-visible variables. It is likely that this affects you.
2163 Please be sure to see the table at the end of these notes and rename
2164 your variables accordingly.
2166 MH-E has been written mh-e, Mh-e, MH-e and MH-E. We have decided that
2167 the proper term should be MH-E. Please try to use MH-E in your
2168 writing.
2170 ** New Features in MH-E 7.0
2172 *** Speedbar
2174 There is now support for the speedbar. Try "M-x speedbar" (closes SF
2175 #503727).
2177 Press the middle mouse button on the `+' icons to open a folder,
2178 middle mouse button on a folder name to open the folder. Folders with
2179 unseen messages are shown in bold, so this is a handy way to browse
2180 new messages that you have filed with procmail or slocal.
2182 See the new customization variable `mh-large-folder,' which controls
2183 when the speedbar asks for how many messages to scan when opening a
2184 large folder and `mh-speed-run-flists-flag' whose default value of t
2185 means to use the flists command to populate the count of unseen and
2186 total messages in each folder.
2188 *** Indexed Search
2190 Interoperability with swish++, swish, glimpse, and namazu has been
2191 added to enable lightening-fast searches of your mail. If none of
2192 these are present, grep is used. Try "F i (mh-index-search)".
2194 For more information, read the documentation for the functions
2195 `mh-swish++-execute-search,' `mh-swish-execute-search,'
2196 `mh-namazu-execute-search,' or `mh-glimpse-execute-search' depending
2197 on your preferred indexing program to see what kind of setup is needed
2198 to generate the index.
2200 *** Threading
2202 Use "T t (mh-toggle-threads)" to view the threads in the folder. Use
2203 it again to return to a non-threaded view.
2205 *** Brief Help
2207 Use "? (mh-help)" and "X ? (mh-prefix-help)," where X is a prefix
2208 character, for a brief synopsis in the minibuffer of frequently used
2209 commands. In the MH-Letter or MH-Pick buffers, use "C-c ? (mh-help)"
2210 (closes SF #493740).
2212 *** Folder Keymap Shared by Show Buffer
2214 You can now use the MH-Folder mode commands from the MH-Show buffer.
2215 Because of this, the MH-Show buffer is now read-only (closes SF
2216 #493749 and SF #527946) and you now have to use "M (mh-modify)" to
2217 edit a message.
2219 *** Better Scanning
2221 You no longer have to modify your scan format if your folders have
2222 more than 9999 messages in them. If you've only modified your scan
2223 format file to allow for the wider message numbers, consider using the
2224 default behavior of MH-E and simplify your MH-E configuration
2225 considerably (closes SF #635791).
2227 To do this, you may have to remove your modifications of
2228 `mh-scan.*-regexp' and `mh-cmd-note' and your customization of
2229 `mh-scan-format-file'.
2231 You may still want the updated format files for running MH commands
2232 outside of MH-E; the default of `mh-scan-format-file' will cause them
2233 to be ignored.
2235 If you prefer fixed-width message numbers, set the new customization
2236 variable to nil , set this variable to
2237 nil and call `mh-set-cmd-note' with the width specified by the scan format in
2238 `mh-scan-format-file'. For example, the default width is 4, so you would use
2239 "(mh-set-cmd-note 4)" if `mh-scan-format-file' were nil.
2241 *** X-Face
2243 MH-E now displays the content of the X-Face header field in the From
2244 field. When sending a message, an X-Face field is appended to the
2245 header if it doesn't already exist and "~/.face" is present. See the
2246 new customization variables `mh-show-use-xface-flag' and `mh-x-face-file'
2247 (closes SF #480770).
2249 MH-E depends on the external x-face package found in
2250 ftp://ftp.jpl.org/pub/elisp/ to do this. The `uncompface' binary is
2251 also required to be in the execute PATH. It can be obtained from:
2252 http://freshmeat.net/redir/compface/1439/url_tgz/compface-1.4.tar.gz.
2254 It has also been observed that if you don't see the faces, you might
2255 have to do this (for unknown reasons):
2257     mv /usr/local/include/compface.h /usr/include/
2259 *** Graphical Smileys
2261 Smiley's are now converted to cute little images. See the new
2262 customization variable `mh-graphical-smileys-flag.'
2264 *** Text Emphasis
2266 ASCII formatting is now converted to the appropriate font. For
2267 example, _underline_ is underlined, *bold* appears in bold, /italic/
2268 appears in italic, etc. See `gnus-emphasis-alist' for the whole list.
2269 See the new customization variables `mh-decode-mime' and
2270 `mh-graphical-emphasis-flag.'
2272 *** Attachment Handling
2274 Inline attachments are now displayed. Regular attachments appear as
2275 buttons in show buffer. Use "K TAB (mh-next-button)" or "K SHIFT-TAB
2276 (mh-prev-button)" to cycle through these buttons. Use "K v
2277 (mh-folder-toggle-mime-part)" to view, "K o
2278 (mh-folder-save-mime-part)" to save one part or "K-a
2279 (mh-save-mime-parts)" to save all parts, or "K i
2280 (mh-folder-inline-mime-part)" to view the attachment inline.
2282 See the new customization variable `mh-decode-mime' for additional
2283 information. Other customization variables that affect this new feature
2284 include `mh-store-mime-parts-default-directory' and
2285 `mh-display-buttons-for-inline-parts-flag'.
2287 HTML documents can be viewed inline if Gnus v5.10 and w3 or w3m lisp
2288 packages are present. Set the customization variable
2289 `mm-text-html-renderer' accordingly (closes SF #453352).
2291 *** Quoted-printable Handling
2293 Quoted-printable body parts are now decoded.
2295 *** More Choices for `mh-yank-from-start-of-msg'
2297 Historically, if this variable was t, the entire message, with full
2298 headers would be included and every line would begin with
2299 `mh-ins-buf-prefix.' This usage is deprecated in favor of the setting
2300 `supercite' below. The default has been changed to `attribution.' The
2301 following symbols are now understood:
2303 `body': yank the message minus the header.
2305 `supercite': include the entire message, with full headers. This also
2306 causes the invocation of `sc-cite-original' without the setting of
2307 `mail-citation-hook', now deprecated practice.
2309 `autosupercite': do as for `supercite' automatically when show buffer
2310 matches the message being replied-to.
2312 `attribution': yank the message minus the header and add a simple
2313 attribution line at the top.
2315 `autoattrib': do as for `attribution' automatically when show buffer
2316 matches the message being replied-to.
2318 There is a new customization variable called
2319 `mh-extract-from-attribution-verb' which is used for attribution which
2320 provides a method for setting a different language.
2322 *** Use Gnus mml Instead of mhn
2324 When inserting attachments into a message draft, Gnus mml directives
2325 are now used instead of mhn directives. One beneficial side-effect of
2326 this is that attachments can now appear inline as well as separate.
2328 The new customization variable `mh-compose-insertion' controls whether
2329 Gnus or mhn is used to insert MIME message directives in messages
2330 (default: 'gnus, if the mml library exists).
2332 *** Content-Type Now Obtained Automatically
2334 The value of the Content-Type no longer needs to be entered by the
2335 user.
2337 *** Attachments Automatically Included Upon Send
2339 You no longer have to run "C-c C-e (mh-edit-mhn)" before sending a
2340 message with attachments--this is done automatically when you send the
2341 message with "C-c C-c (mh-send-letter)". There is, however, a new key
2342 binding "C-c C-m m (mh-mml-to-mime)" which is analogous to "C-c C-e
2343 (mh-edit-mhn)".
2345 *** GPG Handling
2347 Messages that have been signed or encrypted with GPG are verified and
2348 decrypted automatically. To sign or encrypt a message, use "C-c RET
2349 C-s (mh-mml-secure-message-sign-pgpmime)" and "C-c C-m C-e
2350 (mh-mml-secure-message-encrypt-pgpmime)." You need Gnus version 5.10
2351 for this feature. These functions are provided by the pgg.el package.
2353 Users report "flashing" with the pgg.el package and prefer the gpg.el
2354 package instead. To use gpg.el instead of the pgg.el package you need:
2356   (setq mml2015-use 'gpg)
2358 To mimic automatic encryption in gpg.el, use:
2360   (setq mm-verify-option 'always)
2361   (setq mm-decrypt-option 'always)
2363 The venerable mailcrypt package is also an option. However, now that
2364 show buffers are read-only, mailcrypt version 3.5.6 and older fail
2365 when they attempt to decrypt the contents.
2367 *** Mail-Followup-To Header Field
2369 Support for this controversial field has been added because nmh
2370 supports it (closes SF #627035). If you want to add it to outgoing
2371 mail for selected mailing lists, add those mailing lists to the new
2372 customization variable `mh-insert-mail-followup-to-list.' If you think
2373 this field is evil, set the new customization variable
2374 `mh-insert-mail-followup-to-flag' to nil.
2376 *** Gnus Issues
2378 If you update Gnus, you must recompile MH-E. Note that if you are
2379 running the stock version of MH-E that comes with Emacs or the MH-E
2380 package on a Debian GNU/Linux, this is done for you.
2382 ** New Variables in MH-E 7.0
2384 New customization variables not mentioned earlier include:
2386 *** mh-letter-insert-signature-hook
2388 Invoked at the beginning of the "C-c C-s (mh-insert-signature)"
2389 command. Can be used to determine which signature file to use based on
2390 message content. On return, if `mh-signature-file-name' is non-nil
2391 that file will be inserted at the current point in the buffer.
2393 *** mh-show-maximum-size
2395 Maximum size of message (in bytes) to display automatically. Provides
2396 an opportunity to skip over large messages which may be slow to load.
2397 Use a value of 0 to display all messages automatically regardless of
2398 size (closes SF #488696).
2400 *** mh-tool-bar-reply-3-buttons-flag
2402 Non-nil means use three buttons for reply commands in tool-bar. If you
2403 have room on your tool-bar because you are using a large font, you may
2404 set this variable to expand the single reply button into three buttons
2405 that won't lead to minibuffer prompt about who to reply to.
2407 ** Bug Fixes in MH-E 7.0
2409 *** mh-delete-msg, mh-refile-msg, mh-undo
2411 Mandrake Linux includes XEmacs initialization code that binds
2412 `transient-mark-mode' which causes problems in MH-E. These problems
2413 have been fixed (closes SF #541915).
2415 *** mh-edit-again
2417 This would sometimes yield a read-only buffer. This has been fixed
2418 (closes SF #624283 and SF #625538).
2420 *** mh-forward
2422 When using nmh, always specify -mime so as to preserve the original
2423 message(s).
2425 *** mh-inc-folder
2427 If you had narrowed to a sequence and then incorporated new mail,
2428 those new messages would not be present in your +inbox when you
2429 widened. This has been fixed (closes SF #489430, SF #489437, SF
2430 #629233).
2432 *** mh-insert-letter
2434 No longer uses mhl to include a message as this mangled the header and
2435 gave supercite fits (closes SF #629153).
2437 *** mh-letter-mode
2439 "M-q (fill-paragraph)" now fills quoted paragraphs (for example,
2440 starting with "> ") correctly (closes SF #489927).
2442 *** mh-next-undeleted-msg, mh-previous-undeleted-msg
2444 If there are no more undeleted messages the point remains at its
2445 original position and a message is produced (closes SF #494304).
2447 *** mh-pick-mode
2449 Now calls `mh-pick-mode-hook' as documented.
2451 *** mh-put-msg-in-seq
2453 Now puts all messages in region in sequence (closes SF #630324).
2455 *** mh-refile-msg, mh-write-msg-to-file
2457 These functions stomped on the variables that held the name of the
2458 last file and folder respectively for the other function. This has
2459 been fixed so that the last folder or file name is preserved (closes
2460 SF #580772).
2462 *** mh-region-to-sequence
2464 If the region in MH-Folder was set with "C-x h (mark-whole-buffer)",
2465 you couldn't perform operations on all of the messages as you would
2466 expect. This has been fixed (closes SF #621632).
2468 *** mh-reply
2470 Performing an undo the first thing after replying would blank out the
2471 entire draft. Now just the insertion of the yanked message is undone
2472 leaving the header and signature intact for additional editing (closes
2473 SF #623693).
2475 *** mh-show-mode
2477 Now calls `mh-show-mode-hook' as documented (closes SF #627222).
2479 *** mh-subject-thread-to-sequence
2481 Make 'subject sequence a real one, exported to MH. This means you can,
2482 for example, mh-forward it. But it also shows up with a mark in the
2483 scan output (closes SF #489445).
2485 *** Other Bug Fixes
2487 The following bugs have also been closed:
2489 SF #495450: Folder buffer read-only after inc
2490 SF #489706: mh-page-msg bombs out
2491 SF #580772: mh-last-destination is overloaded
2493 *** Variables renamed to conform with Emacs coding conventions
2495 The coding conventions require that boolean variables end in -flag.
2496 The following two tables show which variables were affected (closes SF
2497 #627015).
2499 Customization Variables (defcustom)
2501 Old Name                               New Name
2503 mh-auto-folder-collect                 mh-auto-folder-collect-flag
2504 mh-bury-show-buffer                    mh-bury-show-buffer-flag
2505 mh-clean-message-header                mh-clean-message-header-flag
2506 mh-decode-quoted-printable             mh-decode-quoted-printable-flag
2507 mh-delete-yanked-msg-window            mh-delete-yanked-msg-window-flag
2508 mh-do-not-confirm                      mh-do-not-confirm-flag
2509 mh-highlight-citation-p                mh-highlight-citation
2510 mh-insert-x-mailer-p                   mh-insert-x-mailer-flag
2511 mh-print-background                    mh-print-background-flag
2512 mh-recenter-summary-p                  mh-recenter-summary-flag
2513 mh-recursive-folders                   mh-recursive-folders-flag
2514 mh-reply-show-message-p                mh-reply-show-message-flag
2515 mh-show-use-goto-addr                  mh-show-use-goto-addr-flag
2516 mh-update-sequences-after-mh-show      mh-update-sequences-after-mh-show-flag
2518 Regular Variables (defvar)
2520 Old Name                               New Name
2522 mh-mhn-compose-insert-p                mh-mhn-compose-insert-flag
2523 mh-nmh-p                               mh-nmh-flag
2524 mh-page-to-next-msg-p                  mh-page-to-next-msg-flag
2528 * Changes in mh-e 6.1
2530 This is a minor release which includes a few bug fixes. The
2531 distribution now includes the ChangeLog.
2533 ** New Features in mh-e 6.1
2535 *** Fontification
2537 Unseen messages now displayed in bold.
2539 *** Viewing folders and sequences
2541 The folder and sequence listings that "F l (mh-list-folders)" and "S l
2542 (mh-list-sequences)" create are now displayed in view mode.
2544 ** Bug Fixes in mh-e 6.1
2546 *** mh-folder-unseen-seq-name
2548 Byte compilation failed when initializing this variable when the
2549 user's MH environment was not set up. This has been fixed (closes
2550 Debian #140232 and Debian #140817).
2552 *** mh-forward
2554 When forwarding a sequence, the mode of the draft would not be set to
2555 MH-Letter correctly. This has been fixed (closes SF #489448).
2557 *** mh-insert-prefix-string
2559 Fixed to work under XEmacs. Thanks to Will Partain
2560 <partain at dcs.gla.ac.uk>.
2562 *** mh-quit
2564 mh-quit now cleans up the buffers named `mh-temp-buffer,'
2565 'mh-temp-folders-buffer' and 'mh-temp-sequences-buffer.'
2568 * Changes in mh-e 6.0
2570 mh-e is now maintained at SourceForge (see
2571 http://mh-e.sourceforge.net/). This is where you need to go to obtain
2572 new versions of mh-e, report bugs and receive support.
2574 The maintainers have moved much of their personal configurations into
2575 the codebase, so you may find that you may be able to reduce your mh-e
2576 customizations as well.
2578 There are several incompatibilities in this version from older
2579 versions. Please read the following notes carefully for details. Pay
2580 particular attention to the key binding changes in the MH-Folder
2581 section. If you have customized your scan format, you will want to
2582 read about the new variable `mh-scan-format-file'.
2584 The manual could not be updated in time for this release. It will be
2585 updated in the near future. If the Preface in your manual indicates
2586 the older version (version 1.3, for mh-e version 5.0.2), please check
2587 the following page occasionally for an update:
2589   https://sourceforge.net/project/showfiles.php?group_id=13357
2592 ** New Features in mh-e 6.0
2594 *** Customization
2596 mh-e now uses the customize feature of Emacs. Use "M-x customize-group
2597 mh RET" to customize mh-e.
2599 *** Menus
2601 All mh-e modes now provide menus that contain most mh-e functions.
2603 *** Toolbars
2605 All mh-e modes now have toolbar buttons for oft-used functions (Emacs 21).
2607 *** Fontification
2609 All mh-e buffers now have font-lock keywords. To use, either call
2610 (turn-on-font-lock) from the appropriate hook, or set
2611 `global-font-lock-mode' to t. To customize, use "M-x
2612 customize-apropos-faces ^mh RET".
2614 If you have customized your scan lines, you will have to update your
2615 scan regexps. The existing regexps were changed to extract a match so
2616 you will have to add appropriate grouping constructs to take advantage
2617 of the fontification. Your old settings will continue to work, but the
2618 folder will not be fontified. For example:
2620   (setq mh-good-msg-regexp  "^\\(.....\\)[^D^]")
2622 You will most likely have to update the new variable
2623 `mh-scan-subject-regexp' as well. There is another new variable
2624 `mh-scan-date-regexp' which you may also find useful. Run "M-x apropos
2625 mh.*regexp" for a complete list.
2627 *** mail-user-agent support
2629 You can now set `mail-user-agent' to `mh-e-user-agent' so that packages
2630 that need to send mail will use mh-e (closes SF #406883, SF #470024).
2632 *** replgroupcomps support
2634 If you reply to `cc' or `all' and you use nmh, the nmh repl option
2635 -group will be used. This means that the file `replgroupcomps' will be
2636 used. If you have customized `replcomps', you will definitely want to
2637 either copy `$NMH_LIB/replgroupcomps' to your mail directory and modify
2638 it the same way that you modified your `replcomps' file, or simply
2639 copy your `replcomps' file to `replgroupcomps'.
2641 *** MH-Folder mode
2643 The variable `mh-summary-height' used to have a default of 4. It now
2644 varies from 4 to 10 depending on the height of the frame.
2646 Clicking the mouse on a message shows that message.
2648 Delete, refile and undo now operate on a region (but only if
2649 `transient-mark-mode' is non-nil).
2651 SPC (mh-page-msg) now displays the message if it is not already
2652 visible. If the bottom of a message is showing, SPC (mh-page-msg)
2653 moves to the next message (respecting the direction you are moving
2654 through the folder).
2656 The threading commands "T u (mh-next-unseen-subject-thread)",
2657 "T t (mh-toggle-subject-thread)", "T s (mh-narrow-to-subject-thread)",
2658 and "T k (mh-delete-subject-thread)" have been added. These functions
2659 do not offer threading in the true sense of the word, but do allow
2660 some manipulation by subject.
2662 Major, major keymap changes. This was done to free up movement
2663 commands in the buffer, and to provide for additional features, such
2664 as the threading commands. At the same time, better and more
2665 consistent mnemonics were realized that should make it easier to
2666 remember key bindings.
2668 Added new sub-keymaps for folder commands, sequence commands,
2669 extraction commands, and digest commands which begin with with F, S,
2670 X, and D, respectively. These sub-keymaps allowed some consistency
2671 (e.g., especially with l(ist) and k(ill)).
2673 Here are the actual changes and rationale:
2675 Old     New     Rationale
2677 e       -       Deleted. Already have x. Now used by mh-edit-again.
2678 j       -       Deleted. Already have g.
2680 M-a     e       Better mnemonic. Matches rmail. Frees movement command.
2681 M-e     E       Better mnemonic. Consistent with e.
2682 -       S       Why not? mh-sort-folder.
2684 M-f     Fv      Frees movement command
2685 M-f     Ff      Alias (keep?)
2686 M-f     Fo      Alias (keep?)
2687 M-k     Fk      No reason but to keep with folder commands
2688 M-l     Fl      No reason but to keep with folder commands
2689 M-p     Fp      No reason but to keep with folder commands
2690 M-r     Fr      Frees movement command
2691 M-s     Fs      No reason but to keep with folder commands
2692 M-u     Fu      No reason but to keep with folder commands
2694 M-%     Sd      Better mnemonic
2695 M-#     Sk      Better mnemonic
2696 M-q     Sl      Better mnemonic
2697 C-xn    Sn      Frees up standard key binding
2698 %       Sp      Better mnemonic for putting a message in a sequence
2699 ?       Ss      Shows sequences that message is in
2700 C-xw    Sw      Frees up standard key binding
2702 M-n     Xs      Better mnemonic (extract shar)
2703 M-n     Xu      Better mnemonic (extract uuencode)
2705 M-SPC   D SPC   Frees mark command
2706 M-\177  D \177  No reason but to keep with digest commands
2707 M-b     Db      Frees movement command
2709 As the number of variables increases, it is becoming important to
2710 organize the mh-e namespace. Several variables having to do with the
2711 format of scan lines were renamed, as follows:
2713 Old                             New
2715 mh-good-msg-regexp              mh-scan-good-msg-regexp
2716 mh-deleted-msg-regexp           mh-scan-deleted-msg-regexp
2717 mh-refiled-msg-regexp           mh-scan-refiled-msg-regexp
2718 mh-valid-scan-line              mh-scan-valid-regexp
2719 mh-cur-scan-msg-regexp          mh-scan-cur-msg-number-regexp
2720 -                               mh-scan-cur-msg-regexp
2721 -                               mh-scan-rcpt-regexp
2722 -                               mh-scan-format-regexp
2723 mh-msg-number-regexp            mh-scan-msg-number-regexp
2724 mh-msg-search-regexp            mh-scan-msg-search-regexp
2726 *** MH-Show mode
2728 While the MIME support is not complete, quoted-printable body parts
2729 are now decoded.
2731 Some MTAs quote From at the beginning of the line with a ">". The ">"
2732 is now removed in the display, but not on disk.
2734 *** MH-Letter mode
2736 New function "C-c C-o (mh-split-line)" splits lines in a draft
2737 preserving the fill prefix and indentation. This is useful when
2738 responding to several sentences in a single paragraph separately.
2740 "M-q (fill-paragraph)" can now be used on the message that is being
2741 replied to. The fill prefix such as "> " is preserved.
2743 You no longer have to run "C-c C-e (mh-edit-mhn)" manually as this is
2744 now done automatically when the message is sent.
2746 The X-Mailer header field is now added to messages as they are sent.
2748 "C-c C-m C-i (mh-mhn-compose-insertion)" now makes a pretty good guess
2749 at the type of file using the `file' command and no longer asks the
2750 user for the media type. If the necessary version of `file' is not
2751 available, the user is asked for the media type as before; however,
2752 the list of media types is now taken from the system mailcap if
2753 available. Failing that, the built-in list of types has been
2754 supplemented so in most cases the type you need should be present
2755 (closes SF #406883, #441179).
2757 ** New Variables in mh-e 6.0
2759 New variables not mentioned earlier include:
2761 *** mh-insert-x-mailer-p
2763 Default value of t means that an X-Mailer header field should be
2764 added.
2766 *** mh-reply-show-message-p
2768 The setting of this variable determines whether the MH show-buffer is
2769 displayed with the current message when using mh-reply without a prefix
2770 argument. Set it to nil if you already include the message
2771 automatically in your draft using "repl: -filter repl.filter" in
2772 "~/.mh_profile."
2774 *** mh-scan-format-file
2776 Specifies the format file to pass to the scan program. If t, the
2777 format string will be taken from the either `mh-scan-format-mh' or
2778 `mh-scan-format-nmh' depending on whether MH or nmh is in use. If nil,
2779 the default scan output will be used.
2781 If you customize the scan format, you may need to modify a few
2782 variables containing regexps that mh-e uses to identify specific
2783 portions of the output. Use `M-x apropos RET mh-scan.*regexp' to
2784 obtain a list of these variables.
2786 *** mh-scan-format-mh
2788 Scan format string for MH, provided to the scan program via the
2789 -format arg. This format is identical to the default except that
2790 additional hints for fontification have been added to the sixth
2791 column.
2793 *** mh-scan-format-nmh
2795 Scan format string for nmh, provided to the scan program via the
2796 -format arg. This format is identical to the default except that
2797 additional hints for fontification have been added to the sixth
2798 column.
2800 *** mh-show-use-goto-addr
2802 Non-nil means URLs and e-mail addresses are highlighted using
2803 goto-addr in MH-Show buffer.
2805 *** mh-letter-fill-column
2807 Fill column to use in `mh-letter-mode'. This is useful to make the
2808 lines a bit shorter to allow for quoting in replies.
2810 *** mh-folder-updated-hook
2812 Invoked when the actions in a folder (such as moves and deletes) are
2813 performed. Variables that are useful in this hook include
2814 `mh-delete-list' and `mh-refile-list' which can be used to see which
2815 changes are being made to current folder, `mh-current-folder'.
2817 *** mh-unseen-updated-hook
2819 Invoked after the unseen sequence has been updated. The variable
2820 `mh-seen-list' can be used to obtain the list of messages which will
2821 be removed from the unseen sequence
2823 ** Bug Fixes in mh-e 6.0
2825 *** mh-edit-again and mh-extract-rejected-mail
2827 Now insert a header separator (--------) which packages such as
2828 mailcrypt expect.
2830 *** mh-find-progs
2832 Now uses `mhparam' to set `mh-lib-progs' and `mh-lib'. Added more
2833 directories to `mh-progs' so that mh-e can autoconfigure in more
2834 environments. Chances are that you no longer have to set these
2835 variables, and if you do, you will only have to set `mh-progs'.
2836 Unless, of course, you are using an ancient version of MH that doesn't
2837 have `mhparam'.
2839 *** mh-folder-mode-map
2841 The DEL/<delete>/<backspace> change in Emacs 21 broke
2842 `mh-previous-page'. This has been fixed (closes SF #228907).
2844 *** mh-forward
2846 If you had "forw: -mime" to your .mh_profile, forwarding a message
2847 resulted in:
2849   Search failed: "^------- Forwarded Message"
2851 In addition, the Subject field was not filled in. This has been fixed
2852 (closes SF #223603).
2854 *** mh-kill-folder
2856 The user is now always prompted before this action; the variable
2857 `mh-do-not-confirm' is no longer consulted here. Therefore users who
2858 wanted to set `mh-do-not-confirm' but didn't because of the
2859 `mh-kill-folder' dependency may now do so.
2861 *** mh-make-folder-mode-line
2863 Properly deals with folders that do not have any lines in them. Prints
2864 "no msgs" instead of "0 msgs". Does not try to print a range when
2865 there are no messages.
2867 *** mh-mhn-compose-insertion
2869 Now gets the MIME type automatically (assuming the local file command
2870 supports the -i and -b options). If this use of the file command is
2871 not supported, the list of MIME types has been expanded to use the
2872 system's mailcap file.
2874 *** mh-nmh-p
2876 This variable (t when nmh is in use rather than MH) assumed that the
2877 string "nmh" is in `mh-lib-progs' or `mh-lib'. This has been fixed
2878 (closes SF #441776).
2880 *** mh-refile-msg
2882 No longer lets you specify an empty folder (closes SF #476824).
2884 *** mh-regenerate-headers
2886 Now suppresses "scan: bad message list" messages.
2888 *** mh-print-msg
2890 This function was looking for `mhl' in the wrong place on nmh on
2891 Redhat LINUX 7.0. This has been fixed (closes SF #481128).
2893 *** mh-show
2895 Now updates `cur' sequence after a message is shown (closes SF #481772).
2897 *** mh-showing
2899 Renamed variable and function to `mh-showing-mode' to conform with
2900 minor mode conventions. Added optional arg to function so it would
2901 behave like a normal minor mode: no or nil arg toggles mode, 0 arg
2902 turns off, non-nil turns on. This fixed the error that occurred when
2903 `desktop-create-buffer' recreated mh-e buffers because it was calling
2904 `mh-showing' with an arg.
2906 *** mh-version
2908 Fixed for nmh. Now displays mh-e version correctly. Cleaned up output
2909 and display `mh-progs', etc.
2911 *** mh-widen
2913 Now attempts to stay on the same message number (closes SF #480922).
2915 No longer wipes out pending deletes and refiles without warning
2916 (closes SF #481036).
2919 * Changes in mh-e 5.0.2
2921 This version contains additional minor changes to integrate it with
2922 reporter.el (requires reporter.el version 3.1c or later) and Emacs
2923 19.30.  The mh-goto-msg function is much faster, which also speeds up
2924 several other operations.
2927 * Changes in mh-e 5.0.1
2929 This version contains minor changes from mh-e 5.0 to integrate it with
2930 Emacs 19.29.
2933 * User-visible changes to mh-e 5.0
2935 Note: This being a major release, there are many internal changes.
2936 This document lists only changes to the external interfaces of mh-e.
2938 When upgrading, you must either explicitly reload the new versions of
2939 all mh-e files that are already loaded or restart your Emacs.
2942 ** Major Changes and New Features in mh-e 5.0
2944 The emphasis for this release has been on consistency and
2945 documentation. Many documentation strings were enhanced. Documentation
2946 strings were changed to comments for internal functions and variables.
2948 *** There is now proper documentation in the form of a 75-page users
2949 manual. The Texinfo source is mh-e.texi; the formatted Info document
2950 is mh-e.info.
2952 *** There is a new command `mh-update-sequences', which updates MH's
2953 idea of what messages are in the Unseen sequence and what is the
2954 current folder and message. `mh-quit' calls it. While
2955 `mh-execute-commands' has always done this updating as a side effect,
2956 the new function is faster.
2958 *** The MH profile entry "Inbox:" is supported.
2960 *** If the show-buffer is modified, the user is queried before mh-e
2961 reuses the buffer to show a different message. This buffer is also
2962 auto-saved and backed up correctly.
2964 *** `mh-store-buffer' is significantly more robust. It now handles
2965 messages created by a wide variety of packaging software. The status
2966 message for `uudecode' includes the name of the file created. An error
2967 is signaled if the subprocess exits with a non-zero status.
2969 *** `mh-search-folder' behaves predictably, adding messages found to
2970 the `search' sequence. It correctly handles the case of no messages
2971 found.
2973 *** `mh-burst-digest' (`M-b') now only rescans the part of the folder
2974 affected by the burst. It is now much faster in a large folder.
2977 ** New Hooks and Customization Variables in mh-e 5.0
2979 *** `mh-default-folder-for-message-function': new name for the old
2980 `mh-msg-folder-hook', which wasn't a hook. The old name was confusing,
2981 leading people to think they could use `add-hook' with it, when
2982 actually `setq' is the correct way.
2984 *** `mh-sortm-args': When this variable is used has changed. Now
2985 `mh-sortm-args' is passed if there IS a prefix argument to
2986 `mh-sort-folder'. The assumption is that for arguments you normally
2987 want, you would specify them in an MH profile entry.
2989 *** `mh-mhn-args': new hook, a list of additional arguments to pass to
2990 the `mhn' program if `mh-edit-mhn' is given a prefix argument.
2992 *** `mh-edit-mhn-hook': new hook called by `mh-edit-mhn', the function
2993 that formats MIME messages.
2995 *** `mh-folder-list-change-hook': new hook, called whenever the cached
2996 list of folders, `mh-folder-list', is changed.
2998 *** `mh-find-path-hook': new hook, called when entering mh-e.
3000 *** `mh-repl-formfile': new variable, used to change the format file
3001 used by `mh-reply' from the default of "replcomps".
3003 *** New variables to customize the scan format and notating:
3004 `mh-note-deleted', `mh-note-refiled', `mh-note-seq', `mh-note-cur',
3005 `mh-note-copied', `mh-note-printed'.
3008 ** Key Binding Changes in mh-e 5.0
3010 *** `RET' runs `mh-show' for consistency with the Finder and Info. The
3011 old binding `.' still works, but `RET' is now the standard binding.
3013 *** `M-<' now runs `mh-first-msg' for consistency with `M->', which
3014 runs `mh-last-msg'.
3016 *** `C-c C-f C-d' in MH-Letter mode moves to a Dcc: header field.
3018 *** `C-c C-f C-r' in MH-Letter mode moves to a From: header field.
3020 *** `g' is now the standard binding for `mh-goto-msg'. The old binding
3021 `j' still works.
3024 ** Other Improvements and Changes to mh-e 5.0
3026 *** `mh-lpr-command-format' no longer passes the "-p" argument to
3027 `lpr' by default. The mail header typically has the date anyway.
3029 *** When prompting for a sequence name, if no sequences have been used
3030 yet, mh-e will offer the first sequence the current message is in.
3032 *** The patterns of more mailers are recognized by
3033 `mh-extract-rejected-mail'.
3035 *** `mh-insert-prefix-string' no longer wraps the call to the
3036 `mail-citation-hook' function in a `save-excursion' so the hook writer
3037 can choose whether to leave point at the beginning or the end of the
3038 yanked text.
3040 *** `mh-write-msg-to-file': The prompt now refers to "message" or
3041 "message body" depending on which will be written. (This is controlled
3042 by a prefix argument.) The file defaults to the last-used file instead
3043 of supplying only the directory name.
3045 *** mh-e uses message ranges when running MH commands. Thus "rmm 1 2 3
3046 4 6" is now "rmm 1-4 6". This change makes it less likely to overflow
3047 system argument list limits, and it might be faster, too.
3050 ** Bug Fixes to mh-e 5.0
3052 *** mh-e's idea of the unseen sequence now stays in sync with MH's
3053 better.
3055 *** Functions that are supposed to find fields in the message header
3056 no longer look in the message body.
3058 *** mh-e would sometimes fail to remove the "%" from a scan line when
3059 the message was removed from a sequence if the message was also in the
3060 Previous sequence.
3062 *** The variable `mh-inc-prog' is now correctly used in all places.
3064 *** `mh-pipe-msg' runs the process in the correct directory.
3066 *** A partially scanned folder will no longer lose the "/select"
3067 annotation when you execute marked deletes and refiles with `x'.
3070 * Changes to mh-e 4.0
3072 This file is automatically generated from news-mh-e.txinfo.  Do not edit.
3074 [MH-E-ONEWS has been incorporated here and removed. news-mh-e.txinfo
3075 is no longer available.]
3077 Note: there are many internal changes to mh-e in this release.  If you
3078 have the previous version loaded into your Emacs, you will probably not
3079 be able to load this version on top of it.
3081 ** New Features in mh-e 4.0
3083 *** Background folder collection. The first time you are prompted for
3084 a folder, you must wait while mh-e collects the names of all existing
3085 folders. Now however, if you abort, collecting will continue in the
3086 background, and you can do something else in Emacs until the
3087 collection completes. Normally, mh-e will begin collecting folders
3088 names in the background when you first load it; you can disable this
3089 feature by setting `mh-auto-folder-collect' to nil.
3091 *** There is support for composing MIME messages using the `mhn'
3092 program from MH 6.8. See the documentation string for mh-edit-mhn.
3093 (While composing a letter, type `C-h k C-c C-e'.) See also mhn(1).
3094 There is as yet no support for reading MIME messages.
3096 *** `mh-show', typically on `.', repositions to the start of the
3097 message if the message is already visible. It used to do nothing in
3098 this case.
3100 *** The function `mh-unshar-msg' is renamed `mh-store-msg'. It now
3101 does uudecoding, too. Someday it should do MIME. It remembers the last
3102 directory you used and offers it as the default for next time.
3104 *** New function `mh-header-display', on `,', displays the message
3105 with all headers, including those normally not displayed. Type `.' to
3106 display the message normally again.
3108 *** New function `mh-list-sequences' lists the sequences in use in the
3109 current folder.
3111 *** New function `mh-version' displays version information about MH
3112 and mh-e. Please use the output in bug reports.
3114 *** `mh-quit' now burys the folder buffer and show buffer.
3117 ** New hooks and customization variables in mh-e 4.0
3119 *** `mh-pick-mode-hook': new hook called by new mode `mh-pick-mode'.
3120 The pick buffer didn't used to have its own mode. Another advantage of
3121 `mh-pick-mode' is that `C-h m' works in the pick buffer.
3123 *** `mail-citation-hook': new variable for supercite.
3125 *** `mh-refile-msg-hook': new hook called by `mh-refile-msg' (and
3126 `mh-refile-or-write-again' when refiling).
3128 *** `mh-msg-folder-hook': new hook used by `mh-refile-msg' and
3129 `mh-to-fcc' to provide a default folder for user prompt.
3131 *** `mh-show-hook': new hook called by `mh-show'.
3133 *** `mh-delete-msg-hook': new hook called by `mh-delete-msg'.
3135 *** `mh-show-mode-hook': new hook called by new mode `mh-show-mode'
3136 for `show-' buffers.
3138 *** `mh-comp-formfile': new variable so can customize `components'
3139 file.
3141 *** `mh-sortm-args': new variable, a list of extra arguments to be
3142 passed to sortm by `mh-sort-folder'. Give an argument to
3143 `mh-sort-folder' to suppress this behavior.
3145 *** `mh-send-prog': new variable so can customize name of `send'
3146 program in case of name conflicts.
3148 *** `mh-scan-prog': new variable so can customize name of `scan'
3149 program to generate custom effects.
3151 *** `mh-inc-prog': new variable so can customize name of `inc' program
3152 to do fancy management of incoming messages.
3154 *** `mh-forwarded-letter-subject': new function used by `mh-forward'
3155 to compute the Subject line of the new message. It is a small function
3156 which can be replaced by the user for customization. Uses the new
3157 variable `mh-forward-subject-format', which allows some simple
3158 customizations without rewriting even `mh-forwarded-letter-subject'.
3160 *** `mh-new-draft-cleaned-headers': new variable, header lines removed
3161 by `mh-edit-again' and `mh-extract-rejected-mail' before offering a
3162 message as a new draft.
3164 *** `mh-signature-file-name': new variable used by
3165 `mh-insert-signature' to so can customize name of the file to insert.
3167 *** `mh-read-address': new function called to read all To: and Cc:
3168 addresses.
3170 *** `mh-msg-folder-hook': new hook used by `mh-refile-msg' and
3171 `mh-to-fcc' to provide a default folder for user prompt.
3174 ** Key binding changes in mh-e 4.0
3176 *** `,' runs new function `mh-header-display'. It is like `.' but it
3177 displays *all* the headers.
3179 *** `M-#' runs the new function `mh-delete-seq'. One used to have to
3180 type `C-u M-%' to delete a sequence.
3182 *** `<' no longer does `mh-first-msg', but `M->' now does
3183 `mh-last-msg'. This allows first and last to be consistent (`>' was
3184 taken) and is more likely to be discovered by chance anyway.
3186 *** `M-d' runs `mh-redistribute', `r' runs `mh-reply' (on the theory
3187 that the more commonly used function should be easier to type, and the
3188 obscure action of redistributing can be harder to type).
3190 *** `M-o' changed to `C-o' (`mh-write-msg-to-file'). It was
3191 interfering with arrow keys for some people.
3193 *** `M-n' now runs `mh-store-msg' (formerly `mh-unshar-msg').
3195 *** `b' no longer runs `mh-quit'; use `q' instead. `b' may be used in
3196 a future version for something else.
3199 ** Minor improvements to mh-e 4.0
3201 *** The mh-e code is now divided into multiple Emacs Lisp files, so it
3202 starts up faster because Emacs doesn't have to load all of it at once.
3203 (This change also makes it easier for the maintainer to manage
3204 things.)
3206 *** When searching for the directory containing the MH programs,
3207 search the user's PATH in addition to the built-in directories, to
3208 increase the chance of finding the MH programs.
3210 *** The subject for a forwarded message no longer has ugly square
3211 brackets around it.
3213 *** The name of the folder is no longer appears twice in the show
3214 buffer mode line.
3216 *** When typing a folder name in the minibuffer, parent folders
3217 complete to the trailing slash (/), for easier typing of subfolders.
3219 *** The folder buffer mode name changed from `mh-e scan' or `mh-e
3220 show' to `MH-Folder', which makes the hook name easier to guess. Added
3221 `mh-showing' to `minor-mode-alist' so there is still an indication in
3222 the mode line of whether messages will be shown automatically.
3224 *** `mh-rename-seq' does completion on the old sequence name.
3226 *** If called by a user who has never used MH on this system before,
3227 mh-e runs the MH program `install-mh' to get them set up.
3229 *** Undo history for previous messages is not kept to avoid wasting
3230 memory.
3232 *** The internal temp buffer used by mh-e has `buffer-offer-save'
3233 explicitly nil. This change benefits people who change the
3234 `buffer-offer-save' default.
3237 ** Bug fixes to mh-e 4.0
3239 *** `mh-to-field': don't bomb if no To: field.
3241 *** `mh-get-new-mail': restore annotations, e.g., cur, even if no new
3242 mail.
3244 *** `mh-rename-seq': verify that the new seq name was accepted by
3245 `mark' before updating state.
3247 *** `mh-internal-seq': the Previous sequence is not notated, since it
3248 would notate everything scanned.
3250 *** `mh-read-draft': don't call `find-file-noselect' so an
3251 `auto-mode-alist' doesn't trigger `mh-letter-mode-hook' twice. Faster,
3252 too.
3254 *** `mh-show': If user moves onto a message that doesn't exist, don't
3255 leave the cursor in the show pane.
3257 *** `mh-delete-scan-msgs': use `equal', not `=', on the result of
3258 `mh-get-msg-num', since it may be nil.
3260 *** `mh-get-field': do anchored search so searching for `reply-to:'
3261 doesn't find `in-reply-to:'.
3263 *** `mh-widen': do nothing if not narrowed.
3265 *** `mh-clean-message-header': find end of headers even if no body.
3268 This file is part of GNU Emacs.
3270 GNU Emacs is free software: you can redistribute it and/or modify
3271 it under the terms of the GNU General Public License as published by
3272 the Free Software Foundation, either version 3 of the License, or
3273 (at your option) any later version.
3275 GNU Emacs is distributed in the hope that it will be useful,
3276 but WITHOUT ANY WARRANTY; without even the implied warranty of
3277 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
3278 GNU General Public License for more details.
3280 You should have received a copy of the GNU General Public License
3281 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
3284 Local variables:
3285 mode: outline
3286 paragraph-separate: "[  \f]*$"
3287 end: