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