#
[bpt/emacs.git] / etc / MH-E-NEWS
1 User-visible changes to mh-e in version 5.0 from 4.1.
2
3 Note: This being a major release, there are many internal changes.
4 This document lists only changes to the external interfaces of mh-e.
5
6 When upgrading, you must either explicitly reload the new versions of
7 all mh-e files that are already loaded or restart your Emacs.
8
9 mh-e 5.0.1 contains minor changes from mh-e 5.0 to integrate it with
10 Emacs 19.29.
11
12 mh-e 5.0.2 contains additional minor changes to integrate it with
13 reporter.el (requires reporter.el version 3.1c or later) and Emacs
14 19.30. The mh-goto-msg function is much faster, which also speeds up
15 several other operations.
16
17 Major Changes and New Features in mh-e
18 ======================================
19
20 The emphasis for this release has been on consistency and
21 documentation. Many documentation strings were enhanced.
22 Documentation strings were changed to comments for internal functions
23 and variables.
24
25 There is now proper documentation in the form of a 75-page users
26 manual. The Texinfo source is mh-e.texi; the formatted Info document
27 is mh-e.info.
28
29 There is a new command `mh-update-sequences', which updates MH's
30 idea of what messages are in the Unseen sequence and what is the current
31 folder and message. `mh-quit' calls it. While `mh-execute-commands'
32 has always done this updating as a side effect, the new function is
33 faster.
34
35 The MH profile entry "Inbox:" is supported.
36
37 If the show-buffer is modified, the user is queried before mh-e
38 reuses the buffer to show a different message. This buffer is also
39 auto-saved and backed up correctly.
40
41 `mh-store-buffer' is significantly more robust. It now handles
42 messages created by a wide variety of packaging software. The status
43 message for `uudecode' includes the name of the file created. An error
44 is signaled if the subprocess exits with a non-zero status.
45
46 `mh-search-folder' behaves predictably, adding messages found to the
47 `search' sequence. It correctly handles the case of no messages found.
48
49 `mh-burst-digest' (`M-b') now only rescans the part of the folder
50 affected by the burst. It is now much faster in a large folder.
51
52 New mh-e Hooks and Customization Variables
53 ==========================================
54
55 `mh-default-folder-for-message-function': new name for the old
56 `mh-msg-folder-hook', which wasn't a hook. The old name was confusing,
57 leading people to think they could use `add-hook' with it, when
58 actually `setq' is the correct way.
59
60 `mh-sortm-args': When this variable is used has changed. Now
61 `mh-sortm-args' is passed if there IS a prefix argument to
62 `mh-sort-folder'. The assumption is that for arguments you normally
63 want, you would specify them in an MH profile entry.
64
65 `mh-mhn-args': new hook, a list of additional arguments to pass to
66 the `mhn' program if `mh-edit-mhn' is given a prefix argument.
67
68 `mh-edit-mhn-hook': new hook called by `mh-edit-mhn', the function
69 that formats MIME messages.
70
71 `mh-folder-list-change-hook': new hook, called whenever the cached
72 list of folders, `mh-folder-list', is changed.
73
74 `mh-find-path-hook': new hook, called when entering mh-e.
75
76 `mh-repl-formfile': new variable, used to change the format file
77 used by `mh-reply' from the default of "replcomps".
78
79 New variables to customize the scan format and notating:
80 `mh-note-deleted', `mh-note-refiled', `mh-note-seq', `mh-note-cur',
81 `mh-note-copied', `mh-note-printed'.
82
83 Key Binding Changes in mh-e
84 ===========================
85
86 `RET' runs `mh-show' for consistency with the Finder and Info. The
87 old binding `.' still works, but `RET' is now the standard binding.
88
89 `M-<' now runs `mh-first-msg' for consistency with `M->', which runs
90 `mh-last-msg'.
91
92 `C-c C-f C-d' in MH-Letter mode moves to a Dcc: header field.
93
94 `C-c C-f C-r' in MH-Letter mode moves to a From: header field.
95
96 `g' is now the standard binding for `mh-goto-msg'. The old binding
97 `j' still works.
98
99 Other Improvements and Changes to mh-e
100 ======================================
101
102 `mh-lpr-command-format' no longer passes the "-p" argument to `lpr'
103 by default. The mail header typically has the date anyway.
104
105 When prompting for a sequence name, if no sequences have been used
106 yet, mh-e will offer the first sequence the current message is in.
107
108 The patterns of more mailers are recognized by
109 `mh-extract-rejected-mail'.
110
111 `mh-insert-prefix-string' no longer wraps the call to the
112 `mail-citation-hook' function in a `save-excursion' so the hook writer
113 can choose whether to leave point at the beginning or the end of the
114 yanked text.
115
116 `mh-write-msg-to-file': The prompt now refers to "message" or
117 "message body" depending on which will be written. (This is controlled
118 by a prefix argument.) The file defaults to the last-used file instead
119 of supplying only the directory name.
120
121 mh-e uses message ranges when running MH commands. Thus "rmm 1 2 3
122 4 6" is now "rmm 1-4 6". This change makes it less likely to overflow
123 system argument list limits, and it might be faster, too.
124
125 Bug Fixes to mh-e
126 =================
127
128 mh-e's idea of the unseen sequence now stays in sync with MH's
129 better.
130
131 Functions that are supposed to find fields in the message header no
132 longer look in the message body.
133
134 mh-e would sometimes fail to remove the "%" from a scan line when the
135 message was removed from a sequence if the message was also in the
136 Previous sequence.
137
138 The variable `mh-inc-prog' is now correctly used in all places.
139
140 `mh-pipe-msg' runs the process in the correct directory.
141
142 A partially scanned folder will no longer lose the "/select"
143 annotation when you execute marked deletes and refiles with `x'.
144