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