* NEWS, MH-E-NEWS: Update for MH-E release 8.2.91.
[emacs.git] / etc / MH-E-NEWS
bloba46354d7b7bc63ecfcdc925568ec9c7f3cb5056f
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.2.91
8 Version 8.2.91 fixes the folder window problem that was introduced
9 in 8.2.90. It also fixes compilation warnings in XEmacs 21.5.31, as
10 well as an error when running XEmacs 21.5.31 in a terminal.
12 Another implication of the VCS change is that users who download MH-E
13 from SourceForge and explicitly load MH-E will have to be change their
14 `load-path' to "/path/to/mh-e/emacs/trunk/lisp/mh-e" instead. Note the
15 addition of "trunk."
17 This version of MH-E is packaged with GNU Emacs 24.1
19 * Changes in MH-E 8.2.90
21 In 2010, the version control system (VCS) of Emacs was upgraded from
22 CVS to Bazaar. In 2011, the MH-E team followed suit and upgraded the
23 MH-E repository at SourceForge from CVS to Bazaar as well. The result
24 is version 8.2.90 of MH-E, which includes needed changes to the build
25 scripts.
27 Otherwise, this is a small release that includes mostly internal
28 changes from the Emacs team. One of these changes manifests itself in
29 the user interface--you can now complete folders with abbreviations,
30 meaning that `+f/b/b TAB' can complete to `+foo/bar/baz'.
32 Also, RFC 2047-encoded Subject header fields in replies are now
33 decoded.
37 * Changes in MH-E 8.2
39 Version 8.2 of MH-E appeared in GNU Emacs 23.1.  This is a small
40 release that includes internal changes from the Emacs team. A new
41 hook, `mh-pack-folder-hook', has been added.
43 There is a known bug where you can't attach attachments in Emacs 21.
44 This will be fixed in 8.2.1.
46 ** New Variables in MH-E 8.2
48 *** mh-pack-folder-hook
50 The `mh-pack-folder-hook' is run by `F p' (`mh-pack-folder') after
51 renumbering the messages. Hook functions can access the current folder
52 name with `mh-current-folder'.
54 ** Bug Fixes in MH-E 8.2
56 *** New version of mh-mm-save-part
58 Several functions have been updated with code from Gnus 5.11 (closes
59 SF #2235022).
63 * Changes in MH-E 8.1
65 Version 8.1 fixes some issues with forwarding messages, respects the
66 MH environment variable, adds the abilities to use aliases with GPG
67 and show HTML even though it is discouraged. A new hook,
68 `mh-annotate-msg-hook', has been added.
70 ** New Features in MH-E 8.1
72 *** Showing HTML When Text Is the Preferred Alternative
74 The `:' (`mh-show-preferred-alternative') function displays the
75 message with the default preferred alternative. This is as if
76 `mm-discouraged-alternatives' was set to nil (closes SF #1777321).
78 ** New Variables in MH-E 8.1
80 *** mh-annotate-msg-hook
82 The `mh-annotate-msg-hook' hook is run whenever a message is sent and
83 after the scan lines and message are annotated. Hook functions can
84 access the current folder name with `mh-current-folder' and obtain the
85 message numbers of the annotated messages with `mh-annotate-list'
86 (closes SF #2032269).
88 ** Bug Fixes in MH-E 8.1
90 *** Can't Use Aliases with GPG
92 GPG requires e-mail addresses, not aliases. So resolve aliases before
93 passing addresses to GPG/PGP (closes SF #649226).
95 *** mh-mml-forward-message: Disposition Should Be Inline
97 The `f' (`mh-forward') function now forwards messages as inline
98 attachments (closes SF #1378993).
100 *** Illegal Filename Characters on Windows Filesystems
102 The X-Image-URL cache created filenames with invalid characters on
103 Windows. This has been fixed with assistance from Darel Henman (closes
104 SF #1396499).
106 *** Make Many Header Fields Invisible
108 A vast landscape of header fields are now invisible. You may wish to
109 browse `mh-invisible-header-fields-default' and clean up your
110 `mh-invisible-header-fields' option. A permanent bug (SF #1916032) has
111 been created where you can submit header fields that should be
112 rendered invisible (closes SF #1701231).
114 *** mh-forward Includes Messages in Reverse Order
116 The `f' (`mh-forward') function now includes messages in ascending
117 order (closes SF #1730393).
119 *** Compile Fails on XEmacs 21.5 beta 28
121 This has been fixed with help from Henrique Martins (closes SF
122 #1749774).
124 *** Rename Variant mu-mh to gnu-mh
126 The GNU mailutils MH variant was named inconsistently. The variant has
127 been renamed to gnu-mh throughout. Thanks to Darel Henman (closes SF
128 #1768928).
130 *** Respect MH environment Variable
132 Even if the MH environment variable was set, an error was generated if
133 "~/.mh_profile" was missing. This has been fixed thanks to Xavier
134 Maillard (closes SF #1946861).
136 *** Enhance mh-mairix-regexp-builder
138 Additional items have been added to the Mairix search string in order
139 to support org-mode. Thanks to Nick Dokos (closes SF #1965704).
141 *** mh-mh-to-mime and mh-mh-to-mime-undo Reset Modes
143 The functions `mh-mh-to-mime' and `mh-mh-to-mime-undo' would reset the
144 buffer to fundamental mode. This has been fixed thanks to Sergey
145 Poznyakoff (closes SF #1966722).
149 * Changes in MH-E 8.0.3
151 Version 8.0.3 fixes errors in sending messages and in running spam
152 filter commands in certain circumstances.
154 ** Bug Fixes in MH-E 8.0.3
156 *** mh-send-args Cannot Be nil
158 If `mh-send-uses-spost-flag' was set, an error would prevent the
159 sending of messages. This has been fixed (closes SF #1564742).
161 *** Missing Quotes in sa-learn Command Line
163 This has been fixed (closes SF #1565460).
165 *** Errors Associated with mh-junk-background
167 The Spamassassin filter commands were used inconsistently and
168 incorrectly; if `mh-junk-background' were nil, not all of the updating
169 would happen correctly. In the other back-ends such as bogofilter and
170 SpamProbe, a value of t for `mh-junk-background' would cause the
171 commands associated with these filters to fail. These problems have
172 been fixed (closes SF #1594802).
176 * Changes in MH-E 8.0.2
178 Version 8.0.2 fixes the tool bar and `F n' on XEmacs, and `K a' on GNU
179 mailutils.
181 ** Bug Fixes in MH-E 8.0.2
183 *** Tool Bar Not Displayed in XEmacs
185 The MH-E tool bar didn't show up in XEmacs; now it does. Thanks to Ted
186 Phelps <phelps@gnusto.com> (closes SF #1506846).
188 *** mh-mime-save-parts Assumes -store Default
190 It was assumed that -store was the default for both mhn and mhstore.
191 This has been fixed by using -store except when using nmh. Thanks to
192 Sergey Poznyakoff <gray@Mirddin.farlep.net> (closes SF #1513140).
194 *** F-n Doesn't Work
196 The fix for SF #1499712 broke `F n' (`mh-index-new-messages') on
197 XEmacs since a regular expression that XEmacs could not handle was
198 added. This regexp has been fixed (closes SF #1514424).
202 * Changes in MH-E 8.0.1
204 Version 8.0.1 works around a couple of bugs in GNU mailutils, spost,
205 and Windows. MH-E now requires the use of version 1.0 of mailutils due
206 to a bug in the folder command.
208 ** Bug Fixes in MH-E 8.0.1
210 *** Infinite Loop When Searching (mailutils)
212 The GNU mailutils folder command displays output when a folder doesn't
213 exist. MH-E didn't expect this and responded with an infinite loop
214 during searches. While this bug has since been fixed in mailutils,
215 MH-E has been modified to work anyway (closes SF #1499712).
217 *** spost Doesn't Have -msgid or -mime Flags
219 The post replacement spost does not support the -msgid or -mime flags.
220 A new variable `mh-send-uses-spost-flag' was added to control the use
221 of these flags (closes SF #1486726).
223 *** <2> in Search Folders Illegal in Windows
225 The <2> suffix to the search folder names contain illegal filename
226 characters in Windows. These cause searches to fail on Windows. This
227 has been fixed by changing the suffix to -2 (closes SF #1507002).
231 * Changes in MH-E 8.0
233 Version 8.0 supports GNU mailutils, S/MIME, picons, which-func-mode,
234 sports an improved interface for hiding header fields, improves upon
235 the MH variant detection, improves folder completion, makes the pick
236 search equivalent to the other types of searches, spruces up the tool
237 bar, creates the correct MIME type when including OpenOffice
238 documents, works on a Mac, adds colors to buttons for signed or
239 encrypted messages, incorporates new features introduced in
240 Emacs 22.1, fixes a bunch of bugs, and best of all, comes with an
241 updated manual!
243 Internally, MH-E now sports a new software organization which will
244 help future maintainability. As a side-effect, the number of XEmacs
245 compilation warnings has plummeted from hundreds to just three. CVS
246 users will notice that MH-E has been migrated from the CVS repository
247 from SourceForge to Savannah (but only for those files that were
248 already part of Emacs). As a result, the location of MH-E in the
249 load-path has changed, and mh-e-autoloads.el was renamed to
250 mh-autoloads.el. See section INSTALL in the README for details. While
251 this migration will benefit maintainers, it will also benefit users:
252 CVS Emacs users will not have to check out MH-E separately and welcome
253 faster MH-E updates, and CVS MH-E users will welcome faster MH-E
254 updates from Emacs developers. Read section CVS MH-E INSTALL in the
255 README for details.
257 While not related to this release, the MH-E mailing lists are now
258 gatewayed at gmane.org (closes SF #979308).
260 If you want to see the release notes for the alpha and beta releases
261 leading up this release, please see:
263   http://cvs.savannah.gnu.org/viewvc/emacs/emacs/etc/MH-E-NEWS?revision=1.25&view=markup
267 ** New Features in MH-E 8.0
269 *** GNU mailutils Support
271 MH-E now supports GNU mailutils 0.4 and higher versions.
273 *** S/MIME Support
275 MH-E now supports S/MIME using Gnus 5.10.6 or higher.
277 *** Picon Support
279 In addition to the other methods of displaying an icon for the sender
280 of a message, MH-E can now display images from a picon directory. The
281 directory search path is found in the `mh-picon-directory-list'
282 variable. More documentation is found in the "facedb" sections in the
283 xfaces man page.
285 *** Catchup Command
287 There is a new `F c' (`mh-catchup') command that marks all unread
288 messages in the current folder as read.
290 *** Use which-func-mode to Display Folder in Index Mode
292 Turning on `which-func-mode' displays the folder name of the message
293 under the cursor in index folders (closes SF #855520).
295 *** Quick Key Help
297 The `?' (`mh-help') function now displays the help in its own buffer
298 called *MH-E Help* (closes SF #493740 and SF #656631).
300 *** Search Unification
302 The old `F s' behavior of adding messages to the search sequence has
303 been removed. The `F i' keybinding was deprecated and the new `F s'
304 (`mh-search') command is used to initiate either indexed or pick
305 searches. Within the MH-Search buffer (renamed from MH-Pick), the
306 command `C-c C-p' (`mh-pick-do-search') now runs pick on the given
307 folder recursively and displays the results in a search folder like
308 the other search methods (closes SF #829207).
310 *** Entry Points Have Moved
312 Emacs 21 users must now add `(require 'mh-autoloads)' because the
313 entry points (such as `mh-rmail' and `mh-smail') have moved to
314 different files which have made the autoloads that come with Emacs
315 inaccurate. This change was necessary because the code was reorganized
316 to remove circular dependencies, to make the code more stable and
317 maintainable, and to reduce the time to load MH-E.
319 *** MH-Folder Keymap Changes
321 There is now a keymap for the printing functions whose prefix is `P'.
322 The command `l' (`mh-print-msg') has been replaced with `P l' although
323 we suggest you use the new `P p' instead.
325 Key          7.4.4                         8.0
327 ;            -                             mh-toggle-mh-decode-mime-flag
328 l            mh-print-msg                  -
329 / f          mh-narrow-to-from             -
330 / r          mh-narrow-to-range            -
331 / g          -                             mh-narrow-to-range
332 / m          -                             mh-narrow-to-from
333 F c          -                             mh-catchup
334 F i          mh-index-search               -
335 F s          mh-search-folder              mh-search
336 K e          -                             mh-display-with-external-viewer
337 K t          -                             mh-toggle-mime-buttons
338 P ?          -                             mh-prefix-help
339 P C          -                             mh-ps-print-toggle-color
340 P F          -                             mh-ps-print-toggle-faces
341 P f          -                             mh-ps-print-msg-file
342 P l          -                             mh-print-msg
343 P p          -                             mh-ps-print-msg
345 *** MH-Letter Keymap Changes
347 The change where `mh-letter-mode' derives from `mail-mode' adds a few
348 keybindings. Some are interesting: experiment! Only the keybinding
349 changes for MH-E functions are listed here.
351 Most of the changes have to do with the renaming of the functions with
352 "mhn" in them to "mh" because nmh doesn't use `mhn'. The names were
353 also made consistent with the family of "mml" functions.
355 The type of signing or encryption has been generalized so the method
356 is now an option rather than a part of the function's name. The option
357 is `mh-mml-method-default' and choices include PGP (MIME), PGP,
358 S/MIME, or none.
360 Key          7.4.4                         8.0
362 C-c C-e      mh-edit-mhn                   mh-mh-to-mime
363 C-c RET C-e  mh-mml-secure-message-encrypt-pgpmime
364                                            mh-mml-secure-message-encrypt
365 C-c RET C-g  -                             mh-mh-compose-anon-ftp
366 C-c RET C-n  -                             mh-mml-unsecure-message
367 C-c RET C-s  mh-mml-secure-message-sign-pgpmime
368                                            mh-mml-secure-message-sign
369 C-c RET C-t  -                             mh-mh-compose-external-compressed-tar
370 C-c RET C-u  mh-revert-mhn-edit            mh-mh-to-mime-undo
371 C-c RET C-x  -                             mh-mh-compose-external-type
372 C-c RET e    mh-mml-secure-message-encrypt-pgpmime
373                                            Prefix Command
374 C-c RET e e  -                             mh-mml-secure-message-encrypt
375 C-c RET e s  -                             mh-mml-secure-message-signencrypt
376 C-c RET g    -                             mh-mh-compose-anon-ftp
377 C-c RET n    -                             mh-mml-unsecure-message
378 C-c RET s    -                             Prefix Command
379 C-c RET s e  -                             mh-mml-secure-message-signencrypt
380 C-c RET s s  -                             mh-mml-secure-message-sign
381 C-c RET t    -                             mh-mh-compose-external-compressed-tar
382 C-c RET u    mh-revert-mhn-edit            mh-mh-to-mime-undo
383 C-c RET x    -                             mh-mh-compose-external-type
385 C-c C-f C-a  -                             mh-to-field
386 C-c C-f C-l  -                             mh-to-field
387 C-c C-f RET  -                             mh-to-field
388 C-c C-f a    -                             mh-to-field
389 C-c C-f l    -                             mh-to-field
390 C-c C-f m    -                             mh-to-field
392 *** MH-Search Keymap Changes
394 These are the changes associated with the new search mode. The command
395 `C-c C-c' (`mh-index-do-search') now performs the standard indexed
396 search, while `C-c C-p' (`mh-pick-do-search') runs pick as before,
397 only better!
399 The `mh-to-field' keybindings were adjusted to be consistent with
400 those in the MH-Letter mode.
402 Key          7.4.4                         8.0
404 C-c C-c      mh-do-search                  mh-index-do-search
405 C-c C-f C-d  mh-to-field                   -
406 C-c C-f C-f  mh-to-field                   -
407 C-c C-f C-r  mh-to-field                   -
408 C-c C-f RET  -                             mh-to-field
409 C-c C-f d    mh-to-field                   -
410 C-c C-f f    mh-to-field                   -
411 C-c C-f m    -                             mh-to-field
412 C-c C-f r    mh-to-field                   -
413 C-c TAB      mh-index-do-search            -
415 *** Updates to X-Image-URL
417 Now support the use of `curl' and `fetch' as alternatives to `wget' to
418 obtain the image. The display of images are controlled with the
419 `mh-show-use-xface-flag' option while the `mh-fetch-x-image-url'
420 option controls how the images are fetched.
422 The default of `mh-fetch-x-image-url' has been changed to "Never
423 Fetch." Those of you who like the value of "Ask Before Fetching" will
424 have to customize this option (closes SF #831278).
426 WARNING: There are security concerns with this feature. Please read
427 the documentation for these options carefully before changing the
428 default.
430 *** Updates to mh-identity-list
432 Note that the field names found in `mh-identity-list' that refer to
433 the fields in `mh-identity-handlers' have changed in an incompatible
434 way from 7.4.4. In general, the symbolic names now have a ":" prefix
435 to avoid collisions with header fields. Before starting Emacs, edit
436 your .emacs and insert ":" before "signature" if you have defined it.
438 You can change your attribution in replies with the new "Attribution
439 Verb" field, and you can set your default GPG user ID with the "GPG
440 key ID" field.
442 Signatures can now be read from the `mh-signature-file-name' variable,
443 or come from a function, in addition to a named file. If you write
444 your own function, variables that you can use include
445 `mh-signature-separator-regexp', `mh-signature-separator',
446 and `mh-signature-separator-p'.
448 The handling of these fields has been moved into a new
449 `mh-identity-handlers' option, an alist of fields (strings) and
450 handlers (functions). Strings are lowercase. Use ":signature" for
451 Signature and ":pgg-default-user-id" for GPG Key ID. The function
452 associated with the string "default" is used if no other functions are
453 appropriate. For this reason, don't name a header field "Default".
455 If you point your signature at a vCard file with a vcf suffix, then it
456 will be incorporated as a vCard body part (closes SF #802723).
458 *** Updates to Speedbar
460 The speedbar now renders the folders with unseen messages in boldface
461 which makes them easier to identify (closes SF #623369).
463 *** Updates to mh-msg-is-in-seq
465 Can now specify an alternate message number to `S s'
466 (`mh-msg-is-in-seq') with a prefix argument.
468 *** Updates to mh-to-field-choices
470 In MH-Letter mode, you can use the `C-c C-f' (`mh-to-field') prefix to
471 go to and insert fields. The fields `Reply-To:', `Mail-Reply-To:',
472 `Mail-Followup-To:' can now be created via the `C-r', `C-a' (for
473 author), and `C-l' keys respectively. The key for the `From:' field
474 has been renamed from `C-r' to `C-m' for consistency with `mail-mode'
475 (closes SF #1400139).
477 *** Change Content-Type Renderer on the Fly in MH-Show Buffer
479 This has been implemented by adding the key binding `K e'
480 (`mh-display-with-external-viewer'). For inline text/html parts,
481 buttons aren't displayed by default. In that case use `K t'
482 (`mh-toggle-mime-buttons') to display the button before viewing it
483 with an external browser (closes SF #839318).
485 *** MH-E No Longer Calls install-mh
487 The new variant detection code makes use of `mhparam' which assumes
488 that your MH environment has already been set up. The code to call
489 `install-mh', which could no longer be run anyway, was removed.
491 *** Add :package-version Keyword to Options
493 This `defcustom', `defgroup', and `defface' keyword was introduced in
494 Emacs 22.1. MH-E has been extended to take advantage of it. With this
495 keyword, you can now use `M-x customize-changed-options' to see what
496 options in MH-E have changed between versions of Emacs. In a future
497 version of Emacs, you'll be able to see changes between MH-E versions
498 as well (closes SF #1452724).
500 *** Render Signature and vCard in Italics
502 This has been implemented.  Use `mh-show-signature-face' to customize
503 the face used (closes SF #802722).
505 *** Derive mh-letter-mode from mail-mode
507 MH-Letter mode is now derived from `mail-mode'. We were able to delete
508 a lot of code. In return, there are a few `mail-mode' commands that
509 are available that may or may not be useful and the `mail-mode-hook'
510 is run (closes SF #1385571).
512 *** Remove Emacs 20 Support
514 As it turns out, we had already added some code that didn't work on
515 Emacs 20. However, now we've formalized it and removed code that was
516 present solely for Emacs 20 support (closes SF #1359240).
518 *** Glimpse Support Removed
520 Since glimpse isn't free, we cannot mention it. Glimpse has been
521 removed from the option `mh-indexer-choices' (closes SF #831276).
523 *** Use run-hook-with-args
525 We use normal hooks whenever possible and do not use
526 `run-hook-with-args' (with one documented exception) (closes SF
527 #643702).
531 ** New Variables in MH-E 8.0
533 *** mh-after-commands-processed-hook
535 Hook run by `x' (`mh-execute-commands') after performing outstanding
536 refile and delete requests.
538 *** mh-alias-reloaded-hook
540 Invoked by `mh-alias-reload' after reloading aliases.
542 *** mh-auto-fields-prompt-flag
544 On means to prompt before sending if fields in `mh-auto-fields-list'
545 are inserted.
547 *** mh-before-commands-processed-hook
549 Renamed from `mh-folder-updated-hook'. It wasn't clear whether
550 `mh-folder-updated-hook' was run before or after the commands were
551 executed. We now provide both with clear names.
553 *** mh-compose-forward-as-mime-flag
555 On means that messages are forwarded as attachments (closes SF
556 #827203).
558 *** mh-default-folder-for-message-function
560 Function to select a default folder for refiling or `Fcc:'.
562 *** mh-forward-hook
564 Invoked on the forwarded letter by `f' (`mh-forward').
566 *** mh-highlight-citation-style
568 Renamed from `mh-highlight-citation-p' since it wasn't a boolean. The
569 new name is also more descriptive.
571 *** mh-identity-handlers
573 Handler functions for fields in `mh-identity-list'.
575 *** mh-insert-signature-hook
577 Renamed from `mh-letter-insert-signature-hook' since most of the other
578 hooks do not carry the mode in the prefix and because the new name is
579 equally clear.
581 *** mh-invisible-header-fields-default
583 List of hidden header fields. The header fields listed in this option
584 are hidden, although you can check off any field that you would like
585 to see. Header fields that you would like to hide that aren't listed
586 can be added to the `mh-invisible-header-fields' option (closes SF
587 #752045).
589 The option `mh-visible-header-fields' has been deleted.
591 *** mh-junk-background
593 If on, spam programs are run in background. This used to be the
594 default behavior but this could overwhelm a system if many messages
595 were black- or whitelisted at once. The spam programs are now run in
596 the foreground, but this option can be used to put them back in the
597 background.
599 *** mh-junk-disposition
601 Renamed from `mh-junk-mail-folder' since this variable can accept
602 values other than folder names.
604 *** mh-kill-folder-suppress-prompt-hooks
606 Renamed from `mh-kill-folder-suppress-prompt-hook'. By convention,
607 abnormal hooks, which this is, either have a -function or -hooks
608 suffix.
610 *** mh-mhl-format-file
612 Renamed from `mhl-formfile' to put it in the MH-E namespace and to be
613 consistent with other similar options.
615 *** mh-mh-to-mime-hook
617 Renamed from `mh-edit-mhn-hook'. We have a family of `mh-mml-to-mime'
618 functions and variables; the older mhn functions and variables were
619 renamed to have a consistent `mh-mh-to-mime' prefix.
621 *** mh-mml-method-default
623 Default method to use in security tags.
625 *** mh-new-messages-folders
627 Renamed from `mh-index-new-messages-folders' for clarity.
629 *** mh-path
631 Additional list of directories to search for MH.
633 *** mh-redist-full-contents-flag
635 On means the `dist' command needs entire letter for redistribution.
636 This was previously a variable. It's now an option.
638 *** mh-search-mode-hook
640 Renamed from `mh-pick-mode-hook' as part of the
641 `mh-index.el'/`mh-pick.el' merge into `mh-search.el'.
643 *** mh-search-program
645 Renamed from `mh-index-program' as part of the
646 `mh-index.el'/`mh-pick.el' merge into `mh-search.el'.
648 *** mh-signature-separator-flag
650 On means a signature separator should be inserted. It is not
651 recommended that you change this option since various mail user
652 agents, including MH-E, use the separator to present the signature
653 differently, and to suppress the signature when replying or yanking a
654 letter into a draft.
656 *** mh-sortm-args
658 Additional arguments for `sortm'. This was previously an internal
659 variable. It's now an user-customizable option.
661 *** mh-speed-update-interval
663 Renamed from `mh-speed-flists-interval' for clarity.
665 *** mh-ticked-messages-folders
667 Renamed from `mh-index-ticked-messages-folders' for clarity.
669 *** mh-variant
671 Specifies the variant used by MH-E. The default setting of this option
672 is `Auto-detect' which means that MH-E will automatically choose the
673 first of nmh, MH, or GNU mailutils that it finds in the directories
674 listed in `mh-path', `mh-sys-path', and `exec-path'. If, for example,
675 you have both nmh and mailutils installed and `mh-variant-in-use' was
676 initialized to nmh but you want to use mailutils, then you can set
677 this option to `mailutils'.
679 When this variable is changed, MH-E resets `mh-progs', `mh-lib',
680 `mh-lib-progs', `mh-flists-present-flag', and `mh-variant-in-use'
681 accordingly.
683 If you've set these variables in your .emacs, it is strongly suggested
684 that you comment them out. The MH detection code has been completely
685 rewritten and it is very likely that you no longer to set them and
686 their setting may confuse other MH-E settings.
688 *** mh-xemacs-tool-bar-position
690 Renamed from `mh-xemacs-toolbar-position' per GNU Emacs naming conventions.
692 *** mh-xemacs-use-tool-bar-flag
694 Renamed from `mh-xemacs-use-toolbar-flag' per GNU Emacs naming conventions.
696 *** mh-yank-behavior
698 Renamed from `mh-yank-from-start-of-msg' for clarity.
702 ** Variables Deleted in MH-E 8.0
704 *** mh-alias-system-aliases
706 System definitions should not be a user option.
708 *** mh-edit-mhn-hook
710 Renamed to `mh-mh-to-mime-hook'.
712 *** mh-folder-updated-hook
714 Renamed to `mh-before-commands-processed-hook'.
716 *** mh-highlight-citation-p
718 Renamed to `mh-highlight-citation-style'.
720 *** mh-index-new-messages-folders
722 Renamed to `mh-new-messages-folders'.
724 *** mh-index-program
726 Renamed to `mh-search-program'.
728 *** mh-index-ticked-messages-folders
730 Renamed to `mh-ticked-messages-folders'.
732 *** mh-junk-mail-folder
734 Since this variable can accept values other than folder names, it was
735 renamed to `mh-junk-disposition' to more accurately reflect the content.
737 *** mh-kill-folder-suppress-prompt-hook
739 Renamed to `mh-kill-folder-suppress-prompt-hooks'.
741 *** mh-letter-insert-signature-hook
743 Renamed to `mh-insert-signature-hook'.
745 *** mh-pick-mode-hook
747 Renamed to `mh-search-mode-hook'.
749 *** mh-show-use-goto-addr-flag
751 This flag was redundant with and inconsistent with
752 `goto-address-highlight-p' at the same time, so we removed it. Please
753 customize `goto-address-highlight-p' if you wish to turn off email
754 address and URL highlighting.
756 *** mh-speed-flists-interval
758 Renamed to `mh-speed-update-interval'.
760 *** mh-speed-run-flists-flag
762 Deleted since setting `mh-speed-flists-interval' to 0 accomplishes the
763 same thing.
765 *** mh-visible-header-fields
767 Deleted since it would hide new header fields you might want to see.
769 *** mh-xemacs-toolbar-position
771 Renamed to `mh-xemacs-tool-bar-position'.
773 *** mh-xemacs-use-toolbar-flag
775 Renamed to `mh-xemacs-use-tool-bar-flag'.
777 *** mh-yank-from-start-of-msg
779 Renamed to `mh-yank-behavior'.
781 *** mhl-formfile
783 Renamed to `mh-mhl-format-file'.
787 ** New Faces in MH-E 8.0
789 *** mh-folder-address
791 Renamed from `mh-folder-address-face' per new Emacs conventions.
793 *** mh-folder-body
795 Renamed from `mh-folder-body-face' per new Emacs conventions.
797 *** mh-folder-cur-msg-number
799 Renamed from `mh-folder-cur-msg-number-face' per new Emacs conventions.
801 *** mh-folder-date
803 Renamed from `mh-folder-date-face' per new Emacs conventions.
805 *** mh-folder-deleted
807 Renamed from `mh-folder-deleted-face' per new Emacs conventions.
809 *** mh-folder-followup
811 Renamed from `mh-folder-followup-face' per new Emacs conventions.
813 *** mh-folder-msg-number
815 Renamed from `mh-folder-msg-number-face' per new Emacs conventions.
817 *** mh-folder-refiled
819 Renamed from `mh-folder-refiled-face' per new Emacs conventions.
821 *** mh-folder-sent-to-me-hint
823 Fontification hint face in messages sent directly to us.
825 *** mh-folder-sent-to-me-sender
827 Sender face in messages sent directly to us.
829 *** mh-folder-subject
831 Renamed from `mh-folder-subject-face' per new Emacs conventions.
833 *** mh-folder-tick
835 Renamed from `mh-folder-tick-face' per new Emacs conventions.
837 *** mh-folder-to
839 Renamed from `mh-folder-to-face' per new Emacs conventions.
841 *** mh-letter-header-field
843 Renamed from `mh-letter-header-field-face' per new Emacs conventions.
845 *** mh-search-folder
847 Renamed from `mh-index-folder-face'.
849 *** mh-show-cc
851 Renamed from `mh-show-cc-face' per new Emacs conventions.
853 *** mh-show-date
855 Renamed from `mh-show--face' per new Emacs conventions.
857 *** mh-show-from
859 Renamed from `mh-show-from-face' per new Emacs conventions.
861 *** mh-show-header
863 Renamed from `mh-show-header-face' per new Emacs conventions.
865 *** mh-show-pgg-bad
867 Face used to highlight a bad PGG signature.
869 *** mh-show-pgg-good
871 Face used to highlight a good PGG signature.
873 *** mh-show-pgg-unknown
875 Face used to highlight a PGG signature whose status is unknown. This
876 face is also used for a signature when the signer is untrusted.
878 *** mh-show-signature
880 Face used to highlight the signature.
882 *** mh-show-subject
884 Renamed from `mh-show-subject-face' per new Emacs conventions.
886 *** mh-show-to
888 Renamed from `mh-show-to-face' per new Emacs conventions.
890 *** mh-show-xface
892 Renamed from `mh-show-xface-face' per new Emacs conventions.
894 *** mh-speedbar-folder
896 Renamed from `mh-speedbar-folder-face' per new Emacs conventions.
898 *** mh-speedbar-folder-with-unseen-messages
900 Renamed from `mh-speedbar-folder-with-unseen-messages-face' per new
901 Emacs conventions.
903 *** mh-speedbar-selected-folder
905 Renamed from `mh-speedbar-selected-folder-face' per new Emacs conventions.
907 *** mh-speedbar-selected-folder-with-unseen-messages
909 Renamed from `mh-speedbar-selected-folder-with-unseen-messages-face'
910 per new Emacs conventions. 
914 ** Faces Deleted in MH-E 8.0
916 *** mh-folder-address-face
918 Renamed to `mh-folder-address' per new Emacs conventions.
920 *** mh-folder-body-face
922 Renamed to `mh-folder-body' per new Emacs conventions.
924 *** mh-folder-cur-msg-face
926 Deleted. Not used.
928 *** mh-folder-cur-msg-number-face
930 Renamed to `mh-folder-cur-msg-number' per new Emacs conventions.
932 *** mh-folder-date-face
934 Renamed to `mh-folder-date' per new Emacs conventions.
936 *** mh-folder-deleted-face
938 Renamed to `mh-folder-deleted' per new Emacs conventions.
940 *** mh-folder-followup-face
942 Renamed to `mh-folder-followup' per new Emacs conventions.
944 *** mh-folder-msg-number-face
946 Renamed to `mh-folder-msg-number' per new Emacs conventions.
948 *** mh-folder-refiled-face
950 Renamed to `mh-folder-refiled' per new Emacs conventions.
952 *** mh-folder-subject-face
954 Renamed to `mh-folder-subject' per new Emacs conventions.
956 *** mh-folder-tick-face
958 Renamed to `mh-folder-tick' per new Emacs conventions.
960 *** mh-folder-to-face
962 Renamed to `mh-folder-to' per new Emacs conventions.
964 *** mh-index-folder-face
966 Renamed to `mh-search-folder'.
968 *** mh-letter-header-field-face
970 Renamed to `mh-letter-header-field' per new Emacs conventions.
972 *** mh-show-cc-face
974 Renamed to `mh-show-cc' per new Emacs conventions.
976 *** mh-show-date-face
978 Renamed to `mh-show-date' per new Emacs conventions.
980 *** mh-show-from-face
982 Renamed to `mh-show-from' per new Emacs conventions.
984 *** mh-show-header-face
986 Renamed to `mh-show-header' per new Emacs conventions.
988 *** mh-show-subject-face
990 Renamed to `mh-show-subject' per new Emacs conventions.
992 *** mh-show-to-face
994 Renamed to `mh-show-to' per new Emacs conventions.
996 *** mh-show-xface-face
998 Renamed to `mh-show-xface' per new Emacs conventions.
1000 *** mh-speedbar-folder-face
1002 Renamed to `mh-speedbar-folder' per new Emacs conventions.
1004 *** mh-speedbar-folder-with-unseen-messages-face
1006 Renamed to `mh-speedbar-folder-with-unseen-messages' per new Emacs conventions.
1008 *** mh-speedbar-selected-folder-face
1010 Renamed to `mh-speedbar-selected-folder' per new Emacs conventions.
1012 *** mh-speedbar-selected-folder-with-unseen-messages-face
1014 Renamed to `mh-speedbar-selected-folder-with-unseen-messages' per new
1015 Emacs conventions.
1019 ** Bug Fixes in MH-E 8.0
1021 *** Face Variable Names Now Follow Current Conventions
1023 The -face suffix has been dropped from all face names. 
1025 *** Swish Fixes
1027 Items in swish indexes that aren't mail messages are now handled more
1028 gracefully.
1030 *** Spamassassin Fixes
1032 If you use spamassassin, there was an error when you tried to junk
1033 mail if the option `mh-junk-background' was set. This has been fixed.
1035 *** Mairix Support
1037 Indexing now compatible with Mairix version 0.12 and later.
1039 *** mh-extract-rejected-mail Can't Do MIME (and Other Formats)
1041 Now handles qmail and exim bounces (addresses SF #404965).
1043 *** mh-rmail Hangs in XEmacs
1045 We've determined that MH-E is incompatible with some versions of
1046 XEmacs (21.5.9-21.5.16). More recent versions work fine. If you think
1047 our list is too broad, please let us know which version of XEmacs you
1048 are using (closes SF #644321).
1050 *** Completions Offered by mh-refile-message Are Not Sorted
1052 This behavior is no longer observed (closes SF #698734).
1054 *** Add Message-ID to Outgoing Messages
1056 If you replied to a message in your `+outbox', an `In-Reply-To:'
1057 header field was created that broke threading at the recipient's end.
1058 We now add a `Message-ID:' to outgoing messages which fixes this
1059 (closes SF #725425).
1061 *** Inconsistent Prompts
1063 Emacs changed their defaults in prompts from "Prompt: [value]" to
1064 "Prompt (default value): ". All MH-E prompts have been updated to
1065 comply with the new standard and are therefore now consistent
1066 throughout the application (closes SF #730470, SF #1275933).
1068 *** Empty Shell Comments Confuse mh-mhn-directive-present-p
1070 If you had a string that matched the regexp "^# $" in your draft, it
1071 would cause an error. This has been fixed (closes SF #762458).
1073 *** Quote Hashes When mhbuild Directives Used
1075 A related bug, if you had empty shell comments but inserted your own
1076 directives, you'd get another error from mhbuild. This has been fixed
1077 by quoting the hash ("^# $") like this "##" before submitting to
1078 mhbuild (closes SF #762464).
1080 *** Inconsistent Usage in Scan Formatting Variables
1082 The variables:
1084     mh-note-cur
1085     mh-note-deleted
1086     mh-note-dist
1087     mh-note-forw
1088     mh-note-refiled
1089     mh-note-repl
1090     mh-note-seq
1092 used to contain strings. Although only the first character was read,
1093 the entire string would be inserted which may have caused problems.
1094 These variables have been converted to character constants so that
1095 only a single character can be inserted into the scan line (closes SF
1096 #770772).
1098 *** Bad Handling of Aliases That Conflict With Local User Names
1100 If a user name existed both locally and in the aliases file, the local
1101 user would be flashed, but the alias would be used when sending. This
1102 has been fixed so that the user name that is flashed is the same as
1103 the name that is sent (closes SF #772595).
1105 *** Initialization Fails If ~/Mail Exists
1107 MH-E no longer calls `install-mh' so this issue has gone away (closes
1108 SF #835192).
1110 *** Not Re-prompted to Sign After Pass Phrase Typo
1112 If there were errors when sending a signed message (like getting the
1113 pass phrase wrong), the MML markup remained in the draft buffer. The
1114 draft buffer is now restored if there is an error (closes SF #839303).
1116 *** Font-lock Gets Confused in MH-Letter Buffer
1118 If a user manually moved the cursor to the end of the header field
1119 separator line (by mouse click or keyboard navigation) and hit Enter
1120 to start typing their message, any line in the body with a colon would
1121 be fontified with a gray background. This has been fixed (closes SF
1122 #855479).
1124 *** RETURN Causes Infinite Loop in mh-letter
1126 This behavior is no longer observed (closes SF #887346).
1128 *** mh-refile-msg Fails to Suggest Folder for Empty Message
1130 If you received a message with an empty body from someone who is
1131 listed in your aliases file, `o' (`mh-refile-msg') failed to suggest
1132 the correct folder. This has been fixed (closes SF #917096).
1134 *** Missing Headers When Replying to All
1136 User needed to edit `replgroupcomps' (closes SF #918194).
1138 *** Error Visiting Folder With no Unseen Messages
1140 If you visited a folder without unseen messages and the option "flist:
1141 -noshowzero" is present in your `~/.mh_profile', you'd get an error.
1142 This has been fixed (closes SF #933954).
1144 *** Error Message When Trying to Send Using MH-E
1146 This behavior is no longer observed (closes SF #1002103).
1148 *** mh-find-path Doesn't Use mhparam
1150 MH-E no longer peeks into the MH profile `~/.mh_profile' directly. It
1151 uses `mhparam' instead (closes SF #1016027).
1153 *** rmmproc Refile Complains No Such Message
1155 MH-E would get confused about which folder to delete messages from if
1156 you were refiling and deleting messages at the same time. This has
1157 been fixed (closes SF #1023959).
1159 *** auto-mode-alist Updated
1161 MH-E originally updated auto-mode-alist to set the major mode of
1162 drafts. Now that we explicitly set the mode, there is no reason to do
1163 this, and this behavior caused problems for people who didn't use MH-E
1164 who were editing files that looked like MH message files (closes SF
1165 #1032353).
1167 *** ! Doesn't Do Regions
1169 Now it does (closes SF #1046330).
1171 *** mh-show-unquote-From Fails (read-only buffer)
1173 MH-E quotes the `From ' header field that is inserted by MTAs.
1174 However, it was trying to do this in a read-only buffer. This has been
1175 fixed (closes SF #1089870).
1177 *** Whitespace in pick Expressions
1179 The `C-u / s RET' command now works. In addition, you can now add
1180 whitespace to any of the limiting (/) commands (closes SF #1122655).
1182 *** mh-index-previous-folder Does Not Work Correctly
1184 If your cursor was on an item below a folder heading and you used
1185 `M-TAB' (`mh-index-previous-folder'), you would move to the previous
1186 folder heading. This has been fixed (closes SF #1126188).
1188 *** Default Identity Prevents Insertion of Auto Fields
1190 Auto insertion of an identity now occurs even when the default
1191 identity is used (closes SF #1204506).
1193 *** mh-compose-forward and Default Message Number
1195 `mh-compose-forward' will now default to the sent message in the sent
1196 folder and the `cur' message in other folders. It also takes ranges of
1197 messages and can include multiple messages at a time (closes SF
1198 #1205890).
1200 *** Better Handling of Empty cur Sequence
1202 If you refiled a message into a folder and then used `F r'
1203 (`mh-rescan-folder') in that folder, your cursor would be taken to the
1204 first message. The cursor now stays where it was (closes SF #1207247).
1206 *** mh-customize Uses Group mh, Not mh-e
1208 The `mh' customization group alias has been deleted to avoid some
1209 problems that were found (closes SF #1213716).
1211 *** "Args out of range" Error in Displaying Message
1213 This behavior is no longer observed (closes SF #1227504).
1215 *** Front-and-back Truncation in mailto: Rendering
1217 This behavior is no longer observed (closes SF #1227510).
1219 *** Name of the Draft File in mh-comp.el
1221 MH is documented to use the draft file. If you use a draft file for
1222 something else (like Sylpheed), then use draft folders (closes SF
1223 #1231483).
1225 *** font-lock Error in mh-letter-mode
1227 An error in MH-E was introduced as a result of a change in CVS Emacs.
1228 This has been fixed (closes SF #1241017).
1230 *** Msg Display Broken After Displaying Msg with Inline Image
1232 Messages with inline images no longer trim certain message header
1233 fields (closes SF #1306141).
1235 *** mh-visit-folder Munges font-lock-keywords
1237 MH-E broke highlighting in Gnus buffers. This was actually a problem
1238 in CVS Emacs 22 and has been fixed there (closes SF #1393879).
1240 *** Illegal Filename Chars for W32 Filesystems
1242 Windows users who view `X-Image-URL:' images could not cache the
1243 images since the cached image file names had illegal characters. This
1244 has been fixed (closes SF #1396499).
1246 *** mh-send Doesn't Handle mml Insertions Via mail-user-agent
1248 Can now forward messages in Gnus if MH-E is your `mail-user-agent'
1249 (closes SF #1399307).
1251 *** Can't Narrow to Subject with Regexp Chars
1253 The command `/ s' could not limit subjects that had special pick
1254 characters (such as [, *, $, .). This has been fixed (closes SF
1255 #1432548).
1257 *** `/ s' Can Miss the Original Mail
1259 The command `/ s' failed to include the message with the "Re:" in the
1260 Subject. This has been fixed (closes SF #1438369).
1262 *** mhparam -components Fails on mailutils
1264 This error prevented MH-E from loading when using GNU mailutils. GNU
1265 mailutils drops the `s' in this argument, so we did too since
1266 -component still works in nmh and MH (closes SF #1446985).
1268 *** `/ s' Still Has Problems With []'d Mail
1270 On XEmacs, subjects that had special characters would prevent `/ s'
1271 from narrowing to the given subject. These characters are now quoted
1272 correctly in XEmacs (closes SF #1447598).
1274 *** Variable mh-send-args Is a String, Not a List
1276 This was causing errors when sending under GNU mailutils. The internal
1277 variable `mh-send-args' is now a list which fixes the problem (closes
1278 SF #1448604).
1280 *** Update Icons
1282 Most of the tool bar icons have been replaced by GTK or GNOME 2 icons
1283 (closes SF #1452715).
1285 *** Strip Build Number From emacs-version in X-Mailer
1287 This has been done (closes SF #1466481).
1289 *** Rename Function and Variable Definers
1291 If you had ever shown help for an MH-E symbol that was both a function
1292 or variable, you might have found that the hyperlink to the file
1293 brought you to the wrong definition. This has been fixed by renaming
1294 the macros `mh-defgroup', `mh-defcustom', `mh-defface',
1295 `mh-defun-compat', and `mh-defmacro-compat' to `defgroup-mh',
1296 `defcustom-mh', `defface-mh', `defun-mh', `defmacro-mh' respectively
1297 (closes SF #1472029).
1299 *** mh-insert-letter Uses Wrong Default
1301 If you had used `C-c TAB' (`mh-insert-letter') to insert a letter into
1302 your draft, specified a different folder, and chose the default
1303 message number, you got the wrong message. This has been fixed (closes
1304 SF #1473729).
1308 * Changes in MH-E 7.4.4
1310 Version 7.4.4 addresses programmatic issues from the FSF and prepares
1311 MH-E for inclusion into an impending GNU Emacs release (22.1). There
1312 are no user-visible changes (unless you are using XEmacs on DOS or
1313 don't have the cl package installed). Filenames are now unique in
1314 their first 8 characters (DOS 8.3 requirement). The runtime dependency
1315 on the cl package has been removed. Desktop saving and restoration
1316 code moved here from desktop.el.
1318 * Changes in MH-E 7.4.3
1320 Version 7.4.3 fixes the problem where `mh-identity-list' was not getting
1321 set from .emacs.
1323 * Changes in MH-E 7.4.2
1325 Version 7.4.2 fixes the accidental dependence on nmh (closes SF
1326 #791021).
1328 * Changes in MH-E 7.4.1
1330 Version 7.4.1 fixes the Makefile so it no longer tries to compile
1331 mh-unit.el.
1333 * Changes in MH-E 7.4
1335 Version 7.4 contains many new useful features including arbitrary MH
1336 range handling, new draft features such as draft form editing, as well
1337 as sequence propagation and manipulation. We've also fixed bugs and
1338 added a handful of new variables.
1340 ** New Features in MH-E 7.4
1342 *** Add Arbitrary Ranges to MH-E UI
1344 MH-E now handles any legal MH range (such as last:5 or 4 8 10-12)
1345 wherever you're prompted for a message number or sequence (closes SF
1346 #728638).
1348 *** Remove Prompting in mh-send
1350 Brian Reid's original mhe didn't do prompting anywhere but used forms
1351 instead. While we won't go that far, we eliminated prompting where a
1352 form is already involved, such as in composing a message.
1354 The new customization variable `mh-compose-prompt-flag' can be set to
1355 t to get the original behavior (closes SF #745622).
1357 *** Use TAB to Switch Fields in Header
1359 When composing a message, TAB and SHIFT-TAB can be used to move
1360 quickly between header fields. The new customization variable,
1361 `mh-compose-skipped-header-fields', contains a list of header fields
1362 that are skipped and truncated if they are too long (closes SF
1363 #745627).
1365 *** Alias Completion in Composition Buffer
1367 Aliases can be completed in the draft with "M-TAB
1368 (mh-letter-complete)". Or, if the customization variable
1369 `mh-compose-space-does-completion-flag' is set to t, then a "SPC
1370 (mh-letter-complete-or-space)" with do the same thing. If
1371 `mh-alias-flash-on-comma' is non-nil, ", (mh-letter-confirm-address)"
1372 will show the alias expansion in the minibuffer (closes SF #745634).
1374 *** Auto Fields Should be Inserted During Send
1376 Fields that were inserted by the multiple personality code when the
1377 draft was sent now insert the header fields when the draft is composed
1378 to give you a chance to edit them (closes SF #747890).
1380 *** mh-index-tick-messages
1382 The command "F ' (mh-index-ticked-messages)" creates a buffer with all
1383 messages ticked with "' (mh-toggle-tick)" in the folders listed in the
1384 new customization variable `mh-index-ticked-messages-folders'. Chances
1385 are that if you set `mh-index-new-messages-folders', you'll want to
1386 set `mh-index-ticked-messages-folders' accordingly.
1388 In addition, a general function, "F q (mh-index-sequenced-messages)"
1389 has been provided that displays messages in the `mh-unseen-seq' in the
1390 folders listed `mh-index-new-messages-folders', unless a prefix
1391 argument is given, in which case you can provide both a list of
1392 folders and a sequence (closes SF #718833).
1394 *** Narrow to Region
1396 If there is a region, "/ r (mh-narrow-to-range)" will only consider
1397 those messages in the region. In addition, there is now a stack of
1398 folder limits which can be popped with "/ w (mh-widen)". With a prefix
1399 arg, all the restrictions are popped off of the stack (closes SF
1400 #732823).
1402 *** Narrow to Ticked Sequence
1404 The buffer can now be narrowed to ticked messages with "S '
1405 (mh-narrow-to-tick)" (closes SF #732825).
1407 *** Display Multiple Buttons for multipart/alternative
1409 A new customizable variable,
1410 `mh-display-buttons-for-alternatives-flag', was added to display
1411 buttons for the alternatives. The default value is nil to retain the
1412 current behavior (closes SF #741288).
1414 *** Identity Menu Changes
1416 A menu item has been added that inserts custom fields if the To or Cc
1417 header fields match `mh-auto-fields-list'.
1419 ** New Variables in MH-E 7.4
1421 *** mh-alias-local-users-prefix
1423 This string is prepended to the real names of users from the passwd
1424 file. If nil, use the username string unmodified instead of the real
1425 name from the gecos field of the passwd file.
1427 *** mh-alias-passwd-gecos-comma-separator-flag
1429 Non-nil means the gecos field in the passwd file uses comma as a
1430 separator. Used to construct aliases for users in the passwd file."
1432 *** mh-interpret-number-as-range-flag
1434 Non-nil means interpret a number as a range. If the variable is
1435 non-nil, and you use an integer, N, when asked for a range to scan,
1436 then MH-E uses the range "last:N".
1438 *** mh-kill-folder-suppress-prompt-hook
1440 This new hook is invoked at the beginning of the `F k
1441 (mh-kill-folder)' command. It is a list of functions to be called,
1442 with no arguments, which should return a value of non-nil if you
1443 should not be asked if you're sure that you want to remove the folder.
1444 This is useful for folders that are easily regenerated.
1446 The default value of `mh-index-p' suppresses the prompt on folders
1447 generated by an index search.
1449 WARNING: Use this hook with care. If there is a bug in your hook which
1450 returns t on +inbox and you hit `F k' by accident in the +inbox
1451 buffer, you will not be happy.
1453 *** mh-refile-preserves-sequences-flag
1455 Non-nil means that sequences are preserved when messages are refiled.
1456 If this variable is non-nil and a message belonging to a sequence
1457 other than cur or Previous-Sequence (see mh-profile 5) is refiled then
1458 it is put in the same sequence in the destination folder. Additional
1459 sequences that should not to be preserved can be specified by setting
1460 `mh-unpropagated-sequences' appropriately.
1462 *** mh-visible-header-fields
1464 Customize this instead of `mh-visible-headers', which is now a defvar.
1465 This was done to mimic the relationship between
1466 `mh-invisible-header-fields' and `mh-invisible-fields'.
1468 ** Variables Deleted in MH-E 7.4
1470 *** mh-visible-headers
1472 See the paragraph for `mh-visible-header-fields' above.
1474 ** Bug Fixes in MH-E 7.4
1476 *** Aliases Constantly Reloaded
1478 The system aliases are not loaded as often as they were, so the
1479 completion speed has been dramatically improved if your passwd file is
1480 large (closes SF #693859).
1482 *** Folders in MH-Index View Not Saved
1484 When you perform a search to produce an MH-Index buffer, the folders
1485 that contain the messages are shown. If the MH-Index buffer was
1486 deleted, or Emacs was restarted and the corresponding folder
1487 rescanned, the folder information would be lost. This has been fixed
1488 by saving the information in a file called ".mhe_index" (closes SF
1489 #701762).
1491 *** Ticking Messages in +mhe-index/new
1493 If a new message in a buffer created by "F n" was ticked (with "'"),
1494 the message would not be added to the tick sequence in the source
1495 folder. This has been fixed so that any sequence changes in any index
1496 folder (from within MH-E of course) are now reflected back to the
1497 corresponding source folder (closes SF #709664).
1499 *** Custom Vars Set by a Function
1501 The default setting of customization variable `mh-summary-height' is
1502 now `nil' which means MH-E will change the size dynamically according
1503 to the size of the frame (closes SF #723267).
1505 *** Folder Completion Slow
1507 The first folder completion was very slow. This has been fixed (closes
1508 SF #730426).
1510 *** Tick Sequence Persistent When Refiled
1512 Sequences are now preserved when messages are refiled (closes SF
1513 #737128).
1515 *** Auto-inserted Header Fields Inconsistent
1517 For consistency, all automatically inserted header fields (such as
1518 X-Mailer and X-Face) are added when the draft is first presented to
1519 you. This also gives you a chance to edit or delete them if necessary
1520 (closes SF #745624). Note that we would be distressed if you deleted
1521 the X-Mailer field.
1523 *** Toolbar Spec Error
1525 The following message appeared when displaying a message in XEmacs:
1527   Signaling: (error "Toolbar spec must be list or nil" )
1529 This has been fixed (closes SF #745655).
1531 *** mh-index-search Doesn't Find Short Acronyms
1533 Swish typically ignores words with fewer than four letters, but will
1534 still look for acronyms. Unfortunately, MH-E was downcasing the input
1535 words which defeated this feature. This has been fixed (closes SF
1536 #755718).
1540 * Changes in MH-E 7.3
1542 This release includes the new features of an index view of unseen
1543 messages in all folders, spam software support, relative folder
1544 specification @ support, marking messages, recipient handling by
1545 mh-default-folder-list, Face and X-Image-URL header field support, and
1546 Fcc completion. Function arguments have been unified. Bugs have been
1547 fixed.
1549 ** New Features in MH-E 7.3
1551 *** Unified Function Arguments
1553 Any function with MSG-OR-SEQ in its docstring uses the displayed
1554 message by default for this argument. However, if a prefix argument is
1555 provided, then the user is prompted for a message sequence. If the
1556 variable `transient-mark-mode' is non-nil and the mark is active, then
1557 the function operates on the messages in the selected region. In a
1558 program, MSG-OR-SEQ can be a message number, a list of message
1559 numbers, a region in a cons cell, or a sequence.
1561 *** MH-Index View of Unseen Messages
1563 Use "F n (mh-index-new-messages)" or Folder -> View New Messages menu
1564 item to display messages in the `mh-unseen-seq' sequence in folders
1565 specified by `mh-index-new-messages-folders'. With a prefix argument,
1566 enter a space-separated list of folders, or nothing to search all
1567 folders.
1569 Like other MH-Index folders, use "v (mh-index-visit-folder)" if you
1570 wish to visit the original folder with the unseen message. This is
1571 usually not necessary since the original message is annotated if you
1572 reply, deleted if you delete the message, or refiled if you refile the
1573 message (closes SF #701756).
1575 *** Spam Software Support
1577 MH-E now supports several spam filters including Bogofilter,
1578 SpamProbe, and SpamAssassin. Spam that is mistakenly considered to be
1579 good mail can be reclassified as spam with "J b (mh-junk-blacklist)".
1580 Conversely, good mail that is accidently considered to be spam can be
1581 reclassified with "J w (mh-junk-whitelist)" (closes SF #669518).
1583 If a message is blacklisted, and `mh-junk-mail-folder' is a string,
1584 then the message is refiled to that folder. If this variable is nil,
1585 the message is deleted. If a message is whitelisted, then the message
1586 is refiled to `mh-inbox'.
1588 To change the spam program being used, customize `mh-junk-program'.
1589 This should only be necessary if you have multiple filters on your
1590 system and MH-E picked the wrong one. These customization variables
1591 are found in the new customization group `mh-junk'.
1593 The documentation for the following functions describes what setup is
1594 needed for the different spam fighting programs:
1596   - `mh-bogofilter-blacklist'
1597   - `mh-spamprobe-blacklist'
1598   - `mh-spamassassin-blacklist'
1600 *** Relative Folder Specification @ Supported
1602 You can now use the relative folder marker @ in folder names (closes
1603 SF #666774).
1605 *** Marking Messages
1607 Messages can now be highlighted with "' (mh-toggle-tick)", Sequence ->
1608 Toggle Tick Mark menu item or the "Toggle tick mark" button. These
1609 messages are added to the "tick" sequence, although this sequence can
1610 be changed in `mh-tick-seq'. The highlighting effect can be modified
1611 by customizing `mh-folder-tick-face' (closes SF #623367).
1613 There is also a new keybinding "/ ' (mh-narrow-to-tick)" and menu item
1614 Sequence -> Narrow to Tick Sequence to narrow the view to the
1615 highlighted messages.
1617 *** mh-default-folder-list Now Takes Recipients
1619 If you wish to file a message based upon the recipient of a message
1620 (such as a mailing list), you can now indicate that when filling out
1621 the address in the `mh-default-folder-list' customization variable.
1623 *** Face Header Field Supported
1625 In addition to the X-Face header field, the Face header field, which
1626 can display color images, is now supported. As a bonus, the external
1627 xface-e21 library is no longer required.
1629 *** X-Image-URL Support
1631 Images specified in X-Image-URL header fields are now supported.
1632 See the customization variable `mh-fetch-x-image-url' to enable this
1633 support.
1635 *** Fcc Completion
1637 Folders in Fcc fields in message drafts can now be completed with
1638 M-TAB.
1640 ** New Variables in MH-E 7.3
1642 Variables that have been added to MH-E that have not been discussed
1643 elsewhere are listed here.
1645 *** mh-auto-fields-list
1647 Alist of addresses for which header lines are automatically inserted.
1648 When a regular expression matches in the To or cc fields of a message,
1649 the corresponding header field is automatically inserted in the
1650 message header. It also allows the automatic setting of an identity
1651 (using `mh-insert-identity') to set an alternate identity when sending
1652 messages to a certain person or mailing list.
1654 Since this is a more general use of `mh-insert-mail-followup-to-flag'
1655 and `mh-insert-mail-followup-to-list', these variables have been removed.
1657 *** mh-show-xface-face
1659 Face for displaying the X-Face image.
1661 *** mh-xemacs-toolbar-position
1663 This customization variable allows the user to place the toolbar on
1664 the four edges of the frame.
1666 *** mh-xemacs-use-toolbar-flag
1668 This customization variable is used to enable or disable the toolbar
1669 under XEmacs.
1671 ** Variables Deleted in MH-E 7.3
1673 Variables that have been removed from MH-E that have not been
1674 discussed elsewhere are listed here.
1676 *** mh-decode-content-transfer-encoded-message-flag
1678 No longer needed since the external program mimencode is no longer
1679 used.
1681 *** mh-index-show-hook
1683 This hook was never used, so it was removed.
1685 *** mh-tool-bar-reply-3-buttons-flag
1687 Obsolete. This functionality is present `mh-tool-bar-folder-buttons'.
1689 ** Bug Fixes in MH-E 7.3
1691 *** Can't Refile Message
1693 Messages with invalid addresses were causing errors in ali which
1694 prevented the refiling of messages. The ali error is now shown in the
1695 "*MH-E Log*" buffer and refiling suggests the last folder used (closes
1696 SF #680388).
1698 *** Empty Body Triggers Duped Header
1700 If the body was empty the header would be treated like the body and
1701 was therefore displayed twice. This has been fixed (closes SF
1702 #681162).
1704 *** mml or mhl Directives Not Always Processed
1706 The mml and mhl directives used to create body parts were not
1707 processed if one re-edited a draft, or if they added the directives
1708 manually. The directives are now always processed upon sending the
1709 letter. You may still, of course, use "C-c C-m m (mh-mml-to-mime)" or
1710 "C-c C-e (mh-edit-mhn)" to manually create the MIME body parts from
1711 the directives and then send the draft.
1713 *** mh-alias-grab-from-field Fails
1715 MH-E was adding aliases with angle brackets around the address when
1716 there wasn't a phrase (usually, the user's name), to go with it. This
1717 caused ali to fail which caused problems in MH-E. This is probably a
1718 bug in ali, but MH-E no longer inserts angle brackets around the
1719 address unless there is a phrase, which avoids the problem (closes SF
1720 #690216).
1722 *** XEmacs Fixes
1724 MH-E is now fully supported under XEmacs and compiles without any
1725 warnings.
1727 In particular, the following now work under XEmacs:
1729 - X-Face, Face, and X-Image-URL header fields
1730 - MH-E logo in mode line
1731 - Emphasis (bold, italics, etc.)
1732 - Smilies
1733 - Toolbar
1735 *** Indexed Folders Should Respect mh-show-threads-flag
1737 Indexed folders are now threaded if `mh-show-threads-flag' is non-nil
1738 (closes SF #709667).
1740 *** Threading Index View Loses Folder Info
1742 This has been fixed (closes SF #709672).
1744 *** No Undo Information When Re-editing Drafts
1746 Undo is turned on in the draft buffer when using "e (mh-edit-again)"
1747 (closes SF #712777).
1749 *** Forwarded base64-encoded Messages Are Incorrectly Displayed
1751 This has been fixed (closes SF #681518).
1753 *** Append to *MH-E Log* Buffer
1755 The last 100 lines of log messages are kept in the *MH-E Log* buffer.
1756 Previously, the buffer was erased every time it was written (closes SF
1757 #685476). In addition, many of the MH-E commands now send their output
1758 into this buffer instead of a plethora of other special-purpose
1759 buffers.
1761 *** mh-inc-folder Complains if No Mail and No Current Message
1763 The function `mh-inc-folder' no longer calls `mh-show' if point is not
1764 on a valid scan line. This keeps `mh-inc-folder' from complaining
1765 (closes SF #678115).
1767 *** Folder Normalization Strips Leading Slash
1769 Leading "/" characters in folder names entered by the user were being
1770 lost. This has been fixed (closes SF #676890).
1772 *** Print Header Doesn't Show Message
1774 When printing a sequence, the header simply indicated that a sequence,
1775 but not which one, was being printed and did not show the message
1776 number. This has been fixed. If more than one message is printed, a
1777 page of the scan lines is printed and its header indicates the
1778 sequence or message range. The pages with the actual messages all set
1779 the header to the folder and message displayed on that page.
1781 *** Aliases Constantly Reloaded
1783 Empty lists are now handled properly (closes SF #693859).
1785 *** Remove RCS Keywords
1787 Removed RCS keywords per Emacs conventions (closes SF #680731).
1789 *** Replace Mimencode
1791 MH-E was enhanced to decode message based on charset and
1792 Content-Transfer-Encoding. This eliminates the need for the external
1793 program mimencode (closes SF #674857).
1797 * Changes in MH-E 7.2
1799 This release includes the new features of filing hints, hierarchical
1800 file name completion, indexed search and pick integration, unification
1801 between `mh-visit-folder' and the speedbar, a displayed message
1802 indicator, buffer name organization, support for mairix indexed
1803 search, and last but not least, the MH-E logo has been added to the
1804 mode line. Code that handles sequences and message regions runs
1805 faster. Bugs have been fixed.
1807 ** New Features in MH-E 7.2
1809 *** Filing Hints
1811 When you file a message, MH-E now looks for an alias corresponding to
1812 the address of the sender and offers that as a default folder (closes
1813 SF #657096). The new variable `mh-default-folder-prefix' can be used
1814 to put these folders in a sub-folder. The new variable
1815 `mh-default-folder-must-exist-flag' means to suppress the suggested
1816 folder (thereby providing the previous folder used) if the folder
1817 doesn't already exist. The new variable `mh-default-folder-list' can
1818 be used to map additional addresses and folders.
1820 *** Hierarchical File Name Completion
1822 When you completed filenames in the past, you were presented with a
1823 list of all your folders at all depths in the tree. Now you are
1824 presented with only one level at a time (closes SF #664821).
1825 As a result, the variables `mh-auto-folder-collect-flag' and
1826 `mh-folder-list-change-hook' are obsolete.
1828 *** Indexed Search and Pick Integration
1830 The indexed and pick searches have been integrated (closes SF
1831 #664816). Both "F s (mh-search-folder)" and "F i (mh-index-search)"
1832 use the pick template for forming queries. To submit the query, use
1833 "C-c C-c (mh-do-search)" which will use the query method you selected.
1834 If you change your mind while forming the query, you can use "C-c C-i
1835 (mh-index-do-search)" or "C-c C-p (mh-pick-do-search)" to submit the
1836 query using the respective method.
1838 Second, the results from a pick search are now saved in a sub-folder
1839 of +mhe-index like an indexed search.
1841 Third, `pick' is now a valid choice for `mh-index-program'.
1843 *** mh-visit-folder Metamorphosis Continues
1845 When visiting a folder from the speedbar, only the unseen messages are
1846 shown if there are unseen messages. If there aren't any unseen
1847 messages, all of the messages are shown if there are fewer than
1848 `mh-large-folder' messages; otherwise, the user is prompted for the
1849 range of messages to display. The "F v (mh-visit-folder)" command has
1850 been modified to mimic this behavior. Use a prefix arg to force the
1851 message range prompt.
1853 *** Displayed Message Indicator
1855 In graphical Emacs, the message that is shown is marked by a triangle
1856 in the fringe. In textual Emacs, there is a ">" in the first column
1857 (closes SF #664824).
1859 *** Buffer Name Organization
1861 All ephemeral buffer names start with " *mh" while all interesting
1862 buffers start with "*MH-E ". The "*Folders*", "*Sequences*", and
1863 "*Recipients*" buffers were therefore renamed to "*MH-E Folders*",
1864 "*MH-E Sequences*" and "*MH-E Recipients*" respectively (programmers
1865 should see mh-utils.el for the names of the new constants). Also, the
1866 output of MH commands is saved in the "*MH-E Log*" buffer.
1868 *** mh-index-program
1870 Add choices for `mairix' and `pick'.
1872 *** Logo Displayed on Mode Line
1874 ** New Variables in MH-E 7.2
1876 The new variables have been discussed elsewhere.
1878 ** Bug Fixes in MH-E 7.2
1880 *** mh-decode-content-transfer-encoded-message
1882 Messages that had been encoded with base64 were not decoded. This has
1883 been fixed with this new function (closes SF #674190). As a result,
1884 the variable `mh-decode-quoted-printable-flag' has been renamed to
1885 `mh-decode-content-transfer-encoded-message-flag'.
1887 *** mh-kill-folder
1889 Now restores previous window configuration (closes SF #664828).
1891 *** mh-mime-display
1893 MH-E was not using the charset defined in the content-type
1894 header. This meant that mail in a different charset would not
1895 be properly displayed. This has been fixed (closes SF #655123).
1897 *** mh-read-address
1899 In XEmacs and Emacs20, this function would always prompt using "To: "
1900 instead of using the command argument. This has been fixed (closes SF
1901 #670913).
1903 *** mh-rmail
1905 Unseen messages are now shown in addition to new ones (closes SF
1906 #667542).
1908 *** mh-scan-msg-overflow-regexp
1910 Change the variable so that a space is always maintained in the
1911 beginning of the scan line.
1913 *** mh-swish-execute-search
1915 The example configuration file in the docstring didn't show the
1916 backslash in the FileRules filename. If the example had been used
1917 literally by the user, no files would be indexed! This has been fixed
1918 (closes SF #665888).
1920 *** mh-thread-refile
1922 The "T o (mh-thread-refile)" command did not provide refiling hints
1923 like `mh-refile-msg'. This has been fixed (closes SF #664829).
1925 *** mh-toggle-threads
1927 If the threaded view was modified and then toggled, the standard view
1928 may not have been accurate (as it contained a potentially old first
1929 message to last message range). This has been fixed (closes SF
1930 #626117).
1932 *** mh-tool-bar-show-set, mh-tool-bar-letter-set, mh-tool-bar-folder-set
1934 Clicking the customize and help buttons now deletes the other windows
1935 in the frame.
1937 *** mh-version
1939 The "M-x mh-version" command displayed "Aliasfile: aliases". This has
1940 been fixed (closes SF #664467). See Buffer Name Organization above.
1944 * Changes in MH-E 7.1
1946 This release includes the new features of multiple identities and
1947 alias completion. In addition, indexed searching has been revamped.
1948 Various other features have been added and a few bugs were fixed.
1950 ** New Features in MH-E 7.1
1952 *** Multiple Identities
1954 MH-E now supports multiple identities (closes SF #628782). That means
1955 that you can have different From and Organization header fields (or
1956 any other header field of your choice) as well as different signatures
1957 depending on your context. Usually, the contexts are home and work.
1959 Add your identities to the variable `mh-identity-list' and set the
1960 default identity with the variable `mh-identity-default'. Your
1961 identity can be switched on the fly by using the Identity menu or by
1962 calling "M-x mh-insert-identity RET".
1964 This functionality can be customized within the mh-identity group.
1966 *** Alias Completion and Harvesting
1968 The contributed file mh-alias.el has been rewritten and incorporated
1969 into MH-E.
1971 By default, aliases are culled from the system files
1972 "/etc/nmh/MailAliases," "/usr/lib/mh/MailAliases," and "/etc/passwd"
1973 (see `mh-alias-system-aliases') and from your "AliasFile" MH profile
1974 component. These aliases are then used for completion in the
1975 minibuffer when entering addresses. Within the header of the message
1976 draft, "M-TAB (mh-letter-complete)" is used to do alias completion.
1978 The package also provides for alias creation based upon the From
1979 header field of the current message. Use the lasso button
1980 (mh-alias-grab-from-field).
1982 This functionality can be customized within the mh-alias group.
1984 *** Index Folder Updates
1986 The results of an index search "F i (mh-index-search)" are now stored
1987 in a bona fide folder so that you can refile messages and reply to
1988 messages directly from the result folder. This folder is a sub-folder
1989 of +mhe-index and the name is based upon the search string (closes SF
1990 #623321).
1992 If a prefix argument is given then the search in the current index
1993 buffer is redone.
1995 The index folder lists the names of the source folders as before.
1996 However, instead of using RET on the name of the folder to visit the
1997 folder, use "v (mh-show-index-visit-folder)" anywhere within the
1998 results to visit that folder narrowed to the results of the search.
1999 Additional functions have been added to navigate including "TAB
2000 (mh-index-next-folder)", and "SHIFT-TAB (mh-index-previous-folder)."
2002 *** mh-visit-folder Interface Updated
2004 A change was made to the prompting of the message range. In general,
2005 you can use the same format for messages and sequences as you can in
2006 MH with a single exception: a single number means to scan that many
2007 messages, rather than scan that message number. This turns out to be
2008 much more useful than visiting a single message and is consistent with
2009 Gnus and the MH-E speedbar (closes SF #655891).
2011 If mh-visit-folder is called non-interactively and RANGE is nil then
2012 all messages are displayed. This behavior is now documented and
2013 provides backwards compatibility.
2015 *** Threading Improvements
2017 After incorporating new mail into a threaded folder, unseen messages
2018 can be spread about. Two new functions have been added to make it
2019 easier to find them: these are "M-n (mh-next-unread-msg)" and "M-p
2020 (mh-previous-unread-msg)" (closes SF #630328)
2022 Two new functions were added to delete and refile threads. They are "T
2023 d (mh-thread-delete)" and "T o (mh-thread-refile)" respectively
2024 (closes SF #630493).
2026 In addition, the key "k" used to be bound to the function
2027 `mh-delete-subject': it is now bound to
2028 `mh-show-delete-subject-or-thread'.
2030 New functions to navigate threads include "T u (mh-thread-ancestor)",
2031 which can jump to the root message of the current thread given an
2032 optional argument, "T n (mh-thread-next-sibling)", and "T p
2033 (mh-thread-previous-sibling)"
2035 *** Refiling of Messages in Region
2037 If mark is active and `transient-mark-mode' is enabled then all the
2038 messages in the region are refiled.
2040 *** vCard Handling
2042 If a signature cannot be identified, but there is a vCard attachment,
2043 then that vCard will be presented as a signature (closes SF #649216).
2045 *** New Info Added to mh-version
2047 Information about Gnus versions available at both compile time and run
2048 time has been added.
2050 ** New Variables in MH-E 7.1
2052 The defcustom groups were reorganized. Rather than iterate the
2053 specific changes here, you are invited to browse the groups with "M-x
2054 mh-customize RET".
2056 *** mh-alias-completion-ignore-case-flag
2058 Non-nil means don't consider case significant in MH alias completion.
2059 This is the default in plain MH, so it is the default here as well. It
2060 can be useful to set this to t if, for example, you use lowercase
2061 aliases for people and uppercase for mailing lists.
2063 *** mh-alias-expand-aliases-flag
2065 Non-nil means to expand aliases entered in the minibuffer. In other
2066 words, aliases entered in the minibuffer will be expanded to the full
2067 address in the message draft. By default, this expansion is not
2068 performed.
2070 *** mh-alias-flash-on-comma
2072 Specify whether to flash the translation of the alias or warn if there
2073 isn't a translation of the alias.
2075 *** mh-alias-insert-file
2077 Filename to use to store new MH-E aliases. This variable can also be a
2078 list of filenames, in which case MH-E will prompt for one of them. If
2079 nil, the default, then MH-E will use the first file found in the
2080 "AliasFile" component of the MH profile.
2082 *** mh-alias-insertion-location
2084 Specifies where new aliases are entered in alias files. Options are
2085 sorted alphabetically (the default), at the top of the file or at the
2086 bottom.
2088 *** mh-alias-local-users
2090 If t, local users are completed in MH-E To: and Cc: prompts.
2092 If you set this variable to a string, it will be executed to generate
2093 a password file. A value of "ypcat passwd" is helpful if NIS is in
2094 use.
2096 *** mh-alias-system-aliases
2098 A list of system files from which to cull aliases. If these files are
2099 modified, they are automatically reread. This list need include only
2100 system aliases and the passwd file, since personal alias files listed
2101 in your "AliasFile" MH profile component are automatically included.
2103 *** mh-identity-default
2105 Default identity to use when `mh-letter-mode' is called.
2107 *** mh-identity-list
2109 List holding MH-E identity.
2111 *** mh-invisible-header-fields
2113 Simple user interface to change `mh-invisible-headers'.
2115 *** mh-letter-complete-function
2117 Function to call when completing outside of fields specific to
2118 aliases. By default, it is bound to 'ispell-complete-word.
2120 *** mh-show-threads-flag
2122 Non-nil means new folders start in threaded mode. Threading large
2123 number of messages can be time consuming. So if the flag is non-nil
2124 then threading will be done only if the number of messages being
2125 threaded is less than `mh-large-folder' (closes SF #646794).
2127 *** mh-tool-bar-folder-buttons
2129 Buttons to include in MH-E folder/show toolbar.
2131 *** mh-tool-bar-letter-buttons
2133 Buttons to include in MH-E letter toolbar.
2135 ** Bug Fixes in MH-E 7.1
2137 *** mh-get-new-mail
2139 Call new function `mh-add-cur-notation' to undo the work of
2140 `mh-remove-cur-notation' if there was no new mail (closes SF #647681).
2142 *** mh-set-cmd-note
2144 No longer updates the default `mh-cmd-note' value. This resulted in
2145 the misplacement of the current mark when the message number width
2146 changed (closes SF #643701).
2150 * Changes in MH-E 7.0
2152 This is a major release which includes a lot of new features including
2153 improved MIME handling, speedbar folder browsing, and indexed
2154 searching. In this version, MH-E runs under XEmacs, passes checkdoc,
2155 and compiles clean under all supported platforms.
2157 The "passes checkdoc" feature above required changing the name of
2158 several user-visible variables. It is likely that this affects you.
2159 Please be sure to see the table at the end of these notes and rename
2160 your variables accordingly.
2162 MH-E has been written mh-e, Mh-e, MH-e and MH-E. We have decided that
2163 the proper term should be MH-E. Please try to use MH-E in your
2164 writing.
2166 ** New Features in MH-E 7.0
2168 *** Speedbar
2170 There is now support for the speedbar. Try "M-x speedbar" (closes SF
2171 #503727).
2173 Press the middle mouse button on the `+' icons to open a folder,
2174 middle mouse button on a folder name to open the folder. Folders with
2175 unseen messages are shown in bold, so this is a handy way to browse
2176 new messages that you have filed with procmail or slocal.
2178 See the new customization variable `mh-large-folder,' which controls
2179 when the speedbar asks for how many messages to scan when opening a
2180 large folder and `mh-speed-run-flists-flag' whose default value of t
2181 means to use the flists command to populate the count of unseen and
2182 total messages in each folder.
2184 *** Indexed Search
2186 Interoperability with swish++, swish, glimpse, and namazu has been
2187 added to enable lightening-fast searches of your mail. If none of
2188 these are present, grep is used. Try "F i (mh-index-search)".
2190 For more information, read the documentation for the functions
2191 `mh-swish++-execute-search,' `mh-swish-execute-search,'
2192 `mh-namazu-execute-search,' or `mh-glimpse-execute-search' depending
2193 on your preferred indexing program to see what kind of setup is needed
2194 to generate the index.
2196 *** Threading
2198 Use "T t (mh-toggle-threads)" to view the threads in the folder. Use
2199 it again to return to a non-threaded view.
2201 *** Brief Help
2203 Use "? (mh-help)" and "X ? (mh-prefix-help)," where X is a prefix
2204 character, for a brief synopsis in the minibuffer of frequently used
2205 commands. In the MH-Letter or MH-Pick buffers, use "C-c ? (mh-help)"
2206 (closes SF #493740).
2208 *** Folder Keymap Shared by Show Buffer
2210 You can now use the MH-Folder mode commands from the MH-Show buffer.
2211 Because of this, the MH-Show buffer is now read-only (closes SF
2212 #493749 and SF #527946) and you now have to use "M (mh-modify)" to
2213 edit a message.
2215 *** Better Scanning
2217 You no longer have to modify your scan format if your folders have
2218 more than 9999 messages in them. If you've only modified your scan
2219 format file to allow for the wider message numbers, consider using the
2220 default behavior of MH-E and simplify your MH-E configuration
2221 considerably (closes SF #635791).
2223 To do this, you may have to remove your modifications of
2224 `mh-scan.*-regexp' and `mh-cmd-note' and your customization of
2225 `mh-scan-format-file'.
2227 You may still want the updated format files for running MH commands
2228 outside of MH-E; the default of `mh-scan-format-file' will cause them
2229 to be ignored.
2231 If you prefer fixed-width message numbers, set the new customization
2232 variable to nil , set this variable to
2233 nil and call `mh-set-cmd-note' with the width specified by the scan format in
2234 `mh-scan-format-file'. For example, the default width is 4, so you would use
2235 "(mh-set-cmd-note 4)" if `mh-scan-format-file' were nil.
2237 *** X-Face
2239 MH-E now displays the content of the X-Face header field in the From
2240 field. When sending a message, an X-Face field is appended to the
2241 header if it doesn't already exist and "~/.face" is present. See the
2242 new customization variables `mh-show-use-xface-flag' and `mh-x-face-file'
2243 (closes SF #480770).
2245 MH-E depends on the external x-face package found in
2246 ftp://ftp.jpl.org/pub/elisp/ to do this. The `uncompface' binary is
2247 also required to be in the execute PATH. It can be obtained from:
2248 http://freshmeat.net/redir/compface/1439/url_tgz/compface-1.4.tar.gz.
2250 It has also been observed that if you don't see the faces, you might
2251 have to do this (for unknown reasons):
2253     mv /usr/local/include/compface.h /usr/include/
2255 *** Graphical Smileys
2257 Smiley's are now converted to cute little images. See the new
2258 customization variable `mh-graphical-smileys-flag.'
2260 *** Text Emphasis
2262 ASCII formatting is now converted to the appropriate font. For
2263 example, _underline_ is underlined, *bold* appears in bold, /italic/
2264 appears in italic, etc. See `gnus-emphasis-alist' for the whole list.
2265 See the new customization variables `mh-decode-mime' and
2266 `mh-graphical-emphasis-flag.'
2268 *** Attachment Handling
2270 Inline attachments are now displayed. Regular attachments appear as
2271 buttons in show buffer. Use "K TAB (mh-next-button)" or "K SHIFT-TAB
2272 (mh-prev-button)" to cycle through these buttons. Use "K v
2273 (mh-folder-toggle-mime-part)" to view, "K o
2274 (mh-folder-save-mime-part)" to save one part or "K-a
2275 (mh-save-mime-parts)" to save all parts, or "K i
2276 (mh-folder-inline-mime-part)" to view the attachment inline.
2278 See the new customization variable `mh-decode-mime' for additional
2279 information. Other customization variables that affect this new feature
2280 include `mh-store-mime-parts-default-directory' and
2281 `mh-display-buttons-for-inline-parts-flag'.
2283 HTML documents can be viewed inline if Gnus v5.10 and w3 or w3m lisp
2284 packages are present. Set the customization variable
2285 `mm-text-html-renderer' accordingly (closes SF #453352).
2287 *** Quoted-printable Handling
2289 Quoted-printable body parts are now decoded.
2291 *** More Choices for `mh-yank-from-start-of-msg'
2293 Historically, if this variable was t, the entire message, with full
2294 headers would be included and every line would begin with
2295 `mh-ins-buf-prefix.' This usage is deprecated in favor of the setting
2296 `supercite' below. The default has been changed to `attribution.' The
2297 following symbols are now understood:
2299 `body': yank the message minus the header.
2301 `supercite': include the entire message, with full headers. This also
2302 causes the invocation of `sc-cite-original' without the setting of
2303 `mail-citation-hook', now deprecated practice.
2305 `autosupercite': do as for `supercite' automatically when show buffer
2306 matches the message being replied-to.
2308 `attribution': yank the message minus the header and add a simple
2309 attribution line at the top.
2311 `autoattrib': do as for `attribution' automatically when show buffer
2312 matches the message being replied-to.
2314 There is a new customization variable called
2315 `mh-extract-from-attribution-verb' which is used for attribution which
2316 provides a method for setting a different language.
2318 *** Use Gnus mml Instead of mhn
2320 When inserting attachments into a message draft, Gnus mml directives
2321 are now used instead of mhn directives. One beneficial side-effect of
2322 this is that attachments can now appear inline as well as separate.
2324 The new customization variable `mh-compose-insertion' controls whether
2325 Gnus or mhn is used to insert MIME message directives in messages
2326 (default: 'gnus, if the mml library exists).
2328 *** Content-Type Now Obtained Automatically
2330 The value of the Content-Type no longer needs to be entered by the
2331 user.
2333 *** Attachments Automatically Included Upon Send
2335 You no longer have to run "C-c C-e (mh-edit-mhn)" before sending a
2336 message with attachments--this is done automatically when you send the
2337 message with "C-c C-c (mh-send-letter)". There is, however, a new key
2338 binding "C-c C-m m (mh-mml-to-mime)" which is analogous to "C-c C-e
2339 (mh-edit-mhn)".
2341 *** GPG Handling
2343 Messages that have been signed or encrypted with GPG are verified and
2344 decrypted automatically. To sign or encrypt a message, use "C-c RET
2345 C-s (mh-mml-secure-message-sign-pgpmime)" and "C-c C-m C-e
2346 (mh-mml-secure-message-encrypt-pgpmime)." You need Gnus version 5.10
2347 for this feature. These functions are provided by the pgg.el package.
2349 Users report "flashing" with the pgg.el package and prefer the gpg.el
2350 package instead. To use gpg.el instead of the pgg.el package you need:
2352   (setq mml2015-use 'gpg)
2354 To mimic automatic encryption in gpg.el, use:
2356   (setq mm-verify-option 'always)
2357   (setq mm-decrypt-option 'always)
2359 The venerable mailcrypt package is also an option. However, now that
2360 show buffers are read-only, mailcrypt version 3.5.6 and older fail
2361 when they attempt to decrypt the contents.
2363 *** Mail-Followup-To Header Field
2365 Support for this controversial field has been added because nmh
2366 supports it (closes SF #627035). If you want to add it to outgoing
2367 mail for selected mailing lists, add those mailing lists to the new
2368 customization variable `mh-insert-mail-followup-to-list.' If you think
2369 this field is evil, set the new customization variable
2370 `mh-insert-mail-followup-to-flag' to nil.
2372 *** Gnus Issues
2374 If you update Gnus, you must recompile MH-E. Note that if you are
2375 running the stock version of MH-E that comes with Emacs or the MH-E
2376 package on a Debian GNU/Linux, this is done for you.
2378 ** New Variables in MH-E 7.0
2380 New customization variables not mentioned earlier include:
2382 *** mh-letter-insert-signature-hook
2384 Invoked at the beginning of the "C-c C-s (mh-insert-signature)"
2385 command. Can be used to determine which signature file to use based on
2386 message content. On return, if `mh-signature-file-name' is non-nil
2387 that file will be inserted at the current point in the buffer.
2389 *** mh-show-maximum-size
2391 Maximum size of message (in bytes) to display automatically. Provides
2392 an opportunity to skip over large messages which may be slow to load.
2393 Use a value of 0 to display all messages automatically regardless of
2394 size (closes SF #488696).
2396 *** mh-tool-bar-reply-3-buttons-flag
2398 Non-nil means use three buttons for reply commands in tool-bar. If you
2399 have room on your tool-bar because you are using a large font, you may
2400 set this variable to expand the single reply button into three buttons
2401 that won't lead to minibuffer prompt about who to reply to.
2403 ** Bug Fixes in MH-E 7.0
2405 *** mh-delete-msg, mh-refile-msg, mh-undo
2407 Mandrake Linux includes XEmacs initialization code that binds
2408 `transient-mark-mode' which causes problems in MH-E. These problems
2409 have been fixed (closes SF #541915).
2411 *** mh-edit-again
2413 This would sometimes yield a read-only buffer. This has been fixed
2414 (closes SF #624283 and SF #625538).
2416 *** mh-forward
2418 When using nmh, always specify -mime so as to preserve the original
2419 message(s).
2421 *** mh-inc-folder
2423 If you had narrowed to a sequence and then incorporated new mail,
2424 those new messages would not be present in your +inbox when you
2425 widened. This has been fixed (closes SF #489430, SF #489437, SF
2426 #629233).
2428 *** mh-insert-letter
2430 No longer uses mhl to include a message as this mangled the header and
2431 gave supercite fits (closes SF #629153).
2433 *** mh-letter-mode
2435 "M-q (fill-paragraph)" now fills quoted paragraphs (for example,
2436 starting with "> ") correctly (closes SF #489927).
2438 *** mh-next-undeleted-msg, mh-previous-undeleted-msg
2440 If there are no more undeleted messages the point remains at its
2441 original position and a message is produced (closes SF #494304).
2443 *** mh-pick-mode
2445 Now calls `mh-pick-mode-hook' as documented.
2447 *** mh-put-msg-in-seq
2449 Now puts all messages in region in sequence (closes SF #630324).
2451 *** mh-refile-msg, mh-write-msg-to-file
2453 These functions stomped on the variables that held the name of the
2454 last file and folder respectively for the other function. This has
2455 been fixed so that the last folder or file name is preserved (closes
2456 SF #580772).
2458 *** mh-region-to-sequence
2460 If the region in MH-Folder was set with "C-x h (mark-whole-buffer)",
2461 you couldn't perform operations on all of the messages as you would
2462 expect. This has been fixed (closes SF #621632).
2464 *** mh-reply
2466 Performing an undo the first thing after replying would blank out the
2467 entire draft. Now just the insertion of the yanked message is undone
2468 leaving the header and signature intact for additional editing (closes
2469 SF #623693).
2471 *** mh-show-mode
2473 Now calls `mh-show-mode-hook' as documented (closes SF #627222).
2475 *** mh-subject-thread-to-sequence
2477 Make 'subject sequence a real one, exported to MH. This means you can,
2478 for example, mh-forward it. But it also shows up with a mark in the
2479 scan output (closes SF #489445).
2481 *** Other Bug Fixes
2483 The following bugs have also been closed:
2485 SF #495450: Folder buffer read-only after inc
2486 SF #489706: mh-page-msg bombs out
2487 SF #580772: mh-last-destination is overloaded
2489 *** Variables renamed to conform with Emacs coding conventions
2491 The coding conventions require that boolean variables end in -flag.
2492 The following two tables show which variables were affected (closes SF
2493 #627015).
2495 Customization Variables (defcustom)
2497 Old Name                               New Name
2499 mh-auto-folder-collect                 mh-auto-folder-collect-flag
2500 mh-bury-show-buffer                    mh-bury-show-buffer-flag
2501 mh-clean-message-header                mh-clean-message-header-flag
2502 mh-decode-quoted-printable             mh-decode-quoted-printable-flag
2503 mh-delete-yanked-msg-window            mh-delete-yanked-msg-window-flag
2504 mh-do-not-confirm                      mh-do-not-confirm-flag
2505 mh-highlight-citation-p                mh-highlight-citation
2506 mh-insert-x-mailer-p                   mh-insert-x-mailer-flag
2507 mh-print-background                    mh-print-background-flag
2508 mh-recenter-summary-p                  mh-recenter-summary-flag
2509 mh-recursive-folders                   mh-recursive-folders-flag
2510 mh-reply-show-message-p                mh-reply-show-message-flag
2511 mh-show-use-goto-addr                  mh-show-use-goto-addr-flag
2512 mh-update-sequences-after-mh-show      mh-update-sequences-after-mh-show-flag
2514 Regular Variables (defvar)
2516 Old Name                               New Name
2518 mh-mhn-compose-insert-p                mh-mhn-compose-insert-flag
2519 mh-nmh-p                               mh-nmh-flag
2520 mh-page-to-next-msg-p                  mh-page-to-next-msg-flag
2524 * Changes in mh-e 6.1
2526 This is a minor release which includes a few bug fixes. The
2527 distribution now includes the ChangeLog.
2529 ** New Features in mh-e 6.1
2531 *** Fontification
2533 Unseen messages now displayed in bold.
2535 *** Viewing folders and sequences
2537 The folder and sequence listings that "F l (mh-list-folders)" and "S l
2538 (mh-list-sequences)" create are now displayed in view mode.
2540 ** Bug Fixes in mh-e 6.1
2542 *** mh-folder-unseen-seq-name
2544 Byte compilation failed when initializing this variable when the
2545 user's MH environment was not set up. This has been fixed (closes
2546 Debian #140232 and Debian #140817).
2548 *** mh-forward
2550 When forwarding a sequence, the mode of the draft would not be set to
2551 MH-Letter correctly. This has been fixed (closes SF #489448).
2553 *** mh-insert-prefix-string
2555 Fixed to work under XEmacs. Thanks to Will Partain
2556 <partain at dcs.gla.ac.uk>.
2558 *** mh-quit
2560 mh-quit now cleans up the buffers named `mh-temp-buffer,'
2561 'mh-temp-folders-buffer' and 'mh-temp-sequences-buffer.'
2564 * Changes in mh-e 6.0
2566 mh-e is now maintained at SourceForge (see
2567 http://mh-e.sourceforge.net/). This is where you need to go to obtain
2568 new versions of mh-e, report bugs and receive support.
2570 The maintainers have moved much of their personal configurations into
2571 the codebase, so you may find that you may be able to reduce your mh-e
2572 customizations as well.
2574 There are several incompatibilities in this version from older
2575 versions. Please read the following notes carefully for details. Pay
2576 particular attention to the key binding changes in the MH-Folder
2577 section. If you have customized your scan format, you will want to
2578 read about the new variable `mh-scan-format-file'.
2580 The manual could not be updated in time for this release. It will be
2581 updated in the near future. If the Preface in your manual indicates
2582 the older version (version 1.3, for mh-e version 5.0.2), please check
2583 the following page occasionally for an update:
2585   https://sourceforge.net/project/showfiles.php?group_id=13357
2588 ** New Features in mh-e 6.0
2590 *** Customization
2592 mh-e now uses the customize feature of Emacs. Use "M-x customize-group
2593 mh RET" to customize mh-e.
2595 *** Menus
2597 All mh-e modes now provide menus that contain most mh-e functions.
2599 *** Toolbars
2601 All mh-e modes now have toolbar buttons for oft-used functions (Emacs 21).
2603 *** Fontification
2605 All mh-e buffers now have font-lock keywords. To use, either call
2606 (turn-on-font-lock) from the appropriate hook, or set
2607 `global-font-lock-mode' to t. To customize, use "M-x
2608 customize-apropos-faces ^mh RET".
2610 If you have customized your scan lines, you will have to update your
2611 scan regexps. The existing regexps were changed to extract a match so
2612 you will have to add appropriate grouping constructs to take advantage
2613 of the fontification. Your old settings will continue to work, but the
2614 folder will not be fontified. For example:
2616   (setq mh-good-msg-regexp  "^\\(.....\\)[^D^]")
2618 You will most likely have to update the new variable
2619 `mh-scan-subject-regexp' as well. There is another new variable
2620 `mh-scan-date-regexp' which you may also find useful. Run "M-x apropos
2621 mh.*regexp" for a complete list.
2623 *** mail-user-agent support
2625 You can now set `mail-user-agent' to `mh-e-user-agent' so that packages
2626 that need to send mail will use mh-e (closes SF #406883, SF #470024).
2628 *** replgroupcomps support
2630 If you reply to `cc' or `all' and you use nmh, the nmh repl option
2631 -group will be used. This means that the file `replgroupcomps' will be
2632 used. If you have customized `replcomps', you will definitely want to
2633 either copy `$NMH_LIB/replgroupcomps' to your mail directory and modify
2634 it the same way that you modified your `replcomps' file, or simply
2635 copy your `replcomps' file to `replgroupcomps'.
2637 *** MH-Folder mode
2639 The variable `mh-summary-height' used to have a default of 4. It now
2640 varies from 4 to 10 depending on the height of the frame.
2642 Clicking the mouse on a message shows that message.
2644 Delete, refile and undo now operate on a region (but only if
2645 `transient-mark-mode' is non-nil).
2647 SPC (mh-page-msg) now displays the message if it is not already
2648 visible. If the bottom of a message is showing, SPC (mh-page-msg)
2649 moves to the next message (respecting the direction you are moving
2650 through the folder).
2652 The threading commands "T u (mh-next-unseen-subject-thread)",
2653 "T t (mh-toggle-subject-thread)", "T s (mh-narrow-to-subject-thread)",
2654 and "T k (mh-delete-subject-thread)" have been added. These functions
2655 do not offer threading in the true sense of the word, but do allow
2656 some manipulation by subject.
2658 Major, major keymap changes. This was done to free up movement
2659 commands in the buffer, and to provide for additional features, such
2660 as the threading commands. At the same time, better and more
2661 consistent mnemonics were realized that should make it easier to
2662 remember key bindings.
2664 Added new sub-keymaps for folder commands, sequence commands,
2665 extraction commands, and digest commands which begin with with F, S,
2666 X, and D, respectively. These sub-keymaps allowed some consistency
2667 (e.g., especially with l(ist) and k(ill)).
2669 Here are the actual changes and rationale:
2671 Old     New     Rationale
2673 e       -       Deleted. Already have x. Now used by mh-edit-again.
2674 j       -       Deleted. Already have g.
2676 M-a     e       Better mnemonic. Matches rmail. Frees movement command.
2677 M-e     E       Better mnemonic. Consistent with e.
2678 -       S       Why not? mh-sort-folder.
2680 M-f     Fv      Frees movement command
2681 M-f     Ff      Alias (keep?)
2682 M-f     Fo      Alias (keep?)
2683 M-k     Fk      No reason but to keep with folder commands
2684 M-l     Fl      No reason but to keep with folder commands
2685 M-p     Fp      No reason but to keep with folder commands
2686 M-r     Fr      Frees movement command
2687 M-s     Fs      No reason but to keep with folder commands
2688 M-u     Fu      No reason but to keep with folder commands
2690 M-%     Sd      Better mnemonic
2691 M-#     Sk      Better mnemonic
2692 M-q     Sl      Better mnemonic
2693 C-xn    Sn      Frees up standard key binding
2694 %       Sp      Better mnemonic for putting a message in a sequence
2695 ?       Ss      Shows sequences that message is in
2696 C-xw    Sw      Frees up standard key binding
2698 M-n     Xs      Better mnemonic (extract shar)
2699 M-n     Xu      Better mnemonic (extract uuencode)
2701 M-SPC   D SPC   Frees mark command
2702 M-\177  D \177  No reason but to keep with digest commands
2703 M-b     Db      Frees movement command
2705 As the number of variables increases, it is becoming important to
2706 organize the mh-e namespace. Several variables having to do with the
2707 format of scan lines were renamed, as follows:
2709 Old                             New
2711 mh-good-msg-regexp              mh-scan-good-msg-regexp
2712 mh-deleted-msg-regexp           mh-scan-deleted-msg-regexp
2713 mh-refiled-msg-regexp           mh-scan-refiled-msg-regexp
2714 mh-valid-scan-line              mh-scan-valid-regexp
2715 mh-cur-scan-msg-regexp          mh-scan-cur-msg-number-regexp
2716 -                               mh-scan-cur-msg-regexp
2717 -                               mh-scan-rcpt-regexp
2718 -                               mh-scan-format-regexp
2719 mh-msg-number-regexp            mh-scan-msg-number-regexp
2720 mh-msg-search-regexp            mh-scan-msg-search-regexp
2722 *** MH-Show mode
2724 While the MIME support is not complete, quoted-printable body parts
2725 are now decoded.
2727 Some MTAs quote From at the beginning of the line with a ">". The ">"
2728 is now removed in the display, but not on disk.
2730 *** MH-Letter mode
2732 New function "C-c C-o (mh-split-line)" splits lines in a draft
2733 preserving the fill prefix and indentation. This is useful when
2734 responding to several sentences in a single paragraph separately.
2736 "M-q (fill-paragraph)" can now be used on the message that is being
2737 replied to. The fill prefix such as "> " is preserved.
2739 You no longer have to run "C-c C-e (mh-edit-mhn)" manually as this is
2740 now done automatically when the message is sent.
2742 The X-Mailer header field is now added to messages as they are sent.
2744 "C-c C-m C-i (mh-mhn-compose-insertion)" now makes a pretty good guess
2745 at the type of file using the `file' command and no longer asks the
2746 user for the media type. If the necessary version of `file' is not
2747 available, the user is asked for the media type as before; however,
2748 the list of media types is now taken from the system mailcap if
2749 available. Failing that, the built-in list of types has been
2750 supplemented so in most cases the type you need should be present
2751 (closes SF #406883, #441179).
2753 ** New Variables in mh-e 6.0
2755 New variables not mentioned earlier include:
2757 *** mh-insert-x-mailer-p
2759 Default value of t means that an X-Mailer header field should be
2760 added.
2762 *** mh-reply-show-message-p
2764 The setting of this variable determines whether the MH show-buffer is
2765 displayed with the current message when using mh-reply without a prefix
2766 argument. Set it to nil if you already include the message
2767 automatically in your draft using "repl: -filter repl.filter" in
2768 "~/.mh_profile."
2770 *** mh-scan-format-file
2772 Specifies the format file to pass to the scan program. If t, the
2773 format string will be taken from the either `mh-scan-format-mh' or
2774 `mh-scan-format-nmh' depending on whether MH or nmh is in use. If nil,
2775 the default scan output will be used.
2777 If you customize the scan format, you may need to modify a few
2778 variables containing regexps that mh-e uses to identify specific
2779 portions of the output. Use `M-x apropos RET mh-scan.*regexp' to
2780 obtain a list of these variables.
2782 *** mh-scan-format-mh
2784 Scan format string for MH, provided to the scan program via the
2785 -format arg. This format is identical to the default except that
2786 additional hints for fontification have been added to the sixth
2787 column.
2789 *** mh-scan-format-nmh
2791 Scan format string for nmh, provided to the scan program via the
2792 -format arg. This format is identical to the default except that
2793 additional hints for fontification have been added to the sixth
2794 column.
2796 *** mh-show-use-goto-addr
2798 Non-nil means URLs and e-mail addresses are highlighted using
2799 goto-addr in MH-Show buffer.
2801 *** mh-letter-fill-column
2803 Fill column to use in `mh-letter-mode'. This is useful to make the
2804 lines a bit shorter to allow for quoting in replies.
2806 *** mh-folder-updated-hook
2808 Invoked when the actions in a folder (such as moves and deletes) are
2809 performed. Variables that are useful in this hook include
2810 `mh-delete-list' and `mh-refile-list' which can be used to see which
2811 changes are being made to current folder, `mh-current-folder'.
2813 *** mh-unseen-updated-hook
2815 Invoked after the unseen sequence has been updated. The variable
2816 `mh-seen-list' can be used to obtain the list of messages which will
2817 be removed from the unseen sequence
2819 ** Bug Fixes in mh-e 6.0
2821 *** mh-edit-again and mh-extract-rejected-mail
2823 Now insert a header separator (--------) which packages such as
2824 mailcrypt expect.
2826 *** mh-find-progs
2828 Now uses `mhparam' to set `mh-lib-progs' and `mh-lib'. Added more
2829 directories to `mh-progs' so that mh-e can autoconfigure in more
2830 environments. Chances are that you no longer have to set these
2831 variables, and if you do, you will only have to set `mh-progs'.
2832 Unless, of course, you are using an ancient version of MH that doesn't
2833 have `mhparam'.
2835 *** mh-folder-mode-map
2837 The DEL/<delete>/<backspace> change in Emacs 21 broke
2838 `mh-previous-page'. This has been fixed (closes SF #228907).
2840 *** mh-forward
2842 If you had "forw: -mime" to your .mh_profile, forwarding a message
2843 resulted in:
2845   Search failed: "^------- Forwarded Message"
2847 In addition, the Subject field was not filled in. This has been fixed
2848 (closes SF #223603).
2850 *** mh-kill-folder
2852 The user is now always prompted before this action; the variable
2853 `mh-do-not-confirm' is no longer consulted here. Therefore users who
2854 wanted to set `mh-do-not-confirm' but didn't because of the
2855 `mh-kill-folder' dependency may now do so.
2857 *** mh-make-folder-mode-line
2859 Properly deals with folders that do not have any lines in them. Prints
2860 "no msgs" instead of "0 msgs". Does not try to print a range when
2861 there are no messages.
2863 *** mh-mhn-compose-insertion
2865 Now gets the MIME type automatically (assuming the local file command
2866 supports the -i and -b options). If this use of the file command is
2867 not supported, the list of MIME types has been expanded to use the
2868 system's mailcap file.
2870 *** mh-nmh-p
2872 This variable (t when nmh is in use rather than MH) assumed that the
2873 string "nmh" is in `mh-lib-progs' or `mh-lib'. This has been fixed
2874 (closes SF #441776).
2876 *** mh-refile-msg
2878 No longer lets you specify an empty folder (closes SF #476824).
2880 *** mh-regenerate-headers
2882 Now suppresses "scan: bad message list" messages.
2884 *** mh-print-msg
2886 This function was looking for `mhl' in the wrong place on nmh on
2887 Redhat LINUX 7.0. This has been fixed (closes SF #481128).
2889 *** mh-show
2891 Now updates `cur' sequence after a message is shown (closes SF #481772).
2893 *** mh-showing
2895 Renamed variable and function to `mh-showing-mode' to conform with
2896 minor mode conventions. Added optional arg to function so it would
2897 behave like a normal minor mode: no or nil arg toggles mode, 0 arg
2898 turns off, non-nil turns on. This fixed the error that occurred when
2899 `desktop-create-buffer' recreated mh-e buffers because it was calling
2900 `mh-showing' with an arg.
2902 *** mh-version
2904 Fixed for nmh. Now displays mh-e version correctly. Cleaned up output
2905 and display `mh-progs', etc.
2907 *** mh-widen
2909 Now attempts to stay on the same message number (closes SF #480922).
2911 No longer wipes out pending deletes and refiles without warning
2912 (closes SF #481036).
2915 * Changes in mh-e 5.0.2
2917 This version contains additional minor changes to integrate it with
2918 reporter.el (requires reporter.el version 3.1c or later) and Emacs
2919 19.30.  The mh-goto-msg function is much faster, which also speeds up
2920 several other operations.
2923 * Changes in mh-e 5.0.1
2925 This version contains minor changes from mh-e 5.0 to integrate it with
2926 Emacs 19.29.
2929 * User-visible changes to mh-e 5.0
2931 Note: This being a major release, there are many internal changes.
2932 This document lists only changes to the external interfaces of mh-e.
2934 When upgrading, you must either explicitly reload the new versions of
2935 all mh-e files that are already loaded or restart your Emacs.
2938 ** Major Changes and New Features in mh-e 5.0
2940 The emphasis for this release has been on consistency and
2941 documentation. Many documentation strings were enhanced. Documentation
2942 strings were changed to comments for internal functions and variables.
2944 *** There is now proper documentation in the form of a 75-page users
2945 manual. The Texinfo source is mh-e.texi; the formatted Info document
2946 is mh-e.info.
2948 *** There is a new command `mh-update-sequences', which updates MH's
2949 idea of what messages are in the Unseen sequence and what is the
2950 current folder and message. `mh-quit' calls it. While
2951 `mh-execute-commands' has always done this updating as a side effect,
2952 the new function is faster.
2954 *** The MH profile entry "Inbox:" is supported.
2956 *** If the show-buffer is modified, the user is queried before mh-e
2957 reuses the buffer to show a different message. This buffer is also
2958 auto-saved and backed up correctly.
2960 *** `mh-store-buffer' is significantly more robust. It now handles
2961 messages created by a wide variety of packaging software. The status
2962 message for `uudecode' includes the name of the file created. An error
2963 is signaled if the subprocess exits with a non-zero status.
2965 *** `mh-search-folder' behaves predictably, adding messages found to
2966 the `search' sequence. It correctly handles the case of no messages
2967 found.
2969 *** `mh-burst-digest' (`M-b') now only rescans the part of the folder
2970 affected by the burst. It is now much faster in a large folder.
2973 ** New Hooks and Customization Variables in mh-e 5.0
2975 *** `mh-default-folder-for-message-function': new name for the old
2976 `mh-msg-folder-hook', which wasn't a hook. The old name was confusing,
2977 leading people to think they could use `add-hook' with it, when
2978 actually `setq' is the correct way.
2980 *** `mh-sortm-args': When this variable is used has changed. Now
2981 `mh-sortm-args' is passed if there IS a prefix argument to
2982 `mh-sort-folder'. The assumption is that for arguments you normally
2983 want, you would specify them in an MH profile entry.
2985 *** `mh-mhn-args': new hook, a list of additional arguments to pass to
2986 the `mhn' program if `mh-edit-mhn' is given a prefix argument.
2988 *** `mh-edit-mhn-hook': new hook called by `mh-edit-mhn', the function
2989 that formats MIME messages.
2991 *** `mh-folder-list-change-hook': new hook, called whenever the cached
2992 list of folders, `mh-folder-list', is changed.
2994 *** `mh-find-path-hook': new hook, called when entering mh-e.
2996 *** `mh-repl-formfile': new variable, used to change the format file
2997 used by `mh-reply' from the default of "replcomps".
2999 *** New variables to customize the scan format and notating:
3000 `mh-note-deleted', `mh-note-refiled', `mh-note-seq', `mh-note-cur',
3001 `mh-note-copied', `mh-note-printed'.
3004 ** Key Binding Changes in mh-e 5.0
3006 *** `RET' runs `mh-show' for consistency with the Finder and Info. The
3007 old binding `.' still works, but `RET' is now the standard binding.
3009 *** `M-<' now runs `mh-first-msg' for consistency with `M->', which
3010 runs `mh-last-msg'.
3012 *** `C-c C-f C-d' in MH-Letter mode moves to a Dcc: header field.
3014 *** `C-c C-f C-r' in MH-Letter mode moves to a From: header field.
3016 *** `g' is now the standard binding for `mh-goto-msg'. The old binding
3017 `j' still works.
3020 ** Other Improvements and Changes to mh-e 5.0
3022 *** `mh-lpr-command-format' no longer passes the "-p" argument to
3023 `lpr' by default. The mail header typically has the date anyway.
3025 *** When prompting for a sequence name, if no sequences have been used
3026 yet, mh-e will offer the first sequence the current message is in.
3028 *** The patterns of more mailers are recognized by
3029 `mh-extract-rejected-mail'.
3031 *** `mh-insert-prefix-string' no longer wraps the call to the
3032 `mail-citation-hook' function in a `save-excursion' so the hook writer
3033 can choose whether to leave point at the beginning or the end of the
3034 yanked text.
3036 *** `mh-write-msg-to-file': The prompt now refers to "message" or
3037 "message body" depending on which will be written. (This is controlled
3038 by a prefix argument.) The file defaults to the last-used file instead
3039 of supplying only the directory name.
3041 *** mh-e uses message ranges when running MH commands. Thus "rmm 1 2 3
3042 4 6" is now "rmm 1-4 6". This change makes it less likely to overflow
3043 system argument list limits, and it might be faster, too.
3046 ** Bug Fixes to mh-e 5.0
3048 *** mh-e's idea of the unseen sequence now stays in sync with MH's
3049 better.
3051 *** Functions that are supposed to find fields in the message header
3052 no longer look in the message body.
3054 *** mh-e would sometimes fail to remove the "%" from a scan line when
3055 the message was removed from a sequence if the message was also in the
3056 Previous sequence.
3058 *** The variable `mh-inc-prog' is now correctly used in all places.
3060 *** `mh-pipe-msg' runs the process in the correct directory.
3062 *** A partially scanned folder will no longer lose the "/select"
3063 annotation when you execute marked deletes and refiles with `x'.
3066 * Changes to mh-e 4.0
3068 This file is automatically generated from news-mh-e.txinfo.  Do not edit.
3070 [MH-E-ONEWS has been incorporated here and removed. news-mh-e.txinfo
3071 is no longer available.]
3073 Note: there are many internal changes to mh-e in this release.  If you
3074 have the previous version loaded into your Emacs, you will probably not
3075 be able to load this version on top of it.
3077 ** New Features in mh-e 4.0
3079 *** Background folder collection. The first time you are prompted for
3080 a folder, you must wait while mh-e collects the names of all existing
3081 folders. Now however, if you abort, collecting will continue in the
3082 background, and you can do something else in Emacs until the
3083 collection completes. Normally, mh-e will begin collecting folders
3084 names in the background when you first load it; you can disable this
3085 feature by setting `mh-auto-folder-collect' to nil.
3087 *** There is support for composing MIME messages using the `mhn'
3088 program from MH 6.8. See the documentation string for mh-edit-mhn.
3089 (While composing a letter, type `C-h k C-c C-e'.) See also mhn(1).
3090 There is as yet no support for reading MIME messages.
3092 *** `mh-show', typically on `.', repositions to the start of the
3093 message if the message is already visible. It used to do nothing in
3094 this case.
3096 *** The function `mh-unshar-msg' is renamed `mh-store-msg'. It now
3097 does uudecoding, too. Someday it should do MIME. It remembers the last
3098 directory you used and offers it as the default for next time.
3100 *** New function `mh-header-display', on `,', displays the message
3101 with all headers, including those normally not displayed. Type `.' to
3102 display the message normally again.
3104 *** New function `mh-list-sequences' lists the sequences in use in the
3105 current folder.
3107 *** New function `mh-version' displays version information about MH
3108 and mh-e. Please use the output in bug reports.
3110 *** `mh-quit' now burys the folder buffer and show buffer.
3113 ** New hooks and customization variables in mh-e 4.0
3115 *** `mh-pick-mode-hook': new hook called by new mode `mh-pick-mode'.
3116 The pick buffer didn't used to have its own mode. Another advantage of
3117 `mh-pick-mode' is that `C-h m' works in the pick buffer.
3119 *** `mail-citation-hook': new variable for supercite.
3121 *** `mh-refile-msg-hook': new hook called by `mh-refile-msg' (and
3122 `mh-refile-or-write-again' when refiling).
3124 *** `mh-msg-folder-hook': new hook used by `mh-refile-msg' and
3125 `mh-to-fcc' to provide a default folder for user prompt.
3127 *** `mh-show-hook': new hook called by `mh-show'.
3129 *** `mh-delete-msg-hook': new hook called by `mh-delete-msg'.
3131 *** `mh-show-mode-hook': new hook called by new mode `mh-show-mode'
3132 for `show-' buffers.
3134 *** `mh-comp-formfile': new variable so can customize `components'
3135 file.
3137 *** `mh-sortm-args': new variable, a list of extra arguments to be
3138 passed to sortm by `mh-sort-folder'. Give an argument to
3139 `mh-sort-folder' to suppress this behavior.
3141 *** `mh-send-prog': new variable so can customize name of `send'
3142 program in case of name conflicts.
3144 *** `mh-scan-prog': new variable so can customize name of `scan'
3145 program to generate custom effects.
3147 *** `mh-inc-prog': new variable so can customize name of `inc' program
3148 to do fancy management of incoming messages.
3150 *** `mh-forwarded-letter-subject': new function used by `mh-forward'
3151 to compute the Subject line of the new message. It is a small function
3152 which can be replaced by the user for customization. Uses the new
3153 variable `mh-forward-subject-format', which allows some simple
3154 customizations without rewriting even `mh-forwarded-letter-subject'.
3156 *** `mh-new-draft-cleaned-headers': new variable, header lines removed
3157 by `mh-edit-again' and `mh-extract-rejected-mail' before offering a
3158 message as a new draft.
3160 *** `mh-signature-file-name': new variable used by
3161 `mh-insert-signature' to so can customize name of the file to insert.
3163 *** `mh-read-address': new function called to read all To: and Cc:
3164 addresses.
3166 *** `mh-msg-folder-hook': new hook used by `mh-refile-msg' and
3167 `mh-to-fcc' to provide a default folder for user prompt.
3170 ** Key binding changes in mh-e 4.0
3172 *** `,' runs new function `mh-header-display'. It is like `.' but it
3173 displays *all* the headers.
3175 *** `M-#' runs the new function `mh-delete-seq'. One used to have to
3176 type `C-u M-%' to delete a sequence.
3178 *** `<' no longer does `mh-first-msg', but `M->' now does
3179 `mh-last-msg'. This allows first and last to be consistent (`>' was
3180 taken) and is more likely to be discovered by chance anyway.
3182 *** `M-d' runs `mh-redistribute', `r' runs `mh-reply' (on the theory
3183 that the more commonly used function should be easier to type, and the
3184 obscure action of redistributing can be harder to type).
3186 *** `M-o' changed to `C-o' (`mh-write-msg-to-file'). It was
3187 interfering with arrow keys for some people.
3189 *** `M-n' now runs `mh-store-msg' (formerly `mh-unshar-msg').
3191 *** `b' no longer runs `mh-quit'; use `q' instead. `b' may be used in
3192 a future version for something else.
3195 ** Minor improvements to mh-e 4.0
3197 *** The mh-e code is now divided into multiple Emacs Lisp files, so it
3198 starts up faster because Emacs doesn't have to load all of it at once.
3199 (This change also makes it easier for the maintainer to manage
3200 things.)
3202 *** When searching for the directory containing the MH programs,
3203 search the user's PATH in addition to the built-in directories, to
3204 increase the chance of finding the MH programs.
3206 *** The subject for a forwarded message no longer has ugly square
3207 brackets around it.
3209 *** The name of the folder is no longer appears twice in the show
3210 buffer mode line.
3212 *** When typing a folder name in the minibuffer, parent folders
3213 complete to the trailing slash (/), for easier typing of subfolders.
3215 *** The folder buffer mode name changed from `mh-e scan' or `mh-e
3216 show' to `MH-Folder', which makes the hook name easier to guess. Added
3217 `mh-showing' to `minor-mode-alist' so there is still an indication in
3218 the mode line of whether messages will be shown automatically.
3220 *** `mh-rename-seq' does completion on the old sequence name.
3222 *** If called by a user who has never used MH on this system before,
3223 mh-e runs the MH program `install-mh' to get them set up.
3225 *** Undo history for previous messages is not kept to avoid wasting
3226 memory.
3228 *** The internal temp buffer used by mh-e has `buffer-offer-save'
3229 explicitly nil. This change benefits people who change the
3230 `buffer-offer-save' default.
3233 ** Bug fixes to mh-e 4.0
3235 *** `mh-to-field': don't bomb if no To: field.
3237 *** `mh-get-new-mail': restore annotations, e.g., cur, even if no new
3238 mail.
3240 *** `mh-rename-seq': verify that the new seq name was accepted by
3241 `mark' before updating state.
3243 *** `mh-internal-seq': the Previous sequence is not notated, since it
3244 would notate everything scanned.
3246 *** `mh-read-draft': don't call `find-file-noselect' so an
3247 `auto-mode-alist' doesn't trigger `mh-letter-mode-hook' twice. Faster,
3248 too.
3250 *** `mh-show': If user moves onto a message that doesn't exist, don't
3251 leave the cursor in the show pane.
3253 *** `mh-delete-scan-msgs': use `equal', not `=', on the result of
3254 `mh-get-msg-num', since it may be nil.
3256 *** `mh-get-field': do anchored search so searching for `reply-to:'
3257 doesn't find `in-reply-to:'.
3259 *** `mh-widen': do nothing if not narrowed.
3261 *** `mh-clean-message-header': find end of headers even if no body.
3264 This file is part of GNU Emacs.
3266 GNU Emacs is free software: you can redistribute it and/or modify
3267 it under the terms of the GNU General Public License as published by
3268 the Free Software Foundation, either version 3 of the License, or
3269 (at your option) any later version.
3271 GNU Emacs is distributed in the hope that it will be useful,
3272 but WITHOUT ANY WARRANTY; without even the implied warranty of
3273 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
3274 GNU General Public License for more details.
3276 You should have received a copy of the GNU General Public License
3277 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
3280 Local variables:
3281 mode: outline
3282 paragraph-separate: "[  \f]*$"
3283 end: