Work around nondeterministic binding of terminal-local variables. (Fixes national...
[bpt/emacs.git] / etc / MH-E-NEWS
CommitLineData
a66894d8
BW
1* COPYRIGHT
2
e495eaec
BW
3Copyright (C) 2003, 2004, 2005 Free Software Foundation, Inc.
4
924df208
BW
5Copying and distribution of this file, with or without modification,
6are permitted in any medium without royalty provided the copyright
7notice and this notice are preserved.
8
e495eaec
BW
9* Changes in MH-E 7.84
10
11Version 7.84 contains no user-visible changes. This version
12incorporates changes made in CVS Emacs such as the removal of some
13deprecated software.
14
15* Changes in MH-E 7.83
16
17Version 7.83 fixes a handful of bugs, adds colors to buttons for
18signed or encrypted messages, and contains some documentation changes
19related to the upcoming release of the manual. Some options were moved
20to other customization groups as a result.
21
22While not related to this release, the MH-E mailing lists are now
23gatewayed at gmane.org (closes SF #979308).
24
25** New Variables in MH-E 7.83
26
27*** mh-show-pgg-bad-face
28
29Face used to highlight a bad PGG signature.
30
31*** mh-show-pgg-good-face
32
33Face used to highlight a good PGG signature.
34
35*** mh-show-pgg-unknown-face
36
37Face used to highlight a PGG signature whose status is unknown. This
38face is also used for a signature when the signer is untrusted.
39
40** Bug Fixes in MH-E 7.83
41
42*** Whitespace in pick Expressions
43
44The "C-u / s RET" command now works. In addition, you can now add
45whitespace to any of the limiting (/) commands (closes SF #1122655).
46
47*** auto-mode-alist Updated
48
49MH-E originally updated auto-mode-alist to set the major mode of
50drafts. Now that we explicitly set the mode, there is no reason to do
51this, and this behavior caused problems for people who didn't use MH-E
52who were editing files that looked like MH message files (closes SF
53#1032353).
54
55*** mh-show-unquote-From Fails (read-only buffer)
56
57MH-E quotes the "From " header field that is inserted by MTAs.
58However, it was trying to do this in a read-only buffer. This has been
59fixed (closes SF #1089870).
60
61*** rmmproc Refile Complains No Such Message
62
63MH-E would get confused about which folder to delete messages from if
64you were refiling and deleting messages at the same time. This has
65been fixed (closes SF #1023959).
66
67*** ! Doesn't Do Regions
68
69Now it does (closes SF #1046330).
70
71*** Swish Fixes
72
73Items in swish indexes that aren't mail messages are now handled more
74gracefully.
75
76*** Spamassassin Fixes
77
78If you use spamassassin, there was an error when you tried to junk
79mail if the option mh-junk-background was set. This has been fixed.
80
81*** Mairix Support
82
83Indexing now compatible with Mairix version 0.12 and later.
84
85\f
86
eccf9613
BW
87* Changes in MH-E 7.82
88
5e4c34ce 89Version 7.82 continues to address the saga surrounding the use of CL
e495eaec
BW
90macros in CVS Emacs and fixes the auto-detection of vanilla MH (closes
91SF #1014781).
eccf9613 92
d103d8b3
BW
93* Changes in MH-E 7.81
94
95Version 7.81 fixes a `wrong-type-argument' argument error that
96sometimes occurred when processing the Message-ID, adds the ";
97(mh-toggle-mh-decode-mime-flag)" command, and uses ":default" instead
98of "default" in `mh-identity-handlers' to avoid problems with
99"Default:" as a user defined field. If you have modified
100`mh-identity-handlers' in your .emacs, you'll need to rename "default"
101to ":default". This release also corrects the release numbering; the
102previous version number was intended to be 7.80.
103
e495eaec
BW
104\f
105
f0d73c14
BW
106* Changes in MH-E 7.4.80
107
108Version 7.4.80 now supports GNU mailutils, S/MIME, picons,
109which-func-mode, has an improved interface for hiding header fields,
110improves upon the MH variant detection, and contains many bug fixes.
111Those of you familiar with the GNU version numbering schemes will
112recognize this as an alpha release. This does not reflect on the
113quality of this release which is as high as it has always been.
114Although we are not ready to release 8.0, we want you to have access
115to the work that has been hiding in CVS. At the same time we want to
116make it clear that there are incompatible changes with previous
117versions.
118
119We are planning to release the long-awaited manual update synchronized
120with version 8.0. We are using documentation from the manual in the
121docstrings which is hoped to make "C-h f (describe-function)" really
122useful and create a seamless experience when switching back and forth
123between the manual and the docstrings. This has been done in about
124half of the variables and functions in this version.
125
126The writing of the manual has revealed a few inconsistencies in the
127software whose fixes have resulted in incompatible changes, and there
128may well be more. So, unlike version 7 which was chock full of new
129features, version 8's strengths will include complete documentation
130and higher quality.
131
132** New Features in MH-E 7.4.80
133
134*** GNU mailutils Support
135
136MH-E now supports GNU mailutils 0.4 and higher versions.
137
138*** S/MIME Support
139
140MH-E now supports S/MIME using Gnus 5.10.6 or higher.
141
142*** Picon Support
143
144In addition to the other methods of displaying an icon for the sender
145of a message, MH-E can now display images from a picon directory. The
146directory search path is found in the `mh-picon-directory-list'
147variable. More documentation is found in the "facedb" sections in the
148xfaces man page. [NOTE: need to make mh-picon-directory-list an option
149and add xfaces facedb documentation to it.]
150
151*** X-Image-URL Updates
152
153Now support the use of `curl' and `fetch' as alternatives to `wget' to
154obtain the image. The display of images are controlled with the
155`mh-show-use-xface-flag' option while the `mh-fetch-x-image-url'
156option controls how the images are fetched.
157
158WARNING: There are security concerns with this feature. Please read
159the documentation for these options carefully before changing the
160default.
161
162*** Updates to mh-identity-list
163
164Note that the field names found in `mh-identity-list' that refer to
165the fields in `mh-identity-handlers' have changed in an incompatible
166way from 7.4.4. In general, the symbolic names now have a ":" prefix
167to avoid collisions with header fields. Before starting Emacs, edit
168your .emacs and insert ":" before "signature" if you have defined it.
169
170You can change your attribution in replies with the new "Attribution
171Verb" field, and you can set your default GPG user ID with the "GPG
172key ID" field.
173
174Signatures can now be read from the `mh-signature-file-name' variable,
175or come from a function, in addition to a named file. If you write
176your own function, variables that you can use include
177`mh-signature-separator-regexp', `mh-signature-separator',
178and `mh-signature-separator-p'.
179
180The handling of these fields has been moved into a new
181`mh-identity-handlers' option, an alist of fields (strings) and
182handlers (functions). Strings are lowercase. Use ":signature" for
183Signature and ":pgg-default-user-id" for GPG Key ID. The function
184associated with the string "default" is used if no other functions are
185appropriate. For this reason, don't name a header field "Default".
186
187If you point your signature at a vCard file with a vcf suffix, then it
188will be incorporated as a vCard body part (closes SF #802723).
189
190*** Catchup Command
191
192There is a new "F c (mh-catchup)" command that marks all unread
193messages in the current folder as read.
194
195*** Change Content-Type Renderer on the Fly in MH-Show Buffer
196
197This has been implemented by adding the key binding "K e
198(mh-display-with-external-viewer)". For inline text/html parts,
199buttons aren't displayed by default. In that case use "K t
200(mh-toggle-mime-buttons)" to display the button before viewing it with
201an external browser (closes SF #839318).
202
203*** Use which-func-mode to Display Folder in Index Mode
204
205Turning on `which-func-mode' displays the folder name of the message
206under the cursor in index folders (closes SF #855520).
207
208*** Render Signature and vCard in Italics
209
210This has been implemented. Use `mh-show-signature-face' to customize
211the face used (closes SF #802722).
212
213*** New Print Map
214
215There is now a keymap for the printing functions whose prefix is "P".
216The command "l (mh-print-msg)" has been replaced with "P l". Other new
217functions in this keymap include:
218
219 P A mh-ps-print-toggle-mime
220 P C mh-ps-print-toggle-color
221 P F mh-ps-print-toggle-faces
222 P M mh-ps-print-toggle-mime
223 P f mh-ps-print-msg-file
224 P l mh-print-msg
225 P p mh-ps-print-msg
226 P s mh-ps-print-msg-show
227
228*** Draft Buffer Keymap Changes
229
230The keymap in the draft buffer has been modified slightly. The old
231anonymous ftp and tar composition commands have been reinstated and
232letter signing and encrypting keymaps have been added.
233
234The type of signing or encryption has been generalized so the method
235is now an option rather than a part of the function's name. The option
236is `mh-mml-method-default' and choices include PGP (MIME), PGP,
237S/MIME, or none.
238
239Key 7.4.4 7.4.80
240
241C-c RET C-e mh-mml-secure-message-encrypt-pgpmime
242 mh-mml-secure-message-encrypt
243C-c RET C-s mh-mml-secure-message-sign-pgpmime
244 -
245C-c RET C-g - mh-mhn-compose-anon-ftp
246C-c RET C-n - mh-mml-unsecure-message
247C-c RET C-s - mh-mml-secure-message-sign
248C-c RET C-t - mh-mhn-compose-external-compressed-tar
249C-c RET C-s mh-mml-secure-message-sign-pgpmime
250 mh-mml-secure-message-sign
251C-c RET C-x - mh-mhn-compose-external-type
252C-c RET e mh-mml-secure-message-encrypt-pgpmime
253 Prefix Command
254C-c RET e e - mh-mml-secure-message-encrypt
255C-c RET e s - mh-mml-secure-message-signencrypt
256C-c RET g - mh-mhn-compose-anon-ftp
257C-c RET n - mh-mml-unsecure-message
258C-c RET s mh-mml-secure-message-sign-pgpmime
259 Prefix Command
260C-c RET s e - mh-mml-secure-message-signencrypt
261C-c RET s s - mh-mml-secure-message-sign
262C-c RET t - mh-mhn-compose-external-compressed-tar
263C-c RET x - mh-mhn-compose-external-type
264
265*** Speedbar: Highlight Folders With Unseen
266
267The speedbar now renders the folders with unseen messages in boldface
268which makes them easier to identify (closes SF #623369).
269
270*** Quick Key Help
271
272The "? (mh-help)" function now displays the help in its own buffer
273called *MH-E Help* (closes SF #493740 and SF #656631).
274
275*** New Startup File mh-e-autoloads.el
276
277If you are installing MH-E yourself, then you can replace any
278autoloads you may have with "(require 'mh-e-autoloads.el)". See the
279README for details.
280
281*** Glimpse Support Removed
282
283Since glimpse isn't free, we cannot mention it. Glimpse has been
284removed from the option `mh-indexer-choices' (closes SF #831276).
285
286*** mh-msg-is-in-seq Update
287
288Can now specify an alternate message number to "S s
289(mh-msg-is-in-seq)" with a prefix argument.
290
291** New Variables in MH-E 7.4.80
292
293Variables that have been added to MH-E that have not been discussed
294elsewhere are listed here.
295
296*** mail-citation-hook
297
298Hook for modifying a citation just inserted in the mail buffer.
299
300*** mh-alias-reloaded-hook
301
302Invoked by `mh-alias-reload' after reloading aliases.
303
304*** mh-auto-fields-prompt-flag
305
306Non-nil means to prompt before sending if fields in
307`mh-auto-fields-list' are inserted.
308
309*** mh-default-folder-for-message-function
310
311Function to select a default folder for refiling or `Fcc'.
312
313*** mh-forward-hook
314
315Invoked on the forwarded letter by "f (mh-forward)".
316
317*** mh-invisible-header-fields-default
318
319List of hidden header fields. The header fields listed in this option
320are hidden, although you can check off any field that you would like
321to see. Header fields that you would like to hide that aren't listed
322can be added to the `mh-invisible-header-fields' option (closes SF
323#752045).
324
325The option `mh-visible-header-fields' has been deleted.
326
327*** mh-junk-background
328
329If on, spam programs are run in background. This used to be the
330default behavior but this could overwhelm a system if many messages
331were black- or whitelisted at once. The spam programs are now run in
332the foreground, but this option can be used to put them back in the
333background.
334
335*** mh-signature-separator-flag
336
337Non-nil means a signature separator should be inserted. It is not
338recommended that you change this option since various mail user
339agents, including MH-E, use the separator to present the signature
340differently, and to suppress the signature when replying or yanking a
341letter into a draft.
342
343*** mh-variant
344
345Specifies the variant used by MH-E. The default setting of this option
346is `Auto-detect' which means that MH-E will automatically choose the
347first of nmh, MH, or GNU mailutils that it finds in the directories
348listed in `mh-path', `mh-sys-path', and `exec-path'. If, for example,
349you have both nmh and mailutils installed and `mh-variant-in-use' was
350initialized to nmh but you want to use mailutils, then you can set
351this option to `mailutils'.
352
353When this variable is changed, MH-E resets `mh-progs', `mh-lib',
354`mh-lib-progs', `mh-flists-present-flag', and `mh-variant-in-use'
355accordingly.
356
357If you've set these variables in your .emacs, it is strongly suggested
358that you comment them out. The MH detection code has been completely
359rewritten and it is very likely that you no longer to set them and
360their setting may confuse other MH-E settings.
361
362** Variables Deleted in MH-E
363
364Variables that have been removed from MH-E that have not been
365discussed elsewhere are listed here.
366
367*** mh-alias-system-aliases
368
369System definitions should not be a user option.
370
371*** mh-junk-mail-folder
372
373Since this variable can accept values other than folder names, it was
374renamed to `mh-junk-disposition' to more accurately reflect the content.
375
376** Bug Fixes in MH-E 7.4.80
377
378Many bugs were fixed in this version that aren't listed below.
379
380*** mh-extract-rejected-mail Can't Do MIME (and Other Formats)
381
382Now handles qmail and exim bounces (addresses SF #404965).
383
384*** mh-rmail Hangs in XEmacs
385
386We've determined that MH-E is incompatible with some versions of
387XEmacs (21.5.9-21.5.16). More recent versions work fine. If you think
388our list is too broad, please let us know which version of XEmacs you
389are using (closes SF #644321).
390
391*** Inconsistent Prompts
392
393Prompt formats are now consistent throughout the application (closes
394SF #730470).
395
396*** Empty Shell Comments Confuse mh-mhn-directive-present-p
397
398If you had a string that matched the regexp "^# $" in your draft, it
399would cause an error. This has been fixed (closes SF #762458).
400
401*** Quote Hashes When mhbuild Directives Used
402
403A related bug, if you had empty shell comments but inserted your own
404directives, you'd get another error from mhbuild. This has been fixed
405by quoting the hash ("^# $") like this "##" before submitting to
406mhbuild (closes SF #762464).
407
408*** Inconsistent Usage in Scan Formatting Variables
409
410The variables:
411
412 mh-note-cur
413 mh-note-deleted
414 mh-note-dist
415 mh-note-forw
416 mh-note-refiled
417 mh-note-repl
418 mh-note-seq
419
420used to contain strings. Although only the first character was read,
421the entire string would be inserted which may have caused problems.
422These variables have been converted to character constants so that
423only a single character can be inserted into the scan line (closes SF
424#770772).
425
426*** Bad Handling of Aliases That Conflict With Local User Names
427
428If a user name existed both locally and in the aliases file, the local
429user would be flashed, but the alias would be used when sending. This
430has been fixed so that the user name that is flashed is the same as
431the name that is sent (closes SF #772595).
432
433*** Args out of range
434
435In rare and non-reproducible circumstances, compilation sometimes
436threw an "Args out of range" error. Nonetheless, this has been fixed
437(closes SF #806577).
438
439*** mh-forward hard-codes '-mime' Switch on nmh
440
441Added new option `mh-compose-forward-as-mime-flag' that controls whether
442messages are forwarded as MIME attachments (closes SF #827203).
443
444*** Not Re-prompted to Sign After Pass Phrase Typo
445
446If there were errors when sending a signed message (like getting the
447pass phrase wrong), the MML markup remained in the draft buffer. The
448draft buffer is now restored if there is an error (closes SF #839303).
449
450*** Font-lock Gets Confused in MH-Letter Buffer
451
452If a user manually moved the cursor to the end of the header field
453separator line (by mouse click or keyboard navigation) and hit Enter
454to start typing their message, any line in the body with a colon would
455be fontified with a gray background. This has been fixed (closes SF
456#855479).
457
458*** mh-refile-msg Fails to Suggest Folder for Empty Message
459
460If you received a message with an empty body from someone who is
461listed in your aliases file, "o (mh-refile-msg)" failed to suggest the
462correct folder. This has been fixed (closes SF #917096).
463
464*** Error Visiting Folder With no Unseen Messages
465
466If you visited a folder without unseen messages and the option "flist:
467-noshowzero" is present in your ~/.mh_profile, you'd get an error. This
468has been fixed (closes SF #933954).
469
470\f
471
a66894d8
BW
472* Changes in MH-E 7.4.4
473
474Version 7.4.4 addresses programmatic issues from the FSF and prepares
bf247b6e 475MH-E for inclusion into an impending GNU Emacs release (22.1). There
a66894d8
BW
476are no user-visible changes (unless you are using XEmacs on DOS or
477don't have the cl package installed). Filenames are now unique in
478their first 8 characters (DOS 8.3 requirement). The runtime dependency
479on the cl package has been removed. Desktop saving and restoration
480code moved here from desktop.el.
481
482* Changes in MH-E 7.4.3
483
f0d73c14 484Version 7.4.3 fixes the problem where `mh-identity-list' was not getting
a66894d8
BW
485set from .emacs.
486
487* Changes in MH-E 7.4.2
488
489Version 7.4.2 fixes the accidental dependence on nmh (closes SF
490#791021).
491
492* Changes in MH-E 7.4.1
493
494Version 7.4.1 fixes the Makefile so it no longer tries to compile
495mh-unit.el.
496
497* Changes in MH-E 7.4
498
499Version 7.4 contains many new useful features including arbitrary MH
500range handling, new draft features such as draft form editing, as well
501as sequence propagation and manipulation. We've also fixed bugs and
502added a handful of new variables.
503
504** New Features in MH-E 7.4
505
506*** Add Arbitrary Ranges to MH-E UI
507
508MH-E now handles any legal MH range (such as last:5 or 4 8 10-12)
509wherever you're prompted for a message number or sequence (closes SF
510#728638).
511
512*** Remove Prompting in mh-send
513
514Brian Reid's original mhe didn't do prompting anywhere but used forms
515instead. While we won't go that far, we eliminated prompting where a
516form is already involved, such as in composing a message.
517
518The new customization variable `mh-compose-prompt-flag' can be set to
519t to get the original behavior (closes SF #745622).
520
521*** Use TAB to Switch Fields in Header
522
523When composing a message, TAB and SHIFT-TAB can be used to move
524quickly between header fields. The new customization variable,
525`mh-compose-skipped-header-fields', contains a list of header fields
526that are skipped and truncated if they are too long (closes SF
527#745627).
528
529*** Alias Completion in Composition Buffer
530
531Aliases can be completed in the draft with "M-TAB
532(mh-letter-complete)". Or, if the customization variable
533`mh-compose-space-does-completion-flag' is set to t, then a "SPC
534(mh-letter-complete-or-space)" with do the same thing. If
535`mh-alias-flash-on-comma' is non-nil, ", (mh-letter-confirm-address)"
536will show the alias expansion in the minibuffer (closes SF #745634).
537
538*** Auto Fields Should be Inserted During Send
539
540Fields that were inserted by the multiple personality code when the
541draft was sent now insert the header fields when the draft is composed
542to give you a chance to edit them (closes SF #747890).
543
544*** mh-index-tick-messages
545
546The command "F ' (mh-index-ticked-messages)" creates a buffer with all
547messages ticked with "' (mh-toggle-tick)" in the folders listed in the
548new customization variable `mh-index-ticked-messages-folders'. Chances
549are that if you set `mh-index-new-messages-folders', you'll want to
550set `mh-index-ticked-messages-folders' accordingly.
551
552In addition, a general function, "F q (mh-index-sequenced-messages)"
553has been provided that displays messages in the `mh-unseen-seq' in the
554folders listed `mh-index-new-messages-folders', unless a prefix
555argument is given, in which case you can provide both a list of
556folders and a sequence (closes SF #718833).
557
558*** Narrow to Region
559
560If there is a region, "/ r (mh-narrow-to-range)" will only consider
561those messages in the region. In addition, there is now a stack of
562folder limits which can be popped with "/ w (mh-widen)". With a prefix
563arg, all the restrictions are popped off of the stack (closes SF
564#732823).
565
566*** Narrow to Ticked Sequence
567
568The buffer can now be narrowed to ticked messages with "S '
569(mh-narrow-to-tick)" (closes SF #732825).
570
571*** Display Multiple Buttons for multipart/alternative
572
573A new customizable variable,
574`mh-display-buttons-for-alternatives-flag', was added to display
575buttons for the alternatives. The default value is nil to retain the
576current behavior (closes SF #741288).
577
578*** Identity Menu Changes
579
580A menu item has been added that inserts custom fields if the To or Cc
581header fields match `mh-auto-fields-list'.
582
583** New Variables in MH-E 7.4
584
585*** mh-alias-local-users-prefix
586
587This string is prepended to the real names of users from the passwd
588file. If nil, use the username string unmodified instead of the real
589name from the gecos field of the passwd file.
590
591*** mh-alias-passwd-gecos-comma-separator-flag
592
593Non-nil means the gecos field in the passwd file uses comma as a
594separator. Used to construct aliases for users in the passwd file."
595
596*** mh-interpret-number-as-range-flag
597
598Non-nil means interpret a number as a range. If the variable is
599non-nil, and you use an integer, N, when asked for a range to scan,
600then MH-E uses the range "last:N".
601
602*** mh-kill-folder-suppress-prompt-hook
603
604This new hook is invoked at the beginning of the `F k
605(mh-kill-folder)' command. It is a list of functions to be called,
606with no arguments, which should return a value of non-nil if you
607should not be asked if you're sure that you want to remove the folder.
608This is useful for folders that are easily regenerated.
609
610The default value of `mh-index-p' suppresses the prompt on folders
611generated by an index search.
612
613WARNING: Use this hook with care. If there is a bug in your hook which
614returns t on +inbox and you hit `F k' by accident in the +inbox
615buffer, you will not be happy.
616
617*** mh-refile-preserves-sequences-flag
618
619Non-nil means that sequences are preserved when messages are refiled.
620If this variable is non-nil and a message belonging to a sequence
621other than cur or Previous-Sequence (see mh-profile 5) is refiled then
622it is put in the same sequence in the destination folder. Additional
623sequences that should not to be preserved can be specified by setting
624`mh-unpropagated-sequences' appropriately.
625
626*** mh-visible-header-fields
627
628Customize this instead of `mh-visible-headers', which is now a defvar.
629This was done to mimic the relationship between
630`mh-invisible-header-fields' and `mh-invisible-fields'.
631
632** Variables Deleted in MH-E 7.4
633
634*** mh-visible-headers
635
636See the paragraph for `mh-visible-header-fields' above.
637
638** Bug Fixes in MH-E 7.4
639
640*** Aliases Constantly Reloaded
641
642The system aliases are not loaded as often as they were, so the
643completion speed has been dramatically improved if your passwd file is
644large (closes SF #693859).
645
646*** Folders in MH-Index View Not Saved
647
648When you perform a search to produce an MH-Index buffer, the folders
649that contain the messages are shown. If the MH-Index buffer was
650deleted, or Emacs was restarted and the corresponding folder
651rescanned, the folder information would be lost. This has been fixed
652by saving the information in a file called ".mhe_index" (closes SF
653#701762).
654
655*** Ticking Messages in +mhe-index/new
656
657If a new message in a buffer created by "F n" was ticked (with "'"),
658the message would not be added to the tick sequence in the source
659folder. This has been fixed so that any sequence changes in any index
660folder (from within MH-E of course) are now reflected back to the
661corresponding source folder (closes SF #709664).
662
663*** Custom Vars Set by a Function
664
665The default setting of customization variable `mh-summary-height' is
666now `nil' which means MH-E will change the size dynamically according
667to the size of the frame (closes SF #723267).
668
669*** Folder Completion Slow
670
671The first folder completion was very slow. This has been fixed (closes
672SF #730426).
673
674*** Tick Sequence Persistent When Refiled
675
676Sequences are now preserved when messages are refiled (closes SF
677#737128).
678
679*** Auto-inserted Header Fields Inconsistent
680
681For consistency, all automatically inserted header fields (such as
682X-Mailer and X-Face) are added when the draft is first presented to
683you. This also gives you a chance to edit or delete them if necessary
684(closes SF #745624). Note that we would be distressed if you deleted
685the X-Mailer field.
686
687*** Toolbar Spec Error
688
689The following message appeared when displaying a message in XEmacs:
690
691 Signaling: (error "Toolbar spec must be list or nil" )
692
693This has been fixed (closes SF #745655).
694
695*** mh-index-search Doesn't Find Short Acronyms
696
697Swish typically ignores words with fewer than four letters, but will
698still look for acronyms. Unfortunately, MH-E was downcasing the input
699words which defeated this feature. This has been fixed (closes SF
700#755718).
701
702\f
924df208
BW
703
704* Changes in MH-E 7.3
705
286fbd0f
BW
706This release includes the new features of an index view of unseen
707messages in all folders, spam software support, relative folder
708specification @ support, marking messages, recipient handling by
709mh-default-folder-list, Face and X-Image-URL header field support, and
710Fcc completion. Function arguments have been unified. Bugs have been
711fixed.
712
924df208
BW
713** New Features in MH-E 7.3
714
286fbd0f 715*** Unified Function Arguments
924df208
BW
716
717Any function with MSG-OR-SEQ in its docstring uses the displayed
718message by default for this argument. However, if a prefix argument is
719provided, then the user is prompted for a message sequence. If the
720variable `transient-mark-mode' is non-nil and the mark is active, then
721the function operates on the messages in the selected region. In a
722program, MSG-OR-SEQ can be a message number, a list of message
723numbers, a region in a cons cell, or a sequence.
724
286fbd0f 725*** MH-Index View of Unseen Messages
924df208
BW
726
727Use "F n (mh-index-new-messages)" or Folder -> View New Messages menu
728item to display messages in the `mh-unseen-seq' sequence in folders
729specified by `mh-index-new-messages-folders'. With a prefix argument,
730enter a space-separated list of folders, or nothing to search all
731folders.
732
733Like other MH-Index folders, use "v (mh-index-visit-folder)" if you
734wish to visit the original folder with the unseen message. This is
735usually not necessary since the original message is annotated if you
736reply, deleted if you delete the message, or refiled if you refile the
737message (closes SF #701756).
738
286fbd0f 739*** Spam Software Support
924df208
BW
740
741MH-E now supports several spam filters including Bogofilter,
742SpamProbe, and SpamAssassin. Spam that is mistakenly considered to be
743good mail can be reclassified as spam with "J b (mh-junk-blacklist)".
744Conversely, good mail that is accidently considered to be spam can be
745reclassified with "J w (mh-junk-whitelist)" (closes SF #669518).
746
747If a message is blacklisted, and `mh-junk-mail-folder' is a string,
748then the message is refiled to that folder. If this variable is nil,
749the message is deleted. If a message is whitelisted, then the message
750is refiled to `mh-inbox'.
751
752To change the spam program being used, customize `mh-junk-program'.
753This should only be necessary if you have multiple filters on your
754system and MH-E picked the wrong one. These customization variables
755are found in the new customization group `mh-junk'.
756
757The documentation for the following functions describes what setup is
758needed for the different spam fighting programs:
759
760 - `mh-bogofilter-blacklist'
761 - `mh-spamprobe-blacklist'
762 - `mh-spamassassin-blacklist'
763
286fbd0f 764*** Relative Folder Specification @ Supported
924df208
BW
765
766You can now use the relative folder marker @ in folder names (closes
767SF #666774).
768
286fbd0f 769*** Marking Messages
924df208
BW
770
771Messages can now be highlighted with "' (mh-toggle-tick)", Sequence ->
772Toggle Tick Mark menu item or the "Toggle tick mark" button. These
773messages are added to the "tick" sequence, although this sequence can
774be changed in `mh-tick-seq'. The highlighting effect can be modified
775by customizing `mh-folder-tick-face' (closes SF #623367).
776
777There is also a new keybinding "/ ' (mh-narrow-to-tick)" and menu item
778Sequence -> Narrow to Tick Sequence to narrow the view to the
779highlighted messages.
780
286fbd0f 781*** mh-default-folder-list Now Takes Recipients
924df208
BW
782
783If you wish to file a message based upon the recipient of a message
784(such as a mailing list), you can now indicate that when filling out
785the address in the `mh-default-folder-list' customization variable.
786
286fbd0f 787*** Face Header Field Supported
924df208
BW
788
789In addition to the X-Face header field, the Face header field, which
790can display color images, is now supported. As a bonus, the external
791xface-e21 library is no longer required.
792
286fbd0f 793*** X-Image-URL Support
924df208
BW
794
795Images specified in X-Image-URL header fields are now supported.
796See the customization variable `mh-fetch-x-image-url' to enable this
797support.
798
286fbd0f 799*** Fcc Completion
924df208
BW
800
801Folders in Fcc fields in message drafts can now be completed with
802M-TAB.
803
804** New Variables in MH-E 7.3
805
806Variables that have been added to MH-E that have not been discussed
807elsewhere are listed here.
808
809*** mh-auto-fields-list
810
811Alist of addresses for which header lines are automatically inserted.
812When a regular expression matches in the To or cc fields of a message,
813the corresponding header field is automatically inserted in the
814message header. It also allows the automatic setting of an identity
815(using `mh-insert-identity') to set an alternate identity when sending
816messages to a certain person or mailing list.
817
818Since this is a more general use of `mh-insert-mail-followup-to-flag'
819and `mh-insert-mail-followup-to-list', these variables have been removed.
820
821*** mh-show-xface-face
822
823Face for displaying the X-Face image.
824
825*** mh-xemacs-toolbar-position
826
827This customization variable allows the user to place the toolbar on
828the four edges of the frame.
829
830*** mh-xemacs-use-toolbar-flag
831
832This customization variable is used to enable or disable the toolbar
833under XEmacs.
834
835** Variables Deleted in MH-E 7.3
836
837Variables that have been removed from MH-E that have not been
838discussed elsewhere are listed here.
839
840*** mh-decode-content-transfer-encoded-message-flag
841
842No longer needed since the external program mimencode is no longer
843used.
844
845*** mh-index-show-hook
846
847This hook was never used, so it was removed.
848
849*** mh-tool-bar-reply-3-buttons-flag
850
851Obsolete. This functionality is present `mh-tool-bar-folder-buttons'.
852
853** Bug Fixes in MH-E 7.3
854
286fbd0f 855*** Can't Refile Message
924df208
BW
856
857Messages with invalid addresses were causing errors in ali which
858prevented the refiling of messages. The ali error is now shown in the
859"*MH-E Log*" buffer and refiling suggests the last folder used (closes
860SF #680388).
861
286fbd0f 862*** Empty Body Triggers Duped Header
924df208
BW
863
864If the body was empty the header would be treated like the body and
865was therefore displayed twice. This has been fixed (closes SF
866#681162).
867
286fbd0f 868*** mml or mhl Directives Not Always Processed
924df208
BW
869
870The mml and mhl directives used to create body parts were not
871processed if one re-edited a draft, or if they added the directives
872manually. The directives are now always processed upon sending the
873letter. You may still, of course, use "C-c C-m m (mh-mml-to-mime)" or
874"C-c C-e (mh-edit-mhn)" to manually create the MIME body parts from
875the directives and then send the draft.
876
286fbd0f 877*** mh-alias-grab-from-field Fails
924df208
BW
878
879MH-E was adding aliases with angle brackets around the address when
880there wasn't a phrase (usually, the user's name), to go with it. This
881caused ali to fail which caused problems in MH-E. This is probably a
882bug in ali, but MH-E no longer inserts angle brackets around the
883address unless there is a phrase, which avoids the problem (closes SF
884#690216).
885
286fbd0f 886*** XEmacs Fixes
924df208
BW
887
888MH-E is now fully supported under XEmacs and compiles without any
889warnings.
890
891In particular, the following now work under XEmacs:
892
893- X-Face, Face, and X-Image-URL header fields
894- MH-E logo in mode line
895- Emphasis (bold, italics, etc.)
896- Smilies
897- Toolbar
898
286fbd0f 899*** Indexed Folders Should Respect mh-show-threads-flag
924df208
BW
900
901Indexed folders are now threaded if `mh-show-threads-flag' is non-nil
902(closes SF #709667).
903
286fbd0f 904*** Threading Index View Loses Folder Info
924df208
BW
905
906This has been fixed (closes SF #709672).
907
286fbd0f 908*** No Undo Information When Re-editing Drafts
924df208
BW
909
910Undo is turned on in the draft buffer when using "e (mh-edit-again)"
911(closes SF #712777).
912
286fbd0f 913*** Forwarded base64-encoded Messages Are Incorrectly Displayed
924df208
BW
914
915This has been fixed (closes SF #681518).
916
286fbd0f 917*** Append to *MH-E Log* Buffer
924df208
BW
918
919The last 100 lines of log messages are kept in the *MH-E Log* buffer.
920Previously, the buffer was erased every time it was written (closes SF
921#685476). In addition, many of the MH-E commands now send their output
922into this buffer instead of a plethora of other special-purpose
923buffers.
924
286fbd0f 925*** mh-inc-folder Complains if No Mail and No Current Message
924df208
BW
926
927The function `mh-inc-folder' no longer calls `mh-show' if point is not
928on a valid scan line. This keeps `mh-inc-folder' from complaining
929(closes SF #678115).
930
286fbd0f 931*** Folder Normalization Strips Leading Slash
924df208
BW
932
933Leading "/" characters in folder names entered by the user were being
934lost. This has been fixed (closes SF #676890).
935
286fbd0f 936*** Print Header Doesn't Show Message
924df208
BW
937
938When printing a sequence, the header simply indicated that a sequence,
939but not which one, was being printed and did not show the message
940number. This has been fixed. If more than one message is printed, a
941page of the scan lines is printed and its header indicates the
942sequence or message range. The pages with the actual messages all set
943the header to the folder and message displayed on that page.
944
286fbd0f 945*** Aliases Constantly Reloaded
924df208
BW
946
947Empty lists are now handled properly (closes SF #693859).
948
286fbd0f 949*** Remove RCS Keywords
924df208
BW
950
951Removed RCS keywords per Emacs conventions (closes SF #680731).
952
286fbd0f 953*** Replace Mimencode
924df208
BW
954
955MH-E was enhanced to decode message based on charset and
956Content-Transfer-Encoding. This eliminates the need for the external
957program mimencode (closes SF #674857).
958
959\f
960
3d7ca223
BW
961* Changes in MH-E 7.2
962
963This release includes the new features of filing hints, hierarchical
964file name completion, indexed search and pick integration, unification
965between `mh-visit-folder' and the speedbar, a displayed message
966indicator, buffer name organization, support for mairix indexed
967search, and last but not least, the MH-E logo has been added to the
968mode line. Code that handles sequences and message regions runs
969faster. Bugs have been fixed.
970
971** New Features in MH-E 7.2
972
973*** Filing Hints
974
975When you file a message, MH-E now looks for an alias corresponding to
976the address of the sender and offers that as a default folder (closes
977SF #657096). The new variable `mh-default-folder-prefix' can be used
978to put these folders in a sub-folder. The new variable
979`mh-default-folder-must-exist-flag' means to suppress the suggested
980folder (thereby providing the previous folder used) if the folder
981doesn't already exist. The new variable `mh-default-folder-list' can
982be used to map additional addresses and folders.
983
984*** Hierarchical File Name Completion
985
986When you completed filenames in the past, you were presented with a
987list of all your folders at all depths in the tree. Now you are
988presented with only one level at a time (closes SF #664821).
989As a result, the variables `mh-auto-folder-collect-flag' and
990`mh-folder-list-change-hook' are obsolete.
991
992*** Indexed Search and Pick Integration
993
994The indexed and pick searches have been integrated (closes SF
995#664816). Both "F s (mh-search-folder)" and "F i (mh-index-search)"
996use the pick template for forming queries. To submit the query, use
997"C-c C-c (mh-do-search)" which will use the query method you selected.
998If you change your mind while forming the query, you can use "C-c C-i
999(mh-index-do-search)" or "C-c C-p (mh-pick-do-search)" to submit the
1000query using the respective method.
1001
1002Second, the results from a pick search are now saved in a sub-folder
1003of +mhe-index like an indexed search.
1004
1005Third, `pick' is now a valid choice for `mh-index-program'.
1006
1007*** mh-visit-folder Metamorphosis Continues
1008
1009When visiting a folder from the speedbar, only the unseen messages are
1010shown if there are unseen messages. If there aren't any unseen
1011messages, all of the messages are shown if there are fewer than
1012`mh-large-folder' messages; otherwise, the user is prompted for the
1013range of messages to display. The "F v (mh-visit-folder)" command has
1014been modified to mimic this behavior. Use a prefix arg to force the
1015message range prompt.
1016
1017*** Displayed Message Indicator
1018
1019In graphical Emacs, the message that is shown is marked by a triangle
1020in the fringe. In textual Emacs, there is a ">" in the first column
1021(closes SF #664824).
1022
1023*** Buffer Name Organization
1024
1025All ephemeral buffer names start with " *mh" while all interesting
1026buffers start with "*MH-E ". The "*Folders*", "*Sequences*", and
1027"*Recipients*" buffers were therefore renamed to "*MH-E Folders*",
1028"*MH-E Sequences*" and "*MH-E Recipients*" respectively (programmers
1029should see mh-utils.el for the names of the new constants). Also, the
1030output of MH commands is saved in the "*MH-E Log*" buffer.
1031
1032*** mh-index-program
1033
1034Add choices for `mairix' and `pick'.
1035
1036*** Logo Displayed on Mode Line
1037
1038** New Variables in MH-E 7.2
1039
1040The new variables have been discussed elsewhere.
1041
1042** Bug Fixes in MH-E 7.2
1043
1044*** mh-decode-content-transfer-encoded-message
1045
1046Messages that had been encoded with base64 were not decoded. This has
1047been fixed with this new function (closes SF #674190). As a result,
1048the variable `mh-decode-quoted-printable-flag' has been renamed to
1049`mh-decode-content-transfer-encoded-message-flag'.
1050
1051*** mh-kill-folder
1052
1053Now restores previous window configuration (closes SF #664828).
1054
1055*** mh-mime-display
1056
1057MH-E was not using the charset defined in the content-type
1058header. This meant that mail in a different charset would not
1059be properly displayed. This has been fixed (closes SF #655123).
1060
1061*** mh-read-address
1062
1063In XEmacs and Emacs20, this function would always prompt using "To: "
1064instead of using the command argument. This has been fixed (closes SF
1065#670913).
1066
1067*** mh-rmail
1068
1069Unseen messages are now shown in addition to new ones (closes SF
1070#667542).
1071
1072*** mh-scan-msg-overflow-regexp
1073
1074Change the variable so that a space is always maintained in the
1075beginning of the scan line.
1076
1077*** mh-swish-execute-search
1078
1079The example configuration file in the docstring didn't show the
1080backslash in the FileRules filename. If the example had been used
1081literally by the user, no files would be indexed! This has been fixed
1082(closes SF #665888).
1083
1084*** mh-thread-refile
1085
1086The "T o (mh-thread-refile)" command did not provide refiling hints
1087like `mh-refile-msg'. This has been fixed (closes SF #664829).
1088
1089*** mh-toggle-threads
1090
1091If the threaded view was modified and then toggled, the standard view
1092may not have been accurate (as it contained a potentially old first
1093message to last message range). This has been fixed (closes SF
1094#626117).
1095
1096*** mh-tool-bar-show-set, mh-tool-bar-letter-set, mh-tool-bar-folder-set
1097
1098Clicking the customize and help buttons now deletes the other windows
1099in the frame.
1100
1101*** mh-version
1102
1103The "M-x mh-version" command displayed "Aliasfile: aliases". This has
1104been fixed (closes SF #664467). See Buffer Name Organization above.
1105
1106\f
1107
1108* Changes in MH-E 7.1
c3d9274a
BW
1109
1110This release includes the new features of multiple identities and
1111alias completion. In addition, indexed searching has been revamped.
1112Various other features have been added and a few bugs were fixed.
1113
1114** New Features in MH-E 7.1
1115
1116*** Multiple Identities
1117
1118MH-E now supports multiple identities (closes SF #628782). That means
1119that you can have different From and Organization header fields (or
1120any other header field of your choice) as well as different signatures
1121depending on your context. Usually, the contexts are home and work.
1122
1123Add your identities to the variable `mh-identity-list' and set the
1124default identity with the variable `mh-identity-default'. Your
1125identity can be switched on the fly by using the Identity menu or by
1126calling "M-x mh-insert-identity RET".
1127
1128This functionality can be customized within the mh-identity group.
1129
1130*** Alias Completion and Harvesting
1131
1132The contributed file mh-alias.el has been rewritten and incorporated
1133into MH-E.
1134
1135By default, aliases are culled from the system files
1136"/etc/nmh/MailAliases," "/usr/lib/mh/MailAliases," and "/etc/passwd"
1137(see `mh-alias-system-aliases') and from your "AliasFile" MH profile
1138component. These aliases are then used for completion in the
1139minibuffer when entering addresses. Within the header of the message
1140draft, "M-TAB (mh-letter-complete)" is used to do alias completion.
1141
1142The package also provides for alias creation based upon the From
1143header field of the current message. Use the lasso button
1144(mh-alias-grab-from-field).
1145
1146This functionality can be customized within the mh-alias group.
1147
1148*** Index Folder Updates
1149
1150The results of an index search "F i (mh-index-search)" are now stored
1151in a bona fide folder so that you can refile messages and reply to
1152messages directly from the result folder. This folder is a sub-folder
1153of +mhe-index and the name is based upon the search string (closes SF
1154#623321).
1155
1156If a prefix argument is given then the search in the current index
1157buffer is redone.
1158
1159The index folder lists the names of the source folders as before.
1160However, instead of using RET on the name of the folder to visit the
1161folder, use "v (mh-show-index-visit-folder)" anywhere within the
1162results to visit that folder narrowed to the results of the search.
1163Additional functions have been added to navigate including "TAB
1164(mh-index-next-folder)", and "SHIFT-TAB (mh-index-previous-folder)."
1165
1166*** mh-visit-folder Interface Updated
1167
1168A change was made to the prompting of the message range. In general,
1169you can use the same format for messages and sequences as you can in
1170MH with a single exception: a single number means to scan that many
1171messages, rather than scan that message number. This turns out to be
1172much more useful than visiting a single message and is consistent with
1173Gnus and the MH-E speedbar (closes SF #655891).
1174
1175If mh-visit-folder is called non-interactively and RANGE is nil then
1176all messages are displayed. This behavior is now documented and
1177provides backwards compatibility.
1178
1179*** Threading Improvements
1180
1181After incorporating new mail into a threaded folder, unseen messages
1182can be spread about. Two new functions have been added to make it
1183easier to find them: these are "M-n (mh-next-unread-msg)" and "M-p
1184(mh-previous-unread-msg)" (closes SF #630328)
1185
1186Two new functions were added to delete and refile threads. They are "T
1187d (mh-thread-delete)" and "T o (mh-thread-refile)" respectively
1188(closes SF #630493).
1189
1190In addition, the key "k" used to be bound to the function
1191`mh-delete-subject': it is now bound to
1192`mh-show-delete-subject-or-thread'.
1193
1194New functions to navigate threads include "T u (mh-thread-ancestor)",
1195which can jump to the root message of the current thread given an
1196optional argument, "T n (mh-thread-next-sibling)", and "T p
1197(mh-thread-previous-sibling)"
1198
1199*** Refiling of Messages in Region
1200
1201If mark is active and `transient-mark-mode' is enabled then all the
1202messages in the region are refiled.
1203
1204*** vCard Handling
1205
1206If a signature cannot be identified, but there is a vCard attachment,
1207then that vCard will be presented as a signature (closes SF #649216).
1208
1209*** New Info Added to mh-version
1210
1211Information about Gnus versions available at both compile time and run
1212time has been added.
1213
1214** New Variables in MH-E 7.1
1215
1216The defcustom groups were reorganized. Rather than iterate the
1217specific changes here, you are invited to browse the groups with "M-x
1218mh-customize RET".
1219
1220*** mh-alias-completion-ignore-case-flag
1221
1222Non-nil means don't consider case significant in MH alias completion.
1223This is the default in plain MH, so it is the default here as well. It
1224can be useful to set this to t if, for example, you use lowercase
1225aliases for people and uppercase for mailing lists.
1226
1227*** mh-alias-expand-aliases-flag
1228
1229Non-nil means to expand aliases entered in the minibuffer. In other
1230words, aliases entered in the minibuffer will be expanded to the full
1231address in the message draft. By default, this expansion is not
1232performed.
1233
1234*** mh-alias-flash-on-comma
1235
1236Specify whether to flash the translation of the alias or warn if there
1237isn't a translation of the alias.
1238
1239*** mh-alias-insert-file
1240
1241Filename to use to store new MH-E aliases. This variable can also be a
1242list of filenames, in which case MH-E will prompt for one of them. If
1243nil, the default, then MH-E will use the first file found in the
1244"AliasFile" component of the MH profile.
1245
1246*** mh-alias-insertion-location
1247
1248Specifies where new aliases are entered in alias files. Options are
1249sorted alphabetically (the default), at the top of the file or at the
1250bottom.
1251
1252*** mh-alias-local-users
1253
1254If t, local users are completed in MH-E To: and Cc: prompts.
1255
1256If you set this variable to a string, it will be executed to generate
1257a password file. A value of "ypcat passwd" is helpful if NIS is in
1258use.
1259
1260*** mh-alias-system-aliases
1261
1262A list of system files from which to cull aliases. If these files are
1263modified, they are automatically reread. This list need include only
1264system aliases and the passwd file, since personal alias files listed
1265in your "AliasFile" MH profile component are automatically included.
1266
1267*** mh-identity-default
1268
1269Default identity to use when `mh-letter-mode' is called.
1270
1271*** mh-identity-list
1272
1273List holding MH-E identity.
1274
1275*** mh-invisible-header-fields
1276
1277Simple user interface to change `mh-invisible-headers'.
1278
1279*** mh-letter-complete-function
1280
1281Function to call when completing outside of fields specific to
1282aliases. By default, it is bound to 'ispell-complete-word.
1283
1284*** mh-show-threads-flag
1285
1286Non-nil means new folders start in threaded mode. Threading large
1287number of messages can be time consuming. So if the flag is non-nil
1288then threading will be done only if the number of messages being
1289threaded is less than `mh-large-folder' (closes SF #646794).
1290
1291*** mh-tool-bar-folder-buttons
1292
1293Buttons to include in MH-E folder/show toolbar.
1294
1295*** mh-tool-bar-letter-buttons
1296
1297Buttons to include in MH-E letter toolbar.
1298
1299** Bug Fixes in MH-E 7.1
1300
1301*** mh-get-new-mail
1302
1303Call new function `mh-add-cur-notation' to undo the work of
1304`mh-remove-cur-notation' if there was no new mail (closes SF #647681).
1305
1306*** mh-set-cmd-note
1307
1308No longer updates the default `mh-cmd-note' value. This resulted in
1309the misplacement of the current mark when the message number width
1310changed (closes SF #643701).
1311
1312\f
1313
3d7ca223 1314* Changes in MH-E 7.0
bdcfe844
BW
1315
1316This is a major release which includes a lot of new features including
1317improved MIME handling, speedbar folder browsing, and indexed
1318searching. In this version, MH-E runs under XEmacs, passes checkdoc,
1319and compiles clean under all supported platforms.
1320
1321The "passes checkdoc" feature above required changing the name of
1322several user-visible variables. It is likely that this affects you.
1323Please be sure to see the table at the end of these notes and rename
1324your variables accordingly.
1325
1326MH-E has been written mh-e, Mh-e, MH-e and MH-E. We have decided that
1327the proper term should be MH-E. Please try to use MH-E in your
1328writing.
1329
1330** New Features in MH-E 7.0
1331
1332*** Speedbar
1333
1334There is now support for the speedbar. Try "M-x speedbar" (closes SF
177c0ea7 1335#503727).
bdcfe844
BW
1336
1337Press the middle mouse button on the `+' icons to open a folder,
1338middle mouse button on a folder name to open the folder. Folders with
1339unseen messages are shown in bold, so this is a handy way to browse
1340new messages that you have filed with procmail or slocal.
1341
1342See the new customization variable `mh-large-folder,' which controls
1343when the speedbar asks for how many messages to scan when opening a
1344large folder and `mh-speed-run-flists-flag' whose default value of t
1345means to use the flists command to populate the count of unseen and
1346total messages in each folder.
1347
1348*** Indexed Search
1349
1350Interoperability with swish++, swish, glimpse, and namazu has been
1351added to enable lightening-fast searches of your mail. If none of
1352these are present, grep is used. Try "F i (mh-index-search)".
1353
1354For more information, read the documentation for the functions
1355`mh-swish++-execute-search,' `mh-swish-execute-search,'
1356`mh-namazu-execute-search,' or `mh-glimpse-execute-search' depending
1357on your preferred indexing program to see what kind of setup is needed
1358to generate the index.
1359
1360*** Threading
1361
1362Use "T t (mh-toggle-threads)" to view the threads in the folder. Use
1363it again to return to a non-threaded view.
1364
1365*** Brief Help
1366
1367Use "? (mh-help)" and "X ? (mh-prefix-help)," where X is a prefix
1368character, for a brief synopsis in the minibuffer of frequently used
1369commands. In the MH-Letter or MH-Pick buffers, use "C-c ? (mh-help)"
1370(closes SF #493740).
1371
1372*** Folder Keymap Shared by Show Buffer
1373
1374You can now use the MH-Folder mode commands from the MH-Show buffer.
1375Because of this, the MH-Show buffer is now read-only (closes SF
1376#493749 and SF #527946) and you now have to use "M (mh-modify)" to
1377edit a message.
c3d9274a 1378
bdcfe844
BW
1379*** Better Scanning
1380
1381You no longer have to modify your scan format if your folders have
1382more than 9999 messages in them. If you've only modified your scan
1383format file to allow for the wider message numbers, consider using the
1384default behavior of MH-E and simplify your MH-E configuration
1385considerably (closes SF #635791).
1386
1387To do this, you may have to remove your modifications of
1388`mh-scan.*-regexp' and `mh-cmd-note' and your customization of
1389`mh-scan-format-file'.
1390
1391You may still want the updated format files for running MH commands
1392outside of MH-E; the default of `mh-scan-format-file' will cause them
1393to be ignored.
1394
1395If you prefer fixed-width message numbers, set the new customization
1396variable to nil , set this variable to
1397nil and call `mh-set-cmd-note' with the width specified by the scan format in
1398`mh-scan-format-file'. For example, the default width is 4, so you would use
1399"(mh-set-cmd-note 4)" if `mh-scan-format-file' were nil.
1400
1401*** X-Face
1402
1403MH-E now displays the content of the X-Face header field in the From
1404field. When sending a message, an X-Face field is appended to the
1405header if it doesn't already exist and "~/.face" is present. See the
1406new customization variables `mh-show-use-xface-flag' and `mh-x-face-file'
1407(closes SF #480770).
1408
1409MH-E depends on the external x-face package found in
1410ftp://ftp.jpl.org/pub/elisp/ to do this. The `uncompface' binary is
1411also required to be in the execute PATH. It can be obtained from:
1412http://freshmeat.net/redir/compface/1439/url_tgz/compface-1.4.tar.gz.
1413
1414It has also been observed that if you don't see the faces, you might
1415have to do this (for unknown reasons):
177c0ea7 1416
bdcfe844
BW
1417 mv /usr/local/include/compface.h /usr/include/
1418
1419*** Graphical Smileys
1420
1421Smiley's are now converted to cute little images. See the new
1422customization variable `mh-graphical-smileys-flag.'
1423
1424*** Text Emphasis
1425
1426ASCII formatting is now converted to the appropriate font. For
1427example, _underline_ is underlined, *bold* appears in bold, /italic/
1428appears in italic, etc. See `gnus-emphasis-alist' for the whole list.
1429See the new customization variables `mh-decode-mime' and
1430`mh-graphical-emphasis-flag.'
1431
1432*** Attachment Handling
1433
1434Inline attachments are now displayed. Regular attachments appear as
1435buttons in show buffer. Use "K TAB (mh-next-button)" or "K SHIFT-TAB
1436(mh-prev-button)" to cycle through these buttons. Use "K v
1437(mh-folder-toggle-mime-part)" to view, "K o
1438(mh-folder-save-mime-part)" to save one part or "K-a
1439(mh-save-mime-parts)" to save all parts, or "K i
1440(mh-folder-inline-mime-part)" to view the attachment inline.
1441
1442See the new customization variable `mh-decode-mime' for additional
1443information. Other customization variables that affect this new feature
1444include `mh-store-mime-parts-default-directory' and
1445`mh-display-buttons-for-inline-parts-flag'.
1446
1447HTML documents can be viewed inline if Gnus v5.10 and w3 or w3m lisp
1448packages are present. Set the customization variable
1449`mm-text-html-renderer' accordingly (closes SF #453352).
1450
1451*** Quoted-printable Handling
1452
1453Quoted-printable body parts are now decoded.
1454
1455*** More Choices for `mh-yank-from-start-of-msg'
1456
1457Historically, if this variable was t, the entire message, with full
1458headers would be included and every line would begin with
1459`mh-ins-buf-prefix.' This usage is deprecated in favor of the setting
1460`supercite' below. The default has been changed to `attribution.' The
1461following symbols are now understood:
1462
1463`body': yank the message minus the header.
1464
1465`supercite': include the entire message, with full headers. This also
1466causes the invocation of `sc-cite-original' without the setting of
1467`mail-citation-hook', now deprecated practice.
1468
1469`autosupercite': do as for `supercite' automatically when show buffer
1470matches the message being replied-to.
1471
1472`attribution': yank the message minus the header and add a simple
1473attribution line at the top.
1474
1475`autoattrib': do as for `attribution' automatically when show buffer
1476matches the message being replied-to.
1477
1478There is a new customization variable called
1479`mh-extract-from-attribution-verb' which is used for attribution which
1480provides a method for setting a different language.
1481
1482*** Use Gnus mml Instead of mhn
1483
1484When inserting attachments into a message draft, Gnus mml directives
1485are now used instead of mhn directives. One beneficial side-effect of
1486this is that attachments can now appear inline as well as separate.
1487
1488The new customization variable `mh-compose-insertion' controls whether
1489Gnus or mhn is used to insert MIME message directives in messages
1490(default: 'gnus, if the mml library exists).
1491
1492*** Content-Type Now Obtained Automatically
1493
1494The value of the Content-Type no longer needs to be entered by the
1495user.
1496
1497*** Attachments Automatically Included Upon Send
1498
1499You no longer have to run "C-c C-e (mh-edit-mhn)" before sending a
1500message with attachments--this is done automatically when you send the
1501message with "C-c C-c (mh-send-letter)". There is, however, a new key
1502binding "C-c C-m m (mh-mml-to-mime)" which is analogous to "C-c C-e
1503(mh-edit-mhn)".
1504
1505*** GPG Handling
1506
1507Messages that have been signed or encrypted with GPG are verified and
1508decrypted automatically. To sign or encrypt a message, use "C-c RET
1509C-s (mh-mml-secure-message-sign-pgpmime)" and "C-c C-m C-e
1510(mh-mml-secure-message-encrypt-pgpmime)." You need Gnus version 5.10
1511for this feature. These functions are provided by the pgg.el package.
1512
1513Users report "flashing" with the pgg.el package and prefer the gpg.el
1514package instead. To use gpg.el instead of the pgg.el package you need:
1515
1516 (setq mml2015-use 'gpg)
1517
1518To mimic automatic encryption in gpg.el, use:
1519
1520 (setq mm-verify-option 'always)
1521 (setq mm-decrypt-option 'always)
1522
1523The venerable mailcrypt package is also an option. However, now that
1524show buffers are read-only, mailcrypt version 3.5.6 and older fail
1525when they attempt to decrypt the contents.
1526
1527*** Mail-Followup-To Header Field
1528
1529Support for this controversial field has been added because nmh
1530supports it (closes SF #627035). If you want to add it to outgoing
1531mail for selected mailing lists, add those mailing lists to the new
1532customization variable `mh-insert-mail-followup-to-list.' If you think
1533this field is evil, set the new customization variable
1534`mh-insert-mail-followup-to-flag' to nil.
1535
1536*** Gnus Issues
1537
1538If you update Gnus, you must recompile MH-E. Note that if you are
1539running the stock version of MH-E that comes with Emacs or the MH-E
1540package on a Debian GNU/Linux, this is done for you.
1541
1542** New Variables in MH-E 7.0
1543
1544New customization variables not mentioned earlier include:
1545
1546*** mh-letter-insert-signature-hook
1547
1548Invoked at the beginning of the "C-c C-s (mh-insert-signature)"
1549command. Can be used to determine which signature file to use based on
1550message content. On return, if `mh-signature-file-name' is non-nil
1551that file will be inserted at the current point in the buffer.
1552
1553*** mh-show-maximum-size
1554
1555Maximum size of message (in bytes) to display automatically. Provides
1556an opportunity to skip over large messages which may be slow to load.
1557Use a value of 0 to display all messages automatically regardless of
1558size (closes SF #488696).
1559
1560*** mh-tool-bar-reply-3-buttons-flag
1561
1562Non-nil means use three buttons for reply commands in tool-bar. If you
1563have room on your tool-bar because you are using a large font, you may
1564set this variable to expand the single reply button into three buttons
1565that won't lead to minibuffer prompt about who to reply to.
1566
1567** Bug Fixes in MH-E 7.0
1568
1569*** mh-delete-msg, mh-refile-msg, mh-undo
1570
1571Mandrake Linux includes XEmacs initialization code that binds
1572`transient-mark-mode' which causes problems in MH-E. These problems
1573have been fixed (closes SF #541915).
1574
1575*** mh-edit-again
1576
1577This would sometimes yield a read-only buffer. This has been fixed
1578(closes SF #624283 and SF #625538).
1579
1580*** mh-forward
1581
1582When using nmh, always specify -mime so as to preserve the original
1583message(s).
1584
1585*** mh-inc-folder
1586
1587If you had narrowed to a sequence and then incorporated new mail,
1588those new messages would not be present in your +inbox when you
1589widened. This has been fixed (closes SF #489430, SF #489437, SF
1590#629233).
1591
1592*** mh-insert-letter
1593
1594No longer uses mhl to include a message as this mangled the header and
1595gave supercite fits (closes SF #629153).
1596
1597*** mh-letter-mode
1598
1599"M-q (fill-paragraph)" now fills quoted paragraphs (for example,
1600starting with "> ") correctly (closes SF #489927).
1601
177c0ea7 1602*** mh-next-undeleted-msg, mh-previous-undeleted-msg
bdcfe844
BW
1603
1604If there are no more undeleted messages the point remains at its
1605original position and a message is produced (closes SF #494304).
1606
1607*** mh-pick-mode
1608
1609Now calls `mh-pick-mode-hook' as documented.
1610
1611*** mh-put-msg-in-seq
1612
1613Now puts all messages in region in sequence (closes SF #630324).
1614
1615*** mh-refile-msg, mh-write-msg-to-file
1616
1617These functions stomped on the variables that held the name of the
1618last file and folder respectively for the other function. This has
1619been fixed so that the last folder or file name is preserved (closes
1620SF #580772).
1621
1622*** mh-region-to-sequence
1623
1624If the region in MH-Folder was set with "C-x h (mark-whole-buffer)",
1625you couldn't perform operations on all of the messages as you would
1626expect. This has been fixed (closes SF #621632).
1627
1628*** mh-reply
1629
1630Performing an undo the first thing after replying would blank out the
1631entire draft. Now just the insertion of the yanked message is undone
1632leaving the header and signature intact for additional editing (closes
1633SF #623693).
1634
1635*** mh-show-mode
1636
1637Now calls `mh-show-mode-hook' as documented (closes SF #627222).
1638
1639*** mh-subject-thread-to-sequence
1640
1641Make 'subject sequence a real one, exported to MH. This means you can,
1642for example, mh-forward it. But it also shows up with a mark in the
1643scan output (closes SF #489445).
1644
1645*** Other Bug Fixes
1646
1647The following bugs have also been closed:
1648
1649SF #495450: Folder buffer read-only after inc
1650SF #489706: mh-page-msg bombs out
1651SF #580772: mh-last-destination is overloaded
1652
1653*** Variables renamed to conform with Emacs coding conventions
1654
1655The coding conventions require that boolean variables end in -flag.
1656The following two tables show which variables were affected (closes SF
1657#627015).
1658
1659Customization Variables (defcustom)
1660
1661Old Name New Name
1662
1663mh-auto-folder-collect mh-auto-folder-collect-flag
1664mh-bury-show-buffer mh-bury-show-buffer-flag
1665mh-clean-message-header mh-clean-message-header-flag
1666mh-decode-quoted-printable mh-decode-quoted-printable-flag
1667mh-delete-yanked-msg-window mh-delete-yanked-msg-window-flag
1668mh-do-not-confirm mh-do-not-confirm-flag
1669mh-highlight-citation-p mh-highlight-citation
1670mh-insert-x-mailer-p mh-insert-x-mailer-flag
1671mh-print-background mh-print-background-flag
1672mh-recenter-summary-p mh-recenter-summary-flag
1673mh-recursive-folders mh-recursive-folders-flag
1674mh-reply-show-message-p mh-reply-show-message-flag
1675mh-show-use-goto-addr mh-show-use-goto-addr-flag
1676mh-update-sequences-after-mh-show mh-update-sequences-after-mh-show-flag
1677
1678Regular Variables (defvar)
1679
1680Old Name New Name
1681
1682mh-mhn-compose-insert-p mh-mhn-compose-insert-flag
1683mh-nmh-p mh-nmh-flag
1684mh-page-to-next-msg-p mh-page-to-next-msg-flag
1685
1686\f
1687
a1b4049d 1688* Changes in mh-e 6.1
a933dad1 1689
a1b4049d
BW
1690This is a minor release which includes a few bug fixes. The
1691distribution now includes the ChangeLog.
a933dad1 1692
a1b4049d 1693** New Features in mh-e 6.1
a933dad1 1694
a1b4049d
BW
1695*** Fontification
1696
1697Unseen messages now displayed in bold.
1698
1699*** Viewing folders and sequences
1700
1701The folder and sequence listings that "F l (mh-list-folders)" and "S l
1702(mh-list-sequences)" create are now displayed in view mode.
1703
1704** Bug Fixes in mh-e 6.1
1705
1706*** mh-folder-unseen-seq-name
1707
1708Byte compilation failed when initializing this variable when the
1709user's MH environment was not set up. This has been fixed (closes
1710Debian #140232 and Debian #140817).
1711
1712*** mh-forward
1713
1714When forwarding a sequence, the mode of the draft would not be set to
1715MH-Letter correctly. This has been fixed (closes SF #489448).
1716
1717*** mh-insert-prefix-string
1718
1719Fixed to work under XEmacs. Thanks to Will Partain
1720<partain at dcs.gla.ac.uk>.
1721
1722*** mh-quit
1723
bdcfe844 1724mh-quit now cleans up the buffers named `mh-temp-buffer,'
a1b4049d
BW
1725'mh-temp-folders-buffer' and 'mh-temp-sequences-buffer.'
1726
1727\f
1728* Changes in mh-e 6.0
1729
1730mh-e is now maintained at SourceForge (see
1731http://mh-e.sourceforge.net/). This is where you need to go to obtain
1732new versions of mh-e, report bugs and receive support.
1733
1734The maintainers have moved much of their personal configurations into
1735the codebase, so you may find that you may be able to reduce your mh-e
1736customizations as well.
1737
1738There are several incompatibilities in this version from older
1739versions. Please read the following notes carefully for details. Pay
1740particular attention to the key binding changes in the MH-Folder
1741section. If you have customized your scan format, you will want to
1742read about the new variable `mh-scan-format-file'.
1743
1744The manual could not be updated in time for this release. It will be
1745updated in the near future. If the Preface in your manual indicates
1746the older version (version 1.3, for mh-e version 5.0.2), please check
1747the following page occasionally for an update:
1748
1749 https://sourceforge.net/project/showfiles.php?group_id=13357
1750
1751
1752** New Features in mh-e 6.0
1753
1754*** Customization
1755
1756mh-e now uses the customize feature of Emacs. Use "M-x customize-group
1757mh RET" to customize mh-e.
1758
1759*** Menus
1760
1761All mh-e modes now provide menus that contain most mh-e functions.
1762
1763*** Toolbars
1764
1765All mh-e modes now have toolbar buttons for oft-used functions (Emacs 21).
1766
1767*** Fontification
1768
1769All mh-e buffers now have font-lock keywords. To use, either call
1770(turn-on-font-lock) from the appropriate hook, or set
1771`global-font-lock-mode' to t. To customize, use "M-x
1772customize-apropos-faces ^mh RET".
1773
1774If you have customized your scan lines, you will have to update your
1775scan regexps. The existing regexps were changed to extract a match so
1776you will have to add appropriate grouping constructs to take advantage
1777of the fontification. Your old settings will continue to work, but the
1778folder will not be fontified. For example:
1779
1780 (setq mh-good-msg-regexp "^\\(.....\\)[^D^]")
1781
1782You will most likely have to update the new variable
1783`mh-scan-subject-regexp' as well. There is another new variable
1784`mh-scan-date-regexp' which you may also find useful. Run "M-x apropos
1785mh.*regexp" for a complete list.
1786
1787*** mail-user-agent support
1788
1789You can now set `mail-user-agent' to `mh-e-user-agent' so that packages
1790that need to send mail will use mh-e (closes SF #406883, SF #470024).
1791
1792*** replgroupcomps support
1793
1794If you reply to `cc' or `all' and you use nmh, the nmh repl option
1795-group will be used. This means that the file `replgroupcomps' will be
1796used. If you have customized `replcomps', you will definitely want to
1797either copy `$NMH_LIB/replgroupcomps' to your mail directory and modify
1798it the same way that you modified your `replcomps' file, or simply
1799copy your `replcomps' file to `replgroupcomps'.
1800
1801*** MH-Folder mode
1802
1803The variable `mh-summary-height' used to have a default of 4. It now
1804varies from 4 to 10 depending on the height of the frame.
1805
1806Clicking the mouse on a message shows that message.
1807
1808Delete, refile and undo now operate on a region (but only if
1809`transient-mark-mode' is non-nil).
1810
1811SPC (mh-page-msg) now displays the message if it is not already
1812visible. If the bottom of a message is showing, SPC (mh-page-msg)
1813moves to the next message (respecting the direction you are moving
1814through the folder).
1815
177c0ea7 1816The threading commands "T u (mh-next-unseen-subject-thread)",
a1b4049d
BW
1817"T t (mh-toggle-subject-thread)", "T s (mh-narrow-to-subject-thread)",
1818and "T k (mh-delete-subject-thread)" have been added. These functions
1819do not offer threading in the true sense of the word, but do allow
1820some manipulation by subject.
1821
1822Major, major keymap changes. This was done to free up movement
1823commands in the buffer, and to provide for additional features, such
1824as the threading commands. At the same time, better and more
1825consistent mnemonics were realized that should make it easier to
1826remember key bindings.
1827
1828Added new sub-keymaps for folder commands, sequence commands,
1829extraction commands, and digest commands which begin with with F, S,
1830X, and D, respectively. These sub-keymaps allowed some consistency
1831(e.g., especially with l(ist) and k(ill)).
1832
1833Here are the actual changes and rationale:
1834
1835Old New Rationale
1836
1837e - Deleted. Already have x. Now used by mh-edit-again.
1838j - Deleted. Already have g.
1839
1840M-a e Better mnemonic. Matches rmail. Frees movement command.
1841M-e E Better mnemonic. Consistent with e.
1842- S Why not? mh-sort-folder.
1843
1844M-f Fv Frees movement command
1845M-f Ff Alias (keep?)
1846M-f Fo Alias (keep?)
1847M-k Fk No reason but to keep with folder commands
1848M-l Fl No reason but to keep with folder commands
1849M-p Fp No reason but to keep with folder commands
1850M-r Fr Frees movement command
1851M-s Fs No reason but to keep with folder commands
1852M-u Fu No reason but to keep with folder commands
1853
1854M-% Sd Better mnemonic
1855M-# Sk Better mnemonic
1856M-q Sl Better mnemonic
1857C-xn Sn Frees up standard key binding
1858% Sp Better mnemonic for putting a message in a sequence
1859? Ss Shows sequences that message is in
1860C-xw Sw Frees up standard key binding
1861
1862M-n Xs Better mnemonic (extract shar)
1863M-n Xu Better mnemonic (extract uuencode)
1864
1865M-SPC D SPC Frees mark command
1866M-\177 D \177 No reason but to keep with digest commands
1867M-b Db Frees movement command
1868
1869As the number of variables increases, it is becoming important to
1870organize the mh-e namespace. Several variables having to do with the
1871format of scan lines were renamed, as follows:
1872
1873Old New
1874
1875mh-good-msg-regexp mh-scan-good-msg-regexp
1876mh-deleted-msg-regexp mh-scan-deleted-msg-regexp
1877mh-refiled-msg-regexp mh-scan-refiled-msg-regexp
1878mh-valid-scan-line mh-scan-valid-regexp
1879mh-cur-scan-msg-regexp mh-scan-cur-msg-number-regexp
1880- mh-scan-cur-msg-regexp
1881- mh-scan-rcpt-regexp
1882- mh-scan-format-regexp
1883mh-msg-number-regexp mh-scan-msg-number-regexp
1884mh-msg-search-regexp mh-scan-msg-search-regexp
1885
1886*** MH-Show mode
1887
1888While the MIME support is not complete, quoted-printable body parts
1889are now decoded.
1890
1891Some MTAs quote From at the beginning of the line with a ">". The ">"
1892is now removed in the display, but not on disk.
1893
1894*** MH-Letter mode
1895
1896New function "C-c C-o (mh-split-line)" splits lines in a draft
1897preserving the fill prefix and indentation. This is useful when
1898responding to several sentences in a single paragraph separately.
1899
1900"M-q (fill-paragraph)" can now be used on the message that is being
1901replied to. The fill prefix such as "> " is preserved.
1902
1903You no longer have to run "C-c C-e (mh-edit-mhn)" manually as this is
1904now done automatically when the message is sent.
1905
1906The X-Mailer header field is now added to messages as they are sent.
1907
1908"C-c C-m C-i (mh-mhn-compose-insertion)" now makes a pretty good guess
1909at the type of file using the `file' command and no longer asks the
1910user for the media type. If the necessary version of `file' is not
1911available, the user is asked for the media type as before; however,
1912the list of media types is now taken from the system mailcap if
1913available. Failing that, the built-in list of types has been
1914supplemented so in most cases the type you need should be present
1915(closes SF #406883, #441179).
1916
1917** New Variables in mh-e 6.0
1918
1919New variables not mentioned earlier include:
1920
1921*** mh-insert-x-mailer-p
1922
1923Default value of t means that an X-Mailer header field should be
1924added.
1925
1926*** mh-reply-show-message-p
1927
1928The setting of this variable determines whether the MH show-buffer is
1929displayed with the current message when using mh-reply without a prefix
1930argument. Set it to nil if you already include the message
1931automatically in your draft using "repl: -filter repl.filter" in
1932"~/.mh_profile."
1933
1934*** mh-scan-format-file
1935
1936Specifies the format file to pass to the scan program. If t, the
1937format string will be taken from the either `mh-scan-format-mh' or
1938`mh-scan-format-nmh' depending on whether MH or nmh is in use. If nil,
1939the default scan output will be used.
1940
1941If you customize the scan format, you may need to modify a few
1942variables containing regexps that mh-e uses to identify specific
1943portions of the output. Use `M-x apropos RET mh-scan.*regexp' to
1944obtain a list of these variables.
1945
1946*** mh-scan-format-mh
1947
1948Scan format string for MH, provided to the scan program via the
1949-format arg. This format is identical to the default except that
1950additional hints for fontification have been added to the sixth
1951column.
1952
1953*** mh-scan-format-nmh
1954
1955Scan format string for nmh, provided to the scan program via the
1956-format arg. This format is identical to the default except that
1957additional hints for fontification have been added to the sixth
1958column.
1959
1960*** mh-show-use-goto-addr
1961
1962Non-nil means URLs and e-mail addresses are highlighted using
1963goto-addr in MH-Show buffer.
1964
1965*** mh-letter-fill-column
1966
1967Fill column to use in `mh-letter-mode'. This is useful to make the
1968lines a bit shorter to allow for quoting in replies.
1969
1970*** mh-folder-updated-hook
1971
1972Invoked when the actions in a folder (such as moves and deletes) are
1973performed. Variables that are useful in this hook include
1974`mh-delete-list' and `mh-refile-list' which can be used to see which
1975changes are being made to current folder, `mh-current-folder'.
1976
1977*** mh-unseen-updated-hook
1978
1979Invoked after the unseen sequence has been updated. The variable
1980`mh-seen-list' can be used to obtain the list of messages which will
1981be removed from the unseen sequence
1982
1983** Bug Fixes in mh-e 6.0
1984
1985*** mh-edit-again and mh-extract-rejected-mail
1986
1987Now insert a header separator (--------) which packages such as
1988mailcrypt expect.
1989
1990*** mh-find-progs
1991
1992Now uses `mhparam' to set `mh-lib-progs' and `mh-lib'. Added more
1993directories to `mh-progs' so that mh-e can autoconfigure in more
1994environments. Chances are that you no longer have to set these
1995variables, and if you do, you will only have to set `mh-progs'.
1996Unless, of course, you are using an ancient version of MH that doesn't
1997have `mhparam'.
1998
1999*** mh-folder-mode-map
2000
2001The DEL/<delete>/<backspace> change in Emacs 21 broke
2002`mh-previous-page'. This has been fixed (closes SF #228907).
2003
2004*** mh-forward
2005
2006If you had "forw: -mime" to your .mh_profile, forwarding a message
2007resulted in:
2008
2009 Search failed: "^------- Forwarded Message"
2010
2011In addition, the Subject field was not filled in. This has been fixed
2012(closes SF #223603).
2013
2014*** mh-kill-folder
2015
2016The user is now always prompted before this action; the variable
2017`mh-do-not-confirm' is no longer consulted here. Therefore users who
2018wanted to set `mh-do-not-confirm' but didn't because of the
2019`mh-kill-folder' dependency may now do so.
a933dad1 2020
a1b4049d
BW
2021*** mh-make-folder-mode-line
2022
2023Properly deals with folders that do not have any lines in them. Prints
2024"no msgs" instead of "0 msgs". Does not try to print a range when
2025there are no messages.
2026
2027*** mh-mhn-compose-insertion
2028
2029Now gets the MIME type automatically (assuming the local file command
2030supports the -i and -b options). If this use of the file command is
2031not supported, the list of MIME types has been expanded to use the
2032system's mailcap file.
2033
2034*** mh-nmh-p
2035
2036This variable (t when nmh is in use rather than MH) assumed that the
2037string "nmh" is in `mh-lib-progs' or `mh-lib'. This has been fixed
2038(closes SF #441776).
2039
2040*** mh-refile-msg
2041
2042No longer lets you specify an empty folder (closes SF #476824).
2043
2044*** mh-regenerate-headers
2045
2046Now suppresses "scan: bad message list" messages.
2047
2048*** mh-print-msg
2049
2050This function was looking for `mhl' in the wrong place on nmh on
2051Redhat LINUX 7.0. This has been fixed (closes SF #481128).
2052
2053*** mh-show
2054
2055Now updates `cur' sequence after a message is shown (closes SF #481772).
2056
2057*** mh-showing
2058
2059Renamed variable and function to `mh-showing-mode' to conform with
2060minor mode conventions. Added optional arg to function so it would
2061behave like a normal minor mode: no or nil arg toggles mode, 0 arg
2062turns off, non-nil turns on. This fixed the error that occurred when
2063`desktop-create-buffer' recreated mh-e buffers because it was calling
2064`mh-showing' with an arg.
2065
2066*** mh-version
2067
2068Fixed for nmh. Now displays mh-e version correctly. Cleaned up output
2069and display `mh-progs', etc.
2070
2071*** mh-widen
2072
2073Now attempts to stay on the same message number (closes SF #480922).
2074
2075No longer wipes out pending deletes and refiles without warning
2076(closes SF #481036).
2077
2078\f
2079* Changes in mh-e 5.0.2
2080
2081This version contains additional minor changes to integrate it with
a933dad1
DL
2082reporter.el (requires reporter.el version 3.1c or later) and Emacs
208319.30. The mh-goto-msg function is much faster, which also speeds up
2084several other operations.
2085
a1b4049d
BW
2086\f
2087* Changes in mh-e 5.0.1
2088
2089This version contains minor changes from mh-e 5.0 to integrate it with
2090Emacs 19.29.
2091
2092\f
2093* User-visible changes to mh-e 5.0
2094
2095Note: This being a major release, there are many internal changes.
2096This document lists only changes to the external interfaces of mh-e.
2097
2098When upgrading, you must either explicitly reload the new versions of
2099all mh-e files that are already loaded or restart your Emacs.
a933dad1 2100
a933dad1 2101
a1b4049d
BW
2102** Major Changes and New Features in mh-e 5.0
2103
2104The emphasis for this release has been on consistency and
2105documentation. Many documentation strings were enhanced. Documentation
2106strings were changed to comments for internal functions and variables.
2107
2108*** There is now proper documentation in the form of a 75-page users
2109manual. The Texinfo source is mh-e.texi; the formatted Info document
a933dad1
DL
2110is mh-e.info.
2111
a1b4049d
BW
2112*** There is a new command `mh-update-sequences', which updates MH's
2113idea of what messages are in the Unseen sequence and what is the
2114current folder and message. `mh-quit' calls it. While
2115`mh-execute-commands' has always done this updating as a side effect,
2116the new function is faster.
a933dad1 2117
a1b4049d 2118*** The MH profile entry "Inbox:" is supported.
a933dad1 2119
a1b4049d
BW
2120*** If the show-buffer is modified, the user is queried before mh-e
2121reuses the buffer to show a different message. This buffer is also
a933dad1
DL
2122auto-saved and backed up correctly.
2123
a1b4049d
BW
2124*** `mh-store-buffer' is significantly more robust. It now handles
2125messages created by a wide variety of packaging software. The status
2126message for `uudecode' includes the name of the file created. An error
a933dad1
DL
2127is signaled if the subprocess exits with a non-zero status.
2128
a1b4049d
BW
2129*** `mh-search-folder' behaves predictably, adding messages found to
2130the `search' sequence. It correctly handles the case of no messages
2131found.
2132
2133*** `mh-burst-digest' (`M-b') now only rescans the part of the folder
2134affected by the burst. It is now much faster in a large folder.
a933dad1 2135
a933dad1 2136
a1b4049d 2137** New Hooks and Customization Variables in mh-e 5.0
a933dad1 2138
a1b4049d
BW
2139*** `mh-default-folder-for-message-function': new name for the old
2140`mh-msg-folder-hook', which wasn't a hook. The old name was confusing,
a933dad1
DL
2141leading people to think they could use `add-hook' with it, when
2142actually `setq' is the correct way.
2143
a1b4049d 2144*** `mh-sortm-args': When this variable is used has changed. Now
a933dad1 2145`mh-sortm-args' is passed if there IS a prefix argument to
a1b4049d 2146`mh-sort-folder'. The assumption is that for arguments you normally
a933dad1
DL
2147want, you would specify them in an MH profile entry.
2148
a1b4049d 2149*** `mh-mhn-args': new hook, a list of additional arguments to pass to
a933dad1
DL
2150the `mhn' program if `mh-edit-mhn' is given a prefix argument.
2151
a1b4049d 2152*** `mh-edit-mhn-hook': new hook called by `mh-edit-mhn', the function
a933dad1
DL
2153that formats MIME messages.
2154
a1b4049d 2155*** `mh-folder-list-change-hook': new hook, called whenever the cached
a933dad1
DL
2156list of folders, `mh-folder-list', is changed.
2157
a1b4049d 2158*** `mh-find-path-hook': new hook, called when entering mh-e.
a933dad1 2159
a1b4049d 2160*** `mh-repl-formfile': new variable, used to change the format file
a933dad1
DL
2161used by `mh-reply' from the default of "replcomps".
2162
a1b4049d 2163*** New variables to customize the scan format and notating:
a933dad1
DL
2164`mh-note-deleted', `mh-note-refiled', `mh-note-seq', `mh-note-cur',
2165`mh-note-copied', `mh-note-printed'.
2166
a933dad1 2167
a1b4049d
BW
2168** Key Binding Changes in mh-e 5.0
2169
2170*** `RET' runs `mh-show' for consistency with the Finder and Info. The
a933dad1
DL
2171old binding `.' still works, but `RET' is now the standard binding.
2172
a1b4049d
BW
2173*** `M-<' now runs `mh-first-msg' for consistency with `M->', which
2174runs `mh-last-msg'.
a933dad1 2175
a1b4049d 2176*** `C-c C-f C-d' in MH-Letter mode moves to a Dcc: header field.
a933dad1 2177
a1b4049d 2178*** `C-c C-f C-r' in MH-Letter mode moves to a From: header field.
a933dad1 2179
a1b4049d 2180*** `g' is now the standard binding for `mh-goto-msg'. The old binding
a933dad1
DL
2181`j' still works.
2182
a933dad1 2183
a1b4049d
BW
2184** Other Improvements and Changes to mh-e 5.0
2185
2186*** `mh-lpr-command-format' no longer passes the "-p" argument to
2187`lpr' by default. The mail header typically has the date anyway.
a933dad1 2188
a1b4049d 2189*** When prompting for a sequence name, if no sequences have been used
a933dad1
DL
2190yet, mh-e will offer the first sequence the current message is in.
2191
a1b4049d 2192*** The patterns of more mailers are recognized by
a933dad1
DL
2193`mh-extract-rejected-mail'.
2194
a1b4049d 2195*** `mh-insert-prefix-string' no longer wraps the call to the
a933dad1
DL
2196`mail-citation-hook' function in a `save-excursion' so the hook writer
2197can choose whether to leave point at the beginning or the end of the
2198yanked text.
2199
a1b4049d
BW
2200*** `mh-write-msg-to-file': The prompt now refers to "message" or
2201"message body" depending on which will be written. (This is controlled
2202by a prefix argument.) The file defaults to the last-used file instead
a933dad1
DL
2203of supplying only the directory name.
2204
a1b4049d
BW
2205*** mh-e uses message ranges when running MH commands. Thus "rmm 1 2 3
22064 6" is now "rmm 1-4 6". This change makes it less likely to overflow
a933dad1
DL
2207system argument list limits, and it might be faster, too.
2208
a933dad1 2209
a1b4049d
BW
2210** Bug Fixes to mh-e 5.0
2211
2212*** mh-e's idea of the unseen sequence now stays in sync with MH's
a933dad1
DL
2213better.
2214
a1b4049d
BW
2215*** Functions that are supposed to find fields in the message header
2216no longer look in the message body.
a933dad1 2217
a1b4049d
BW
2218*** mh-e would sometimes fail to remove the "%" from a scan line when
2219the message was removed from a sequence if the message was also in the
a933dad1
DL
2220Previous sequence.
2221
a1b4049d 2222*** The variable `mh-inc-prog' is now correctly used in all places.
a933dad1 2223
a1b4049d 2224*** `mh-pipe-msg' runs the process in the correct directory.
a933dad1 2225
a1b4049d 2226*** A partially scanned folder will no longer lose the "/select"
a933dad1
DL
2227annotation when you execute marked deletes and refiles with `x'.
2228
a1b4049d
BW
2229\f
2230* Changes to mh-e 4.0
2231
2232This file is automatically generated from news-mh-e.txinfo. Do not edit.
2233
2234[MH-E-ONEWS has been incorporated here and removed. news-mh-e.txinfo
2235is no longer available.]
2236
2237Note: there are many internal changes to mh-e in this release. If you
2238have the previous version loaded into your Emacs, you will probably not
2239be able to load this version on top of it.
2240
2241** New Features in mh-e 4.0
2242
2243*** Background folder collection. The first time you are prompted for
2244a folder, you must wait while mh-e collects the names of all existing
2245folders. Now however, if you abort, collecting will continue in the
2246background, and you can do something else in Emacs until the
2247collection completes. Normally, mh-e will begin collecting folders
2248names in the background when you first load it; you can disable this
2249feature by setting `mh-auto-folder-collect' to nil.
2250
2251*** There is support for composing MIME messages using the `mhn'
2252program from MH 6.8. See the documentation string for mh-edit-mhn.
2253(While composing a letter, type `C-h k C-c C-e'.) See also mhn(1).
2254There is as yet no support for reading MIME messages.
2255
2256*** `mh-show', typically on `.', repositions to the start of the
2257message if the message is already visible. It used to do nothing in
2258this case.
2259
2260*** The function `mh-unshar-msg' is renamed `mh-store-msg'. It now
2261does uudecoding, too. Someday it should do MIME. It remembers the last
2262directory you used and offers it as the default for next time.
2263
2264*** New function `mh-header-display', on `,', displays the message
2265with all headers, including those normally not displayed. Type `.' to
2266display the message normally again.
2267
2268*** New function `mh-list-sequences' lists the sequences in use in the
2269current folder.
2270
2271*** New function `mh-version' displays version information about MH
2272and mh-e. Please use the output in bug reports.
2273
2274*** `mh-quit' now burys the folder buffer and show buffer.
2275
2276
2277** New hooks and customization variables in mh-e 4.0
2278
2279*** `mh-pick-mode-hook': new hook called by new mode `mh-pick-mode'.
2280The pick buffer didn't used to have its own mode. Another advantage of
2281`mh-pick-mode' is that `C-h m' works in the pick buffer.
2282
2283*** `mail-citation-hook': new variable for supercite.
2284
2285*** `mh-refile-msg-hook': new hook called by `mh-refile-msg' (and
2286`mh-refile-or-write-again' when refiling).
2287
2288*** `mh-msg-folder-hook': new hook used by `mh-refile-msg' and
2289`mh-to-fcc' to provide a default folder for user prompt.
2290
2291*** `mh-show-hook': new hook called by `mh-show'.
2292
2293*** `mh-delete-msg-hook': new hook called by `mh-delete-msg'.
2294
2295*** `mh-show-mode-hook': new hook called by new mode `mh-show-mode'
2296for `show-' buffers.
2297
2298*** `mh-comp-formfile': new variable so can customize `components'
2299file.
2300
2301*** `mh-sortm-args': new variable, a list of extra arguments to be
2302passed to sortm by `mh-sort-folder'. Give an argument to
2303`mh-sort-folder' to suppress this behavior.
2304
2305*** `mh-send-prog': new variable so can customize name of `send'
2306program in case of name conflicts.
2307
2308*** `mh-scan-prog': new variable so can customize name of `scan'
2309program to generate custom effects.
2310
2311*** `mh-inc-prog': new variable so can customize name of `inc' program
2312to do fancy management of incoming messages.
2313
2314*** `mh-forwarded-letter-subject': new function used by `mh-forward'
2315to compute the Subject line of the new message. It is a small function
2316which can be replaced by the user for customization. Uses the new
2317variable `mh-forward-subject-format', which allows some simple
2318customizations without rewriting even `mh-forwarded-letter-subject'.
2319
2320*** `mh-new-draft-cleaned-headers': new variable, header lines removed
2321by `mh-edit-again' and `mh-extract-rejected-mail' before offering a
2322message as a new draft.
2323
2324*** `mh-signature-file-name': new variable used by
2325`mh-insert-signature' to so can customize name of the file to insert.
2326
2327*** `mh-read-address': new function called to read all To: and Cc:
2328addresses.
2329
2330*** `mh-msg-folder-hook': new hook used by `mh-refile-msg' and
2331`mh-to-fcc' to provide a default folder for user prompt.
2332
2333
2334** Key binding changes in mh-e 4.0
2335
2336*** `,' runs new function `mh-header-display'. It is like `.' but it
2337displays *all* the headers.
2338
2339*** `M-#' runs the new function `mh-delete-seq'. One used to have to
2340type `C-u M-%' to delete a sequence.
2341
2342*** `<' no longer does `mh-first-msg', but `M->' now does
2343`mh-last-msg'. This allows first and last to be consistent (`>' was
2344taken) and is more likely to be discovered by chance anyway.
2345
2346*** `M-d' runs `mh-redistribute', `r' runs `mh-reply' (on the theory
2347that the more commonly used function should be easier to type, and the
2348obscure action of redistributing can be harder to type).
2349
2350*** `M-o' changed to `C-o' (`mh-write-msg-to-file'). It was
2351interfering with arrow keys for some people.
2352
2353*** `M-n' now runs `mh-store-msg' (formerly `mh-unshar-msg').
2354
2355*** `b' no longer runs `mh-quit'; use `q' instead. `b' may be used in
2356a future version for something else.
2357
2358
2359** Minor improvements to mh-e 4.0
2360
2361*** The mh-e code is now divided into multiple Emacs Lisp files, so it
2362starts up faster because Emacs doesn't have to load all of it at once.
2363(This change also makes it easier for the maintainer to manage
2364things.)
2365
2366*** When searching for the directory containing the MH programs,
2367search the user's PATH in addition to the built-in directories, to
2368increase the chance of finding the MH programs.
2369
2370*** The subject for a forwarded message no longer has ugly square
2371brackets around it.
2372
2373*** The name of the folder is no longer appears twice in the show
2374buffer mode line.
2375
2376*** When typing a folder name in the minibuffer, parent folders
2377complete to the trailing slash (/), for easier typing of subfolders.
2378
2379*** The folder buffer mode name changed from `mh-e scan' or `mh-e
2380show' to `MH-Folder', which makes the hook name easier to guess. Added
2381`mh-showing' to `minor-mode-alist' so there is still an indication in
2382the mode line of whether messages will be shown automatically.
2383
2384*** `mh-rename-seq' does completion on the old sequence name.
2385
2386*** If called by a user who has never used MH on this system before,
2387mh-e runs the MH program `install-mh' to get them set up.
2388
2389*** Undo history for previous messages is not kept to avoid wasting
2390memory.
2391
2392*** The internal temp buffer used by mh-e has `buffer-offer-save'
2393explicitly nil. This change benefits people who change the
2394`buffer-offer-save' default.
2395
2396
2397** Bug fixes to mh-e 4.0
2398
2399*** `mh-to-field': don't bomb if no To: field.
2400
2401*** `mh-get-new-mail': restore annotations, e.g., cur, even if no new
2402mail.
2403
2404*** `mh-rename-seq': verify that the new seq name was accepted by
2405`mark' before updating state.
2406
2407*** `mh-internal-seq': the Previous sequence is not notated, since it
2408would notate everything scanned.
2409
2410*** `mh-read-draft': don't call `find-file-noselect' so an
2411`auto-mode-alist' doesn't trigger `mh-letter-mode-hook' twice. Faster,
2412too.
2413
2414*** `mh-show': If user moves onto a message that doesn't exist, don't
2415leave the cursor in the show pane.
2416
2417*** `mh-delete-scan-msgs': use `equal', not `=', on the result of
2418`mh-get-msg-num', since it may be nil.
2419
2420*** `mh-get-field': do anchored search so searching for `reply-to:'
2421doesn't find `in-reply-to:'.
2422
2423*** `mh-widen': do nothing if not narrowed.
2424
2425*** `mh-clean-message-header': find end of headers even if no body.
2426
2427\f
2428Local variables:
2429mode: outline
2430paragraph-separate: "[ \f]*$"
2431end:
ab5796a9
MB
2432
2433arch-tag: f6696cad-eb1b-4c5f-8057-4e3954a98d18