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