annotate etc/MH-E-NEWS @ 39960:d0d7ddac8c5e

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