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