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