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