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