Discourage in comments from defining HAVE_GETCWD on MS-Windows.
[emacs.git] / etc / MH-E-NEWS
blobaca5781fe35c6a4085903d2a096424cb11acd5f5
1 * COPYRIGHT
3 Copyright (C) 2001-2012  Free Software Foundation, Inc.
4 See the end of the file for license conditions.
6 * Changes in MH-E 8.3.1
8 This version of MH-E fixes typos in the documentation and is packaged
9 with GNU Emacs 24.1
11 * Changes in MH-E 8.3
13 In 2010, the version control system (VCS) of Emacs was upgraded from
14 CVS to Bazaar. In 2011, the MH-E team followed suit and upgraded the
15 MH-E repository at SourceForge from CVS to Bazaar as well. The result
16 is version 8.3 of MH-E, which includes needed changes to the build
17 scripts.
19 Otherwise, this is a small release that includes mostly internal
20 changes from the Emacs team. One of these changes manifests itself in
21 the user interface--you can now complete folders with abbreviations,
22 meaning that `+f/b/b TAB' can complete to `+foo/bar/baz'.
24 Also, RFC 2047-encoded Subject header fields in replies are now
25 decoded.
27 It also fixes compilation warnings in XEmacs 21.5.31, as
28 well as an error when running XEmacs 21.5.31 in a terminal.
30 Another implication of the VCS change is that users who download MH-E
31 from SourceForge and explicitly load MH-E will have to be change their
32 `load-path' to "/path/to/mh-e/emacs/trunk/lisp/mh-e" instead. Note the
33 addition of "trunk."
35 ** Bug Fixes in MH-E 8.3
37 *** Make mh-showing a legitimate minor mode
39 The `mh-showing-mode' variable is now defined with `define-minor-mode'
40 (closes SF #482666).
42 *** Desktop fails to restore MH-Folder buffers
44 When restoring MH folders from ".emacs.desktop", Emacs now opens them in
45 the expected `mh-folder' mode instead of `dired-mode' (closes SF #1510145)
47 *** *MH-E Log* buffer can point to removed directory
48 This was caused by using `set-buffer' instead of
49 `with-current-buffer.' This has been fixed thanks to Stefan Monnier
50 (closes SF #1903293).
54 * Changes in MH-E 8.2
56 Version 8.2 of MH-E appeared in GNU Emacs 23.1.  This is a small
57 release that includes internal changes from the Emacs team. A new
58 hook, `mh-pack-folder-hook', has been added.
60 There is a known bug where you can't attach attachments in Emacs 21.
61 This will be fixed in 8.2.1.
63 ** New Variables in MH-E 8.2
65 *** mh-pack-folder-hook
67 The `mh-pack-folder-hook' is run by `F p' (`mh-pack-folder') after
68 renumbering the messages. Hook functions can access the current folder
69 name with `mh-current-folder'.
71 ** Bug Fixes in MH-E 8.2
73 *** New version of mh-mm-save-part
75 Several functions have been updated with code from Gnus 5.11 (closes
76 SF #2235022).
80 * Changes in MH-E 8.1
82 Version 8.1 fixes some issues with forwarding messages, respects the
83 MH environment variable, adds the abilities to use aliases with GPG
84 and show HTML even though it is discouraged. A new hook,
85 `mh-annotate-msg-hook', has been added.
87 ** New Features in MH-E 8.1
89 *** Showing HTML When Text Is the Preferred Alternative
91 The `:' (`mh-show-preferred-alternative') function displays the
92 message with the default preferred alternative. This is as if
93 `mm-discouraged-alternatives' was set to nil (closes SF #1777321).
95 ** New Variables in MH-E 8.1
97 *** mh-annotate-msg-hook
99 The `mh-annotate-msg-hook' hook is run whenever a message is sent and
100 after the scan lines and message are annotated. Hook functions can
101 access the current folder name with `mh-current-folder' and obtain the
102 message numbers of the annotated messages with `mh-annotate-list'
103 (closes SF #2032269).
105 ** Bug Fixes in MH-E 8.1
107 *** Can't Use Aliases with GPG
109 GPG requires e-mail addresses, not aliases. So resolve aliases before
110 passing addresses to GPG/PGP (closes SF #649226).
112 *** mh-mml-forward-message: Disposition Should Be Inline
114 The `f' (`mh-forward') function now forwards messages as inline
115 attachments (closes SF #1378993).
117 *** Illegal Filename Characters on Windows Filesystems
119 The X-Image-URL cache created filenames with invalid characters on
120 Windows. This has been fixed with assistance from Darel Henman (closes
121 SF #1396499).
123 *** Make Many Header Fields Invisible
125 A vast landscape of header fields are now invisible. You may wish to
126 browse `mh-invisible-header-fields-default' and clean up your
127 `mh-invisible-header-fields' option. A permanent bug (SF #1916032) has
128 been created where you can submit header fields that should be
129 rendered invisible (closes SF #1701231).
131 *** mh-forward Includes Messages in Reverse Order
133 The `f' (`mh-forward') function now includes messages in ascending
134 order (closes SF #1730393).
136 *** Compile Fails on XEmacs 21.5 beta 28
138 This has been fixed with help from Henrique Martins (closes SF
139 #1749774).
141 *** Rename Variant mu-mh to gnu-mh
143 The GNU mailutils MH variant was named inconsistently. The variant has
144 been renamed to gnu-mh throughout. Thanks to Darel Henman (closes SF
145 #1768928).
147 *** Respect MH environment Variable
149 Even if the MH environment variable was set, an error was generated if
150 "~/.mh_profile" was missing. This has been fixed thanks to Xavier
151 Maillard (closes SF #1946861).
153 *** Enhance mh-mairix-regexp-builder
155 Additional items have been added to the Mairix search string in order
156 to support org-mode. Thanks to Nick Dokos (closes SF #1965704).
158 *** mh-mh-to-mime and mh-mh-to-mime-undo Reset Modes
160 The functions `mh-mh-to-mime' and `mh-mh-to-mime-undo' would reset the
161 buffer to fundamental mode. This has been fixed thanks to Sergey
162 Poznyakoff (closes SF #1966722).
166 * Changes in MH-E 8.0.3
168 Version 8.0.3 fixes errors in sending messages and in running spam
169 filter commands in certain circumstances.
171 ** Bug Fixes in MH-E 8.0.3
173 *** mh-send-args Cannot Be nil
175 If `mh-send-uses-spost-flag' was set, an error would prevent the
176 sending of messages. This has been fixed (closes SF #1564742).
178 *** Missing Quotes in sa-learn Command Line
180 This has been fixed (closes SF #1565460).
182 *** Errors Associated with mh-junk-background
184 The Spamassassin filter commands were used inconsistently and
185 incorrectly; if `mh-junk-background' were nil, not all of the updating
186 would happen correctly. In the other back-ends such as bogofilter and
187 SpamProbe, a value of t for `mh-junk-background' would cause the
188 commands associated with these filters to fail. These problems have
189 been fixed (closes SF #1594802).
193 * Changes in MH-E 8.0.2
195 Version 8.0.2 fixes the tool bar and `F n' on XEmacs, and `K a' on GNU
196 mailutils.
198 ** Bug Fixes in MH-E 8.0.2
200 *** Tool Bar Not Displayed in XEmacs
202 The MH-E tool bar didn't show up in XEmacs; now it does. Thanks to Ted
203 Phelps <phelps@gnusto.com> (closes SF #1506846).
205 *** mh-mime-save-parts Assumes -store Default
207 It was assumed that -store was the default for both mhn and mhstore.
208 This has been fixed by using -store except when using nmh. Thanks to
209 Sergey Poznyakoff <gray@Mirddin.farlep.net> (closes SF #1513140).
211 *** F-n Doesn't Work
213 The fix for SF #1499712 broke `F n' (`mh-index-new-messages') on
214 XEmacs since a regular expression that XEmacs could not handle was
215 added. This regexp has been fixed (closes SF #1514424).
219 * Changes in MH-E 8.0.1
221 Version 8.0.1 works around a couple of bugs in GNU mailutils, spost,
222 and Windows. MH-E now requires the use of version 1.0 of mailutils due
223 to a bug in the folder command.
225 ** Bug Fixes in MH-E 8.0.1
227 *** Infinite Loop When Searching (mailutils)
229 The GNU mailutils folder command displays output when a folder doesn't
230 exist. MH-E didn't expect this and responded with an infinite loop
231 during searches. While this bug has since been fixed in mailutils,
232 MH-E has been modified to work anyway (closes SF #1499712).
234 *** spost Doesn't Have -msgid or -mime Flags
236 The post replacement spost does not support the -msgid or -mime flags.
237 A new variable `mh-send-uses-spost-flag' was added to control the use
238 of these flags (closes SF #1486726).
240 *** <2> in Search Folders Illegal in Windows
242 The <2> suffix to the search folder names contain illegal filename
243 characters in Windows. These cause searches to fail on Windows. This
244 has been fixed by changing the suffix to -2 (closes SF #1507002).
248 * Changes in MH-E 8.0
250 Version 8.0 supports GNU mailutils, S/MIME, picons, which-func-mode,
251 sports an improved interface for hiding header fields, improves upon
252 the MH variant detection, improves folder completion, makes the pick
253 search equivalent to the other types of searches, spruces up the tool
254 bar, creates the correct MIME type when including OpenOffice
255 documents, works on a Mac, adds colors to buttons for signed or
256 encrypted messages, incorporates new features introduced in
257 Emacs 22.1, fixes a bunch of bugs, and best of all, comes with an
258 updated manual!
260 Internally, MH-E now sports a new software organization which will
261 help future maintainability. As a side-effect, the number of XEmacs
262 compilation warnings has plummeted from hundreds to just three. CVS
263 users will notice that MH-E has been migrated from the CVS repository
264 from SourceForge to Savannah (but only for those files that were
265 already part of Emacs). As a result, the location of MH-E in the
266 load-path has changed, and mh-e-autoloads.el was renamed to
267 mh-autoloads.el. See section INSTALL in the README for details. While
268 this migration will benefit maintainers, it will also benefit users:
269 CVS Emacs users will not have to check out MH-E separately and welcome
270 faster MH-E updates, and CVS MH-E users will welcome faster MH-E
271 updates from Emacs developers. Read section CVS MH-E INSTALL in the
272 README for details.
274 While not related to this release, the MH-E mailing lists are now
275 gatewayed at gmane.org (closes SF #979308).
277 If you want to see the release notes for the alpha and beta releases
278 leading up this release, please see:
280   http://cvs.savannah.gnu.org/viewvc/emacs/emacs/etc/MH-E-NEWS?revision=1.25&view=markup
284 ** New Features in MH-E 8.0
286 *** GNU mailutils Support
288 MH-E now supports GNU mailutils 0.4 and higher versions.
290 *** S/MIME Support
292 MH-E now supports S/MIME using Gnus 5.10.6 or higher.
294 *** Picon Support
296 In addition to the other methods of displaying an icon for the sender
297 of a message, MH-E can now display images from a picon directory. The
298 directory search path is found in the `mh-picon-directory-list'
299 variable. More documentation is found in the "facedb" sections in the
300 xfaces man page.
302 *** Catchup Command
304 There is a new `F c' (`mh-catchup') command that marks all unread
305 messages in the current folder as read.
307 *** Use which-func-mode to Display Folder in Index Mode
309 Turning on `which-func-mode' displays the folder name of the message
310 under the cursor in index folders (closes SF #855520).
312 *** Quick Key Help
314 The `?' (`mh-help') function now displays the help in its own buffer
315 called *MH-E Help* (closes SF #493740 and SF #656631).
317 *** Search Unification
319 The old `F s' behavior of adding messages to the search sequence has
320 been removed. The `F i' keybinding was deprecated and the new `F s'
321 (`mh-search') command is used to initiate either indexed or pick
322 searches. Within the MH-Search buffer (renamed from MH-Pick), the
323 command `C-c C-p' (`mh-pick-do-search') now runs pick on the given
324 folder recursively and displays the results in a search folder like
325 the other search methods (closes SF #829207).
327 *** Entry Points Have Moved
329 Emacs 21 users must now add `(require 'mh-autoloads)' because the
330 entry points (such as `mh-rmail' and `mh-smail') have moved to
331 different files which have made the autoloads that come with Emacs
332 inaccurate. This change was necessary because the code was reorganized
333 to remove circular dependencies, to make the code more stable and
334 maintainable, and to reduce the time to load MH-E.
336 *** MH-Folder Keymap Changes
338 There is now a keymap for the printing functions whose prefix is `P'.
339 The command `l' (`mh-print-msg') has been replaced with `P l' although
340 we suggest you use the new `P p' instead.
342 Key          7.4.4                         8.0
344 ;            -                             mh-toggle-mh-decode-mime-flag
345 l            mh-print-msg                  -
346 / f          mh-narrow-to-from             -
347 / r          mh-narrow-to-range            -
348 / g          -                             mh-narrow-to-range
349 / m          -                             mh-narrow-to-from
350 F c          -                             mh-catchup
351 F i          mh-index-search               -
352 F s          mh-search-folder              mh-search
353 K e          -                             mh-display-with-external-viewer
354 K t          -                             mh-toggle-mime-buttons
355 P ?          -                             mh-prefix-help
356 P C          -                             mh-ps-print-toggle-color
357 P F          -                             mh-ps-print-toggle-faces
358 P f          -                             mh-ps-print-msg-file
359 P l          -                             mh-print-msg
360 P p          -                             mh-ps-print-msg
362 *** MH-Letter Keymap Changes
364 The change where `mh-letter-mode' derives from `mail-mode' adds a few
365 keybindings. Some are interesting: experiment! Only the keybinding
366 changes for MH-E functions are listed here.
368 Most of the changes have to do with the renaming of the functions with
369 "mhn" in them to "mh" because nmh doesn't use `mhn'. The names were
370 also made consistent with the family of "mml" functions.
372 The type of signing or encryption has been generalized so the method
373 is now an option rather than a part of the function's name. The option
374 is `mh-mml-method-default' and choices include PGP (MIME), PGP,
375 S/MIME, or none.
377 Key          7.4.4                         8.0
379 C-c C-e      mh-edit-mhn                   mh-mh-to-mime
380 C-c RET C-e  mh-mml-secure-message-encrypt-pgpmime
381                                            mh-mml-secure-message-encrypt
382 C-c RET C-g  -                             mh-mh-compose-anon-ftp
383 C-c RET C-n  -                             mh-mml-unsecure-message
384 C-c RET C-s  mh-mml-secure-message-sign-pgpmime
385                                            mh-mml-secure-message-sign
386 C-c RET C-t  -                             mh-mh-compose-external-compressed-tar
387 C-c RET C-u  mh-revert-mhn-edit            mh-mh-to-mime-undo
388 C-c RET C-x  -                             mh-mh-compose-external-type
389 C-c RET e    mh-mml-secure-message-encrypt-pgpmime
390                                            Prefix Command
391 C-c RET e e  -                             mh-mml-secure-message-encrypt
392 C-c RET e s  -                             mh-mml-secure-message-signencrypt
393 C-c RET g    -                             mh-mh-compose-anon-ftp
394 C-c RET n    -                             mh-mml-unsecure-message
395 C-c RET s    -                             Prefix Command
396 C-c RET s e  -                             mh-mml-secure-message-signencrypt
397 C-c RET s s  -                             mh-mml-secure-message-sign
398 C-c RET t    -                             mh-mh-compose-external-compressed-tar
399 C-c RET u    mh-revert-mhn-edit            mh-mh-to-mime-undo
400 C-c RET x    -                             mh-mh-compose-external-type
402 C-c C-f C-a  -                             mh-to-field
403 C-c C-f C-l  -                             mh-to-field
404 C-c C-f RET  -                             mh-to-field
405 C-c C-f a    -                             mh-to-field
406 C-c C-f l    -                             mh-to-field
407 C-c C-f m    -                             mh-to-field
409 *** MH-Search Keymap Changes
411 These are the changes associated with the new search mode. The command
412 `C-c C-c' (`mh-index-do-search') now performs the standard indexed
413 search, while `C-c C-p' (`mh-pick-do-search') runs pick as before,
414 only better!
416 The `mh-to-field' keybindings were adjusted to be consistent with
417 those in the MH-Letter mode.
419 Key          7.4.4                         8.0
421 C-c C-c      mh-do-search                  mh-index-do-search
422 C-c C-f C-d  mh-to-field                   -
423 C-c C-f C-f  mh-to-field                   -
424 C-c C-f C-r  mh-to-field                   -
425 C-c C-f RET  -                             mh-to-field
426 C-c C-f d    mh-to-field                   -
427 C-c C-f f    mh-to-field                   -
428 C-c C-f m    -                             mh-to-field
429 C-c C-f r    mh-to-field                   -
430 C-c TAB      mh-index-do-search            -
432 *** Updates to X-Image-URL
434 Now support the use of `curl' and `fetch' as alternatives to `wget' to
435 obtain the image. The display of images are controlled with the
436 `mh-show-use-xface-flag' option while the `mh-fetch-x-image-url'
437 option controls how the images are fetched.
439 The default of `mh-fetch-x-image-url' has been changed to "Never
440 Fetch." Those of you who like the value of "Ask Before Fetching" will
441 have to customize this option (closes SF #831278).
443 WARNING: There are security concerns with this feature. Please read
444 the documentation for these options carefully before changing the
445 default.
447 *** Updates to mh-identity-list
449 Note that the field names found in `mh-identity-list' that refer to
450 the fields in `mh-identity-handlers' have changed in an incompatible
451 way from 7.4.4. In general, the symbolic names now have a ":" prefix
452 to avoid collisions with header fields. Before starting Emacs, edit
453 your .emacs and insert ":" before "signature" if you have defined it.
455 You can change your attribution in replies with the new "Attribution
456 Verb" field, and you can set your default GPG user ID with the "GPG
457 key ID" field.
459 Signatures can now be read from the `mh-signature-file-name' variable,
460 or come from a function, in addition to a named file. If you write
461 your own function, variables that you can use include
462 `mh-signature-separator-regexp', `mh-signature-separator',
463 and `mh-signature-separator-p'.
465 The handling of these fields has been moved into a new
466 `mh-identity-handlers' option, an alist of fields (strings) and
467 handlers (functions). Strings are lowercase. Use ":signature" for
468 Signature and ":pgg-default-user-id" for GPG Key ID. The function
469 associated with the string "default" is used if no other functions are
470 appropriate. For this reason, don't name a header field "Default".
472 If you point your signature at a vCard file with a vcf suffix, then it
473 will be incorporated as a vCard body part (closes SF #802723).
475 *** Updates to Speedbar
477 The speedbar now renders the folders with unseen messages in boldface
478 which makes them easier to identify (closes SF #623369).
480 *** Updates to mh-msg-is-in-seq
482 Can now specify an alternate message number to `S s'
483 (`mh-msg-is-in-seq') with a prefix argument.
485 *** Updates to mh-to-field-choices
487 In MH-Letter mode, you can use the `C-c C-f' (`mh-to-field') prefix to
488 go to and insert fields. The fields `Reply-To:', `Mail-Reply-To:',
489 `Mail-Followup-To:' can now be created via the `C-r', `C-a' (for
490 author), and `C-l' keys respectively. The key for the `From:' field
491 has been renamed from `C-r' to `C-m' for consistency with `mail-mode'
492 (closes SF #1400139).
494 *** Change Content-Type Renderer on the Fly in MH-Show Buffer
496 This has been implemented by adding the key binding `K e'
497 (`mh-display-with-external-viewer'). For inline text/html parts,
498 buttons aren't displayed by default. In that case use `K t'
499 (`mh-toggle-mime-buttons') to display the button before viewing it
500 with an external browser (closes SF #839318).
502 *** MH-E No Longer Calls install-mh
504 The new variant detection code makes use of `mhparam' which assumes
505 that your MH environment has already been set up. The code to call
506 `install-mh', which could no longer be run anyway, was removed.
508 *** Add :package-version Keyword to Options
510 This `defcustom', `defgroup', and `defface' keyword was introduced in
511 Emacs 22.1. MH-E has been extended to take advantage of it. With this
512 keyword, you can now use `M-x customize-changed-options' to see what
513 options in MH-E have changed between versions of Emacs. In a future
514 version of Emacs, you'll be able to see changes between MH-E versions
515 as well (closes SF #1452724).
517 *** Render Signature and vCard in Italics
519 This has been implemented.  Use `mh-show-signature-face' to customize
520 the face used (closes SF #802722).
522 *** Derive mh-letter-mode from mail-mode
524 MH-Letter mode is now derived from `mail-mode'. We were able to delete
525 a lot of code. In return, there are a few `mail-mode' commands that
526 are available that may or may not be useful and the `mail-mode-hook'
527 is run (closes SF #1385571).
529 *** Remove Emacs 20 Support
531 As it turns out, we had already added some code that didn't work on
532 Emacs 20. However, now we've formalized it and removed code that was
533 present solely for Emacs 20 support (closes SF #1359240).
535 *** Glimpse Support Removed
537 Since glimpse isn't free, we cannot mention it. Glimpse has been
538 removed from the option `mh-indexer-choices' (closes SF #831276).
540 *** Use run-hook-with-args
542 We use normal hooks whenever possible and do not use
543 `run-hook-with-args' (with one documented exception) (closes SF
544 #643702).
548 ** New Variables in MH-E 8.0
550 *** mh-after-commands-processed-hook
552 Hook run by `x' (`mh-execute-commands') after performing outstanding
553 refile and delete requests.
555 *** mh-alias-reloaded-hook
557 Invoked by `mh-alias-reload' after reloading aliases.
559 *** mh-auto-fields-prompt-flag
561 On means to prompt before sending if fields in `mh-auto-fields-list'
562 are inserted.
564 *** mh-before-commands-processed-hook
566 Renamed from `mh-folder-updated-hook'. It wasn't clear whether
567 `mh-folder-updated-hook' was run before or after the commands were
568 executed. We now provide both with clear names.
570 *** mh-compose-forward-as-mime-flag
572 On means that messages are forwarded as attachments (closes SF
573 #827203).
575 *** mh-default-folder-for-message-function
577 Function to select a default folder for refiling or `Fcc:'.
579 *** mh-forward-hook
581 Invoked on the forwarded letter by `f' (`mh-forward').
583 *** mh-highlight-citation-style
585 Renamed from `mh-highlight-citation-p' since it wasn't a boolean. The
586 new name is also more descriptive.
588 *** mh-identity-handlers
590 Handler functions for fields in `mh-identity-list'.
592 *** mh-insert-signature-hook
594 Renamed from `mh-letter-insert-signature-hook' since most of the other
595 hooks do not carry the mode in the prefix and because the new name is
596 equally clear.
598 *** mh-invisible-header-fields-default
600 List of hidden header fields. The header fields listed in this option
601 are hidden, although you can check off any field that you would like
602 to see. Header fields that you would like to hide that aren't listed
603 can be added to the `mh-invisible-header-fields' option (closes SF
604 #752045).
606 The option `mh-visible-header-fields' has been deleted.
608 *** mh-junk-background
610 If on, spam programs are run in background. This used to be the
611 default behavior but this could overwhelm a system if many messages
612 were black- or whitelisted at once. The spam programs are now run in
613 the foreground, but this option can be used to put them back in the
614 background.
616 *** mh-junk-disposition
618 Renamed from `mh-junk-mail-folder' since this variable can accept
619 values other than folder names.
621 *** mh-kill-folder-suppress-prompt-hooks
623 Renamed from `mh-kill-folder-suppress-prompt-hook'. By convention,
624 abnormal hooks, which this is, either have a -function or -hooks
625 suffix.
627 *** mh-mhl-format-file
629 Renamed from `mhl-formfile' to put it in the MH-E namespace and to be
630 consistent with other similar options.
632 *** mh-mh-to-mime-hook
634 Renamed from `mh-edit-mhn-hook'. We have a family of `mh-mml-to-mime'
635 functions and variables; the older mhn functions and variables were
636 renamed to have a consistent `mh-mh-to-mime' prefix.
638 *** mh-mml-method-default
640 Default method to use in security tags.
642 *** mh-new-messages-folders
644 Renamed from `mh-index-new-messages-folders' for clarity.
646 *** mh-path
648 Additional list of directories to search for MH.
650 *** mh-redist-full-contents-flag
652 On means the `dist' command needs entire letter for redistribution.
653 This was previously a variable. It's now an option.
655 *** mh-search-mode-hook
657 Renamed from `mh-pick-mode-hook' as part of the
658 `mh-index.el'/`mh-pick.el' merge into `mh-search.el'.
660 *** mh-search-program
662 Renamed from `mh-index-program' as part of the
663 `mh-index.el'/`mh-pick.el' merge into `mh-search.el'.
665 *** mh-signature-separator-flag
667 On means a signature separator should be inserted. It is not
668 recommended that you change this option since various mail user
669 agents, including MH-E, use the separator to present the signature
670 differently, and to suppress the signature when replying or yanking a
671 letter into a draft.
673 *** mh-sortm-args
675 Additional arguments for `sortm'. This was previously an internal
676 variable. It's now an user-customizable option.
678 *** mh-speed-update-interval
680 Renamed from `mh-speed-flists-interval' for clarity.
682 *** mh-ticked-messages-folders
684 Renamed from `mh-index-ticked-messages-folders' for clarity.
686 *** mh-variant
688 Specifies the variant used by MH-E. The default setting of this option
689 is `Auto-detect' which means that MH-E will automatically choose the
690 first of nmh, MH, or GNU mailutils that it finds in the directories
691 listed in `mh-path', `mh-sys-path', and `exec-path'. If, for example,
692 you have both nmh and mailutils installed and `mh-variant-in-use' was
693 initialized to nmh but you want to use mailutils, then you can set
694 this option to `mailutils'.
696 When this variable is changed, MH-E resets `mh-progs', `mh-lib',
697 `mh-lib-progs', `mh-flists-present-flag', and `mh-variant-in-use'
698 accordingly.
700 If you've set these variables in your .emacs, it is strongly suggested
701 that you comment them out. The MH detection code has been completely
702 rewritten and it is very likely that you no longer to set them and
703 their setting may confuse other MH-E settings.
705 *** mh-xemacs-tool-bar-position
707 Renamed from `mh-xemacs-toolbar-position' per GNU Emacs naming conventions.
709 *** mh-xemacs-use-tool-bar-flag
711 Renamed from `mh-xemacs-use-toolbar-flag' per GNU Emacs naming conventions.
713 *** mh-yank-behavior
715 Renamed from `mh-yank-from-start-of-msg' for clarity.
719 ** Variables Deleted in MH-E 8.0
721 *** mh-alias-system-aliases
723 System definitions should not be a user option.
725 *** mh-edit-mhn-hook
727 Renamed to `mh-mh-to-mime-hook'.
729 *** mh-folder-updated-hook
731 Renamed to `mh-before-commands-processed-hook'.
733 *** mh-highlight-citation-p
735 Renamed to `mh-highlight-citation-style'.
737 *** mh-index-new-messages-folders
739 Renamed to `mh-new-messages-folders'.
741 *** mh-index-program
743 Renamed to `mh-search-program'.
745 *** mh-index-ticked-messages-folders
747 Renamed to `mh-ticked-messages-folders'.
749 *** mh-junk-mail-folder
751 Since this variable can accept values other than folder names, it was
752 renamed to `mh-junk-disposition' to more accurately reflect the content.
754 *** mh-kill-folder-suppress-prompt-hook
756 Renamed to `mh-kill-folder-suppress-prompt-hooks'.
758 *** mh-letter-insert-signature-hook
760 Renamed to `mh-insert-signature-hook'.
762 *** mh-pick-mode-hook
764 Renamed to `mh-search-mode-hook'.
766 *** mh-show-use-goto-addr-flag
768 This flag was redundant with and inconsistent with
769 `goto-address-highlight-p' at the same time, so we removed it. Please
770 customize `goto-address-highlight-p' if you wish to turn off email
771 address and URL highlighting.
773 *** mh-speed-flists-interval
775 Renamed to `mh-speed-update-interval'.
777 *** mh-speed-run-flists-flag
779 Deleted since setting `mh-speed-flists-interval' to 0 accomplishes the
780 same thing.
782 *** mh-visible-header-fields
784 Deleted since it would hide new header fields you might want to see.
786 *** mh-xemacs-toolbar-position
788 Renamed to `mh-xemacs-tool-bar-position'.
790 *** mh-xemacs-use-toolbar-flag
792 Renamed to `mh-xemacs-use-tool-bar-flag'.
794 *** mh-yank-from-start-of-msg
796 Renamed to `mh-yank-behavior'.
798 *** mhl-formfile
800 Renamed to `mh-mhl-format-file'.
804 ** New Faces in MH-E 8.0
806 *** mh-folder-address
808 Renamed from `mh-folder-address-face' per new Emacs conventions.
810 *** mh-folder-body
812 Renamed from `mh-folder-body-face' per new Emacs conventions.
814 *** mh-folder-cur-msg-number
816 Renamed from `mh-folder-cur-msg-number-face' per new Emacs conventions.
818 *** mh-folder-date
820 Renamed from `mh-folder-date-face' per new Emacs conventions.
822 *** mh-folder-deleted
824 Renamed from `mh-folder-deleted-face' per new Emacs conventions.
826 *** mh-folder-followup
828 Renamed from `mh-folder-followup-face' per new Emacs conventions.
830 *** mh-folder-msg-number
832 Renamed from `mh-folder-msg-number-face' per new Emacs conventions.
834 *** mh-folder-refiled
836 Renamed from `mh-folder-refiled-face' per new Emacs conventions.
838 *** mh-folder-sent-to-me-hint
840 Fontification hint face in messages sent directly to us.
842 *** mh-folder-sent-to-me-sender
844 Sender face in messages sent directly to us.
846 *** mh-folder-subject
848 Renamed from `mh-folder-subject-face' per new Emacs conventions.
850 *** mh-folder-tick
852 Renamed from `mh-folder-tick-face' per new Emacs conventions.
854 *** mh-folder-to
856 Renamed from `mh-folder-to-face' per new Emacs conventions.
858 *** mh-letter-header-field
860 Renamed from `mh-letter-header-field-face' per new Emacs conventions.
862 *** mh-search-folder
864 Renamed from `mh-index-folder-face'.
866 *** mh-show-cc
868 Renamed from `mh-show-cc-face' per new Emacs conventions.
870 *** mh-show-date
872 Renamed from `mh-show--face' per new Emacs conventions.
874 *** mh-show-from
876 Renamed from `mh-show-from-face' per new Emacs conventions.
878 *** mh-show-header
880 Renamed from `mh-show-header-face' per new Emacs conventions.
882 *** mh-show-pgg-bad
884 Face used to highlight a bad PGG signature.
886 *** mh-show-pgg-good
888 Face used to highlight a good PGG signature.
890 *** mh-show-pgg-unknown
892 Face used to highlight a PGG signature whose status is unknown. This
893 face is also used for a signature when the signer is untrusted.
895 *** mh-show-signature
897 Face used to highlight the signature.
899 *** mh-show-subject
901 Renamed from `mh-show-subject-face' per new Emacs conventions.
903 *** mh-show-to
905 Renamed from `mh-show-to-face' per new Emacs conventions.
907 *** mh-show-xface
909 Renamed from `mh-show-xface-face' per new Emacs conventions.
911 *** mh-speedbar-folder
913 Renamed from `mh-speedbar-folder-face' per new Emacs conventions.
915 *** mh-speedbar-folder-with-unseen-messages
917 Renamed from `mh-speedbar-folder-with-unseen-messages-face' per new
918 Emacs conventions.
920 *** mh-speedbar-selected-folder
922 Renamed from `mh-speedbar-selected-folder-face' per new Emacs conventions.
924 *** mh-speedbar-selected-folder-with-unseen-messages
926 Renamed from `mh-speedbar-selected-folder-with-unseen-messages-face'
927 per new Emacs conventions. 
931 ** Faces Deleted in MH-E 8.0
933 *** mh-folder-address-face
935 Renamed to `mh-folder-address' per new Emacs conventions.
937 *** mh-folder-body-face
939 Renamed to `mh-folder-body' per new Emacs conventions.
941 *** mh-folder-cur-msg-face
943 Deleted. Not used.
945 *** mh-folder-cur-msg-number-face
947 Renamed to `mh-folder-cur-msg-number' per new Emacs conventions.
949 *** mh-folder-date-face
951 Renamed to `mh-folder-date' per new Emacs conventions.
953 *** mh-folder-deleted-face
955 Renamed to `mh-folder-deleted' per new Emacs conventions.
957 *** mh-folder-followup-face
959 Renamed to `mh-folder-followup' per new Emacs conventions.
961 *** mh-folder-msg-number-face
963 Renamed to `mh-folder-msg-number' per new Emacs conventions.
965 *** mh-folder-refiled-face
967 Renamed to `mh-folder-refiled' per new Emacs conventions.
969 *** mh-folder-subject-face
971 Renamed to `mh-folder-subject' per new Emacs conventions.
973 *** mh-folder-tick-face
975 Renamed to `mh-folder-tick' per new Emacs conventions.
977 *** mh-folder-to-face
979 Renamed to `mh-folder-to' per new Emacs conventions.
981 *** mh-index-folder-face
983 Renamed to `mh-search-folder'.
985 *** mh-letter-header-field-face
987 Renamed to `mh-letter-header-field' per new Emacs conventions.
989 *** mh-show-cc-face
991 Renamed to `mh-show-cc' per new Emacs conventions.
993 *** mh-show-date-face
995 Renamed to `mh-show-date' per new Emacs conventions.
997 *** mh-show-from-face
999 Renamed to `mh-show-from' per new Emacs conventions.
1001 *** mh-show-header-face
1003 Renamed to `mh-show-header' per new Emacs conventions.
1005 *** mh-show-subject-face
1007 Renamed to `mh-show-subject' per new Emacs conventions.
1009 *** mh-show-to-face
1011 Renamed to `mh-show-to' per new Emacs conventions.
1013 *** mh-show-xface-face
1015 Renamed to `mh-show-xface' per new Emacs conventions.
1017 *** mh-speedbar-folder-face
1019 Renamed to `mh-speedbar-folder' per new Emacs conventions.
1021 *** mh-speedbar-folder-with-unseen-messages-face
1023 Renamed to `mh-speedbar-folder-with-unseen-messages' per new Emacs conventions.
1025 *** mh-speedbar-selected-folder-face
1027 Renamed to `mh-speedbar-selected-folder' per new Emacs conventions.
1029 *** mh-speedbar-selected-folder-with-unseen-messages-face
1031 Renamed to `mh-speedbar-selected-folder-with-unseen-messages' per new
1032 Emacs conventions.
1036 ** Bug Fixes in MH-E 8.0
1038 *** Face Variable Names Now Follow Current Conventions
1040 The -face suffix has been dropped from all face names. 
1042 *** Swish Fixes
1044 Items in swish indexes that aren't mail messages are now handled more
1045 gracefully.
1047 *** Spamassassin Fixes
1049 If you use spamassassin, there was an error when you tried to junk
1050 mail if the option `mh-junk-background' was set. This has been fixed.
1052 *** Mairix Support
1054 Indexing now compatible with Mairix version 0.12 and later.
1056 *** mh-extract-rejected-mail Can't Do MIME (and Other Formats)
1058 Now handles qmail and exim bounces (addresses SF #404965).
1060 *** mh-rmail Hangs in XEmacs
1062 We've determined that MH-E is incompatible with some versions of
1063 XEmacs (21.5.9-21.5.16). More recent versions work fine. If you think
1064 our list is too broad, please let us know which version of XEmacs you
1065 are using (closes SF #644321).
1067 *** Completions Offered by mh-refile-message Are Not Sorted
1069 This behavior is no longer observed (closes SF #698734).
1071 *** Add Message-ID to Outgoing Messages
1073 If you replied to a message in your `+outbox', an `In-Reply-To:'
1074 header field was created that broke threading at the recipient's end.
1075 We now add a `Message-ID:' to outgoing messages which fixes this
1076 (closes SF #725425).
1078 *** Inconsistent Prompts
1080 Emacs changed their defaults in prompts from "Prompt: [value]" to
1081 "Prompt (default value): ". All MH-E prompts have been updated to
1082 comply with the new standard and are therefore now consistent
1083 throughout the application (closes SF #730470, SF #1275933).
1085 *** Empty Shell Comments Confuse mh-mhn-directive-present-p
1087 If you had a string that matched the regexp "^# $" in your draft, it
1088 would cause an error. This has been fixed (closes SF #762458).
1090 *** Quote Hashes When mhbuild Directives Used
1092 A related bug, if you had empty shell comments but inserted your own
1093 directives, you'd get another error from mhbuild. This has been fixed
1094 by quoting the hash ("^# $") like this "##" before submitting to
1095 mhbuild (closes SF #762464).
1097 *** Inconsistent Usage in Scan Formatting Variables
1099 The variables:
1101     mh-note-cur
1102     mh-note-deleted
1103     mh-note-dist
1104     mh-note-forw
1105     mh-note-refiled
1106     mh-note-repl
1107     mh-note-seq
1109 used to contain strings. Although only the first character was read,
1110 the entire string would be inserted which may have caused problems.
1111 These variables have been converted to character constants so that
1112 only a single character can be inserted into the scan line (closes SF
1113 #770772).
1115 *** Bad Handling of Aliases That Conflict With Local User Names
1117 If a user name existed both locally and in the aliases file, the local
1118 user would be flashed, but the alias would be used when sending. This
1119 has been fixed so that the user name that is flashed is the same as
1120 the name that is sent (closes SF #772595).
1122 *** Initialization Fails If ~/Mail Exists
1124 MH-E no longer calls `install-mh' so this issue has gone away (closes
1125 SF #835192).
1127 *** Not Re-prompted to Sign After Pass Phrase Typo
1129 If there were errors when sending a signed message (like getting the
1130 pass phrase wrong), the MML markup remained in the draft buffer. The
1131 draft buffer is now restored if there is an error (closes SF #839303).
1133 *** Font-lock Gets Confused in MH-Letter Buffer
1135 If a user manually moved the cursor to the end of the header field
1136 separator line (by mouse click or keyboard navigation) and hit Enter
1137 to start typing their message, any line in the body with a colon would
1138 be fontified with a gray background. This has been fixed (closes SF
1139 #855479).
1141 *** RETURN Causes Infinite Loop in mh-letter
1143 This behavior is no longer observed (closes SF #887346).
1145 *** mh-refile-msg Fails to Suggest Folder for Empty Message
1147 If you received a message with an empty body from someone who is
1148 listed in your aliases file, `o' (`mh-refile-msg') failed to suggest
1149 the correct folder. This has been fixed (closes SF #917096).
1151 *** Missing Headers When Replying to All
1153 User needed to edit `replgroupcomps' (closes SF #918194).
1155 *** Error Visiting Folder With no Unseen Messages
1157 If you visited a folder without unseen messages and the option "flist:
1158 -noshowzero" is present in your `~/.mh_profile', you'd get an error.
1159 This has been fixed (closes SF #933954).
1161 *** Error Message When Trying to Send Using MH-E
1163 This behavior is no longer observed (closes SF #1002103).
1165 *** mh-find-path Doesn't Use mhparam
1167 MH-E no longer peeks into the MH profile `~/.mh_profile' directly. It
1168 uses `mhparam' instead (closes SF #1016027).
1170 *** rmmproc Refile Complains No Such Message
1172 MH-E would get confused about which folder to delete messages from if
1173 you were refiling and deleting messages at the same time. This has
1174 been fixed (closes SF #1023959).
1176 *** auto-mode-alist Updated
1178 MH-E originally updated auto-mode-alist to set the major mode of
1179 drafts. Now that we explicitly set the mode, there is no reason to do
1180 this, and this behavior caused problems for people who didn't use MH-E
1181 who were editing files that looked like MH message files (closes SF
1182 #1032353).
1184 *** ! Doesn't Do Regions
1186 Now it does (closes SF #1046330).
1188 *** mh-show-unquote-From Fails (read-only buffer)
1190 MH-E quotes the `From ' header field that is inserted by MTAs.
1191 However, it was trying to do this in a read-only buffer. This has been
1192 fixed (closes SF #1089870).
1194 *** Whitespace in pick Expressions
1196 The `C-u / s RET' command now works. In addition, you can now add
1197 whitespace to any of the limiting (/) commands (closes SF #1122655).
1199 *** mh-index-previous-folder Does Not Work Correctly
1201 If your cursor was on an item below a folder heading and you used
1202 `M-TAB' (`mh-index-previous-folder'), you would move to the previous
1203 folder heading. This has been fixed (closes SF #1126188).
1205 *** Default Identity Prevents Insertion of Auto Fields
1207 Auto insertion of an identity now occurs even when the default
1208 identity is used (closes SF #1204506).
1210 *** mh-compose-forward and Default Message Number
1212 `mh-compose-forward' will now default to the sent message in the sent
1213 folder and the `cur' message in other folders. It also takes ranges of
1214 messages and can include multiple messages at a time (closes SF
1215 #1205890).
1217 *** Better Handling of Empty cur Sequence
1219 If you refiled a message into a folder and then used `F r'
1220 (`mh-rescan-folder') in that folder, your cursor would be taken to the
1221 first message. The cursor now stays where it was (closes SF #1207247).
1223 *** mh-customize Uses Group mh, Not mh-e
1225 The `mh' customization group alias has been deleted to avoid some
1226 problems that were found (closes SF #1213716).
1228 *** "Args out of range" Error in Displaying Message
1230 This behavior is no longer observed (closes SF #1227504).
1232 *** Front-and-back Truncation in mailto: Rendering
1234 This behavior is no longer observed (closes SF #1227510).
1236 *** Name of the Draft File in mh-comp.el
1238 MH is documented to use the draft file. If you use a draft file for
1239 something else (like Sylpheed), then use draft folders (closes SF
1240 #1231483).
1242 *** font-lock Error in mh-letter-mode
1244 An error in MH-E was introduced as a result of a change in CVS Emacs.
1245 This has been fixed (closes SF #1241017).
1247 *** Msg Display Broken After Displaying Msg with Inline Image
1249 Messages with inline images no longer trim certain message header
1250 fields (closes SF #1306141).
1252 *** mh-visit-folder Munges font-lock-keywords
1254 MH-E broke highlighting in Gnus buffers. This was actually a problem
1255 in CVS Emacs 22 and has been fixed there (closes SF #1393879).
1257 *** Illegal Filename Chars for W32 Filesystems
1259 Windows users who view `X-Image-URL:' images could not cache the
1260 images since the cached image file names had illegal characters. This
1261 has been fixed (closes SF #1396499).
1263 *** mh-send Doesn't Handle mml Insertions Via mail-user-agent
1265 Can now forward messages in Gnus if MH-E is your `mail-user-agent'
1266 (closes SF #1399307).
1268 *** Can't Narrow to Subject with Regexp Chars
1270 The command `/ s' could not limit subjects that had special pick
1271 characters (such as [, *, $, .). This has been fixed (closes SF
1272 #1432548).
1274 *** `/ s' Can Miss the Original Mail
1276 The command `/ s' failed to include the message with the "Re:" in the
1277 Subject. This has been fixed (closes SF #1438369).
1279 *** mhparam -components Fails on mailutils
1281 This error prevented MH-E from loading when using GNU mailutils. GNU
1282 mailutils drops the `s' in this argument, so we did too since
1283 -component still works in nmh and MH (closes SF #1446985).
1285 *** `/ s' Still Has Problems With []'d Mail
1287 On XEmacs, subjects that had special characters would prevent `/ s'
1288 from narrowing to the given subject. These characters are now quoted
1289 correctly in XEmacs (closes SF #1447598).
1291 *** Variable mh-send-args Is a String, Not a List
1293 This was causing errors when sending under GNU mailutils. The internal
1294 variable `mh-send-args' is now a list which fixes the problem (closes
1295 SF #1448604).
1297 *** Update Icons
1299 Most of the tool bar icons have been replaced by GTK or GNOME 2 icons
1300 (closes SF #1452715).
1302 *** Strip Build Number From emacs-version in X-Mailer
1304 This has been done (closes SF #1466481).
1306 *** Rename Function and Variable Definers
1308 If you had ever shown help for an MH-E symbol that was both a function
1309 or variable, you might have found that the hyperlink to the file
1310 brought you to the wrong definition. This has been fixed by renaming
1311 the macros `mh-defgroup', `mh-defcustom', `mh-defface',
1312 `mh-defun-compat', and `mh-defmacro-compat' to `defgroup-mh',
1313 `defcustom-mh', `defface-mh', `defun-mh', `defmacro-mh' respectively
1314 (closes SF #1472029).
1316 *** mh-insert-letter Uses Wrong Default
1318 If you had used `C-c TAB' (`mh-insert-letter') to insert a letter into
1319 your draft, specified a different folder, and chose the default
1320 message number, you got the wrong message. This has been fixed (closes
1321 SF #1473729).
1325 * Changes in MH-E 7.4.4
1327 Version 7.4.4 addresses programmatic issues from the FSF and prepares
1328 MH-E for inclusion into an impending GNU Emacs release (22.1). There
1329 are no user-visible changes (unless you are using XEmacs on DOS or
1330 don't have the cl package installed). Filenames are now unique in
1331 their first 8 characters (DOS 8.3 requirement). The runtime dependency
1332 on the cl package has been removed. Desktop saving and restoration
1333 code moved here from desktop.el.
1335 * Changes in MH-E 7.4.3
1337 Version 7.4.3 fixes the problem where `mh-identity-list' was not getting
1338 set from .emacs.
1340 * Changes in MH-E 7.4.2
1342 Version 7.4.2 fixes the accidental dependence on nmh (closes SF
1343 #791021).
1345 * Changes in MH-E 7.4.1
1347 Version 7.4.1 fixes the Makefile so it no longer tries to compile
1348 mh-unit.el.
1350 * Changes in MH-E 7.4
1352 Version 7.4 contains many new useful features including arbitrary MH
1353 range handling, new draft features such as draft form editing, as well
1354 as sequence propagation and manipulation. We've also fixed bugs and
1355 added a handful of new variables.
1357 ** New Features in MH-E 7.4
1359 *** Add Arbitrary Ranges to MH-E UI
1361 MH-E now handles any legal MH range (such as last:5 or 4 8 10-12)
1362 wherever you're prompted for a message number or sequence (closes SF
1363 #728638).
1365 *** Remove Prompting in mh-send
1367 Brian Reid's original mhe didn't do prompting anywhere but used forms
1368 instead. While we won't go that far, we eliminated prompting where a
1369 form is already involved, such as in composing a message.
1371 The new customization variable `mh-compose-prompt-flag' can be set to
1372 t to get the original behavior (closes SF #745622).
1374 *** Use TAB to Switch Fields in Header
1376 When composing a message, TAB and SHIFT-TAB can be used to move
1377 quickly between header fields. The new customization variable,
1378 `mh-compose-skipped-header-fields', contains a list of header fields
1379 that are skipped and truncated if they are too long (closes SF
1380 #745627).
1382 *** Alias Completion in Composition Buffer
1384 Aliases can be completed in the draft with "M-TAB
1385 (mh-letter-complete)". Or, if the customization variable
1386 `mh-compose-space-does-completion-flag' is set to t, then a "SPC
1387 (mh-letter-complete-or-space)" with do the same thing. If
1388 `mh-alias-flash-on-comma' is non-nil, ", (mh-letter-confirm-address)"
1389 will show the alias expansion in the minibuffer (closes SF #745634).
1391 *** Auto Fields Should be Inserted During Send
1393 Fields that were inserted by the multiple personality code when the
1394 draft was sent now insert the header fields when the draft is composed
1395 to give you a chance to edit them (closes SF #747890).
1397 *** mh-index-tick-messages
1399 The command "F ' (mh-index-ticked-messages)" creates a buffer with all
1400 messages ticked with "' (mh-toggle-tick)" in the folders listed in the
1401 new customization variable `mh-index-ticked-messages-folders'. Chances
1402 are that if you set `mh-index-new-messages-folders', you'll want to
1403 set `mh-index-ticked-messages-folders' accordingly.
1405 In addition, a general function, "F q (mh-index-sequenced-messages)"
1406 has been provided that displays messages in the `mh-unseen-seq' in the
1407 folders listed `mh-index-new-messages-folders', unless a prefix
1408 argument is given, in which case you can provide both a list of
1409 folders and a sequence (closes SF #718833).
1411 *** Narrow to Region
1413 If there is a region, "/ r (mh-narrow-to-range)" will only consider
1414 those messages in the region. In addition, there is now a stack of
1415 folder limits which can be popped with "/ w (mh-widen)". With a prefix
1416 arg, all the restrictions are popped off of the stack (closes SF
1417 #732823).
1419 *** Narrow to Ticked Sequence
1421 The buffer can now be narrowed to ticked messages with "S '
1422 (mh-narrow-to-tick)" (closes SF #732825).
1424 *** Display Multiple Buttons for multipart/alternative
1426 A new customizable variable,
1427 `mh-display-buttons-for-alternatives-flag', was added to display
1428 buttons for the alternatives. The default value is nil to retain the
1429 current behavior (closes SF #741288).
1431 *** Identity Menu Changes
1433 A menu item has been added that inserts custom fields if the To or Cc
1434 header fields match `mh-auto-fields-list'.
1436 ** New Variables in MH-E 7.4
1438 *** mh-alias-local-users-prefix
1440 This string is prepended to the real names of users from the passwd
1441 file. If nil, use the username string unmodified instead of the real
1442 name from the gecos field of the passwd file.
1444 *** mh-alias-passwd-gecos-comma-separator-flag
1446 Non-nil means the gecos field in the passwd file uses comma as a
1447 separator. Used to construct aliases for users in the passwd file."
1449 *** mh-interpret-number-as-range-flag
1451 Non-nil means interpret a number as a range. If the variable is
1452 non-nil, and you use an integer, N, when asked for a range to scan,
1453 then MH-E uses the range "last:N".
1455 *** mh-kill-folder-suppress-prompt-hook
1457 This new hook is invoked at the beginning of the `F k
1458 (mh-kill-folder)' command. It is a list of functions to be called,
1459 with no arguments, which should return a value of non-nil if you
1460 should not be asked if you're sure that you want to remove the folder.
1461 This is useful for folders that are easily regenerated.
1463 The default value of `mh-index-p' suppresses the prompt on folders
1464 generated by an index search.
1466 WARNING: Use this hook with care. If there is a bug in your hook which
1467 returns t on +inbox and you hit `F k' by accident in the +inbox
1468 buffer, you will not be happy.
1470 *** mh-refile-preserves-sequences-flag
1472 Non-nil means that sequences are preserved when messages are refiled.
1473 If this variable is non-nil and a message belonging to a sequence
1474 other than cur or Previous-Sequence (see mh-profile 5) is refiled then
1475 it is put in the same sequence in the destination folder. Additional
1476 sequences that should not to be preserved can be specified by setting
1477 `mh-unpropagated-sequences' appropriately.
1479 *** mh-visible-header-fields
1481 Customize this instead of `mh-visible-headers', which is now a defvar.
1482 This was done to mimic the relationship between
1483 `mh-invisible-header-fields' and `mh-invisible-fields'.
1485 ** Variables Deleted in MH-E 7.4
1487 *** mh-visible-headers
1489 See the paragraph for `mh-visible-header-fields' above.
1491 ** Bug Fixes in MH-E 7.4
1493 *** Aliases Constantly Reloaded
1495 The system aliases are not loaded as often as they were, so the
1496 completion speed has been dramatically improved if your passwd file is
1497 large (closes SF #693859).
1499 *** Folders in MH-Index View Not Saved
1501 When you perform a search to produce an MH-Index buffer, the folders
1502 that contain the messages are shown. If the MH-Index buffer was
1503 deleted, or Emacs was restarted and the corresponding folder
1504 rescanned, the folder information would be lost. This has been fixed
1505 by saving the information in a file called ".mhe_index" (closes SF
1506 #701762).
1508 *** Ticking Messages in +mhe-index/new
1510 If a new message in a buffer created by "F n" was ticked (with "'"),
1511 the message would not be added to the tick sequence in the source
1512 folder. This has been fixed so that any sequence changes in any index
1513 folder (from within MH-E of course) are now reflected back to the
1514 corresponding source folder (closes SF #709664).
1516 *** Custom Vars Set by a Function
1518 The default setting of customization variable `mh-summary-height' is
1519 now `nil' which means MH-E will change the size dynamically according
1520 to the size of the frame (closes SF #723267).
1522 *** Folder Completion Slow
1524 The first folder completion was very slow. This has been fixed (closes
1525 SF #730426).
1527 *** Tick Sequence Persistent When Refiled
1529 Sequences are now preserved when messages are refiled (closes SF
1530 #737128).
1532 *** Auto-inserted Header Fields Inconsistent
1534 For consistency, all automatically inserted header fields (such as
1535 X-Mailer and X-Face) are added when the draft is first presented to
1536 you. This also gives you a chance to edit or delete them if necessary
1537 (closes SF #745624). Note that we would be distressed if you deleted
1538 the X-Mailer field.
1540 *** Toolbar Spec Error
1542 The following message appeared when displaying a message in XEmacs:
1544   Signaling: (error "Toolbar spec must be list or nil" )
1546 This has been fixed (closes SF #745655).
1548 *** mh-index-search Doesn't Find Short Acronyms
1550 Swish typically ignores words with fewer than four letters, but will
1551 still look for acronyms. Unfortunately, MH-E was downcasing the input
1552 words which defeated this feature. This has been fixed (closes SF
1553 #755718).
1557 * Changes in MH-E 7.3
1559 This release includes the new features of an index view of unseen
1560 messages in all folders, spam software support, relative folder
1561 specification @ support, marking messages, recipient handling by
1562 mh-default-folder-list, Face and X-Image-URL header field support, and
1563 Fcc completion. Function arguments have been unified. Bugs have been
1564 fixed.
1566 ** New Features in MH-E 7.3
1568 *** Unified Function Arguments
1570 Any function with MSG-OR-SEQ in its docstring uses the displayed
1571 message by default for this argument. However, if a prefix argument is
1572 provided, then the user is prompted for a message sequence. If the
1573 variable `transient-mark-mode' is non-nil and the mark is active, then
1574 the function operates on the messages in the selected region. In a
1575 program, MSG-OR-SEQ can be a message number, a list of message
1576 numbers, a region in a cons cell, or a sequence.
1578 *** MH-Index View of Unseen Messages
1580 Use "F n (mh-index-new-messages)" or Folder -> View New Messages menu
1581 item to display messages in the `mh-unseen-seq' sequence in folders
1582 specified by `mh-index-new-messages-folders'. With a prefix argument,
1583 enter a space-separated list of folders, or nothing to search all
1584 folders.
1586 Like other MH-Index folders, use "v (mh-index-visit-folder)" if you
1587 wish to visit the original folder with the unseen message. This is
1588 usually not necessary since the original message is annotated if you
1589 reply, deleted if you delete the message, or refiled if you refile the
1590 message (closes SF #701756).
1592 *** Spam Software Support
1594 MH-E now supports several spam filters including Bogofilter,
1595 SpamProbe, and SpamAssassin. Spam that is mistakenly considered to be
1596 good mail can be reclassified as spam with "J b (mh-junk-blacklist)".
1597 Conversely, good mail that is accidentally considered to be spam can be
1598 reclassified with "J w (mh-junk-whitelist)" (closes SF #669518).
1600 If a message is blacklisted, and `mh-junk-mail-folder' is a string,
1601 then the message is refiled to that folder. If this variable is nil,
1602 the message is deleted. If a message is whitelisted, then the message
1603 is refiled to `mh-inbox'.
1605 To change the spam program being used, customize `mh-junk-program'.
1606 This should only be necessary if you have multiple filters on your
1607 system and MH-E picked the wrong one. These customization variables
1608 are found in the new customization group `mh-junk'.
1610 The documentation for the following functions describes what setup is
1611 needed for the different spam fighting programs:
1613   - `mh-bogofilter-blacklist'
1614   - `mh-spamprobe-blacklist'
1615   - `mh-spamassassin-blacklist'
1617 *** Relative Folder Specification @ Supported
1619 You can now use the relative folder marker @ in folder names (closes
1620 SF #666774).
1622 *** Marking Messages
1624 Messages can now be highlighted with "' (mh-toggle-tick)", Sequence ->
1625 Toggle Tick Mark menu item or the "Toggle tick mark" button. These
1626 messages are added to the "tick" sequence, although this sequence can
1627 be changed in `mh-tick-seq'. The highlighting effect can be modified
1628 by customizing `mh-folder-tick-face' (closes SF #623367).
1630 There is also a new keybinding "/ ' (mh-narrow-to-tick)" and menu item
1631 Sequence -> Narrow to Tick Sequence to narrow the view to the
1632 highlighted messages.
1634 *** mh-default-folder-list Now Takes Recipients
1636 If you wish to file a message based upon the recipient of a message
1637 (such as a mailing list), you can now indicate that when filling out
1638 the address in the `mh-default-folder-list' customization variable.
1640 *** Face Header Field Supported
1642 In addition to the X-Face header field, the Face header field, which
1643 can display color images, is now supported. As a bonus, the external
1644 xface-e21 library is no longer required.
1646 *** X-Image-URL Support
1648 Images specified in X-Image-URL header fields are now supported.
1649 See the customization variable `mh-fetch-x-image-url' to enable this
1650 support.
1652 *** Fcc Completion
1654 Folders in Fcc fields in message drafts can now be completed with
1655 M-TAB.
1657 ** New Variables in MH-E 7.3
1659 Variables that have been added to MH-E that have not been discussed
1660 elsewhere are listed here.
1662 *** mh-auto-fields-list
1664 Alist of addresses for which header lines are automatically inserted.
1665 When a regular expression matches in the To or cc fields of a message,
1666 the corresponding header field is automatically inserted in the
1667 message header. It also allows the automatic setting of an identity
1668 (using `mh-insert-identity') to set an alternate identity when sending
1669 messages to a certain person or mailing list.
1671 Since this is a more general use of `mh-insert-mail-followup-to-flag'
1672 and `mh-insert-mail-followup-to-list', these variables have been removed.
1674 *** mh-show-xface-face
1676 Face for displaying the X-Face image.
1678 *** mh-xemacs-toolbar-position
1680 This customization variable allows the user to place the toolbar on
1681 the four edges of the frame.
1683 *** mh-xemacs-use-toolbar-flag
1685 This customization variable is used to enable or disable the toolbar
1686 under XEmacs.
1688 ** Variables Deleted in MH-E 7.3
1690 Variables that have been removed from MH-E that have not been
1691 discussed elsewhere are listed here.
1693 *** mh-decode-content-transfer-encoded-message-flag
1695 No longer needed since the external program mimencode is no longer
1696 used.
1698 *** mh-index-show-hook
1700 This hook was never used, so it was removed.
1702 *** mh-tool-bar-reply-3-buttons-flag
1704 Obsolete. This functionality is present `mh-tool-bar-folder-buttons'.
1706 ** Bug Fixes in MH-E 7.3
1708 *** Can't Refile Message
1710 Messages with invalid addresses were causing errors in ali which
1711 prevented the refiling of messages. The ali error is now shown in the
1712 "*MH-E Log*" buffer and refiling suggests the last folder used (closes
1713 SF #680388).
1715 *** Empty Body Triggers Duped Header
1717 If the body was empty the header would be treated like the body and
1718 was therefore displayed twice. This has been fixed (closes SF
1719 #681162).
1721 *** mml or mhl Directives Not Always Processed
1723 The mml and mhl directives used to create body parts were not
1724 processed if one re-edited a draft, or if they added the directives
1725 manually. The directives are now always processed upon sending the
1726 letter. You may still, of course, use "C-c C-m m (mh-mml-to-mime)" or
1727 "C-c C-e (mh-edit-mhn)" to manually create the MIME body parts from
1728 the directives and then send the draft.
1730 *** mh-alias-grab-from-field Fails
1732 MH-E was adding aliases with angle brackets around the address when
1733 there wasn't a phrase (usually, the user's name), to go with it. This
1734 caused ali to fail which caused problems in MH-E. This is probably a
1735 bug in ali, but MH-E no longer inserts angle brackets around the
1736 address unless there is a phrase, which avoids the problem (closes SF
1737 #690216).
1739 *** XEmacs Fixes
1741 MH-E is now fully supported under XEmacs and compiles without any
1742 warnings.
1744 In particular, the following now work under XEmacs:
1746 - X-Face, Face, and X-Image-URL header fields
1747 - MH-E logo in mode line
1748 - Emphasis (bold, italics, etc.)
1749 - Smilies
1750 - Toolbar
1752 *** Indexed Folders Should Respect mh-show-threads-flag
1754 Indexed folders are now threaded if `mh-show-threads-flag' is non-nil
1755 (closes SF #709667).
1757 *** Threading Index View Loses Folder Info
1759 This has been fixed (closes SF #709672).
1761 *** No Undo Information When Re-editing Drafts
1763 Undo is turned on in the draft buffer when using "e (mh-edit-again)"
1764 (closes SF #712777).
1766 *** Forwarded base64-encoded Messages Are Incorrectly Displayed
1768 This has been fixed (closes SF #681518).
1770 *** Append to *MH-E Log* Buffer
1772 The last 100 lines of log messages are kept in the *MH-E Log* buffer.
1773 Previously, the buffer was erased every time it was written (closes SF
1774 #685476). In addition, many of the MH-E commands now send their output
1775 into this buffer instead of a plethora of other special-purpose
1776 buffers.
1778 *** mh-inc-folder Complains if No Mail and No Current Message
1780 The function `mh-inc-folder' no longer calls `mh-show' if point is not
1781 on a valid scan line. This keeps `mh-inc-folder' from complaining
1782 (closes SF #678115).
1784 *** Folder Normalization Strips Leading Slash
1786 Leading "/" characters in folder names entered by the user were being
1787 lost. This has been fixed (closes SF #676890).
1789 *** Print Header Doesn't Show Message
1791 When printing a sequence, the header simply indicated that a sequence,
1792 but not which one, was being printed and did not show the message
1793 number. This has been fixed. If more than one message is printed, a
1794 page of the scan lines is printed and its header indicates the
1795 sequence or message range. The pages with the actual messages all set
1796 the header to the folder and message displayed on that page.
1798 *** Aliases Constantly Reloaded
1800 Empty lists are now handled properly (closes SF #693859).
1802 *** Remove RCS Keywords
1804 Removed RCS keywords per Emacs conventions (closes SF #680731).
1806 *** Replace Mimencode
1808 MH-E was enhanced to decode message based on charset and
1809 Content-Transfer-Encoding. This eliminates the need for the external
1810 program mimencode (closes SF #674857).
1814 * Changes in MH-E 7.2
1816 This release includes the new features of filing hints, hierarchical
1817 file name completion, indexed search and pick integration, unification
1818 between `mh-visit-folder' and the speedbar, a displayed message
1819 indicator, buffer name organization, support for mairix indexed
1820 search, and last but not least, the MH-E logo has been added to the
1821 mode line. Code that handles sequences and message regions runs
1822 faster. Bugs have been fixed.
1824 ** New Features in MH-E 7.2
1826 *** Filing Hints
1828 When you file a message, MH-E now looks for an alias corresponding to
1829 the address of the sender and offers that as a default folder (closes
1830 SF #657096). The new variable `mh-default-folder-prefix' can be used
1831 to put these folders in a sub-folder. The new variable
1832 `mh-default-folder-must-exist-flag' means to suppress the suggested
1833 folder (thereby providing the previous folder used) if the folder
1834 doesn't already exist. The new variable `mh-default-folder-list' can
1835 be used to map additional addresses and folders.
1837 *** Hierarchical File Name Completion
1839 When you completed filenames in the past, you were presented with a
1840 list of all your folders at all depths in the tree. Now you are
1841 presented with only one level at a time (closes SF #664821).
1842 As a result, the variables `mh-auto-folder-collect-flag' and
1843 `mh-folder-list-change-hook' are obsolete.
1845 *** Indexed Search and Pick Integration
1847 The indexed and pick searches have been integrated (closes SF
1848 #664816). Both "F s (mh-search-folder)" and "F i (mh-index-search)"
1849 use the pick template for forming queries. To submit the query, use
1850 "C-c C-c (mh-do-search)" which will use the query method you selected.
1851 If you change your mind while forming the query, you can use "C-c C-i
1852 (mh-index-do-search)" or "C-c C-p (mh-pick-do-search)" to submit the
1853 query using the respective method.
1855 Second, the results from a pick search are now saved in a sub-folder
1856 of +mhe-index like an indexed search.
1858 Third, `pick' is now a valid choice for `mh-index-program'.
1860 *** mh-visit-folder Metamorphosis Continues
1862 When visiting a folder from the speedbar, only the unseen messages are
1863 shown if there are unseen messages. If there aren't any unseen
1864 messages, all of the messages are shown if there are fewer than
1865 `mh-large-folder' messages; otherwise, the user is prompted for the
1866 range of messages to display. The "F v (mh-visit-folder)" command has
1867 been modified to mimic this behavior. Use a prefix arg to force the
1868 message range prompt.
1870 *** Displayed Message Indicator
1872 In graphical Emacs, the message that is shown is marked by a triangle
1873 in the fringe. In textual Emacs, there is a ">" in the first column
1874 (closes SF #664824).
1876 *** Buffer Name Organization
1878 All ephemeral buffer names start with " *mh" while all interesting
1879 buffers start with "*MH-E ". The "*Folders*", "*Sequences*", and
1880 "*Recipients*" buffers were therefore renamed to "*MH-E Folders*",
1881 "*MH-E Sequences*" and "*MH-E Recipients*" respectively (programmers
1882 should see mh-utils.el for the names of the new constants). Also, the
1883 output of MH commands is saved in the "*MH-E Log*" buffer.
1885 *** mh-index-program
1887 Add choices for `mairix' and `pick'.
1889 *** Logo Displayed on Mode Line
1891 ** New Variables in MH-E 7.2
1893 The new variables have been discussed elsewhere.
1895 ** Bug Fixes in MH-E 7.2
1897 *** mh-decode-content-transfer-encoded-message
1899 Messages that had been encoded with base64 were not decoded. This has
1900 been fixed with this new function (closes SF #674190). As a result,
1901 the variable `mh-decode-quoted-printable-flag' has been renamed to
1902 `mh-decode-content-transfer-encoded-message-flag'.
1904 *** mh-kill-folder
1906 Now restores previous window configuration (closes SF #664828).
1908 *** mh-mime-display
1910 MH-E was not using the charset defined in the content-type
1911 header. This meant that mail in a different charset would not
1912 be properly displayed. This has been fixed (closes SF #655123).
1914 *** mh-read-address
1916 In XEmacs and Emacs20, this function would always prompt using "To: "
1917 instead of using the command argument. This has been fixed (closes SF
1918 #670913).
1920 *** mh-rmail
1922 Unseen messages are now shown in addition to new ones (closes SF
1923 #667542).
1925 *** mh-scan-msg-overflow-regexp
1927 Change the variable so that a space is always maintained in the
1928 beginning of the scan line.
1930 *** mh-swish-execute-search
1932 The example configuration file in the docstring didn't show the
1933 backslash in the FileRules filename. If the example had been used
1934 literally by the user, no files would be indexed! This has been fixed
1935 (closes SF #665888).
1937 *** mh-thread-refile
1939 The "T o (mh-thread-refile)" command did not provide refiling hints
1940 like `mh-refile-msg'. This has been fixed (closes SF #664829).
1942 *** mh-toggle-threads
1944 If the threaded view was modified and then toggled, the standard view
1945 may not have been accurate (as it contained a potentially old first
1946 message to last message range). This has been fixed (closes SF
1947 #626117).
1949 *** mh-tool-bar-show-set, mh-tool-bar-letter-set, mh-tool-bar-folder-set
1951 Clicking the customize and help buttons now deletes the other windows
1952 in the frame.
1954 *** mh-version
1956 The "M-x mh-version" command displayed "Aliasfile: aliases". This has
1957 been fixed (closes SF #664467). See Buffer Name Organization above.
1961 * Changes in MH-E 7.1
1963 This release includes the new features of multiple identities and
1964 alias completion. In addition, indexed searching has been revamped.
1965 Various other features have been added and a few bugs were fixed.
1967 ** New Features in MH-E 7.1
1969 *** Multiple Identities
1971 MH-E now supports multiple identities (closes SF #628782). That means
1972 that you can have different From and Organization header fields (or
1973 any other header field of your choice) as well as different signatures
1974 depending on your context. Usually, the contexts are home and work.
1976 Add your identities to the variable `mh-identity-list' and set the
1977 default identity with the variable `mh-identity-default'. Your
1978 identity can be switched on the fly by using the Identity menu or by
1979 calling "M-x mh-insert-identity RET".
1981 This functionality can be customized within the mh-identity group.
1983 *** Alias Completion and Harvesting
1985 The contributed file mh-alias.el has been rewritten and incorporated
1986 into MH-E.
1988 By default, aliases are culled from the system files
1989 "/etc/nmh/MailAliases," "/usr/lib/mh/MailAliases," and "/etc/passwd"
1990 (see `mh-alias-system-aliases') and from your "AliasFile" MH profile
1991 component. These aliases are then used for completion in the
1992 minibuffer when entering addresses. Within the header of the message
1993 draft, "M-TAB (mh-letter-complete)" is used to do alias completion.
1995 The package also provides for alias creation based upon the From
1996 header field of the current message. Use the lasso button
1997 (mh-alias-grab-from-field).
1999 This functionality can be customized within the mh-alias group.
2001 *** Index Folder Updates
2003 The results of an index search "F i (mh-index-search)" are now stored
2004 in a bona fide folder so that you can refile messages and reply to
2005 messages directly from the result folder. This folder is a sub-folder
2006 of +mhe-index and the name is based upon the search string (closes SF
2007 #623321).
2009 If a prefix argument is given then the search in the current index
2010 buffer is redone.
2012 The index folder lists the names of the source folders as before.
2013 However, instead of using RET on the name of the folder to visit the
2014 folder, use "v (mh-show-index-visit-folder)" anywhere within the
2015 results to visit that folder narrowed to the results of the search.
2016 Additional functions have been added to navigate including "TAB
2017 (mh-index-next-folder)", and "SHIFT-TAB (mh-index-previous-folder)."
2019 *** mh-visit-folder Interface Updated
2021 A change was made to the prompting of the message range. In general,
2022 you can use the same format for messages and sequences as you can in
2023 MH with a single exception: a single number means to scan that many
2024 messages, rather than scan that message number. This turns out to be
2025 much more useful than visiting a single message and is consistent with
2026 Gnus and the MH-E speedbar (closes SF #655891).
2028 If mh-visit-folder is called non-interactively and RANGE is nil then
2029 all messages are displayed. This behavior is now documented and
2030 provides backwards compatibility.
2032 *** Threading Improvements
2034 After incorporating new mail into a threaded folder, unseen messages
2035 can be spread about. Two new functions have been added to make it
2036 easier to find them: these are "M-n (mh-next-unread-msg)" and "M-p
2037 (mh-previous-unread-msg)" (closes SF #630328)
2039 Two new functions were added to delete and refile threads. They are "T
2040 d (mh-thread-delete)" and "T o (mh-thread-refile)" respectively
2041 (closes SF #630493).
2043 In addition, the key "k" used to be bound to the function
2044 `mh-delete-subject': it is now bound to
2045 `mh-show-delete-subject-or-thread'.
2047 New functions to navigate threads include "T u (mh-thread-ancestor)",
2048 which can jump to the root message of the current thread given an
2049 optional argument, "T n (mh-thread-next-sibling)", and "T p
2050 (mh-thread-previous-sibling)"
2052 *** Refiling of Messages in Region
2054 If mark is active and `transient-mark-mode' is enabled then all the
2055 messages in the region are refiled.
2057 *** vCard Handling
2059 If a signature cannot be identified, but there is a vCard attachment,
2060 then that vCard will be presented as a signature (closes SF #649216).
2062 *** New Info Added to mh-version
2064 Information about Gnus versions available at both compile time and run
2065 time has been added.
2067 ** New Variables in MH-E 7.1
2069 The defcustom groups were reorganized. Rather than iterate the
2070 specific changes here, you are invited to browse the groups with "M-x
2071 mh-customize RET".
2073 *** mh-alias-completion-ignore-case-flag
2075 Non-nil means don't consider case significant in MH alias completion.
2076 This is the default in plain MH, so it is the default here as well. It
2077 can be useful to set this to t if, for example, you use lowercase
2078 aliases for people and uppercase for mailing lists.
2080 *** mh-alias-expand-aliases-flag
2082 Non-nil means to expand aliases entered in the minibuffer. In other
2083 words, aliases entered in the minibuffer will be expanded to the full
2084 address in the message draft. By default, this expansion is not
2085 performed.
2087 *** mh-alias-flash-on-comma
2089 Specify whether to flash the translation of the alias or warn if there
2090 isn't a translation of the alias.
2092 *** mh-alias-insert-file
2094 Filename to use to store new MH-E aliases. This variable can also be a
2095 list of filenames, in which case MH-E will prompt for one of them. If
2096 nil, the default, then MH-E will use the first file found in the
2097 "AliasFile" component of the MH profile.
2099 *** mh-alias-insertion-location
2101 Specifies where new aliases are entered in alias files. Options are
2102 sorted alphabetically (the default), at the top of the file or at the
2103 bottom.
2105 *** mh-alias-local-users
2107 If t, local users are completed in MH-E To: and Cc: prompts.
2109 If you set this variable to a string, it will be executed to generate
2110 a password file. A value of "ypcat passwd" is helpful if NIS is in
2111 use.
2113 *** mh-alias-system-aliases
2115 A list of system files from which to cull aliases. If these files are
2116 modified, they are automatically reread. This list need include only
2117 system aliases and the passwd file, since personal alias files listed
2118 in your "AliasFile" MH profile component are automatically included.
2120 *** mh-identity-default
2122 Default identity to use when `mh-letter-mode' is called.
2124 *** mh-identity-list
2126 List holding MH-E identity.
2128 *** mh-invisible-header-fields
2130 Simple user interface to change `mh-invisible-headers'.
2132 *** mh-letter-complete-function
2134 Function to call when completing outside of fields specific to
2135 aliases. By default, it is bound to 'ispell-complete-word.
2137 *** mh-show-threads-flag
2139 Non-nil means new folders start in threaded mode. Threading large
2140 number of messages can be time consuming. So if the flag is non-nil
2141 then threading will be done only if the number of messages being
2142 threaded is less than `mh-large-folder' (closes SF #646794).
2144 *** mh-tool-bar-folder-buttons
2146 Buttons to include in MH-E folder/show toolbar.
2148 *** mh-tool-bar-letter-buttons
2150 Buttons to include in MH-E letter toolbar.
2152 ** Bug Fixes in MH-E 7.1
2154 *** mh-get-new-mail
2156 Call new function `mh-add-cur-notation' to undo the work of
2157 `mh-remove-cur-notation' if there was no new mail (closes SF #647681).
2159 *** mh-set-cmd-note
2161 No longer updates the default `mh-cmd-note' value. This resulted in
2162 the misplacement of the current mark when the message number width
2163 changed (closes SF #643701).
2167 * Changes in MH-E 7.0
2169 This is a major release which includes a lot of new features including
2170 improved MIME handling, speedbar folder browsing, and indexed
2171 searching. In this version, MH-E runs under XEmacs, passes checkdoc,
2172 and compiles clean under all supported platforms.
2174 The "passes checkdoc" feature above required changing the name of
2175 several user-visible variables. It is likely that this affects you.
2176 Please be sure to see the table at the end of these notes and rename
2177 your variables accordingly.
2179 MH-E has been written mh-e, Mh-e, MH-e and MH-E. We have decided that
2180 the proper term should be MH-E. Please try to use MH-E in your
2181 writing.
2183 ** New Features in MH-E 7.0
2185 *** Speedbar
2187 There is now support for the speedbar. Try "M-x speedbar" (closes SF
2188 #503727).
2190 Press the middle mouse button on the `+' icons to open a folder,
2191 middle mouse button on a folder name to open the folder. Folders with
2192 unseen messages are shown in bold, so this is a handy way to browse
2193 new messages that you have filed with procmail or slocal.
2195 See the new customization variable `mh-large-folder,' which controls
2196 when the speedbar asks for how many messages to scan when opening a
2197 large folder and `mh-speed-run-flists-flag' whose default value of t
2198 means to use the flists command to populate the count of unseen and
2199 total messages in each folder.
2201 *** Indexed Search
2203 Interoperability with swish++, swish, glimpse, and namazu has been
2204 added to enable lightening-fast searches of your mail. If none of
2205 these are present, grep is used. Try "F i (mh-index-search)".
2207 For more information, read the documentation for the functions
2208 `mh-swish++-execute-search,' `mh-swish-execute-search,'
2209 `mh-namazu-execute-search,' or `mh-glimpse-execute-search' depending
2210 on your preferred indexing program to see what kind of setup is needed
2211 to generate the index.
2213 *** Threading
2215 Use "T t (mh-toggle-threads)" to view the threads in the folder. Use
2216 it again to return to a non-threaded view.
2218 *** Brief Help
2220 Use "? (mh-help)" and "X ? (mh-prefix-help)," where X is a prefix
2221 character, for a brief synopsis in the minibuffer of frequently used
2222 commands. In the MH-Letter or MH-Pick buffers, use "C-c ? (mh-help)"
2223 (closes SF #493740).
2225 *** Folder Keymap Shared by Show Buffer
2227 You can now use the MH-Folder mode commands from the MH-Show buffer.
2228 Because of this, the MH-Show buffer is now read-only (closes SF
2229 #493749 and SF #527946) and you now have to use "M (mh-modify)" to
2230 edit a message.
2232 *** Better Scanning
2234 You no longer have to modify your scan format if your folders have
2235 more than 9999 messages in them. If you've only modified your scan
2236 format file to allow for the wider message numbers, consider using the
2237 default behavior of MH-E and simplify your MH-E configuration
2238 considerably (closes SF #635791).
2240 To do this, you may have to remove your modifications of
2241 `mh-scan.*-regexp' and `mh-cmd-note' and your customization of
2242 `mh-scan-format-file'.
2244 You may still want the updated format files for running MH commands
2245 outside of MH-E; the default of `mh-scan-format-file' will cause them
2246 to be ignored.
2248 If you prefer fixed-width message numbers, set the new customization
2249 variable to nil , set this variable to
2250 nil and call `mh-set-cmd-note' with the width specified by the scan format in
2251 `mh-scan-format-file'. For example, the default width is 4, so you would use
2252 "(mh-set-cmd-note 4)" if `mh-scan-format-file' were nil.
2254 *** X-Face
2256 MH-E now displays the content of the X-Face header field in the From
2257 field. When sending a message, an X-Face field is appended to the
2258 header if it doesn't already exist and "~/.face" is present. See the
2259 new customization variables `mh-show-use-xface-flag' and `mh-x-face-file'
2260 (closes SF #480770).
2262 MH-E depends on the external x-face package found in
2263 ftp://ftp.jpl.org/pub/elisp/ to do this. The `uncompface' binary is
2264 also required to be in the execute PATH. It can be obtained from:
2265 http://freshmeat.net/redir/compface/1439/url_tgz/compface-1.4.tar.gz.
2267 It has also been observed that if you don't see the faces, you might
2268 have to do this (for unknown reasons):
2270     mv /usr/local/include/compface.h /usr/include/
2272 *** Graphical Smileys
2274 Smiley's are now converted to cute little images. See the new
2275 customization variable `mh-graphical-smileys-flag.'
2277 *** Text Emphasis
2279 ASCII formatting is now converted to the appropriate font. For
2280 example, _underline_ is underlined, *bold* appears in bold, /italic/
2281 appears in italic, etc. See `gnus-emphasis-alist' for the whole list.
2282 See the new customization variables `mh-decode-mime' and
2283 `mh-graphical-emphasis-flag.'
2285 *** Attachment Handling
2287 Inline attachments are now displayed. Regular attachments appear as
2288 buttons in show buffer. Use "K TAB (mh-next-button)" or "K SHIFT-TAB
2289 (mh-prev-button)" to cycle through these buttons. Use "K v
2290 (mh-folder-toggle-mime-part)" to view, "K o
2291 (mh-folder-save-mime-part)" to save one part or "K-a
2292 (mh-save-mime-parts)" to save all parts, or "K i
2293 (mh-folder-inline-mime-part)" to view the attachment inline.
2295 See the new customization variable `mh-decode-mime' for additional
2296 information. Other customization variables that affect this new feature
2297 include `mh-store-mime-parts-default-directory' and
2298 `mh-display-buttons-for-inline-parts-flag'.
2300 HTML documents can be viewed inline if Gnus v5.10 and w3 or w3m lisp
2301 packages are present. Set the customization variable
2302 `mm-text-html-renderer' accordingly (closes SF #453352).
2304 *** Quoted-printable Handling
2306 Quoted-printable body parts are now decoded.
2308 *** More Choices for `mh-yank-from-start-of-msg'
2310 Historically, if this variable was t, the entire message, with full
2311 headers would be included and every line would begin with
2312 `mh-ins-buf-prefix.' This usage is deprecated in favor of the setting
2313 `supercite' below. The default has been changed to `attribution.' The
2314 following symbols are now understood:
2316 `body': yank the message minus the header.
2318 `supercite': include the entire message, with full headers. This also
2319 causes the invocation of `sc-cite-original' without the setting of
2320 `mail-citation-hook', now deprecated practice.
2322 `autosupercite': do as for `supercite' automatically when show buffer
2323 matches the message being replied-to.
2325 `attribution': yank the message minus the header and add a simple
2326 attribution line at the top.
2328 `autoattrib': do as for `attribution' automatically when show buffer
2329 matches the message being replied-to.
2331 There is a new customization variable called
2332 `mh-extract-from-attribution-verb' which is used for attribution which
2333 provides a method for setting a different language.
2335 *** Use Gnus mml Instead of mhn
2337 When inserting attachments into a message draft, Gnus mml directives
2338 are now used instead of mhn directives. One beneficial side-effect of
2339 this is that attachments can now appear inline as well as separate.
2341 The new customization variable `mh-compose-insertion' controls whether
2342 Gnus or mhn is used to insert MIME message directives in messages
2343 (default: 'gnus, if the mml library exists).
2345 *** Content-Type Now Obtained Automatically
2347 The value of the Content-Type no longer needs to be entered by the
2348 user.
2350 *** Attachments Automatically Included Upon Send
2352 You no longer have to run "C-c C-e (mh-edit-mhn)" before sending a
2353 message with attachments--this is done automatically when you send the
2354 message with "C-c C-c (mh-send-letter)". There is, however, a new key
2355 binding "C-c C-m m (mh-mml-to-mime)" which is analogous to "C-c C-e
2356 (mh-edit-mhn)".
2358 *** GPG Handling
2360 Messages that have been signed or encrypted with GPG are verified and
2361 decrypted automatically. To sign or encrypt a message, use "C-c RET
2362 C-s (mh-mml-secure-message-sign-pgpmime)" and "C-c C-m C-e
2363 (mh-mml-secure-message-encrypt-pgpmime)." You need Gnus version 5.10
2364 for this feature. These functions are provided by the pgg.el package.
2366 Users report "flashing" with the pgg.el package and prefer the gpg.el
2367 package instead. To use gpg.el instead of the pgg.el package you need:
2369   (setq mml2015-use 'gpg)
2371 To mimic automatic encryption in gpg.el, use:
2373   (setq mm-verify-option 'always)
2374   (setq mm-decrypt-option 'always)
2376 The venerable mailcrypt package is also an option. However, now that
2377 show buffers are read-only, mailcrypt version 3.5.6 and older fail
2378 when they attempt to decrypt the contents.
2380 *** Mail-Followup-To Header Field
2382 Support for this controversial field has been added because nmh
2383 supports it (closes SF #627035). If you want to add it to outgoing
2384 mail for selected mailing lists, add those mailing lists to the new
2385 customization variable `mh-insert-mail-followup-to-list.' If you think
2386 this field is evil, set the new customization variable
2387 `mh-insert-mail-followup-to-flag' to nil.
2389 *** Gnus Issues
2391 If you update Gnus, you must recompile MH-E. Note that if you are
2392 running the stock version of MH-E that comes with Emacs or the MH-E
2393 package on a Debian GNU/Linux, this is done for you.
2395 ** New Variables in MH-E 7.0
2397 New customization variables not mentioned earlier include:
2399 *** mh-letter-insert-signature-hook
2401 Invoked at the beginning of the "C-c C-s (mh-insert-signature)"
2402 command. Can be used to determine which signature file to use based on
2403 message content. On return, if `mh-signature-file-name' is non-nil
2404 that file will be inserted at the current point in the buffer.
2406 *** mh-show-maximum-size
2408 Maximum size of message (in bytes) to display automatically. Provides
2409 an opportunity to skip over large messages which may be slow to load.
2410 Use a value of 0 to display all messages automatically regardless of
2411 size (closes SF #488696).
2413 *** mh-tool-bar-reply-3-buttons-flag
2415 Non-nil means use three buttons for reply commands in tool-bar. If you
2416 have room on your tool-bar because you are using a large font, you may
2417 set this variable to expand the single reply button into three buttons
2418 that won't lead to minibuffer prompt about who to reply to.
2420 ** Bug Fixes in MH-E 7.0
2422 *** mh-delete-msg, mh-refile-msg, mh-undo
2424 Mandrake Linux includes XEmacs initialization code that binds
2425 `transient-mark-mode' which causes problems in MH-E. These problems
2426 have been fixed (closes SF #541915).
2428 *** mh-edit-again
2430 This would sometimes yield a read-only buffer. This has been fixed
2431 (closes SF #624283 and SF #625538).
2433 *** mh-forward
2435 When using nmh, always specify -mime so as to preserve the original
2436 message(s).
2438 *** mh-inc-folder
2440 If you had narrowed to a sequence and then incorporated new mail,
2441 those new messages would not be present in your +inbox when you
2442 widened. This has been fixed (closes SF #489430, SF #489437, SF
2443 #629233).
2445 *** mh-insert-letter
2447 No longer uses mhl to include a message as this mangled the header and
2448 gave supercite fits (closes SF #629153).
2450 *** mh-letter-mode
2452 "M-q (fill-paragraph)" now fills quoted paragraphs (for example,
2453 starting with "> ") correctly (closes SF #489927).
2455 *** mh-next-undeleted-msg, mh-previous-undeleted-msg
2457 If there are no more undeleted messages the point remains at its
2458 original position and a message is produced (closes SF #494304).
2460 *** mh-pick-mode
2462 Now calls `mh-pick-mode-hook' as documented.
2464 *** mh-put-msg-in-seq
2466 Now puts all messages in region in sequence (closes SF #630324).
2468 *** mh-refile-msg, mh-write-msg-to-file
2470 These functions stomped on the variables that held the name of the
2471 last file and folder respectively for the other function. This has
2472 been fixed so that the last folder or file name is preserved (closes
2473 SF #580772).
2475 *** mh-region-to-sequence
2477 If the region in MH-Folder was set with "C-x h (mark-whole-buffer)",
2478 you couldn't perform operations on all of the messages as you would
2479 expect. This has been fixed (closes SF #621632).
2481 *** mh-reply
2483 Performing an undo the first thing after replying would blank out the
2484 entire draft. Now just the insertion of the yanked message is undone
2485 leaving the header and signature intact for additional editing (closes
2486 SF #623693).
2488 *** mh-show-mode
2490 Now calls `mh-show-mode-hook' as documented (closes SF #627222).
2492 *** mh-subject-thread-to-sequence
2494 Make 'subject sequence a real one, exported to MH. This means you can,
2495 for example, mh-forward it. But it also shows up with a mark in the
2496 scan output (closes SF #489445).
2498 *** Other Bug Fixes
2500 The following bugs have also been closed:
2502 SF #495450: Folder buffer read-only after inc
2503 SF #489706: mh-page-msg bombs out
2504 SF #580772: mh-last-destination is overloaded
2506 *** Variables renamed to conform with Emacs coding conventions
2508 The coding conventions require that boolean variables end in -flag.
2509 The following two tables show which variables were affected (closes SF
2510 #627015).
2512 Customization Variables (defcustom)
2514 Old Name                               New Name
2516 mh-auto-folder-collect                 mh-auto-folder-collect-flag
2517 mh-bury-show-buffer                    mh-bury-show-buffer-flag
2518 mh-clean-message-header                mh-clean-message-header-flag
2519 mh-decode-quoted-printable             mh-decode-quoted-printable-flag
2520 mh-delete-yanked-msg-window            mh-delete-yanked-msg-window-flag
2521 mh-do-not-confirm                      mh-do-not-confirm-flag
2522 mh-highlight-citation-p                mh-highlight-citation
2523 mh-insert-x-mailer-p                   mh-insert-x-mailer-flag
2524 mh-print-background                    mh-print-background-flag
2525 mh-recenter-summary-p                  mh-recenter-summary-flag
2526 mh-recursive-folders                   mh-recursive-folders-flag
2527 mh-reply-show-message-p                mh-reply-show-message-flag
2528 mh-show-use-goto-addr                  mh-show-use-goto-addr-flag
2529 mh-update-sequences-after-mh-show      mh-update-sequences-after-mh-show-flag
2531 Regular Variables (defvar)
2533 Old Name                               New Name
2535 mh-mhn-compose-insert-p                mh-mhn-compose-insert-flag
2536 mh-nmh-p                               mh-nmh-flag
2537 mh-page-to-next-msg-p                  mh-page-to-next-msg-flag
2541 * Changes in mh-e 6.1
2543 This is a minor release which includes a few bug fixes. The
2544 distribution now includes the ChangeLog.
2546 ** New Features in mh-e 6.1
2548 *** Fontification
2550 Unseen messages now displayed in bold.
2552 *** Viewing folders and sequences
2554 The folder and sequence listings that "F l (mh-list-folders)" and "S l
2555 (mh-list-sequences)" create are now displayed in view mode.
2557 ** Bug Fixes in mh-e 6.1
2559 *** mh-folder-unseen-seq-name
2561 Byte compilation failed when initializing this variable when the
2562 user's MH environment was not set up. This has been fixed (closes
2563 Debian #140232 and Debian #140817).
2565 *** mh-forward
2567 When forwarding a sequence, the mode of the draft would not be set to
2568 MH-Letter correctly. This has been fixed (closes SF #489448).
2570 *** mh-insert-prefix-string
2572 Fixed to work under XEmacs. Thanks to Will Partain
2573 <partain at dcs.gla.ac.uk>.
2575 *** mh-quit
2577 mh-quit now cleans up the buffers named `mh-temp-buffer,'
2578 'mh-temp-folders-buffer' and 'mh-temp-sequences-buffer.'
2581 * Changes in mh-e 6.0
2583 mh-e is now maintained at SourceForge (see
2584 http://mh-e.sourceforge.net/). This is where you need to go to obtain
2585 new versions of mh-e, report bugs and receive support.
2587 The maintainers have moved much of their personal configurations into
2588 the codebase, so you may find that you may be able to reduce your mh-e
2589 customizations as well.
2591 There are several incompatibilities in this version from older
2592 versions. Please read the following notes carefully for details. Pay
2593 particular attention to the key binding changes in the MH-Folder
2594 section. If you have customized your scan format, you will want to
2595 read about the new variable `mh-scan-format-file'.
2597 The manual could not be updated in time for this release. It will be
2598 updated in the near future. If the Preface in your manual indicates
2599 the older version (version 1.3, for mh-e version 5.0.2), please check
2600 the following page occasionally for an update:
2602   https://sourceforge.net/project/showfiles.php?group_id=13357
2605 ** New Features in mh-e 6.0
2607 *** Customization
2609 mh-e now uses the customize feature of Emacs. Use "M-x customize-group
2610 mh RET" to customize mh-e.
2612 *** Menus
2614 All mh-e modes now provide menus that contain most mh-e functions.
2616 *** Toolbars
2618 All mh-e modes now have toolbar buttons for oft-used functions (Emacs 21).
2620 *** Fontification
2622 All mh-e buffers now have font-lock keywords. To use, either call
2623 (turn-on-font-lock) from the appropriate hook, or set
2624 `global-font-lock-mode' to t. To customize, use "M-x
2625 customize-apropos-faces ^mh RET".
2627 If you have customized your scan lines, you will have to update your
2628 scan regexps. The existing regexps were changed to extract a match so
2629 you will have to add appropriate grouping constructs to take advantage
2630 of the fontification. Your old settings will continue to work, but the
2631 folder will not be fontified. For example:
2633   (setq mh-good-msg-regexp  "^\\(.....\\)[^D^]")
2635 You will most likely have to update the new variable
2636 `mh-scan-subject-regexp' as well. There is another new variable
2637 `mh-scan-date-regexp' which you may also find useful. Run "M-x apropos
2638 mh.*regexp" for a complete list.
2640 *** mail-user-agent support
2642 You can now set `mail-user-agent' to `mh-e-user-agent' so that packages
2643 that need to send mail will use mh-e (closes SF #406883, SF #470024).
2645 *** replgroupcomps support
2647 If you reply to `cc' or `all' and you use nmh, the nmh repl option
2648 -group will be used. This means that the file `replgroupcomps' will be
2649 used. If you have customized `replcomps', you will definitely want to
2650 either copy `$NMH_LIB/replgroupcomps' to your mail directory and modify
2651 it the same way that you modified your `replcomps' file, or simply
2652 copy your `replcomps' file to `replgroupcomps'.
2654 *** MH-Folder mode
2656 The variable `mh-summary-height' used to have a default of 4. It now
2657 varies from 4 to 10 depending on the height of the frame.
2659 Clicking the mouse on a message shows that message.
2661 Delete, refile and undo now operate on a region (but only if
2662 `transient-mark-mode' is non-nil).
2664 SPC (mh-page-msg) now displays the message if it is not already
2665 visible. If the bottom of a message is showing, SPC (mh-page-msg)
2666 moves to the next message (respecting the direction you are moving
2667 through the folder).
2669 The threading commands "T u (mh-next-unseen-subject-thread)",
2670 "T t (mh-toggle-subject-thread)", "T s (mh-narrow-to-subject-thread)",
2671 and "T k (mh-delete-subject-thread)" have been added. These functions
2672 do not offer threading in the true sense of the word, but do allow
2673 some manipulation by subject.
2675 Major, major keymap changes. This was done to free up movement
2676 commands in the buffer, and to provide for additional features, such
2677 as the threading commands. At the same time, better and more
2678 consistent mnemonics were realized that should make it easier to
2679 remember key bindings.
2681 Added new sub-keymaps for folder commands, sequence commands,
2682 extraction commands, and digest commands which begin with F, S,
2683 X, and D, respectively. These sub-keymaps allowed some consistency
2684 (e.g., especially with l(ist) and k(ill)).
2686 Here are the actual changes and rationale:
2688 Old     New     Rationale
2690 e       -       Deleted. Already have x. Now used by mh-edit-again.
2691 j       -       Deleted. Already have g.
2693 M-a     e       Better mnemonic. Matches rmail. Frees movement command.
2694 M-e     E       Better mnemonic. Consistent with e.
2695 -       S       Why not? mh-sort-folder.
2697 M-f     Fv      Frees movement command
2698 M-f     Ff      Alias (keep?)
2699 M-f     Fo      Alias (keep?)
2700 M-k     Fk      No reason but to keep with folder commands
2701 M-l     Fl      No reason but to keep with folder commands
2702 M-p     Fp      No reason but to keep with folder commands
2703 M-r     Fr      Frees movement command
2704 M-s     Fs      No reason but to keep with folder commands
2705 M-u     Fu      No reason but to keep with folder commands
2707 M-%     Sd      Better mnemonic
2708 M-#     Sk      Better mnemonic
2709 M-q     Sl      Better mnemonic
2710 C-xn    Sn      Frees up standard key binding
2711 %       Sp      Better mnemonic for putting a message in a sequence
2712 ?       Ss      Shows sequences that message is in
2713 C-xw    Sw      Frees up standard key binding
2715 M-n     Xs      Better mnemonic (extract shar)
2716 M-n     Xu      Better mnemonic (extract uuencode)
2718 M-SPC   D SPC   Frees mark command
2719 M-\177  D \177  No reason but to keep with digest commands
2720 M-b     Db      Frees movement command
2722 As the number of variables increases, it is becoming important to
2723 organize the mh-e namespace. Several variables having to do with the
2724 format of scan lines were renamed, as follows:
2726 Old                             New
2728 mh-good-msg-regexp              mh-scan-good-msg-regexp
2729 mh-deleted-msg-regexp           mh-scan-deleted-msg-regexp
2730 mh-refiled-msg-regexp           mh-scan-refiled-msg-regexp
2731 mh-valid-scan-line              mh-scan-valid-regexp
2732 mh-cur-scan-msg-regexp          mh-scan-cur-msg-number-regexp
2733 -                               mh-scan-cur-msg-regexp
2734 -                               mh-scan-rcpt-regexp
2735 -                               mh-scan-format-regexp
2736 mh-msg-number-regexp            mh-scan-msg-number-regexp
2737 mh-msg-search-regexp            mh-scan-msg-search-regexp
2739 *** MH-Show mode
2741 While the MIME support is not complete, quoted-printable body parts
2742 are now decoded.
2744 Some MTAs quote From at the beginning of the line with a ">". The ">"
2745 is now removed in the display, but not on disk.
2747 *** MH-Letter mode
2749 New function "C-c C-o (mh-split-line)" splits lines in a draft
2750 preserving the fill prefix and indentation. This is useful when
2751 responding to several sentences in a single paragraph separately.
2753 "M-q (fill-paragraph)" can now be used on the message that is being
2754 replied to. The fill prefix such as "> " is preserved.
2756 You no longer have to run "C-c C-e (mh-edit-mhn)" manually as this is
2757 now done automatically when the message is sent.
2759 The X-Mailer header field is now added to messages as they are sent.
2761 "C-c C-m C-i (mh-mhn-compose-insertion)" now makes a pretty good guess
2762 at the type of file using the `file' command and no longer asks the
2763 user for the media type. If the necessary version of `file' is not
2764 available, the user is asked for the media type as before; however,
2765 the list of media types is now taken from the system mailcap if
2766 available. Failing that, the built-in list of types has been
2767 supplemented so in most cases the type you need should be present
2768 (closes SF #406883, #441179).
2770 ** New Variables in mh-e 6.0
2772 New variables not mentioned earlier include:
2774 *** mh-insert-x-mailer-p
2776 Default value of t means that an X-Mailer header field should be
2777 added.
2779 *** mh-reply-show-message-p
2781 The setting of this variable determines whether the MH show-buffer is
2782 displayed with the current message when using mh-reply without a prefix
2783 argument. Set it to nil if you already include the message
2784 automatically in your draft using "repl: -filter repl.filter" in
2785 "~/.mh_profile."
2787 *** mh-scan-format-file
2789 Specifies the format file to pass to the scan program. If t, the
2790 format string will be taken from the either `mh-scan-format-mh' or
2791 `mh-scan-format-nmh' depending on whether MH or nmh is in use. If nil,
2792 the default scan output will be used.
2794 If you customize the scan format, you may need to modify a few
2795 variables containing regexps that mh-e uses to identify specific
2796 portions of the output. Use `M-x apropos RET mh-scan.*regexp' to
2797 obtain a list of these variables.
2799 *** mh-scan-format-mh
2801 Scan format string for MH, provided to the scan program via the
2802 -format arg. This format is identical to the default except that
2803 additional hints for fontification have been added to the sixth
2804 column.
2806 *** mh-scan-format-nmh
2808 Scan format string for nmh, provided to the scan program via the
2809 -format arg. This format is identical to the default except that
2810 additional hints for fontification have been added to the sixth
2811 column.
2813 *** mh-show-use-goto-addr
2815 Non-nil means URLs and e-mail addresses are highlighted using
2816 goto-addr in MH-Show buffer.
2818 *** mh-letter-fill-column
2820 Fill column to use in `mh-letter-mode'. This is useful to make the
2821 lines a bit shorter to allow for quoting in replies.
2823 *** mh-folder-updated-hook
2825 Invoked when the actions in a folder (such as moves and deletes) are
2826 performed. Variables that are useful in this hook include
2827 `mh-delete-list' and `mh-refile-list' which can be used to see which
2828 changes are being made to current folder, `mh-current-folder'.
2830 *** mh-unseen-updated-hook
2832 Invoked after the unseen sequence has been updated. The variable
2833 `mh-seen-list' can be used to obtain the list of messages which will
2834 be removed from the unseen sequence
2836 ** Bug Fixes in mh-e 6.0
2838 *** mh-edit-again and mh-extract-rejected-mail
2840 Now insert a header separator (--------) which packages such as
2841 mailcrypt expect.
2843 *** mh-find-progs
2845 Now uses `mhparam' to set `mh-lib-progs' and `mh-lib'. Added more
2846 directories to `mh-progs' so that mh-e can autoconfigure in more
2847 environments. Chances are that you no longer have to set these
2848 variables, and if you do, you will only have to set `mh-progs'.
2849 Unless, of course, you are using an ancient version of MH that doesn't
2850 have `mhparam'.
2852 *** mh-folder-mode-map
2854 The DEL/<delete>/<backspace> change in Emacs 21 broke
2855 `mh-previous-page'. This has been fixed (closes SF #228907).
2857 *** mh-forward
2859 If you had "forw: -mime" to your .mh_profile, forwarding a message
2860 resulted in:
2862   Search failed: "^------- Forwarded Message"
2864 In addition, the Subject field was not filled in. This has been fixed
2865 (closes SF #223603).
2867 *** mh-kill-folder
2869 The user is now always prompted before this action; the variable
2870 `mh-do-not-confirm' is no longer consulted here. Therefore users who
2871 wanted to set `mh-do-not-confirm' but didn't because of the
2872 `mh-kill-folder' dependency may now do so.
2874 *** mh-make-folder-mode-line
2876 Properly deals with folders that do not have any lines in them. Prints
2877 "no msgs" instead of "0 msgs". Does not try to print a range when
2878 there are no messages.
2880 *** mh-mhn-compose-insertion
2882 Now gets the MIME type automatically (assuming the local file command
2883 supports the -i and -b options). If this use of the file command is
2884 not supported, the list of MIME types has been expanded to use the
2885 system's mailcap file.
2887 *** mh-nmh-p
2889 This variable (t when nmh is in use rather than MH) assumed that the
2890 string "nmh" is in `mh-lib-progs' or `mh-lib'. This has been fixed
2891 (closes SF #441776).
2893 *** mh-refile-msg
2895 No longer lets you specify an empty folder (closes SF #476824).
2897 *** mh-regenerate-headers
2899 Now suppresses "scan: bad message list" messages.
2901 *** mh-print-msg
2903 This function was looking for `mhl' in the wrong place on nmh on
2904 Redhat LINUX 7.0. This has been fixed (closes SF #481128).
2906 *** mh-show
2908 Now updates `cur' sequence after a message is shown (closes SF #481772).
2910 *** mh-showing
2912 Renamed variable and function to `mh-showing-mode' to conform with
2913 minor mode conventions. Added optional arg to function so it would
2914 behave like a normal minor mode: no or nil arg toggles mode, 0 arg
2915 turns off, non-nil turns on. This fixed the error that occurred when
2916 `desktop-create-buffer' recreated mh-e buffers because it was calling
2917 `mh-showing' with an arg.
2919 *** mh-version
2921 Fixed for nmh. Now displays mh-e version correctly. Cleaned up output
2922 and display `mh-progs', etc.
2924 *** mh-widen
2926 Now attempts to stay on the same message number (closes SF #480922).
2928 No longer wipes out pending deletes and refiles without warning
2929 (closes SF #481036).
2932 * Changes in mh-e 5.0.2
2934 This version contains additional minor changes to integrate it with
2935 reporter.el (requires reporter.el version 3.1c or later) and Emacs
2936 19.30.  The mh-goto-msg function is much faster, which also speeds up
2937 several other operations.
2940 * Changes in mh-e 5.0.1
2942 This version contains minor changes from mh-e 5.0 to integrate it with
2943 Emacs 19.29.
2946 * User-visible changes to mh-e 5.0
2948 Note: This being a major release, there are many internal changes.
2949 This document lists only changes to the external interfaces of mh-e.
2951 When upgrading, you must either explicitly reload the new versions of
2952 all mh-e files that are already loaded or restart your Emacs.
2955 ** Major Changes and New Features in mh-e 5.0
2957 The emphasis for this release has been on consistency and
2958 documentation. Many documentation strings were enhanced. Documentation
2959 strings were changed to comments for internal functions and variables.
2961 *** There is now proper documentation in the form of a 75-page users
2962 manual. The Texinfo source is mh-e.texi; the formatted Info document
2963 is mh-e.info.
2965 *** There is a new command `mh-update-sequences', which updates MH's
2966 idea of what messages are in the Unseen sequence and what is the
2967 current folder and message. `mh-quit' calls it. While
2968 `mh-execute-commands' has always done this updating as a side effect,
2969 the new function is faster.
2971 *** The MH profile entry "Inbox:" is supported.
2973 *** If the show-buffer is modified, the user is queried before mh-e
2974 reuses the buffer to show a different message. This buffer is also
2975 auto-saved and backed up correctly.
2977 *** `mh-store-buffer' is significantly more robust. It now handles
2978 messages created by a wide variety of packaging software. The status
2979 message for `uudecode' includes the name of the file created. An error
2980 is signaled if the subprocess exits with a non-zero status.
2982 *** `mh-search-folder' behaves predictably, adding messages found to
2983 the `search' sequence. It correctly handles the case of no messages
2984 found.
2986 *** `mh-burst-digest' (`M-b') now only rescans the part of the folder
2987 affected by the burst. It is now much faster in a large folder.
2990 ** New Hooks and Customization Variables in mh-e 5.0
2992 *** `mh-default-folder-for-message-function': new name for the old
2993 `mh-msg-folder-hook', which wasn't a hook. The old name was confusing,
2994 leading people to think they could use `add-hook' with it, when
2995 actually `setq' is the correct way.
2997 *** `mh-sortm-args': When this variable is used has changed. Now
2998 `mh-sortm-args' is passed if there IS a prefix argument to
2999 `mh-sort-folder'. The assumption is that for arguments you normally
3000 want, you would specify them in an MH profile entry.
3002 *** `mh-mhn-args': new hook, a list of additional arguments to pass to
3003 the `mhn' program if `mh-edit-mhn' is given a prefix argument.
3005 *** `mh-edit-mhn-hook': new hook called by `mh-edit-mhn', the function
3006 that formats MIME messages.
3008 *** `mh-folder-list-change-hook': new hook, called whenever the cached
3009 list of folders, `mh-folder-list', is changed.
3011 *** `mh-find-path-hook': new hook, called when entering mh-e.
3013 *** `mh-repl-formfile': new variable, used to change the format file
3014 used by `mh-reply' from the default of "replcomps".
3016 *** New variables to customize the scan format and notating:
3017 `mh-note-deleted', `mh-note-refiled', `mh-note-seq', `mh-note-cur',
3018 `mh-note-copied', `mh-note-printed'.
3021 ** Key Binding Changes in mh-e 5.0
3023 *** `RET' runs `mh-show' for consistency with the Finder and Info. The
3024 old binding `.' still works, but `RET' is now the standard binding.
3026 *** `M-<' now runs `mh-first-msg' for consistency with `M->', which
3027 runs `mh-last-msg'.
3029 *** `C-c C-f C-d' in MH-Letter mode moves to a Dcc: header field.
3031 *** `C-c C-f C-r' in MH-Letter mode moves to a From: header field.
3033 *** `g' is now the standard binding for `mh-goto-msg'. The old binding
3034 `j' still works.
3037 ** Other Improvements and Changes to mh-e 5.0
3039 *** `mh-lpr-command-format' no longer passes the "-p" argument to
3040 `lpr' by default. The mail header typically has the date anyway.
3042 *** When prompting for a sequence name, if no sequences have been used
3043 yet, mh-e will offer the first sequence the current message is in.
3045 *** The patterns of more mailers are recognized by
3046 `mh-extract-rejected-mail'.
3048 *** `mh-insert-prefix-string' no longer wraps the call to the
3049 `mail-citation-hook' function in a `save-excursion' so the hook writer
3050 can choose whether to leave point at the beginning or the end of the
3051 yanked text.
3053 *** `mh-write-msg-to-file': The prompt now refers to "message" or
3054 "message body" depending on which will be written. (This is controlled
3055 by a prefix argument.) The file defaults to the last-used file instead
3056 of supplying only the directory name.
3058 *** mh-e uses message ranges when running MH commands. Thus "rmm 1 2 3
3059 4 6" is now "rmm 1-4 6". This change makes it less likely to overflow
3060 system argument list limits, and it might be faster, too.
3063 ** Bug Fixes to mh-e 5.0
3065 *** mh-e's idea of the unseen sequence now stays in sync with MH's
3066 better.
3068 *** Functions that are supposed to find fields in the message header
3069 no longer look in the message body.
3071 *** mh-e would sometimes fail to remove the "%" from a scan line when
3072 the message was removed from a sequence if the message was also in the
3073 Previous sequence.
3075 *** The variable `mh-inc-prog' is now correctly used in all places.
3077 *** `mh-pipe-msg' runs the process in the correct directory.
3079 *** A partially scanned folder will no longer lose the "/select"
3080 annotation when you execute marked deletes and refiles with `x'.
3083 * Changes to mh-e 4.0
3085 This file is automatically generated from news-mh-e.txinfo.  Do not edit.
3087 [MH-E-ONEWS has been incorporated here and removed. news-mh-e.txinfo
3088 is no longer available.]
3090 Note: there are many internal changes to mh-e in this release.  If you
3091 have the previous version loaded into your Emacs, you will probably not
3092 be able to load this version on top of it.
3094 ** New Features in mh-e 4.0
3096 *** Background folder collection. The first time you are prompted for
3097 a folder, you must wait while mh-e collects the names of all existing
3098 folders. Now however, if you abort, collecting will continue in the
3099 background, and you can do something else in Emacs until the
3100 collection completes. Normally, mh-e will begin collecting folders
3101 names in the background when you first load it; you can disable this
3102 feature by setting `mh-auto-folder-collect' to nil.
3104 *** There is support for composing MIME messages using the `mhn'
3105 program from MH 6.8. See the documentation string for mh-edit-mhn.
3106 (While composing a letter, type `C-h k C-c C-e'.) See also mhn(1).
3107 There is as yet no support for reading MIME messages.
3109 *** `mh-show', typically on `.', repositions to the start of the
3110 message if the message is already visible. It used to do nothing in
3111 this case.
3113 *** The function `mh-unshar-msg' is renamed `mh-store-msg'. It now
3114 does uudecoding, too. Someday it should do MIME. It remembers the last
3115 directory you used and offers it as the default for next time.
3117 *** New function `mh-header-display', on `,', displays the message
3118 with all headers, including those normally not displayed. Type `.' to
3119 display the message normally again.
3121 *** New function `mh-list-sequences' lists the sequences in use in the
3122 current folder.
3124 *** New function `mh-version' displays version information about MH
3125 and mh-e. Please use the output in bug reports.
3127 *** `mh-quit' now burys the folder buffer and show buffer.
3130 ** New hooks and customization variables in mh-e 4.0
3132 *** `mh-pick-mode-hook': new hook called by new mode `mh-pick-mode'.
3133 The pick buffer didn't used to have its own mode. Another advantage of
3134 `mh-pick-mode' is that `C-h m' works in the pick buffer.
3136 *** `mail-citation-hook': new variable for supercite.
3138 *** `mh-refile-msg-hook': new hook called by `mh-refile-msg' (and
3139 `mh-refile-or-write-again' when refiling).
3141 *** `mh-msg-folder-hook': new hook used by `mh-refile-msg' and
3142 `mh-to-fcc' to provide a default folder for user prompt.
3144 *** `mh-show-hook': new hook called by `mh-show'.
3146 *** `mh-delete-msg-hook': new hook called by `mh-delete-msg'.
3148 *** `mh-show-mode-hook': new hook called by new mode `mh-show-mode'
3149 for `show-' buffers.
3151 *** `mh-comp-formfile': new variable so can customize `components'
3152 file.
3154 *** `mh-sortm-args': new variable, a list of extra arguments to be
3155 passed to sortm by `mh-sort-folder'. Give an argument to
3156 `mh-sort-folder' to suppress this behavior.
3158 *** `mh-send-prog': new variable so can customize name of `send'
3159 program in case of name conflicts.
3161 *** `mh-scan-prog': new variable so can customize name of `scan'
3162 program to generate custom effects.
3164 *** `mh-inc-prog': new variable so can customize name of `inc' program
3165 to do fancy management of incoming messages.
3167 *** `mh-forwarded-letter-subject': new function used by `mh-forward'
3168 to compute the Subject line of the new message. It is a small function
3169 which can be replaced by the user for customization. Uses the new
3170 variable `mh-forward-subject-format', which allows some simple
3171 customizations without rewriting even `mh-forwarded-letter-subject'.
3173 *** `mh-new-draft-cleaned-headers': new variable, header lines removed
3174 by `mh-edit-again' and `mh-extract-rejected-mail' before offering a
3175 message as a new draft.
3177 *** `mh-signature-file-name': new variable used by
3178 `mh-insert-signature' to so can customize name of the file to insert.
3180 *** `mh-read-address': new function called to read all To: and Cc:
3181 addresses.
3183 *** `mh-msg-folder-hook': new hook used by `mh-refile-msg' and
3184 `mh-to-fcc' to provide a default folder for user prompt.
3187 ** Key binding changes in mh-e 4.0
3189 *** `,' runs new function `mh-header-display'. It is like `.' but it
3190 displays *all* the headers.
3192 *** `M-#' runs the new function `mh-delete-seq'. One used to have to
3193 type `C-u M-%' to delete a sequence.
3195 *** `<' no longer does `mh-first-msg', but `M->' now does
3196 `mh-last-msg'. This allows first and last to be consistent (`>' was
3197 taken) and is more likely to be discovered by chance anyway.
3199 *** `M-d' runs `mh-redistribute', `r' runs `mh-reply' (on the theory
3200 that the more commonly used function should be easier to type, and the
3201 obscure action of redistributing can be harder to type).
3203 *** `M-o' changed to `C-o' (`mh-write-msg-to-file'). It was
3204 interfering with arrow keys for some people.
3206 *** `M-n' now runs `mh-store-msg' (formerly `mh-unshar-msg').
3208 *** `b' no longer runs `mh-quit'; use `q' instead. `b' may be used in
3209 a future version for something else.
3212 ** Minor improvements to mh-e 4.0
3214 *** The mh-e code is now divided into multiple Emacs Lisp files, so it
3215 starts up faster because Emacs doesn't have to load all of it at once.
3216 (This change also makes it easier for the maintainer to manage
3217 things.)
3219 *** When searching for the directory containing the MH programs,
3220 search the user's PATH in addition to the built-in directories, to
3221 increase the chance of finding the MH programs.
3223 *** The subject for a forwarded message no longer has ugly square
3224 brackets around it.
3226 *** The name of the folder is no longer appears twice in the show
3227 buffer mode line.
3229 *** When typing a folder name in the minibuffer, parent folders
3230 complete to the trailing slash (/), for easier typing of subfolders.
3232 *** The folder buffer mode name changed from `mh-e scan' or `mh-e
3233 show' to `MH-Folder', which makes the hook name easier to guess. Added
3234 `mh-showing' to `minor-mode-alist' so there is still an indication in
3235 the mode line of whether messages will be shown automatically.
3237 *** `mh-rename-seq' does completion on the old sequence name.
3239 *** If called by a user who has never used MH on this system before,
3240 mh-e runs the MH program `install-mh' to get them set up.
3242 *** Undo history for previous messages is not kept to avoid wasting
3243 memory.
3245 *** The internal temp buffer used by mh-e has `buffer-offer-save'
3246 explicitly nil. This change benefits people who change the
3247 `buffer-offer-save' default.
3250 ** Bug fixes to mh-e 4.0
3252 *** `mh-to-field': don't bomb if no To: field.
3254 *** `mh-get-new-mail': restore annotations, e.g., cur, even if no new
3255 mail.
3257 *** `mh-rename-seq': verify that the new seq name was accepted by
3258 `mark' before updating state.
3260 *** `mh-internal-seq': the Previous sequence is not notated, since it
3261 would notate everything scanned.
3263 *** `mh-read-draft': don't call `find-file-noselect' so an
3264 `auto-mode-alist' doesn't trigger `mh-letter-mode-hook' twice. Faster,
3265 too.
3267 *** `mh-show': If user moves onto a message that doesn't exist, don't
3268 leave the cursor in the show pane.
3270 *** `mh-delete-scan-msgs': use `equal', not `=', on the result of
3271 `mh-get-msg-num', since it may be nil.
3273 *** `mh-get-field': do anchored search so searching for `reply-to:'
3274 doesn't find `in-reply-to:'.
3276 *** `mh-widen': do nothing if not narrowed.
3278 *** `mh-clean-message-header': find end of headers even if no body.
3281 This file is part of GNU Emacs.
3283 GNU Emacs is free software: you can redistribute it and/or modify
3284 it under the terms of the GNU General Public License as published by
3285 the Free Software Foundation, either version 3 of the License, or
3286 (at your option) any later version.
3288 GNU Emacs is distributed in the hope that it will be useful,
3289 but WITHOUT ANY WARRANTY; without even the implied warranty of
3290 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
3291 GNU General Public License for more details.
3293 You should have received a copy of the GNU General Public License
3294 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
3297 Local variables:
3298 mode: outline
3299 paragraph-separate: "[  \f]*$"
3300 end: