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