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