*** empty log message ***
[emacs.git] / admin / FOR-RELEASE
blob99f78af4e256fc6f94cc4a745c39c7467140085e
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.
13 ** Make Rmail find the best version of movemail.
14 To be done by Sergey Poznyakoff <gray@Mirddin.farlep.net>.
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 * GTK RELATED BUGS
37 ** Make GTK scrollbars behave like others w.r.t. overscrolling.
40 * REDISPLAY RELATED BUGS
42 ** Avoid unbreakable loops in redisplay.
44 Redisplay may loop if there is an error in some display property, e.g.
45      (space 'left-margin)
47 A fix would be to somehow disable handling of display properties if an error
48 is encountered.
50 ** Problem with cursor border around images and window-margins:
52 The border around the image when the cursor is on the image
53 flows into the right fringe and margin.
55      (progn
56        (auto-image-file-mode 1)
57        (find-file (concat data-directory "splash.xpm"))
58        (set-window-margins (selected-window) 25 25))
61 ** Problem with modeline and window margins:
63 The mode line's right "box" line is misplaced under the right margin,
64 rather than at the right window edge.
66 emacs -Q
67 (set-window-margins nil 25 25)
68 C-x 2
71 ** custom mode-line face makes Emacs freeze up
73 From: Stephen Berman <Stephen.Berman@gmx.net>
74 Date: Sun, 24 Oct 2004 02:08:56 +0200
76 1. Start Emacs with -q -no-site-file.
78 2. Type `M-x customize-face' and at the prompt `mode-line'.
80 3. In the Custom buffer for mode-line face
81    a. check width and give it the value `narrow';
82    b. check height and give it the value 120 in 1/10 pt;
83    c. check underline and give it the value `on' (or `colored');
84    d. check overline and give it the value `on' (or `colored').
86 4. Set for current session.
88 5. Invoke Ediff on any two files.
90 6. Now Emacs is frozen and consumes 95-99% of CPU.
92 The customizations in step 3 appear to be the minimum necessary to
93 induce this bug.  Leave out any one of them and Ediff runs without a
94 problem.  Also if the 1/10 point value of height is 130 or greater
95 there's no bug (with the default font family; with e.g. Helvetica the
96 bug is induced only by a value of 100 or less).
98 I've noticed this freeze up only when invoking Ediff.  The only thing
99 I've been able to do is kill Emacs externally, via top or with kill
100 when run in gdb, after interrupting.  When the freeze up happens
101 within a gdb session, there is no automatic debugging feedback.  After
102 interrupting I can get a backtrace, here's an example:
104 Update: Maybe only reveals itself when compiled with GTK+
107 ** Mouse-face overlay bleeds into header line
109 From: Stephen Berman <Stephen.Berman@gmx.net>
110 Date: Thu, 21 Oct 2004 18:11:01 +0200
112 Mouse-face overlays bleed into the header line when the beginning of
113 the overlay is above (point-min).  To reproduce:
115 1. Start Emacs with -q -no-site-file.
117 2. In *scratch* eval (setq ov (make-overlay 66 92)), (overlay-put ov
118 'mouse-face 'highlight), and (setq header-line-format "test").
120 3. Drag the mouse over the string "evaluation.\n;; If you want" and
121 notice the highlighting of only this string.
123 4. Now click on the down arrow in the scroll bar until the line
124 beginning ";; If you want" is directly below the header line.
126 5. Drag the mouse over ";; If you want" and notice that not only it
127 but also the header line are highlighted.
130 ** scroll-preserve-screen-position doesn't work with a header-line-format
132 From: jbyler+emacs-lists@anon41.eml.cc
133 Date: Tue, 17 Aug 2004 17:10:14 -0400
135 There seems to be an off-by-one error triggered by using a header line
136 together with scroll-preserve-screen-position.  The symptom: instead of
137 staying in the same position on the screen when scrolling, the cursor
138 moves one screen line down each time the buffer is scrolled.  Put
139 another way: repeatedly typing C-v M-v or using a mouse scroll wheel to
140 scroll up and down causes the cursor to migrate slowly down the screen
141 instead of staying put as it should.
143 To reproduce:
145 emacs -q --no-site-file
146 (setq scroll-preserve-screen-position t)
147 (setq header-line-format "")
148 C-v M-v C-v M-v C-v M-v etc.
151 ** Clicking on partially visible lines fails
153 From: David Kastrup <dak@gnu.org>
154 Date: 27 Apr 2004 16:42:58 +0200
156 I had gnus display a mouse-highlighted line (a URL from browse-url)
157 partially at the bottom of its window.  If I click with middle mouse
158 key on it, the window gets recentered while I hold the mouse key
159 pressed.  If I release it, the window returns into its old position
160 (cursor in top row) and nothing happens, presumably because the click
161 was not registered on the line itself, but on the magically
162 recentered version.
164 That is a nuisance.  Recentering of even partially visible click
165 targets should only happen if window-point moves there, but not at
166 the time of the click.  From the moment I hold down a key until it
167 gets released, the displayed window portion should not change, with
168 the sole exception of scrolling when dragging at the edge of the
169 screen.
172 ** Can't drag modeline when mouse-autoselect-window is set
174 From: Klaus Zeitler <kzeitler@lucent.com>
175 Date: Mon, 11 Oct 2004 11:14:49 +0200
177 1. start emacs -q --no-site-file
178 2. set variable mouse-autoselect-window to t
179 3. split-window-vertically
181 now I can drag the modeline only upwards but not downwards
184 ** line-spacing and (recenter -1)
186 From: SAITO Takuya <tabmore@rivo.mediatti.net>
187 Date: Mon, 31 May 2004 02:07:57 +0900 (JST)
189 (recenter -1) does not show point at the bottom of the window
190 if line-spacing is set to positive integer.
192 Start emacs -Q, and evaluate below:
194 (progn
195   (setq line-spacing 1)
196   (dotimes (i (window-height))
197     (insert "\n" (int-to-string i)))
198   (recenter -1))
200 Then, point is displayed at the center of the window.
201 But point should be displayed at the bottom of the window like Emacs-21.3.
204 ** line-spacing and garbage in fringe
206 From: SAITO Takuya <tabmore@rivo.mediatti.net>
207 Date: Mon, 31 May 2004 02:08:05 +0900 (JST)
209 Start emacs -Q and evaluate below with C-xC-e:
211 (let ((lines 2)
212       (spacing 1))
213   (setq line-spacing spacing
214         indicate-buffer-boundaries t)
215   (insert (make-string (window-height) ?\n))
216   (goto-char (point-min))
217   (message (make-string (* (window-width) lines) ?.))
218   (scroll-up 1))
220 then, garbage is displayed in right fringe.
222 Above code reproduces this bug with
223 (frame-parameter nil 'font)
224 => "-Adobe-Courier-Medium-R-Normal--12-120-75-75-M-70-ISO8859-1"
226 If you use different font, you may need different value of
227 `lines' and/or `spacing'.
230 ** line-spacing and Electric-pop-up-window
232 From: SAITO Takuya <tabmore@rivo.mediatti.net>
233 Date: Mon, 31 May 2004 02:08:10 +0900 (JST)
235 Electric-pop-up-window does not work well
236 if truncate long lines disabled and/or
237 `line-spacing' is set to positive integer.
239 For example, start emacs -Q --line-spacing 1, and type M-` .
240 Then, the last line of *Completions* buffer is not visible.
242 fit-window-to-buffer works well for me, so I guess
243 Electric-pop-up-window can use it.
246 * DOCUMENTATION
248 ** Document Custom Themes.
250 ** Finish updating the Emacs Lisp manual.
252 ** Update the Emacs manual.
254 *** Update man/info.texi.
256 *** Update man/ack.texi.
258 ** Add missing years in copyright notices of all files.
260 ** Update AUTHORS.
262 ** Reorder NEWS entries.
264 ** Check the Emacs manual.
266 Each manual section should be proof-read by at least two people.
267 After each file name, on the same line or the following line, come the
268 names of the people who have checked it.
271 SECTION             READERS
272 -----------------------------
273 man/abbrevs.texi
274 man/anti.texi
275 man/basic.texi      "Luc Teirlinck"
276 man/buffers.texi    "Luc Teirlinck"
277 man/building.texi   "Ted Zlatanov" <tzz@lifelogs.com>
278 man/calendar.texi
279 man/cmdargs.texi
280 man/commands.texi   "Luc Teirlinck"
281 man/custom.texi
282 man/dired.texi
283 man/display.texi    "Luc Teirlinck"
284 man/emacs.texi      "Luc Teirlinck"
285 man/entering.texi   "Luc Teirlinck"
286 man/files.texi      "Luc Teirlinck"
287 man/fixit.texi      "Luc Teirlinck"
288 man/frames.texi     "Luc Teirlinck"
289 man/glossary.texi
290 man/help.texi       "Luc Teirlinck"
291 man/indent.texi     "Luc Teirlinck"
292 man/killing.texi    "Luc Teirlinck"
293 man/kmacro.texi     "Luc Teirlinck"
294 man/macos.texi
295 man/maintaining.texi
296 man/major.texi      "Luc Teirlinck"
297 man/mark.texi       "Luc Teirlinck"
298 man/mini.texi       "Luc Teirlinck"
299 man/misc.texi
300 man/msdog.texi
301 man/mule.texi       "Luc Teirlinck"
302 man/m-x.texi        "Luc Teirlinck"
303 man/picture.texi
304 man/programs.texi
305 man/regs.texi       "Luc Teirlinck"
306 man/rmail.texi
307 man/screen.texi     "Luc Teirlinck"
308 man/search.texi     "Luc Teirlinck"
309 man/sending.texi
310 man/text.texi       "Luc Teirlinck"
311 man/trouble.texi
312 man/windows.texi    "Luc Teirlinck"
313 man/xresources.texi
315 ** Check the Emacs Lisp manual.
317 Each manual section should be proof-read by at least two people.
318 After each file name, on the same line or the following line, come the
319 names of the people who have checked it.
321 SECTION                  READERS
322 ----------------------------------
323 lispref/abbrevs.texi     "Luc Teirlinck"
324 lispref/advice.texi      Joakim Verona <joakim@verona.se>
325 lispref/anti.texi
326 lispref/backups.texi     "Luc Teirlinck"
327 lispref/buffers.texi     "Luc Teirlinck"
328 lispref/calendar.texi    Joakim Verona <joakim@verona.se>
329 lispref/commands.texi    "Luc Teirlinck"
330 lispref/compile.texi     "Luc Teirlinck"
331 lispref/control.texi     "Luc Teirlinck"
332 lispref/customize.texi
333 lispref/debugging.texi
334 lispref/display.texi
335 lispref/edebug.texi
336 lispref/elisp.texi       "Luc Teirlinck"
337 lispref/errors.texi      "Luc Teirlinck"
338 lispref/eval.texi        "Luc Teirlinck"
339 lispref/files.texi       "Luc Teirlinck"
340 lispref/frames.texi      "Luc Teirlinck"
341 lispref/functions.texi   "Luc Teirlinck"
342 lispref/hash.texi        "Luc Teirlinck"
343 lispref/help.texi        "Luc Teirlinck"
344 lispref/hooks.texi
345 lispref/internals.texi   "Luc Teirlinck"
346 lispref/intro.texi       "Luc Teirlinck"
347 lispref/keymaps.texi     "Luc Teirlinck"
348 lispref/lists.texi       "Luc Teirlinck"
349 lispref/loading.texi     "Luc Teirlinck"
350 lispref/locals.texi
351 lispref/macros.texi      "Luc Teirlinck"
352 lispref/maps.texi
353 lispref/markers.texi     "Luc Teirlinck"
354 lispref/minibuf.texi     "Luc Teirlinck"
355 lispref/modes.texi
356 lispref/nonascii.texi    "Luc Teirlinck"
357 lispref/numbers.texi     "Luc Teirlinck"
358 lispref/objects.texi     "Luc Teirlinck"
359 lispref/os.texi          "Luc Teirlinck"
360 lispref/positions.texi   "Luc Teirlinck"
361 lispref/processes.texi
362 lispref/searching.texi   "Luc Teirlinck"
363 lispref/sequences.texi   "Luc Teirlinck"
364 lispref/streams.texi     "Luc Teirlinck"
365 lispref/strings.texi     "Luc Teirlinck"
366 lispref/symbols.texi     "Luc Teirlinck"
367 lispref/syntax.texi      "Luc Teirlinck"
368 lispref/text.texi
369 lispref/tips.texi        "Luc Teirlinck"
370 lispref/variables.texi   "Luc Teirlinck"
371 lispref/windows.texi     "Luc Teirlinck"
374 Local variables:
375 mode: outline
376 end: