(tooltip-mode): Doc fix.
[emacs.git] / admin / FOR-RELEASE
blob73e6d50df1489128257e142bea1eec71e760b308
1 Tasks needed before the next release.
3 * NEW FEATURES
5 ** Face remapping.
7 ** Let mouse-1 follow links.
9 ** Make Rmail find the best version of movemail.
10 To be done by Sergey Poznyakoff <gray@Mirddin.farlep.net>.
12 ** Make VC-over-Tramp work where possible, or at least fail
13 gracefully if something isn't supported over Tramp.
14 To be done by Andre Spiegel <spiegel@gnu.org>.
16 * FATAL ERRORS
18 ** Investigate face cache related crash.
20 Indications: Face cache seems to have been cleared, but
21 redisplay uses an invalidated face_id with FACE_FROM_ID
22 which then returns a NULL pointer.  Said to happen with
23 isearch faces.
25 ** Investigate reported crashes in compact_small_strings.
27 ** Investigate reported crashes related to using an
28 invalid pointer from string_free_list.
31 * LOSSAGE
33 ** Clean up flymake.el to follow Emacs Lisp conventions.
35 ** Fix up url-ldap.el.
37 * BUGS
39 ** Mailabbrev should quote addresses to correspond to RFC 822.
40 See http://article.gmane.org/gmane.emacs.devel/27585
42 ** The '@' character should not expand addresses in mailabbrev
43 See http://article.gmane.org/gmane.emacs.devel/27585
45 ** Bug in url-http-parse-headers, reported in
46 From: Vivek Dasmohapatra <vivek@zeus.com>
47 Date: Tue, 28 Sep 2004 16:13:13 +0100
49 Fetching a url with url-retrieve can reult in an anrbitrary buffer
50 being killed if a 401 (or possibly a 407) result is encountered:
52 url-http-parse-headers calls url-http-handle-authentication,
53 which can call url-retrieve.
55 This results in the current buffer being killed, and a new http buffer
56 being generated. However, when the old http buffer is killed, emacs
57 picks the top buffer from the list as the new current buffer, so by the
58 time we get to the end of url-http-parse-headers, _that_ buffer is marked
59 as dead even though it is not necessarily a url buffer, so next time the
60 url libraries reap their dead buffers, an innocent bystander buffer is
61 killed instead (and an obsolete http buffer may be left lying around too).
63 A possible fix (which I am currently using) is to call set-buffer
64 on the return value of url-http-parse-headers:
66       (case url-http-response-status
67         (401
68          ;; The request requires user authentication.  The response
69          ;; MUST include a WWW-Authenticate header field containing a
70          ;; challenge applicable to the requested resource.  The
71          ;; client MAY repeat the request with a suitable
72          ;; Authorization header field.
73          (url-mark-buffer-as-dead (current-buffer))
74          (set-buffer (url-http-handle-authentication nil)))
75 etc ....
77 which makes sure that it is the right http buffer that is current when
78 we come to mark the http buffers as dead.
82 * GTK RELATED BUGS
84 ** Make GTK scrollbars behave like others w.r.t. overscrolling.
87 * REDISPLAY RELATED BUGS
89 ** Avoid unbreakable loops in redisplay.
91 Redisplay may loop if there is an error in some display property, e.g.
92      (space 'left-margin)
94 A fix would be to somehow disable handling of display properties if an error
95 is encountered.
98 ** Problem with modeline and window margins:
100 The mode line's right "box" line is misplaced under the right margin,
101 rather than at the right window edge.
103 emacs -Q
104 (set-window-margins nil 25 25)
105 C-x 2
108 ** custom mode-line face makes Emacs freeze up
110 From: Stephen Berman <Stephen.Berman@gmx.net>
111 Date: Sun, 24 Oct 2004 02:08:56 +0200
113 1. Start Emacs with -q -no-site-file.
115 2. Type `M-x customize-face' and at the prompt `mode-line'.
117 3. In the Custom buffer for mode-line face
118    a. check width and give it the value `narrow';
119    b. check height and give it the value 120 in 1/10 pt;
120    c. check underline and give it the value `on' (or `colored');
121    d. check overline and give it the value `on' (or `colored').
123 4. Set for current session.
125 5. Invoke Ediff on any two files.
127 6. Now Emacs is frozen and consumes 95-99% of CPU.
129 The customizations in step 3 appear to be the minimum necessary to
130 induce this bug.  Leave out any one of them and Ediff runs without a
131 problem.  Also if the 1/10 point value of height is 130 or greater
132 there's no bug (with the default font family; with e.g. Helvetica the
133 bug is induced only by a value of 100 or less).
135 I've noticed this freeze up only when invoking Ediff.  The only thing
136 I've been able to do is kill Emacs externally, via top or with kill
137 when run in gdb, after interrupting.  When the freeze up happens
138 within a gdb session, there is no automatic debugging feedback.  After
139 interrupting I can get a backtrace, here's an example:
141 Update: Maybe only reveals itself when compiled with GTK+
144 ** line-spacing and Electric-pop-up-window
146 From: SAITO Takuya <tabmore@rivo.mediatti.net>
147 Date: Mon, 31 May 2004 02:08:10 +0900 (JST)
149 Electric-pop-up-window does not work well
150 if truncate long lines disabled and/or
151 `line-spacing' is set to positive integer.
153 For example, start emacs -Q --line-spacing 1, and type M-` .
154 Then, the last line of *Completions* buffer is not visible.
156 fit-window-to-buffer works well for me, so I guess
157 Electric-pop-up-window can use it.
160 ** Partial highlighting of wrapped overlay
162 From: Ralf Angeli <angeli@iwi.uni-sb.de>
163 Date: Mon, 18 Oct 2004 19:09:19 +0200
165 If you put
167 (let* ((length (+ (- (window-width) (current-column)) 40))
168        (start (point))
169        (end (+ (point) length))
170        (string (make-string length ?x))
171        ov)
172   (insert string)
173   (setq ov (make-overlay start end))
174   (overlay-put ov 'mouse-face 'highlight)
175   (overlay-put ov 'display string))
177 into the *scratch* buffer and type `C-x C-e' with point at the last
178 parenthesis, you will get a string which does not fit into the line
179 and has to be wrapped.  If you move over it with your mouse, you
180 should see that only the part on the second line is being highlighted.
181 The full string is highlighted only if the 'display property is not
182 set.
186 * DOCUMENTATION
188 ** Document Custom Themes.
190 ** Finish updating the Emacs Lisp manual.
192 ** Update the Emacs manual.
194 *** Update man/info.texi.
196 *** Update man/ack.texi.
198 ** Add missing years in copyright notices of all files.
200 ** Update AUTHORS.
202 ** Reorder NEWS entries.
204 ** Check the Emacs manual.
206 Each manual section should be proof-read by at least two people.
207 After each file name, on the same line or the following line, come the
208 names of the people who have checked it.
211 SECTION             READERS
212 -----------------------------
213 man/abbrevs.texi
214 man/anti.texi
215 man/basic.texi      "Luc Teirlinck"
216 man/buffers.texi    "Luc Teirlinck"
217 man/building.texi   "Ted Zlatanov" <tzz@lifelogs.com>
218 man/calendar.texi
219 man/cmdargs.texi
220 man/commands.texi   "Luc Teirlinck"
221 man/custom.texi
222 man/dired.texi
223 man/display.texi    "Luc Teirlinck"
224 man/emacs.texi      "Luc Teirlinck"
225 man/entering.texi   "Luc Teirlinck"
226 man/files.texi      "Luc Teirlinck"
227 man/fixit.texi      "Luc Teirlinck"
228 man/frames.texi     "Luc Teirlinck"
229 man/glossary.texi
230 man/help.texi       "Luc Teirlinck"
231 man/indent.texi     "Luc Teirlinck"
232 man/killing.texi    "Luc Teirlinck"
233 man/kmacro.texi     "Luc Teirlinck"
234 man/macos.texi
235 man/maintaining.texi
236 man/major.texi      "Luc Teirlinck"
237 man/mark.texi       "Luc Teirlinck"
238 man/mini.texi       "Luc Teirlinck"
239 man/misc.texi
240 man/msdog.texi
241 man/mule.texi       "Luc Teirlinck"
242 man/m-x.texi        "Luc Teirlinck"
243 man/picture.texi
244 man/programs.texi
245 man/regs.texi       "Luc Teirlinck"
246 man/rmail.texi
247 man/screen.texi     "Luc Teirlinck"
248 man/search.texi     "Luc Teirlinck"
249 man/sending.texi
250 man/text.texi       "Luc Teirlinck"
251 man/trouble.texi
252 man/windows.texi    "Luc Teirlinck"
253 man/xresources.texi
255 ** Check the Emacs Lisp manual.
257 Each manual section should be proof-read by at least two people.
258 After each file name, on the same line or the following line, come the
259 names of the people who have checked it.
261 SECTION                  READERS
262 ----------------------------------
263 lispref/abbrevs.texi     "Luc Teirlinck"
264 lispref/advice.texi      Joakim Verona <joakim@verona.se>
265 lispref/anti.texi
266 lispref/backups.texi     "Luc Teirlinck"
267 lispref/buffers.texi     "Luc Teirlinck"
268 lispref/calendar.texi    Joakim Verona <joakim@verona.se>
269 lispref/commands.texi    "Luc Teirlinck"
270 lispref/compile.texi     "Luc Teirlinck"
271 lispref/control.texi     "Luc Teirlinck"
272 lispref/customize.texi
273 lispref/debugging.texi   Joakim Verona <joakim@verona.se>
274 lispref/display.texi
275 lispref/edebug.texi
276 lispref/elisp.texi       "Luc Teirlinck"
277 lispref/errors.texi      "Luc Teirlinck"
278 lispref/eval.texi        "Luc Teirlinck"
279 lispref/files.texi       "Luc Teirlinck"
280 lispref/frames.texi      "Luc Teirlinck"
281 lispref/functions.texi   "Luc Teirlinck"
282 lispref/hash.texi        "Luc Teirlinck"
283 lispref/help.texi        "Luc Teirlinck"
284 lispref/hooks.texi
285 lispref/internals.texi   "Luc Teirlinck"
286 lispref/intro.texi       "Luc Teirlinck"
287 lispref/keymaps.texi     "Luc Teirlinck"
288 lispref/lists.texi       "Luc Teirlinck"
289 lispref/loading.texi     "Luc Teirlinck"
290 lispref/locals.texi
291 lispref/macros.texi      "Luc Teirlinck"
292 lispref/maps.texi
293 lispref/markers.texi     "Luc Teirlinck"
294 lispref/minibuf.texi     "Luc Teirlinck"
295 lispref/modes.texi
296 lispref/nonascii.texi    "Luc Teirlinck"
297 lispref/numbers.texi     "Luc Teirlinck"
298 lispref/objects.texi     "Luc Teirlinck"
299 lispref/os.texi          "Luc Teirlinck"
300 lispref/positions.texi   "Luc Teirlinck"
301 lispref/processes.texi
302 lispref/searching.texi   "Luc Teirlinck"
303 lispref/sequences.texi   "Luc Teirlinck"
304 lispref/streams.texi     "Luc Teirlinck"
305 lispref/strings.texi     "Luc Teirlinck"
306 lispref/symbols.texi     "Luc Teirlinck"
307 lispref/syntax.texi      "Luc Teirlinck"
308 lispref/text.texi
309 lispref/tips.texi        "Luc Teirlinck"
310 lispref/variables.texi   "Luc Teirlinck"
311 lispref/windows.texi     "Luc Teirlinck"
314 Local variables:
315 mode: outline
316 end: