*** empty log message ***
[emacs.git] / admin / FOR-RELEASE
blobe5e719f903795a90c45ba8ae990e6b5d1e68057b
1 Tasks needed before the next release.
3 * NEW FEATURES
5 ** Test the mbox branch of Rmail.
7 ** Install the mbox branch of Rmail.
9 ** Face remapping.
11 ** Let mouse-1 follow links.
14 * FATAL ERRORS
16 ** Investigate face cache related crash.
18 Indications: Face cache seems to have been cleared, but
19 redisplay uses an invalidated face_id with FACE_FROM_ID
20 which then returns a NULL pointer.  Said to happen with
21 isearch faces.
23 ** Investigate reported crashes in compact_small_strings.
25 ** Investigate reported crashes related to using an
26 invalid pointer from string_free_list.
29 * LOSSAGE
31 ** Clean up flymake.el to follow Emacs Lisp conventions.
34 * GTK RELATED BUGS
36 ** Make GTK scrollbars behave like others w.r.t. overscrolling.
39 * REDISPLAY RELATED BUGS
41 ** Avoid unbreakable loops in redisplay.
43 Redisplay may loop if there is an error in some display property, e.g.
44      (space 'left-margin)
46 A fix would be to somehow disable handling of display properties if an error
47 is encountered.
49 ** Problem with cursor border around images and window-margins:
51 The border around the image when the cursor is on the image
52 flows into the right fringe and margin.
54      (progn
55        (auto-image-file-mode 1)
56        (find-file (concat data-directory "splash.xpm"))
57        (set-window-margins (selected-window) 25 25))
60 ** Problem with modeline and window margins:
62 The mode line's right "box" line is misplaced under the right margin,
63 rather than at the right window edge.
65 emacs -Q
66 (set-window-margins nil 25 25)
67 C-x 2
70 ** custom mode-line face makes Emacs freeze up
72 From: Stephen Berman <Stephen.Berman@gmx.net>
73 Date: Sun, 24 Oct 2004 02:08:56 +0200
75 1. Start Emacs with -q -no-site-file.
77 2. Type `M-x customize-face' and at the prompt `mode-line'.
79 3. In the Custom buffer for mode-line face
80    a. check width and give it the value `narrow';
81    b. check height and give it the value 120 in 1/10 pt;
82    c. check underline and give it the value `on' (or `colored');
83    d. check overline and give it the value `on' (or `colored').
85 4. Set for current session.
87 5. Invoke Ediff on any two files.
89 6. Now Emacs is frozen and consumes 95-99% of CPU.
91 The customizations in step 3 appear to be the minimum necessary to
92 induce this bug.  Leave out any one of them and Ediff runs without a
93 problem.  Also if the 1/10 point value of height is 130 or greater
94 there's no bug (with the default font family; with e.g. Helvetica the
95 bug is induced only by a value of 100 or less).
97 I've noticed this freeze up only when invoking Ediff.  The only thing
98 I've been able to do is kill Emacs externally, via top or with kill
99 when run in gdb, after interrupting.  When the freeze up happens
100 within a gdb session, there is no automatic debugging feedback.  After
101 interrupting I can get a backtrace, here's an example:
103 Update: Maybe only reveals itself when compiled with GTK+
106 ** Mouse-face overlay bleeds into header line
108 From: Stephen Berman <Stephen.Berman@gmx.net>
109 Date: Thu, 21 Oct 2004 18:11:01 +0200
111 Mouse-face overlays bleed into the header line when the beginning of
112 the overlay is above (point-min).  To reproduce:
114 1. Start Emacs with -q -no-site-file.
116 2. In *scratch* eval (setq ov (make-overlay 66 92)), (overlay-put ov
117 'mouse-face 'highlight), and (setq header-line-format "test").
119 3. Drag the mouse over the string "evaluation.\n;; If you want" and
120 notice the highlighting of only this string.
122 4. Now click on the down arrow in the scroll bar until the line
123 beginning ";; If you want" is directly below the header line.
125 5. Drag the mouse over ";; If you want" and notice that not only it
126 but also the header line are highlighted.
129 ** scroll-preserve-screen-position doesn't work with a header-line-format
131 From: jbyler+emacs-lists@anon41.eml.cc
132 Date: Tue, 17 Aug 2004 17:10:14 -0400
134 There seems to be an off-by-one error triggered by using a header line
135 together with scroll-preserve-screen-position.  The symptom: instead of
136 staying in the same position on the screen when scrolling, the cursor
137 moves one screen line down each time the buffer is scrolled.  Put
138 another way: repeatedly typing C-v M-v or using a mouse scroll wheel to
139 scroll up and down causes the cursor to migrate slowly down the screen
140 instead of staying put as it should.
142 To reproduce:
144 emacs -q --no-site-file
145 (setq scroll-preserve-screen-position t)
146 (setq header-line-format "")
147 C-v M-v C-v M-v C-v M-v etc.
150 ** Clicking on partially visible lines fails
152 From: David Kastrup <dak@gnu.org>
153 Date: 27 Apr 2004 16:42:58 +0200
155 I had gnus display a mouse-highlighted line (a URL from browse-url)
156 partially at the bottom of its window.  If I click with middle mouse
157 key on it, the window gets recentered while I hold the mouse key
158 pressed.  If I release it, the window returns into its old position
159 (cursor in top row) and nothing happens, presumably because the click
160 was not registered on the line itself, but on the magically
161 recentered version.
163 That is a nuisance.  Recentering of even partially visible click
164 targets should only happen if window-point moves there, but not at
165 the time of the click.  From the moment I hold down a key until it
166 gets released, the displayed window portion should not change, with
167 the sole exception of scrolling when dragging at the edge of the
168 screen.
171 ** Can't drag modeline when mouse-autoselect-window is set
173 From: Klaus Zeitler <kzeitler@lucent.com>
174 Date: Mon, 11 Oct 2004 11:14:49 +0200
176 1. start emacs -q --no-site-file
177 2. set variable mouse-autoselect-window to t
178 3. split-window-vertically
180 now I can drag the modeline only upwards but not downwards
183 ** line-spacing and (recenter -1)
185 From: SAITO Takuya <tabmore@rivo.mediatti.net>
186 Date: Mon, 31 May 2004 02:07:57 +0900 (JST)
188 (recenter -1) does not show point at the bottom of the window
189 if line-spacing is set to positive integer.
191 Start emacs -Q, and evaluate below:
193 (progn
194   (setq line-spacing 1)
195   (dotimes (i (window-height))
196     (insert "\n" (int-to-string i)))
197   (recenter -1))
199 Then, point is displayed at the center of the window.
200 But point should be displayed at the bottom of the window like Emacs-21.3.
203 ** line-spacing and garbage in fringe
205 From: SAITO Takuya <tabmore@rivo.mediatti.net>
206 Date: Mon, 31 May 2004 02:08:05 +0900 (JST)
208 Start emacs -Q and evaluate below with C-xC-e:
210 (let ((lines 2)
211       (spacing 1))
212   (setq line-spacing spacing
213         indicate-buffer-boundaries t)
214   (insert (make-string (window-height) ?\n))
215   (goto-char (point-min))
216   (message (make-string (* (window-width) lines) ?.))
217   (scroll-up 1))
219 then, garbage is displayed in right fringe.
221 Above code reproduces this bug with
222 (frame-parameter nil 'font)
223 => "-Adobe-Courier-Medium-R-Normal--12-120-75-75-M-70-ISO8859-1"
225 If you use different font, you may need different value of
226 `lines' and/or `spacing'.
229 ** line-spacing and Electric-pop-up-window
231 From: SAITO Takuya <tabmore@rivo.mediatti.net>
232 Date: Mon, 31 May 2004 02:08:10 +0900 (JST)
234 Electric-pop-up-window does not work well
235 if truncate long lines disabled and/or
236 `line-spacing' is set to positive integer.
238 For example, start emacs -Q --line-spacing 1, and type M-` .
239 Then, the last line of *Completions* buffer is not visible.
241 fit-window-to-buffer works well for me, so I guess
242 Electric-pop-up-window can use it.
245 * DOCUMENTATION
247 ** Finish updating the Emacs Lisp manual.
249 ** Update the Emacs manual.
251 *** Update man/info.texi.
253 *** Update man/ack.texi.
255 ** Add missing years in copyright notices of all files.
257 ** Update AUTHORS.
259 ** Reorder NEWS entries.
261 ** Check the Emacs manual.
263 Each manual section should be proof-read by at least two people.
264 After each file name, on the same line or the following line, come the
265 names of the people who have checked it.
268 SECTION             READERS
269 -----------------------------
270 man/abbrevs.texi
271 man/anti.texi
272 man/basic.texi      "Luc Teirlinck"
273 man/buffers.texi    "Luc Teirlinck"
274 man/building.texi   "Ted Zlatanov" <tzz@lifelogs.com>
275 man/calendar.texi
276 man/cmdargs.texi
277 man/commands.texi   "Luc Teirlinck"
278 man/custom.texi
279 man/dired.texi
280 man/display.texi    "Luc Teirlinck"
281 man/emacs.texi      "Luc Teirlinck"
282 man/entering.texi   "Luc Teirlinck"
283 man/files.texi      "Luc Teirlinck"
284 man/fixit.texi      "Luc Teirlinck"
285 man/frames.texi     "Luc Teirlinck"
286 man/glossary.texi
287 man/help.texi       "Luc Teirlinck"
288 man/indent.texi     "Luc Teirlinck"
289 man/killing.texi    "Luc Teirlinck"
290 man/kmacro.texi     "Luc Teirlinck"
291 man/macos.texi
292 man/maintaining.texi
293 man/major.texi      "Luc Teirlinck"
294 man/mark.texi       "Luc Teirlinck"
295 man/mini.texi       "Luc Teirlinck"
296 man/misc.texi
297 man/msdog.texi
298 man/mule.texi       "Luc Teirlinck"
299 man/m-x.texi        "Luc Teirlinck"
300 man/picture.texi
301 man/programs.texi
302 man/regs.texi       "Luc Teirlinck"
303 man/rmail.texi
304 man/screen.texi     "Luc Teirlinck"
305 man/search.texi     "Luc Teirlinck"
306 man/sending.texi
307 man/text.texi       "Luc Teirlinck"
308 man/trouble.texi
309 man/windows.texi    "Luc Teirlinck"
310 man/xresources.texi
312 ** Check the Emacs Lisp manual.
314 Each manual section should be proof-read by at least two people.
315 After each file name, on the same line or the following line, come the
316 names of the people who have checked it.
318 SECTION                  READERS
319 ----------------------------------
320 lispref/abbrevs.texi     "Luc Teirlinck"
321 lispref/advice.texi
322 lispref/anti.texi
323 lispref/backups.texi     "Luc Teirlinck"
324 lispref/buffers.texi     "Luc Teirlinck"
325 lispref/calendar.texi
326 lispref/commands.texi    "Luc Teirlinck"
327 lispref/compile.texi     "Luc Teirlinck"
328 lispref/control.texi     "Luc Teirlinck"
329 lispref/customize.texi
330 lispref/debugging.texi
331 lispref/display.texi
332 lispref/edebug.texi
333 lispref/elisp.texi       "Luc Teirlinck"
334 lispref/errors.texi      "Luc Teirlinck"
335 lispref/eval.texi        "Luc Teirlinck"
336 lispref/files.texi       "Luc Teirlinck"
337 lispref/frames.texi      "Luc Teirlinck"
338 lispref/functions.texi   "Luc Teirlinck"
339 lispref/hash.texi        "Luc Teirlinck"
340 lispref/help.texi        "Luc Teirlinck"
341 lispref/hooks.texi
342 lispref/internals.texi   "Luc Teirlinck"
343 lispref/intro.texi       "Luc Teirlinck"
344 lispref/keymaps.texi     "Luc Teirlinck"
345 lispref/lists.texi       "Luc Teirlinck"
346 lispref/loading.texi     "Luc Teirlinck"
347 lispref/locals.texi
348 lispref/macros.texi      "Luc Teirlinck"
349 lispref/maps.texi
350 lispref/markers.texi     "Luc Teirlinck"
351 lispref/minibuf.texi     "Luc Teirlinck"
352 lispref/modes.texi
353 lispref/nonascii.texi    "Luc Teirlinck"
354 lispref/numbers.texi     "Luc Teirlinck"
355 lispref/objects.texi     "Luc Teirlinck"
356 lispref/os.texi          "Luc Teirlinck"
357 lispref/positions.texi   "Luc Teirlinck"
358 lispref/processes.texi
359 lispref/searching.texi   "Luc Teirlinck"
360 lispref/sequences.texi   "Luc Teirlinck"
361 lispref/streams.texi     "Luc Teirlinck"
362 lispref/strings.texi     "Luc Teirlinck"
363 lispref/symbols.texi     "Luc Teirlinck"
364 lispref/syntax.texi      "Luc Teirlinck"
365 lispref/text.texi
366 lispref/tips.texi        "Luc Teirlinck"
367 lispref/variables.texi   "Luc Teirlinck"
368 lispref/windows.texi     "Luc Teirlinck"
371 Local variables:
372 mode: outline
373 end: