nnimap.el (nnimap-wait-for-response): Minor fixup of message string.
[bpt/emacs.git] / etc / NEWS
CommitLineData
29b7722a 1GNU Emacs NEWS -- history of user-visible changes.
5b87ad55 2
acaf905b 3Copyright (C) 2010-2012 Free Software Foundation, Inc.
5b87ad55 4See the end of the file for license conditions.
a933dad1 5
893db5bc 6Please send Emacs bug reports to bug-gnu-emacs@gnu.org.
9a21d88b
KS
7If possible, use M-x report-emacs-bug.
8
eb199145 9This file is about changes in Emacs version 24.
9a21d88b 10
eb199145
GM
11See files NEWS.23, NEWS.22, NEWS.21, NEWS.20, NEWS.19, NEWS.18,
12and NEWS.1-17 for changes in older Emacs versions.
9a21d88b
KS
13
14You can narrow news to a specific version by calling `view-emacs-news'
15with a prefix argument or by typing C-u C-h C-n.
3f7194ed 16
adce950d
CY
17
18Temporary note:
19 +++ indicates that the appropriate manual has already been updated.
20 --- means no change in the manuals is called for.
21When you add a new item, please add it without either +++ or ---
22so we will look at it and add it to the manual.
23
24\f
eb199145 25* Installation Changes in Emacs 24.1
09e18d03 26
a49ca6b9 27---
31fd3586
GM
28** Emacs can be compiled with Gtk+ 3.0 if you pass --with-x-toolkit=gtk3
29to configure. Note that other libraries used by Emacs, RSVG and GConf,
30also depend on Gtk+. You can disable them with --without-rsvg and
31--without-gconf.
338648ad
GM
32
33---
31fd3586
GM
34** Emacs can be compiled with GnuTLS support.
35This happens by default if a suitably recent version of the library is
36found at build time. To prevent this, use the configure option
37`--without-gnutls'. See below for GnuTLS features.
338648ad 38
aded53ff 39---
31fd3586
GM
40** Emacs can be compiled with SELinux support.
41This happens by default if a suitably recent version of the library is
42found at build time. To prevent this, use the configure option
43`--without-selinux'. See below for SELinux features.
aded53ff 44
e547b051 45---
31fd3586
GM
46** Emacs can be compiled with ImageMagick support.
47This happens by default if a suitably recent version of the library is
48found at build time. To prevent this, use the configure option
49`--without-imagemagick'. See below for ImageMagick features.
c1f10868 50This feature is not available for the Nextstep or MS ports.
d9170db5 51
043efd56
GM
52---
53** Emacs can be compiled with libxml2 support.
54This happens by default if a suitably recent version of the library is
55found at build time. To prevent this, use the configure option
56`--without-xml2'. See below for libxml2 features.
57
3fd50d5c 58---
81eafe29
PE
59** There is a new configure option --with-wide-int.
60With it, Emacs integers typically have 62 bits, even on 32-bit machines.
0a768890
PE
61On 32-bit hosts, this raises the limit on buffer sizes from about 512 MiB
62to about 2 GiB.
81eafe29 63
d064e6a6 64---
31fd3586
GM
65** By default, the installed Info and man pages are compressed.
66You can disable this by configuring --without-compress-info.
d064e6a6 67
31fd3586
GM
68---
69** There are new configure options:
70--with-mmdf, --with-mail-unlink, --with-mailhost.
71These provide no new functionality, they just remove the need to edit
72lib-src/Makefile by hand in order to use the associated features.
73
74---
75** There is a new configure option --enable-use-lisp-union-type.
76This is only useful for Emacs developers to debug certain types of bugs.
77This is not a new feature; only the configure flag is new.
041d709f 78
ddb54206 79---
041d709f
CY
80** The standalone programs digest-doc and sorted-doc are removed.
81Emacs now uses Lisp commands `doc-file-to-man' and `doc-file-to-info'.
82
83---
84** The standalone program `fakemail' is removed.
85If you need it, feedmail.el provides a superset of the functionality.
86
0bfd685e 87\f
eb199145 88* Startup Changes in Emacs 24.1
4a263588 89
fdeb32ec 90---
198a7a97 91** The --unibyte, --multibyte, --no-multibyte, and --no-unibyte
adbf62ff
GM
92command line arguments, and the EMACS_UNIBYTE environment variable, no
93longer have any effect. (They were declared obsolete in Emacs 23.)
198a7a97 94
fdeb32ec 95+++
66b7b0fe 96** New command line option `--no-site-lisp' removes site-lisp directories
1b5e5b0c
GM
97from load-path. -Q now implies this. This option does not affect the
98EMACSLOADPATH environment variable (and hence has no effect for
99Nextstep builds.)
66b7b0fe 100
0bfd685e 101\f
eb199145 102* Changes in Emacs 24.1
7841339b 103
3fd50d5c 104+++
041d709f 105** auto-mode-case-fold is now enabled by default.
2a847524 106
a2a25d24 107** Completion
fdeb32ec 108
e17d9003 109*** shell-mode uses pcomplete rules, with the standard completion UI.
3d992aa0 110+++
de0bde62
CY
111*** Many packages have been changed to use `completion-at-point'
112rather than their own completion code.
3d992aa0 113+++
de0bde62 114*** `completion-at-point' now handles tags and semantic completion.
27a16462 115---
a2a25d24
SM
116*** Completion in a non-minibuffer now tries to detect the end of completion
117and pops down the *Completions* buffer accordingly.
de09aa52 118+++
a2a25d24 119*** Completion can cycle, depending on completion-cycle-threshold.
27a16462 120+++
a2a25d24 121*** New completion style `substring'.
939db9ac 122+++
620c53a6 123*** Completion style can be set per-category `completion-category-overrides'.
939db9ac 124+++
620c53a6
SM
125*** Completion of buffers now uses substring completion by default.
126
6870aaef
LMI
127** Mail changes
128
b30941db
CY
129+++
130*** The default of `send-mail-function' is now `sendmail-query-once',
041d709f
CY
131which asks the user (once) whether to use the smtpmail package to send
132email, or to use the old defaults that rely on external mail
133facilities (`sendmail-send-it' on GNU/Linux and other Unix-like
134systems, and `mailclient-send-it' on Windows).
6870aaef 135
041d709f 136*** smtpmail changes
95f41d9a 137
041d709f
CY
138**** smtpmail now uses encrypted connections (via STARTTLS) if the
139mail server supports them. It also uses the auth-source framework for
140getting credentials.
95f41d9a 141
041d709f
CY
142**** The variable `smtpmail-auth-credentials' has been removed.
143That variable used to have the default value "~/.authinfo", in which
144case you won't see any difference. But if you changed it to be a list
145of user names and passwords, that setting is now ignored; you will be
146prompted for the user name and the password, which will then be saved
ffdcbd1c
LMI
147to ~/.authinfo. (To control where and how the credentials are stored,
148see the auth-source manual. You may want to change the auth-source
149preferences if you want to store the credentials encrypted, for
150instance.)
e2430e31 151
041d709f
CY
152You can also manually copy the credentials to your ~/.authinfo file.
153For example, if you had
e2430e31 154
041d709f
CY
155 (setq smtpmail-auth-credentials
156 '(("mail.example.org" 25 "jim" "s!cret")))
e2430e31
LMI
157
158then the equivalent line in ~/.authinfo would be
159
041d709f
CY
160 machine mail.example.org port 25 login jim password s!cret
161
162**** The variable `smtpmail-starttls-credentials' has been removed.
95f41d9a 163
cd1181db 164If you had that set, then you need to put
95f41d9a 165
041d709f 166 machine smtp.whatever.foo port 25 key "~/.my_smtp_tls.key" cert "~/.my_smtp_tls.cert"
95f41d9a
LMI
167
168in your ~/.authinfo file instead.
169
b30941db 170*** Mail mode changes (this is the old Mail mode, not Message mode)
c3760c17 171+++
b30941db 172**** New command `mail-add-attachment' for adding MIME attachments
c3760c17 173---
b30941db
CY
174**** The command `mail-attach-file' was renamed to `mail-insert-file'.
175The old name is now an obsolete alias to the new name.
c3760c17 176
91af9d2e
GM
177+++
178*** You can type C-c m from M-x report-emacs-bug if you prefer, and if
179your system supports it, to transfer your report to your desktop's
180preferred mail client. This uses either the "xdg-email" utility, or
181OS X's "open" command.
3f88cd72 182
041d709f 183** Emacs server and client changes
ddb54206 184+++
041d709f
CY
185*** New option `server-port' specifies the port on which the Emacs
186server should listen.
187+++
188*** New emacsclient argument -q/--quiet suppresses some status messages.
189+++
190*** New emacsclient argument --frame-parameters can be used to set the
191frame parameters of a newly-created graphical frame.
192+++
8350f087 193*** If emacsclient shuts down as a result of Emacs signaling an
041d709f
CY
194error, its exit status is 1.
195+++
196*** New emacsclient argument --parent-id ID.
197This opens a client frame in parent X window ID, via XEmbed, similar
198to the --parent-id argument to Emacs.
199
d0ce9f8c
MB
200** Internationalization changes
201
f4b6ba46 202+++
d0ce9f8c 203*** Emacs now supports display and editing of bidirectional text.
f4b6ba46 204
f1816485
EZ
205Text that includes characters from right-to-left (RTL) scripts, such
206as Arabic, Farsi, or Hebrew, is displayed in the correct visual order
207as expected by users of those scripts. This display reordering is a
208"Full bidirectionality" class implementation of the Unicode
7850ac23
EZ
209Bidirectional Algorithm. Buffers with no RTL text should look exactly
210the same as before.
f4b6ba46 211
041d709f
CY
212For more information, see the node "Bidirectional Editing" in the
213Emacs Manual.
f4b6ba46 214
041d709f
CY
215+++
216**** New buffer-local variable `bidi-display-reordering'.
217To disable display reordering in any given buffer, change this to nil.
d20e1419 218
041d709f
CY
219+++
220**** New buffer-local variable `bidi-paragraph-direction'.
221If nil (the default), Emacs determines the base direction of each
222paragraph from its text, as specified by the Unicode Bidirectional
f4b6ba46
EZ
223Algorithm.
224
041d709f
CY
225Setting this to `right-to-left' or `left-to-right' forces a particular
226base direction on each paragraph in the buffer.
227
f1816485
EZ
228Paragraphs whose base direction is right-to-left are displayed
229starting at the right margin of the window.
230
d0ce9f8c 231+++
041d709f
CY
232*** Enhanced support for characters with no glyphs in available fonts.
233If a character has no glyphs in any of the available fonts, Emacs
234normally displays it either as a hexadecimal code in a box or as a
d0ce9f8c
MB
235thin 1-pixel space. In addition to these two methods, Emacs can
236display these characters as empty box, as an acronym, or not display
237them at all. To change how these characters are displayed, customize
238the variable `glyphless-char-display-control'.
239
041d709f 240On character terminals, these methods are used for characters that
d0ce9f8c
MB
241cannot be encoded by the `terminal-coding-system'.
242
ddb54206 243---
041d709f
CY
244*** New input methods for Farsi: farsi and farsi-translit.
245
939db9ac
CY
246+++
247*** `nobreak-char-display' now also highlights Unicode hyphen chars
248(U+2010 and U+2011).
249
31fd3586
GM
250---
251*** New translation of the Emacs Tutorial in Hebrew is available.
252Type `C-u C-h t' to choose it in case your language setup doesn't
253automatically select it.
254
041d709f 255** Improved GTK integration
da97a9e6 256+++
041d709f 257*** GTK scroll-bars are now placed on the right by default.
52834b6b 258Use `set-scroll-bar-mode' to change this.
da97a9e6 259+++
041d709f 260*** GTK tool bars can have just text, just images or images and text.
d8004abe 261Customize `tool-bar-style' to choose style. On a Gnome desktop, the default
20fe03ad 262is taken from the desktop settings.
da97a9e6 263---
041d709f 264*** GTK tool bars can be placed on the left/right or top/bottom of the frame.
8b2dd508 265The frame-parameter tool-bar-position controls this. It takes the values
1c0d77cc 266top, left, right or bottom. The Options => Show/Hide menu has entries
8b2dd508 267for this.
d366bd53 268+++
67e729a5
CY
269*** The colors for selected text (the `region' face) are taken from
270the GTK theme when Emacs is built with GTK.
d366bd53 271+++
041d709f
CY
272*** Emacs uses GTK tooltips by default if built with GTK. You can turn that
273off by customizing x-gtk-use-system-tooltips.
16a91140 274
35137ed3 275+++
bc987f8b
JL
276** New basic faces `error', `warning', `success' are available to
277highlight strings that indicate failure, caution or successful operation.
278
b22b1918 279---
1ecb2d3f 280** Lucid menus and dialogs can display antialiased fonts if Emacs is built
3928f2b6
JD
281with Xft. To change font, use the X resource font, for example:
282Emacs.pane.menubar.font: Courier-12
99852628 283
21100e7d 284+++
917794d5 285** On graphical displays, the mode-line no longer ends in dashes.
1dd3c2d9
CY
286Also, the first dash (which does not indicate anything) is just
287displayed as a space.
917794d5 288
a49ca6b9 289+++
b7d65a5f
GM
290** Basic SELinux support has been added.
291This requires Emacs to be linked with libselinux at build time.
292
a49ca6b9 293+++
d8004abe
GM
294*** Emacs preserves the SELinux file context when backing up, and
295optionally when copying files. To this end, copy-file has an extra
296optional argument, and backup-buffer and friends include the SELinux
297context in their return values.
b7d65a5f 298
a49ca6b9 299+++
b7d65a5f
GM
300*** The new functions file-selinux-context and set-file-selinux-context
301get and set the SELinux context of a file.
bfd779dd 302---
a5bee597
MA
303*** Tramp offers handlers for file-selinux-context and set-file-selinux-context
304for remote machines which support SELinux.
305
041d709f 306** Changes for exiting Emacs
ddb54206 307+++
041d709f
CY
308*** The function kill-emacs is now run upon receipt of the signals
309SIGTERM and SIGHUP, and upon SIGINT in batch mode.
ddb54206 310+++
041d709f 311*** kill-emacs-hook is now also run in batch mode.
63c72eeb
GM
312If you have code that adds something to kill-emacs-hook, you should
313consider if it is still appropriate to add it in the noninteractive case.
9c524fcb 314
041d709f 315** Scrolling changes
550f41cd 316+++
041d709f 317*** New scrolling commands `scroll-up-command' and `scroll-down-command'
0a19a6f8
JB
318(bound to C-v/[next] and M-v/[prior]) do not signal errors at top/bottom
319of buffer at first key-press (instead move to top/bottom of buffer)
550f41cd 320when `scroll-error-top-bottom' is non-nil.
550f41cd
CY
321+++
322*** New variable `scroll-error-top-bottom' (see above).
e7a3ff06 323+++
041d709f 324*** New scrolling commands `scroll-up-line' and `scroll-down-line'
5a97d2da 325scroll a line instead of full screen.
550f41cd 326+++
041d709f 327*** New property `scroll-command' should be set on a command's symbol to
b2957ea8 328define it as a scroll command affected by `scroll-preserve-screen-position'.
d0f69533 329+++
041d709f 330*** If you customize `scroll-conservatively' to a value greater than 100,
d0f69533
EZ
331Emacs will never recenter point in the window when it scrolls due to
332cursor motion commands or commands that move point (e.f., `M-g M-g').
333Previously, you needed to use `most-positive-fixnum' as the value of
334`scroll-conservatively' to achieve the same effect.
d0f69533 335---
041d709f 336*** ``Aggressive'' scrolling now honors the scroll margins.
d0f69533
EZ
337If you customize `scroll-up-aggressively' or
338`scroll-down-aggressively' and move point off the window, Emacs now
339scrolls the window so as to avoid positioning point inside the scroll
340margin.
341
f1a5d776 342** Trash changes
04e2ce72 343+++
f1a5d776
CY
344*** `delete-by-moving-to-trash' now only affects commands that specify
345trashing. This avoids inadvertently trashing temporary files.
04e2ce72 346+++
f1a5d776
CY
347*** Calling `delete-file' or `delete-directory' with a prefix argument
348now forces true deletion, regardless of `delete-by-moving-to-trash'.
349
05f77e38 350+++
f0bf7c8e
JL
351** New option `list-colors-sort' defines the color sort order
352for `list-colors-display'.
353
44198b6e
CY
354** An Emacs Lisp package manager is now included.
355This is a convenient way to download and install additional packages,
3fd50d5c 356from a package repository at http://elpa.gnu.org.
d43f5a42 357+++
cb6c4991
CY
358*** `M-x list-packages' shows a list of packages, which can be
359selected for installation.
d43f5a42 360+++
cb6c4991 361*** New command `describe-package', bound to `C-h P'.
d43f5a42 362+++
44198b6e
CY
363*** By default, all installed packages are loaded and activated
364automatically when Emacs starts up. To disable this, set
365`package-enable-at-startup' to nil. To change which packages are
366loaded, customize `package-load-list'.
367
f065864f 368** Custom Themes
b0d7d8af 369+++
f065864f 370*** `M-x customize-themes' lists Custom themes which can be enabled.
b0d7d8af 371+++
782b5e8d
CY
372*** New option `custom-theme-load-path' is the load path for themes.
373Emacs no longer looks for custom themes in `load-path'. The default
374is to search in `custom-theme-directory', followed by a built-in theme
375directory named "themes/" in `data-directory'.
b0d7d8af 376+++
b7617f6d
CY
377*** New option `custom-safe-themes' records known-safe theme files.
378If a theme is not in this list, Emacs queries before loading it, and
379offers to save the theme to `custom-safe-themes' automatically. By
380default, all themes included in Emacs are treated as safe.
278f6845 381
4ddf410a
MA
382** The user option `remote-file-name-inhibit-cache' controls whether
383the remote file-name cache is used for read access.
384
041d709f 385** File- and directory-local variable changes
b8f82dc1 386+++
041d709f
CY
387*** You can stop directory local vars from applying to subdirectories.
388Add an element (subdirs . nil) to the alist portion of any variables
389settings to indicate that the section should not apply to
390subdirectories.
89bd9ccd 391+++
041d709f
CY
392*** Directory local variables can apply to some file-less buffers.
393Affected modes include dired, vc-dir, and log-edit. For example,
394adding "(diff-mode . ((mode . whitespace)))" to .dir-locals.el will
395turn on `whitespace-mode' for *vc-diff* buffers. Modes should call
396`hack-dir-local-variables-non-file-buffer' to support this.
041d709f
CY
397+++
398*** Using "mode: MINOR-MODE" to enable a minor mode is deprecated.
399Instead, use "eval: (minor-mode 1)".
c136e5cd 400
61086eb6 401+++
7b447e9b
GM
402*** The variable `inhibit-first-line-modes-regexps' has been renamed
403to `inhibit-local-variables-regexps'. As the name suggests, it now
404applies to ALL file local variables, not just -*- mode ones.
405The associated `inhibit-first-line-modes-suffixes' has been renamed
406in the corresponding way.
407
fdeb32ec 408+++
f13183cf
CY
409** The variable `focus-follows-mouse' now always defaults to nil.
410
7f3f739f
LL
411** New primitive `secure-hash' that supports many secure hash algorithms
412including md5, sha-1 and sha-2 (sha-224, sha-256, sha-384 and sha-512).
42d4bcc8
LL
413The elisp implementation sha1.el is removed. Feature sha1 is provided
414by default.
415
5d907d6c 416** Menu-bar changes
b22b1918 417---
5d907d6c
DA
418*** `menu-bar-select-buffer-function' lets you choose another operation
419instead of `switch-to-buffer' when selecting an item in the Buffers menu.
420
0a2132ba
CY
421** Window changes
422
423+++
424*** Resizing an Emacs frame now preserves proportional window sizes,
425modulo restrictions like window minimum sizes and fixed-size windows.
426
427*** The behavior of `display-buffer' is now customizable in detail.
717a1362 428+++
0a2132ba
CY
429**** New option `display-buffer-base-action' specifies a list of
430user-determined display "actions" (functions and optional arguments
431for choosing the displaying window).
432
433This takes precedence over the default display action, which is
434specified by `display-buffer-fallback-action'.
435
717a1362 436+++
0a2132ba
CY
437**** New option `display-buffer-alist' maps buffer name regexps to
438display actions, taking precedence over `display-buffer-base-action'.
439
440+++
a0c2d0ae
MR
441*** New option `window-combination-limit'.
442The new option `window-combination-limit' allows to return the space
443obtained for resizing or creating a window more reliably to the window
444from which such space was obtained.
0a2132ba
CY
445
446+++
a0c2d0ae
MR
447*** New option `window-combination-resize'.
448The new option `window-combination-resize' allows to split a window that
449otherwise cannot be split because it's too small by stealing space from
450other windows in the same combination. Subsequent resizing or deletion
451of the window will resize all windows in the same combination as well.
0a2132ba
CY
452
453+++
454*** New commands `maximize-window' and `minimize-window'.
53964682 455These maximize and minimize the size of a window within its frame.
0a2132ba
CY
456
457+++
458*** New commands `switch-to-prev-buffer' and `switch-to-next-buffer'.
459These functions allow to navigate through the live buffers that have
460been shown in a specific window.
461
041d709f
CY
462** The inactive minibuffer has its own major mode `minibuffer-inactive-mode'.
463This is handy for minibuffer-only frames, and is also used for the "mouse-1
464pops up *Messages*" feature, which can now easily be changed.
465
0bfd685e 466\f
eb199145 467* Editing Changes in Emacs 24.1
b350bdf2 468
892777ba 469** Search changes
892777ba
CY
470+++
471*** C-y in Isearch is now bound to isearch-yank-kill, instead of
472isearch-yank-line.
5abc31ef 473+++
25666126
LL
474*** M-y in Isearch is now bound to isearch-yank-pop, instead of
475isearch-yank-kill.
892777ba
CY
476+++
477*** M-s C-e in Isearch is now bound to isearch-yank-line.
478
ea4f7750 479+++
b2b0776e
CY
480** New commands `count-words-region' and `count-words'.
481
482*** `count-lines-region' is now an alias for `count-words-region',
483bound to M-=, which shows the number of lines, words, and characters.
ea4f7750 484
bfd779dd 485+++
d74cba8f
MA
486** The default value of `backup-by-copying-when-mismatch' is now t.
487
21100e7d 488+++
ec9da840 489** The command `just-one-space' (M-SPC), if given a negative argument,
1c708c1a
CY
490also deletes newlines around point.
491
b9229673 492** Deletion changes
50b063c3 493+++
b9229673 494*** New option `delete-active-region'.
ddb54206
CY
495If non-nil, [delete] and DEL delete the region if it is active and no
496prefix argument is given. If set to `kill', these commands kill
497instead.
50b063c3 498+++
59ee0542 499*** New command `delete-forward-char', bound to [delete].
42d9cffa
CY
500This is meant for interactive use, and obeys `delete-active-region'.
501The command `delete-char' does not obey `delete-active-region'.
50b063c3 502---
b9229673
CY
503*** `delete-backward-char' is now a Lisp function.
504Apart from obeying `delete-active-region', its behavior is unchanged.
505However, the byte compiler now warns if it is called from Lisp; you
506should use delete-char with a negative argument instead.
ddb54206 507---
b9229673
CY
508*** The option `mouse-region-delete-keys' has been deleted.
509
f9d71b42
CY
510** Selection changes.
511
b1ab31ae
CY
512The default handling of clipboard and primary selections was changed
513to conform with modern X applications. In short, most commands for
514killing and yanking text now use the clipboard, while mouse commands
515use the primary selection.
516
517In the following, we provide a list of these changes, followed by a
518list of steps to get the old behavior back if you prefer that.
519
963578d3 520+++
b1ab31ae
CY
521*** `select-active-regions' now defaults to t.
522Merely selecting text (e.g. with drag-mouse-1) no longer puts it in
963578d3 523the kill ring. The selected text is put in the primary selection, if
b1ab31ae
CY
524the system possesses a separate primary selection facility (e.g. X).
525
963578d3 526+++
b1ab31ae
CY
527**** `select-active-regions' also accepts a new value, `only'.
528This means to only set the primary selection for temporarily active
529regions (usually made by mouse-dragging or shift-selection);
530"ordinary" active regions, such as those made with C-SPC followed by
531point motion, do not alter the primary selection.
532
963578d3
CY
533---
534**** `mouse-drag-copy-region' now defaults to nil.
535
536+++
b1ab31ae
CY
537*** mouse-2 is now bound to `mouse-yank-primary'.
538This pastes from the primary selection, ignoring the kill-ring.
539Previously, mouse-2 was bound to `mouse-yank-at-click'.
540
963578d3 541+++
b1ab31ae 542*** `x-select-enable-clipboard' now defaults to t on all platforms.
963578d3 543+++
b1ab31ae
CY
544*** `x-select-enable-primary' now defaults to nil.
545Thus, commands that kill text or copy it to the kill-ring (such as
546M-w, C-w, and C-k) also use the clipboard---not the primary selection.
547
963578d3 548---
b1ab31ae
CY
549**** The "Copy", "Cut", and "Paste" items in the "Edit" menu are now
550exactly equivalent to, respectively M-w, C-w, and C-y.
551
963578d3 552---
b1ab31ae
CY
553**** Note that on MS-Windows, `x-select-enable-clipboard' was already
554non-nil by default, as Windows does not support the primary selection
555between applications.
556
963578d3 557---
b1ab31ae 558*** To return to the previous behavior, do the following:
104c2fe9 559**** Change `select-active-regions' to nil.
b1ab31ae
CY
560**** Change `mouse-drag-copy-region' to t.
561**** Change `x-select-enable-primary' to t (on X only).
562**** Change `x-select-enable-clipboard' to nil.
563**** Bind `mouse-yank-at-click' to mouse-2.
f9d71b42 564
963578d3 565+++
084e6df3
JD
566*** Support for X cut buffers has been removed.
567
3fd50d5c
CY
568*** X clipboard managers are now supported.
569To inhibit this, change `x-select-enable-clipboard-manager' to nil.
4b80f674 570
50b063c3 571+++
99f053cf 572** New command `rectangle-number-lines', bound to `C-x r N', numbers
6b2c221e 573the lines in the current rectangle. With a prefix argument, this
99f053cf
JA
574prompts for a number to count from and for a format string.
575
6bf7006f 576+++
db7ab02f 577** The default value of redisplay-dont-pause is now t
6bf7006f
EZ
578This makes Emacs feel more responsive to editing commands that arrive
579at high rate, e.g. if you lean on some key, because stopping redisplay
580in the middle (when this variable is nil) forces more expensive
581updates later on, and Emacs appears to be unable to keep up.
582
e70b5064
CY
583+++
584** The behavior of <TAB> for active regions in Text mode has changed.
585In Text and related modes, typing <TAB> (`indent-for-tab-command')
586when the region is active causes Emacs to indent all the lines in the
587region, aligning them with the line previous to the first line in the
588region (or with the left margin if there is no previous line).
589
9bae34bf 590\f
eb199145 591* Changes in Specialized Modes and Packages in Emacs 24.1
efeb796b 592
bfd779dd 593+++
041d709f 594** Archive Mode has basic support for browsing and updating 7z archives.
d76674bb 595
29eabb8e 596---
b7c3692a
RW
597** BibTeX mode
598
2de69e00 599*** BibTeX mode now supports biblatex.
041d709f
CY
600Use the variable bibtex-dialect to select support for different BibTeX
601dialects. bibtex-entry-field-alist is now an obsolete alias for
2de69e00
RW
602bibtex-BibTeX-entry-alist.
603
34699b85
RW
604*** New command `bibtex-search-entries' bound to C-c C-a.
605
b7c3692a
RW
606*** New `bibtex-entry-format' option `sort-fields', disabled by default.
607
022fe7ce
RW
608*** New variable `bibtex-search-entry-globally'.
609
cf16af42
GM
610** Calendar, Diary, and Appt
611
548d0a63
GM
612+++
613*** Diary entries can contain non-printing `comments'.
614See the variable `diary-comment-start'.
615
5006e634
GM
616+++
617*** Appointments can specify their individual warning times.
618See the variable `appt-warning-time-regexp'.
619
0a2bb1a9
GM
620---
621*** The function specified by `appt-disp-window-function' may be passed
622lists of arguments if multiple appointments are due at similar times.
623If you are using a custom function for this, you should update it.
624
d306b4da 625+++
7454f200
GM
626*** New function `diary-hebrew-birthday'.
627
e565dd37
GM
628---
629*** Elements of `calendar-day-abbrev-array' and `calendar-month-abbrev-array'
630may no longer be nil, but must all be strings.
631
cf16af42
GM
632---
633*** The obsolete (since Emacs 22.1) method of enabling the appt package
634by adding appt-make-list to diary-hook has been removed. Use appt-activate.
635
636---
637*** Some appt variables (obsolete since Emacs 22.1) have been removed:
638appt-issue-message (use the function appt-activate)
639appt-visible/appt-msg-window (use the variable appt-display-format)
640
641---
642*** Some diary function aliases (obsolete since Emacs 22.1) have been removed:
643view-diary-entries, list-diary-entries, show-all-diary-entries
644
523eedb0
GM
645** Browse-url
646
647+++
648*** New option `browse-url-mailto-function' specifies how to handle "mailto:"s.
649
650---
651*** The default browser used by the package is now the "xdg-open" program,
652on platforms that support it. This calls your desktop's preferred browser.
653
041d709f
CY
654** CC Mode (C, C++, etc.)
655
656*** New feature to "guess" the style in an existing buffer.
657
658** comint and modes derived from it use the generic completion code.
659
660** Compilation mode
29eabb8e 661---
041d709f
CY
662*** Compilation mode can be used without font-lock-mode.
663`compilation-parse-errors-function' is now obsolete.
664
665*** `compilation-filter-start' is let-bound to the start of the text
666inserted by the compilation filter function, when calling
667compilation-filter-hook.
668
47a6a35f
GM
669*** `compilation-error-screen-columns' and `compilation-first-column'
670are obeyed in the editing buffer. So programming language modes can
671set them, whereas previously only the value in the *compilation* buffer
672was used.
1dce7193 673
52834b6b
CY
674** Customize
675
b0d7d8af 676+++
52834b6b
CY
677*** Customize buffers now contain a search field.
678The search is performed using `customize-apropos'.
42d9cffa 679To turn off the search field, set custom-search-field to nil.
52834b6b 680
b0d7d8af 681+++
52834b6b
CY
682*** Custom options now start out hidden if at their default values.
683Use the arrow to the left of the option name to toggle visibility.
684
ff1796f3 685---
52834b6b
CY
686*** custom-buffer-sort-alphabetically now defaults to t.
687
b0d7d8af 688+++
52834b6b
CY
689*** The color widget now has a "Choose" button, which allows you to
690choose a color via list-colors-display.
691
041d709f
CY
692** D-Bus
693
694*** It is possible now, to access alternative buses than the default
695system or session bus.
696
697*** dbus-register-{service,method,property}
698The -method and -property functions do not automatically register
699names anymore.
700
701The new function dbus-register-service registers a service known name
702on a D-Bus without simultaneously registering a property or a method.
703
f5d6548a 704** Dired-x
c40a7de7 705---
f5d6548a
JL
706*** dired-jump and dired-jump-other-window called with a prefix argument
707read a file name from the minibuffer instead of using buffer-file-name.
708
817b48a7
GM
709+++
710*** The `dired local variables' feature provided by Dired-x is obsolete.
711The standard directory local variables feature replaces it.
8117868f 712
041d709f 713** ERC changes
7492acc9 714
c4077254
GM
715---
716*** New options `erc-autojoin-timing' and `erc-autojoin-delay',
717controlling attempts to autojoin a channel.
041d709f
CY
718
719*** New variable `erc-coding-system-precedence': If we use `undecided'
720as the server coding system, this variable will then be consulted.
721The default is to decode strings that can be decoded as utf-8 as
722utf-8, and do the normal `undecided' decoding for the rest.
7492acc9 723
041d709f 724** Eshell changes
7492acc9 725
05f77e38
GM
726---
727*** The default value of `eshell-directory-name' has changed
728to be an "eshell" directory in `user-emacs-directory'.
729The old "~/.eshell/" directory is still used if it exists, though.
041d709f
CY
730
731** gdb-mi
88c5c7c8 732+++
05f77e38
GM
733*** The GDB User Interface has been migrated to GDB Machine Interface.
734It now supports multithread non-stop debugging and simultaneous
735debugging of several threads.
7492acc9 736
18af70d0
CY
737** Image mode
738
05f77e38
GM
739+++
740*** RET (`image-toggle-animation') toggles animation, if applicable.
741Animation plays once, unless the option `image-animate-loop' is non-nil.
18af70d0 742
041d709f 743** Info
723ee192 744
041d709f
CY
745*** New command `info-display-manual' displays an Info manual
746specified by its name. If that manual is already visited in some Info
747buffer within the current session, the command will display that
748buffer. Otherwise, it will load the manual and display it. This is
749handy if you have many manuals in many Info buffers, and don't
750remember the name of the buffer visiting the manual you want to
751consult.
691cf4a0 752
88c5c7c8 753+++
24ea72d3
EZ
754*** `e' is now bound to `end-of-buffer' rather than to `Info-edit'.
755This is for compatibility with the stand-alone Info reader program,
756and also because `Info-edit' is a rarely used command that is disabled
757by default.
758
759+++
06b08b88 760** MH-E has been upgraded to MH-E version 8.3.1.
041d709f 761See MH-E-NEWS for details.
37221432 762
ff1796f3 763---
041d709f 764** Modula-2 mode provides auto-indentation.
37221432 765
ff1796f3 766---
041d709f 767** mpc.el: Can use pseudo tags of the form tag1|tag2 as a union of two tags.
3c3d4f5b 768
ff1796f3 769---
041d709f
CY
770** Prolog mode has been completely revamped, with lots of additional
771functionality such as more intelligent indentation, electricity, support for
772more variants, including Mercury, and a lot more.
773
774** Rmail
775
a7686350 776+++
041d709f
CY
777*** The command `rmail-epa-decrypt' decrypts OpenPGP data
778in the Rmail incoming message.
779
50419064
GM
780---
781*** The variable `rmail-message-filter' no longer has any effect.
782This change was made in Emacs 23.1 but was not advertised at the time.
783Try using `rmail-show-message-hook' instead.
784
717a1362 785** Shell mode
88c5c7c8 786+++
de0bde62 787*** Shell mode uses pcomplete rules, with the standard completion UI.
88c5c7c8 788+++
717a1362
CY
789*** The `shell' command prompts for the shell path name if the default
790directory is a remote file name and neither the environment variable
791$ESHELL nor the variable `explicit-shell-file-name' is set.
792
ddb54206 793---
34e8a2da 794** SQL mode
041d709f 795
34e8a2da
GM
796---
797*** New options `sql-port', `sql-connection-alist', `sql-send-terminator',
798and `sql-oracle-scan-on'.
041d709f 799
34e8a2da
GM
800---
801*** New custom variables control prompting for login parameters.
802Each supported product has a custom variable `sql-*-login-params',
803which is a list of the parameters to be prompted for before a
804connection is established.
041d709f 805
34e8a2da 806---
041d709f 807*** The command `sql-product-interactive' now takes a prefix argument,
34e8a2da 808which causes it to prompt for an SQL product.
041d709f 809
34e8a2da
GM
810---
811*** Product-specific SQL interactive commands now take prefix arguments.
041d709f
CY
812These commands (`sql-sqlite', `sql-postgres', `sql-mysql', etc.),
813given a prefix argument, prompt for a name for the SQL interactive
814buffer. This reduces the need for calling `sql-rename-buffer'.
815
34e8a2da 816---
041d709f
CY
817*** SQL interactive modes suppress command continuation prompts, and
818replace tabs with spaces. The first change impacts multiple line SQL
819statements entered with C-j between each line, statements yanked into
820the buffer and statements sent with `sql-send-*' functions. The
34e8a2da
GM
821second prevents the MySQL and Postgres interpreters from listing
822object name completions when sent text via `sql-send-*' functions.
041d709f 823
34e8a2da 824---
041d709f
CY
825*** New command `sql-connect' starts a predefined SQLi session,
826using the login parameters from `sql-connection-alist'.
827
34e8a2da 828---
041d709f
CY
829*** New "Save Connection" menu item in SQLi buffers.
830This gathers the login params specified for the SQLi session, if it
831was not started by a connection, and saves them as a new connection.
832
34e8a2da
GM
833---
834*** New commands for listing database objects and details:
835sql-list-all and sql-list-table.
041d709f 836
34e8a2da 837---
041d709f
CY
838*** An API for manipulating SQL product definitions has been added.
839
840** TeX modes
841
e74e58c9 842+++
041d709f 843*** latex-electric-env-pair-mode keeps \begin..\end matched on the fly.
412b9ee5 844
459bba37 845** Tramp
bfd779dd 846---
a808d31f 847*** There exists a new inline access method "ksu" (kerberized su).
bfd779dd 848---
459bba37 849*** The following access methods are discontinued: "ssh1_old",
ea843702 850"ssh2_old", "scp1_old", "scp2_old", "imap", "imaps" and "fish".
bfd779dd 851---
58f74fe4
MA
852*** The option `ange-ftp-binary-file-name-regexp' has changed its
853default value to "".
854
041d709f
CY
855** `url-queue-retrieve' downloads web pages asynchronously, but allow
856controlling the degree of parallelism.
177549d0 857
0c32ce32
CY
858** VC and related modes
859
2edef1a0 860+++
0c32ce32 861*** Support for pulling on distributed version control systems.
2edef1a0
CY
862`C-x v +' (`vc-pull') runs a "pull" operation, if it is supported, to
863update the current branch and working tree. A prefix argument means
864to prompt the user for specifics, e.g. a pull location.
0c32ce32 865
7d93eca9 866**** `vc-update' is now an alias for `vc-pull'.
0c32ce32 867
659114fd 868**** Currently supported by Bzr, Git, and Mercurial.
0c32ce32 869
2edef1a0 870+++
0c32ce32 871*** Support for merging on distributed version control systems.
2edef1a0
CY
872The vc-merge command now runs a "merge" operation, if it is supported,
873to merge changes from another branch into the current one. It prompts
874for specifics, e.g. a merge source.
0c32ce32 875
33f6cf7b 876**** Currently supported for Bzr, Git, and Mercurial.
0c32ce32 877
bc859d5f 878+++
2afef60a 879*** New option `vc-revert-show-diff' controls whether `vc-revert'
bbe43420 880shows a diff while querying the user. It defaults to t.
2afef60a 881
9cff91f8 882+++
d4eb88c7
CY
883*** Log entries in some Log View buffers can be toggled to display a
884longer description by typing RET (log-view-toggle-entry-display).
885In the Log View buffers made by `C-x v L' (vc-print-root-log), you can
886use this to display the full log entry for the revision at point.
887
33f6cf7b 888**** Currently supported for Bzr, Git, and Mercurial.
d4eb88c7
CY
889
890**** Packages using Log View mode can enable this functionality by
891binding `log-view-expanded-log-entry-function' to a suitable function.
892
9cff91f8 893+++
1c6c854e
CS
894*** New command `vc-ediff' allows visual comparison of two revisions
895of a file similar to `vc-diff', but using ediff backend.
896
80c6d77f 897+++
86c60681
CY
898*** The option `vc-initial-comment' was removed in Emacs 23.2, but
899this was not advertised at the time.
900
901+++
902*** `vc-toggle-read-only' is an obsolete alias for `toggle-read-only'.
903Since Emacs 23, it has done the same thing as `toggle-read-only', but
80c6d77f
GM
904this was not advertised at the time.
905
041d709f
CY
906** Obsolete modes
907
23d70505
GM
908---
909*** abbrevlist.el
910
f8ca9162
GM
911---
912*** erc-hecomplete.el (use erc-pcomplete.el instead)
23d70505
GM
913
914*** partial-completion-mode (complete.el) is obsolete.
041d709f
CY
915You can get a comparable behavior with:
916(setq completion-styles '(partial-completion initials))
917(setq completion-pcm-complete-word-inserts-delimiters t)
918
23d70505
GM
919---
920*** pc-mode.el is obsolete (CUA mode is much more comprehensive).
921
922*** pgg is obsolete (use EasyPG instead)
041d709f 923
23d70505 924---
041d709f
CY
925*** sregex.el is obsolete, since rx.el is a strict superset.
926
23d70505
GM
927---
928*** s-region.el and pc-select.el are obsolete.
929They are superseded by shift-select-mode, enabled by default since 23.1.
930
931+++
932*** vc-mcvs.el is obsolete (for lack of a maintainer)
ca5eed61 933
0fe719e6
GM
934** Miscellaneous
935
05f77e38
GM
936+++
937*** The Landmark game is now invoked with `landmark', not `lm'.
938
939---
940*** In `ido-file-completion-map', C-v is no longer bound to ido-toggle-vc.
941(This interfered with cua-mode.)
942
9f678528
GM
943+++
944*** f90.el has some support for Fortran 2008 syntax.
945
0fe719e6
GM
946---
947*** `copyright-fix-years' can optionally convert consecutive years to ranges.
948
88c5c7c8 949+++
5b3e6db8
GM
950*** New command `nato-region' converts text to NATO phonetic alphabet.
951
eb199145
GM
952\f
953* New Modes and Packages in Emacs 24.1
d445b3f8 954
5abc31ef 955+++
60e56523 956** Occur Edit mode applies edits made in *Occur* buffers to the
8c0f49f0 957original buffers. It is bound to "e" in Occur mode.
60e56523 958
a075a2c5
GM
959** New global minor mode electric-pair-mode.
960When enabled, typing an open parenthesis automatically inserts the
961matching closing one.
962
963** New global minor mode electric-indent-mode.
964When enabled, typing certain characters triggers reindentation.
965
966** New global minor mode electric-layout-mode.
967When enabled, typing certain characters automatically inserts newlines.
3b843809 968
a83ec3c9
CY
969** tabulated-list.el provides a generic major mode for tabulated data,
970from which other modes can be derived.
971
d02c9bcd
SM
972** pcase.el provides the ML-style pattern matching macro `pcase'.
973
7725ebb7
MA
974** secrets.el is an implementation of the Secret Service API, an
975interface to password managers like GNOME Keyring or KDE Wallet. The
065f2743
MA
976Secret Service API requires D-Bus for communication. The command
977`secrets-show-secrets' offers a buffer with a visualization of the
978secrets.
7725ebb7 979
f9e78150
MA
980** notifications.el provides an implementation of the Desktop
981Notifications API. It requires D-Bus for communication.
982
12fe5bcc
MA
983** soap-client.el supports access to SOAP web services from Emacs.
984soap-inspect.el is an interactive inspector for SOAP WSDL structures.
985
ff1796f3
GM
986---
987** New generic mode, xmodmap-generic-mode, for xmodmap files.
ad7d6ecb 988
cefee440 989---
53bbe3ad 990** New emacs-lock.el package.
cefee440
GM
991(The previous version has been moved to obsolete/old-emacs-lock.el.)
992Now, there is a proper minor mode `emacs-lock-mode'.
993Protection against exiting Emacs and killing the buffer can be set
994separately. The mechanism for automatically turning off protection
995for buffers with dead inferior processes has been generalized.
53bbe3ad 996
eb199145
GM
997\f
998* Incompatible Lisp Changes in Emacs 24.1
6dfcbe31 999
fa6996bc
EZ
1000---
1001** `char-direction-table' and the associated function `char-direction'
1002were deleted. They were buggy and inferior to the new support of
1003bidirectional editing introduced in Emacs 24. If you need the
1004bidirectional properties of a character, use `get-char-code-property'
1005with the last argument `bidi-class'.
1006
a6326082 1007+++
470d996d
TV
1008** `copy-directory' now copies the source directory as a subdirectory
1009of the target directory, if the latter is an existing directory. The
1010new optional arg COPY-CONTENTS, if non-nil, makes the function copy
1011the contents directly into a pre-existing target directory.
1012
25ca2e61
CY
1013** `compose-mail' now accepts an optional 8th arg, RETURN-ACTION, and
1014passes it to the mail user agent function. This argument specifies an
1015action for returning to the caller after finishing with the mail.
1016This is currently used by Rmail to delete a mail window.
1017
9173a8fb
CY
1018** For mouse click input events in the text area, the Y pixel
1019coordinate in the POSITION list now counts from the top of the text
1020area, excluding any header line. Previously, it counted from the top
1021of the header line.
1022
2b18055e
GM
1023---
1024** Support for "old-style" backquotes, which have been obsolete for
1025more than 10 years, has been further reduced. Now a backquote not
1026followed by a space is always treated as a "new-style" backquote.
1027Please consider completely removing all "old-style" backquotes from
1028your code as a matter of some urgency. If your code uses backquotes
1029as documented in the Elisp manual, and compiles without warning, then
1030you have nothing to do in this regard. Code not following the
1031appropriate conventions may fail to compile. The most common cause of
1032trouble seems to be an old-style backquote followed by a newline.
288cf4e9 1033
c31b4ce3 1034---
aab25355
GM
1035** view-buffer now treats special mode-class in the same way that
1036view-file has since Emacs 22 (ie, it won't enable View mode if the
1037major-mode is special).
fd5c9dfa 1038
e1ac4066 1039+++
60d47423
GM
1040** Passing a nil argument to a minor mode defined by define-minor-mode
1041now turns the mode ON unconditionally. This is so that you can write, e.g.
1042 (add-hook 'text-mode-hook 'foo-minor-mode)
1043to enable foo-minor-mode in Text mode buffers, thus removing the need
1044for `turn-on-foo-minor-mode' style functions.
6431f2e6 1045
ddb54206 1046+++
6431f2e6 1047** During startup, Emacs no longer adds entries for `menu-bar-lines'
0a19a6f8
JB
1048and `tool-bar-lines' to `default-frame-alist' and `initial-frame-alist'.
1049With these alist entries omitted, `make-frame' checks the value of the
1050variable `menu-bar-mode'/`tool-bar-mode' to determine whether to create
1051a menu-bar or tool-bar, respectively. If the alist entries are added,
1052they override the value of `menu-bar-mode'/`tool-bar-mode'.
6431f2e6 1053
50b063c3 1054+++
fe0aa820
CY
1055** Regions created by mouse dragging are now normal active regions,
1056similar to the ones created by shift-selection. In previous Emacs
1057versions, these regions were delineated by `mouse-drag-overlay', which
1058has now been removed.
d6d8ee7a 1059
34c99998
GM
1060+++
1061** The fourth argument of filter-buffer-substring, which says to remove
1062text properties from the final result, has been removed.
1063Eg simply pass the result through substring-no-properties if you need this.
1064
334023be 1065---
4583e796
GM
1066** cl.el no longer provides `cl-19'.
1067
be890cb8
SM
1068** The menu bar bindings's caches are not used any more.
1069Use (where-is-internal <def> nil t) instead.
1070
3a970881
GM
1071+++
1072** The following obsolete (mostly since at least 21.1) functions and aliases
1073have been removed (the appropriate new function is given in parentheses):
1074comint-kill-output (comint-delete-output),
1075decompose-composite-char (char-to-string),
1076outline-visible (outline-invisible-p),
1077internal-find-face (facep), internal-get-face (facep and check-face),
1078frame-update-faces (not needed),
1079frame-update-face-colors (frame-set-background-mode),
1080x-frob-font-weight and x-frob-font-slant (appropriate make-face-* function),
1081x-make-font-bold and x-make-font-demibold (make-face-bold),
1082x-make-font-italic and x-make-font-oblique (make-face-italic),
1083x-make-font-bold-italic (make-face-bold-italic),
1084x-make-font-unbold (make-face-unbold),
1085x-make-font-unitalic (make-face-unitalic),
1086mldrag-drag-mode-line (mouse-drag-mode-line),
1087mldrag-drag-vertical-line (mouse-drag-vertical-line),
1088iswitchb-default-keybindings (iswitchb-mode), char-bytes (== 1),
1089isearch-return-char (isearch-printing-char), make-local-hook (not needed)
1090
1091+++
1092** The following obsolete (mostly since at least 21.1) variables and varaliases
1093have been removed (the appropriate new variable is given in parentheses):
1094checkdoc-minor-keymap (checkdoc-minor-mode-map),
1095vc-header-alist (vc-BACKEND-header), directory-sep-char (== ?/)
1096font-lock-defaults-alist (font-lock-defaults), and e (float-e).
3226d6ca 1097
334023be 1098---
041d709f 1099** The following obsolete files were removed:
7b0e3048
GM
1100sc.el, x-menu.el, rnews.el, rnewspost.el
1101
33658d4e
CY
1102** FIXME finder-inf.el changes.
1103
eb199145
GM
1104\f
1105* Lisp changes in Emacs 24.1
9097e8af 1106
735cc5ca 1107+++
041d709f
CY
1108** Code can now use lexical scoping by default instead of dynamic scoping.
1109The `lexical-binding' variable lets code use lexical scoping for local
48da7392
GM
1110variables. It is typically set via a file-local variable in the first
1111line of the file, in which case it applies to all the code in that file.
735cc5ca 1112+++
041d709f
CY
1113*** `eval' takes a new optional argument `lexical' to choose the new lexical
1114binding instead of the old dynamic binding mode.
735cc5ca 1115+++
041d709f
CY
1116*** Lexically scoped interpreted functions are represented with a new form
1117of function value which looks like (closure ENV ARGS &rest BODY).
1118
1119*** New macro `letrec' to define recursive local functions.
735cc5ca 1120+++
041d709f
CY
1121*** New function `special-variable-p' to check whether a variable is
1122declared as dynamically bound.
1123
d273439c 1124+++
041d709f
CY
1125** An Emacs Lisp testing tool is now included.
1126Emacs Lisp developers can use this tool to write automated tests for
1127their code. See the ERT info manual for details.
1128
1129** Changes for bidirectional display and editing
f1816485 1130
041d709f
CY
1131+++
1132*** New function `current-bidi-paragraph-direction'.
f1816485
EZ
1133This returns the actual value of base direction of the paragraph at
1134point.
041d709f
CY
1135
1136+++
1137*** New function `bidi-string-mark-left-to-right'.
f1816485
EZ
1138Given a string containing characters from right-to-left (RTL) scripts,
1139this function returns another string which can be safely inserted into
1140a buffer, such that any following text will be always displayed to the
1141right of that string. (This works by appending the Unicode
1142"LEFT-TO-RIGHT MARK" character when the argument string might need that.)
041d709f
CY
1143
1144This is useful when the buffer has overall left-to-right (LTR)
1145paragraph direction and you need to insert a string whose contents and
f1816485
EZ
1146directionality are not known in advance, without disrupting the layout
1147of the line.
041d709f 1148
bee0fcef 1149** Window changes
c4682d18
MR
1150+++
1151*** Window tree functions are accessible in Elisp.
1152Functions are provided to return the parent, siblings or child windows
1153of any window including internal windows (windows not associated with a
1154buffer) in the window tree.
291d142b 1155+++
24300f5f
CY
1156**** New function `window-valid-p' gives non-nil for live and internal
1157windows.
c4682d18 1158+++
24300f5f 1159**** Window manipulation can deal with internal windows.
c4682d18
MR
1160Many window handling functions like `split-window', `delete-window', or
1161`delete-other-windows' as well as the window resizing functions can now
1162act on any window including internal ones.
c4682d18
MR
1163+++
1164*** window-total-height/-width vs window-body-height/-width.
1165The function `window-height' has been renamed to `window-total-height'
1166and `window-width' has been renamed to `window-body-width'. The old
1167names are provided as aliases. Two new functions `window-total-width'
1168and `window-body-height' are provided.
c4682d18
MR
1169+++
1170*** Window parameters specific to window handling functions.
1171For each window you can specify a parameter to override the default
1172behavior of a number of functions like `split-window', `delete-window'
ed6235ea
MR
1173and `delete-other-windows'. The variable `ignore-window-parameters'
1174allows to ignore processing such parameters.
c4682d18
MR
1175+++
1176*** New semantics of third argument of `split-window'.
c4682d18
MR
1177The third argument of `split-window' has been renamed to SIDE and can be
1178set to any of the values 'below, 'right, 'above, or 'left to make the
1179new window appear on the corresponding side of the window that shall be
1180split. Any other value of SIDE will cause `split-window' to split the
1181window into two side-by-side windows as before.
c4682d18
MR
1182+++
1183*** Window resizing functions.
487ffd7a 1184A new standard function for resizing windows called `window-resize' has
c4682d18
MR
1185been introduced. This and all other functions for resizing windows no
1186longer delete any windows when they become too small.
b3c0dbfd
MR
1187+++
1188*** Deleting the selected window now selects the most recently selected
1189live window on that frame instead.
c4682d18
MR
1190+++
1191*** `adjust-window-trailing-edge' adjustments.
1192`adjust-window-trailing-edge' can now deal with fixed-size windows and
1193is able to resize other windows if a window adjacent to the trailing
1194edge cannot be shrunk any more. This makes its behavior more similar to
1195that of Emacs 21 without compromising, however, its inability to delete
1196windows which was introduced in Emacs 22.
c4682d18
MR
1197+++
1198*** Window-local buffer lists.
1199Windows now have local buffer lists. This means that removing a buffer
1200from display in a window will preferably show the buffer previously
1201shown in that window with its previous window-start and window-point
1202positions. This also means that the same buffer may be automatically
1203shown twice even if it already appears in another window.
0e406a72 1204+++
bee0fcef
CY
1205*** `switch-to-buffer' has a new optional argument FORCE-SAME-WINDOW,
1206which if non-nil requires the buffer to be displayed in the currently
1207selected window, signaling an error otherwise. If nil, another window
1208can be used, e.g. if the selected one is strongly dedicated.
24300f5f 1209+++
0a2132ba 1210*** `split-window-vertically' and `split-window-horizontally' renamed
2d197ffb
CY
1211to `split-window-below' and `split-window-right' respectively.
1212The old names are kept as aliases.
24300f5f 1213+++
0a2132ba
CY
1214*** Display actions
1215
1216**** The second arg to `display-buffer' and `pop-to-buffer' is now
1217named ACTION, and takes a display action of the same form as
1218`display-buffer-base-action' (see Changes, above). A non-nil,
1219non-list value is treated specially, as the old meaning.
1220
1221**** New variable `display-buffer-overriding-action'.
1222
1223**** The procedure of `display-buffer' etc. to choose a window is
1224determined by combining `display-buffer-overriding-action',
1225`display-buffer-alist', the ACTION arg, `display-buffer-base-action',
1226and `display-buffer-fallback-action'. The second and fourth of these
1227are user-customizable variables.
1228
1229See the docstring of `display-buffer' for details.
bee0fcef 1230
ed6235ea
MR
1231+++
1232*** New behavior of `quit-window'.
1233The behavior of `quit-window' has been changed in order to restore the
1234state before the last buffer display operation in that window.
1235
d83dc65b
MR
1236+++
1237*** The new option `frame-auto-hide-function' lets you choose between
53964682 1238iconifying or deleting a frame when burying a buffer shown in a dedicated
d83dc65b
MR
1239frame or quitting a window showing a buffer in a frame of its own.
1240
20d2304d
CY
1241+++
1242*** New functions `window-state-get' and `window-state-put'.
1243These functions allow to save and restore the state of an arbitrary
1244frame or window as an Elisp object.
1245
a2a25d24 1246** Completion
041d709f 1247
a2a25d24
SM
1248*** New variable completion-extra-properties used to specify extra properties
1249of the current completion:
1250- :annotate-function, same as the old completion-annotate-function.
1251- :exit-function, function to call after completion took place.
1252
1253*** Functions on completion-at-point-functions can return any of the properties
1254valid for completion-extra-properties.
1255
1256*** completion-annotate-function is obsolete.
1257
620c53a6
SM
1258*** New `metadata' method for completion tables. The metadata thus returned
1259can specify various details of the data returned by `all-completions':
1260- `category' is the kind of objects returned (e.g., `buffer', `file', ...),
1261 used to select a style in completion-category-overrides.
1262- `annotation-function' to add annotations in *Completions*.
1263- `display-sort-function' to specify how to sort entries in *Completions*.
1264- `cycle-sort-function' to specify how to sort entries when cycling.
1265
de09aa52
CY
1266*** minibuffer-local-filename-must-match-map is not used any more.
1267Instead, the bindings in minibuffer-local-filename-completion-map are
1268combined with minibuffer-local-must-match-map.
1269
1270*** New variable `completing-read-function' allows overriding the
1271behavior of `completing-read'.
1272
d366bd53 1273+++
f042970d 1274** `glyphless-char-display' can now distinguish between graphical and
16a43933
CY
1275text terminal display, via a char-table entry that is a cons cell.
1276
da91b5f2
CY
1277** `open-network-stream' can now be used to open an encrypted stream.
1278It now accepts an optional `:type' parameter for initiating a TLS
1279connection, directly or via STARTTLS. To do STARTTLS, additional
1280parameters (`:end-of-command', `:success', `:capabilities-command')
1281must also be supplied.
1282
ddb54206 1283+++
f6d62986
SM
1284** pre/post-command-hook are not reset to nil upon error.
1285Instead, the offending function is removed.
1286
b1f6fa26
CY
1287** New hook types
1288
e7bc51d0 1289+++
b1f6fa26
CY
1290*** New function `run-hook-wrapped' for running an abnormal hook by
1291passing the hook functions as arguments to a "wrapping" function.
e7bc51d0 1292Like `run-hook-with-args-until-success', it stops at the first
5385447f 1293non-nil return value.
e7bc51d0 1294
b1f6fa26
CY
1295+++
1296*** New macro `with-wrapper-hook' for running an abnormal hook as a
1297set of "wrapping" filters, similar to around advice.
54521c99
GM
1298(A version of this macro was actually added in Emacs 23.2 but was not
1299advertised at the time.)
f6d62986 1300
866c1d22
GM
1301+++
1302** The macros `condition-case-no-debug' and `with-demoted-errors' were
1303added in Emacs 23.1, but not advertised.
d6b1d521 1304
953cebf5
GM
1305+++
1306** The new function `server-eval-at' allows evaluation of Lisp forms on
1307named Emacs server instances, using TCP sockets.
7deebf1b 1308
1b9f60cc
GM
1309+++
1310** `call-process' and `call-process-region' allow a `(:file "file")' spec
1311to redirect STDOUT to a file.
7deebf1b 1312
04e2ce72
CY
1313---
1314** Variable `stack-trace-on-error' removed.
e7f7fbaa
SM
1315Also the debugger can now "continue" from an error, which means it will jump
1316to the error handler as if the debugger had not been invoked instead of
1317jumping all the way to the top-level.
1318
da97a9e6
CY
1319+++
1320** The function format-time-string now supports the %N directive, for
1321higher-resolution time stamps.
1322
7e2734bc 1323+++
3ef01959
CY
1324** New function `read-char-choice' reads a restricted set of characters,
1325discarding any inputs not inside the set.
1326
4dee2dea 1327+++
2e288d54
JB
1328** `image-library-alist' is renamed to `dynamic-library-alist'.
1329The variable is now used to load all kind of supported dynamic libraries,
1330not just image libraries. The previous name is still available as an
1331obsolete alias.
1332
04e2ce72
CY
1333** New variable `syntax-propertize-function'.
1334This replaces `font-lock-syntactic-keywords' which is now obsolete.
cf38dd42
SM
1335This allows syntax-table properties to be set independently from font-lock:
1336just call syntax-propertize to make sure the text is propertized.
1337Together with this new variable come a new hook
1338syntax-propertize-extend-region-functions, as well as two helper functions:
1339syntax-propertize-via-font-lock to reuse old font-lock-syntactic-keywords
1340as-is; and syntax-propertize-rules which provides a new way to specify
1341syntactic rules.
1342
f58b9822 1343+++
a2e5caf7
SM
1344** New hook post-self-insert-hook run at the end of self-insert-command.
1345
7cf78aac 1346+++
c5683ceb 1347** Syntax tables support a new "comment style c" additionally to style b.
041d709f 1348
4dee2dea 1349---
4e2db1fe 1350** frame-local variables cannot be let-bound any more.
041d709f 1351
15de15c6 1352** Major and minor mode changes
3fd50d5c 1353+++
15de15c6
CY
1354*** `prog-mode' is a new major mode from which programming modes
1355should be derived.
041d709f 1356
c2f03a4a 1357+++
15de15c6
CY
1358**** `prog-mode-hook' can be used to enable features for programming
1359modes, e.g. (add-hook 'prog-mode-hook 'flyspell-prog-mode) to enable
1360on-the-fly spell checking for comments and strings.
1361
12f381b7 1362+++
15de15c6
CY
1363*** New hook `change-major-mode-after-body-hook', run by
1364`run-mode-hooks' just before any other mode hooks.
1365
c7301fe4 1366+++
7a9a2fc6
GM
1367*** Enabled globalized minor modes can be disabled in specific major modes.
1368If the global mode is global-FOO-mode, then run (FOO-mode -1) in the
1369major mode's hook, where FOO-mode toggles the mode on a per-buffer basis.
15de15c6 1370
56afad3a 1371+++
15de15c6 1372*** `define-minor-mode' accepts a new keyword :variable.
f44379e7 1373
04e2ce72 1374+++
b2957ea8 1375** `delete-file' and `delete-directory' now accept optional arg TRASH.
f1a5d776
CY
1376Trashing is performed if TRASH and `delete-by-moving-to-trash' are
1377both non-nil. Interactively, TRASH defaults to t, unless a prefix
1378argument is supplied (see Trash changes, above).
53967e09 1379
94bc7984 1380---
9317e499 1381** `facemenu-read-color' is now an alias for `read-color'.
94bc7984
GM
1382
1383+++
1384** The command `read-color' now requires a match for a color name
1385or RGB triplet, instead of signaling an error if the user provides
1386invalid input.
9317e499 1387
f7c9199f 1388+++
4039c786
CY
1389** Tool-bars can display separators.
1390Tool-bar separators are handled like menu separators in menu-bar maps,
94975270 1391i.e. via menu entries of the form `(menu-item "--")'.
9317e499 1392
00fe2df1
JL
1393** Image API
1394
eea14f31 1395+++
18af70d0
CY
1396*** Animated images support (currently animated gifs only).
1397
eea14f31 1398+++
18af70d0
CY
1399**** `image-animated-p' returns non-nil if an image can be animated.
1400
eea14f31 1401+++
18af70d0
CY
1402**** `image-animate' animates a supplied image spec.
1403
eea14f31 1404+++
18af70d0
CY
1405**** `image-animate-timer' returns the timer object for an image that
1406is being animated.
00fe2df1 1407
7cb76fe0
GM
1408---
1409*** `image-extension-data' has been renamed to `image-metadata'.
1410The old name is an obsolete alias to the new one.
1546c559 1411
bba26374 1412+++
b4ac6e8c
GM
1413*** Image mode can view any image type that ImageMagick supports.
1414This requires Emacs to be built with ImageMagick support.
31fd3586
GM
1415Then the function `imagemagick-types' returns a list of image file
1416extensions that your installation of ImageMagick supports. The
041d709f
CY
1417function `imagemagick-register-types' enables ImageMagick support for
1418these image types, minus those listed in `imagemagick-types-inhibit'.
bba26374 1419Visiting one of these file types will then use Image mode.
041d709f 1420
b4ac6e8c
GM
1421---
1422*** New commands to resize and rotate images in Image mode.
1423These require Emacs to be built with ImageMagick support.
1424image-transform-fit-to-height, image-transform-fit-to-width,
1425image-transform-set-rotation, image-transform-set-scale.
1426
71c17aec 1427** XML and HTML parsing
043efd56
GM
1428If Emacs is compiled with libxml2 support, there are two new functions:
1429`libxml-parse-html-region' (which parses "real world" HTML) and
1430`libxml-parse-xml-region' (which parses XML). Both return an Emacs
1431Lisp parse tree.
4b9832a6
CY
1432
1433FIXME: These should be front-ended by xml.el.
1434
e2574f2c
TZ
1435** GnuTLS
1436
31fd3586 1437*** New library `gnutls.el'.
573559b4 1438This requires Emacs to have been built with GnuTLS support.
31fd3586
GM
1439The main functions are `open-gnutls-stream' and `gnutls-negotiate'.
1440It's easiest to use these functions through `open-network-stream'
1441because it can upgrade connections through STARTTLS opportunistically
1442or use plain SSL, depending on your needs. For debugging, set
1443`gnutls-log-level' greater than 0.
71c17aec 1444
a6020335
MH
1445** Isearch
1446
7cb76fe0 1447---
a6020335
MH
1448*** New hook `isearch-update-post-hook' that runs in `isearch-update'.
1449
ddb54206 1450+++
9326ba26
CY
1451** Progress reporters can now "spin".
1452The MIN-VALUE and MAX-VALUE arguments of `make-progress-reporter' can
1453now be nil, or omitted. This makes a "non-numeric" reporter. Each
1454time you call `progress-reporter-update' on that progress reporter,
1455with a nil or omitted VALUE argument, the reporter message is
1456displayed with a "spinning bar".
1457
8f05da42 1458+++
3e214b50
JB
1459** New variable `revert-buffer-in-progress-p' is true while a buffer is
1460being reverted, even if the buffer has a local `revert-buffer-function'.
1461
001bf877
GM
1462---
1463** New variables `delayed-warnings-list' and `delayed-warnings-hook'.
1464If delayed-warnings-list is non-nil, the command loop calls
1465delayed-warnings-hook after post-command-hook. At present, this is
1466only used by Emacs on some platforms to display warnings during
1467startup, which might otherwise not be noticed. This uses the functions
1468display-delayed-warnings and collapse-delayed-warnings.
1469
638f053a 1470
e145f188
GM
1471+++
1472** `set-auto-mode' now respects mode: local variables at the end of files,
1473as well as those in the -*- line.
1474
6420d28b
CY
1475---
1476** rx.el has a new `group-n' construct for explicitly numbered groups.
1477
dac86404
GM
1478+++
1479** New function `make-composed-keymap' that constructs a new keymap
1480from multiple input maps. You can use this to make a keymap that
1481inherits from multiple maps, eg:
1482 (set-keymap-parent newmap (make-composed-keymap othermap parent))
43dc9f5b 1483
7aa5aad8
GM
1484+++
1485** Set `debug-on-event' to make Emacs enter the debugger e.g. on receipt
1486of SIGUSR1. This can be useful when `inhibit-quit' is set.
12ca40ec 1487
ddb54206 1488+++
27f7ef2f 1489** New reader macro ## that stands for the empty symbol.
43dc9f5b
AS
1490This means that the empty symbol can now be read back. Also, #: by itself
1491(when not immediately followed by a possible symbol character) stands for
1492an empty uninterned symbol.
041d709f 1493
fead402d
CY
1494+++
1495** New math functions `isnan', `copysign', `frexp', `ldexp'.
1496
041d709f
CY
1497** Obsolete functions and variables
1498
05f77e38
GM
1499---
1500*** `tooltip-use-echo-area' is obsolete.
1501Rather than setting this to t, disable Tooltip mode instead.
1502
34c99998 1503+++
041d709f
CY
1504*** buffer-substring-filters is obsolete.
1505Use `filter-buffer-substring-functions' instead.
1506
7cb76fe0 1507---
041d709f
CY
1508*** `byte-compile-disable-print-circle' is obsolete.
1509
f160676e 1510---
041d709f 1511*** `deferred-action-list' and `deferred-action-function' are obsolete.
f160676e
GM
1512Use `post-command-hook' instead.
1513
d366bd53 1514+++
67e729a5
CY
1515*** `font-lock-maximum-size' is obsolete.
1516
eb199145
GM
1517\f
1518* Changes in Emacs 24.1 on non-free operating systems
d53a60a6 1519
a2f0118c 1520---
7a22e700 1521** On MS Windows, Emacs warns when using the obsolete init file _emacs,
a2f0118c
GM
1522and also when HOME is set to C:\ by default.
1523
7a22e700 1524** New configure.bat options
04779484 1525
a0d363f4 1526+++
7a22e700 1527*** --enable-checking builds Emacs with extra runtime checks.
e3aef5c6 1528
a0d363f4 1529+++
7a22e700 1530*** --distfiles specifies files to be included in binary distribution.
e2574f2c 1531
a0d363f4 1532+++
7a22e700
OK
1533*** --without-gnutls disables automatic GnuTLS detection.
1534
a0d363f4
GM
1535+++
1536*** --lib for general library linkage, works with the USER_LIBS build variable.
e2574f2c 1537
a0d363f4 1538+++
0a19a6f8 1539** New make target `dist' to create binary distribution for MS Windows.
e3aef5c6 1540
1f5e1a16
GM
1541---
1542** The Lisp function `w32-default-color-map' is now obsolete.
1543(It is only used internally in the Emacs C code.)
5430d399 1544
1f5e1a16
GM
1545+++
1546** Customize ns-auto-hide-menu-bar to have the menu-bar hidden, but
1547reappear on mouse-over. (Requires OS X 10.6 or later.)
04e2ce72 1548
05197f40 1549\f
a933dad1 1550----------------------------------------------------------------------
5b87ad55 1551This file is part of GNU Emacs.
a933dad1 1552
ab73e885 1553GNU Emacs is free software: you can redistribute it and/or modify
5b87ad55 1554it under the terms of the GNU General Public License as published by
ab73e885
GM
1555the Free Software Foundation, either version 3 of the License, or
1556(at your option) any later version.
5b87ad55
GM
1557
1558GNU Emacs is distributed in the hope that it will be useful,
1559but WITHOUT ANY WARRANTY; without even the implied warranty of
1560MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1561GNU General Public License for more details.
a933dad1 1562
5b87ad55 1563You should have received a copy of the GNU General Public License
ab73e885 1564along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
a933dad1 1565
05197f40 1566\f
a933dad1
DL
1567Local variables:
1568mode: outline
1569paragraph-separate: "[ \f]*$"
1570end: