NEWS 67.5 KB
Newer Older
1
GNU Emacs NEWS -- history of user-visible changes.
2

Glenn Morris's avatar
Glenn Morris committed
3
Copyright (C) 2010-2012 Free Software Foundation, Inc.
4
See the end of the file for license conditions.
Dave Love's avatar
#  
Dave Love committed
5

6
Please send Emacs bug reports to bug-gnu-emacs@gnu.org.
7 8
If possible, use M-x report-emacs-bug.

9
This file is about changes in Emacs version 24.
10

11 12
See files NEWS.23, NEWS.22, NEWS.21, NEWS.20, NEWS.19, NEWS.18,
and NEWS.1-17 for changes in older Emacs versions.
13 14 15

You can narrow news to a specific version by calling `view-emacs-news'
with a prefix argument or by typing C-u C-h C-n.
16

Glenn Morris's avatar
Glenn Morris committed
17 18 19 20 21 22 23 24
Temporary note:
+++ indicates that the appropriate manual has already been updated.
--- means no change in the manuals is called for.
When you add a new item, please add it without either +++ or ---
so we will look at it and add it to the manual.


* Installation Changes in Emacs 24.2
25 26 27 28 29

** New configure option '--enable-gcc-warnings', intended for developers.
If building with GCC, this enables compile-time checks that warn about
possibly-questionable C code.  On a recent GNU system there should be
no warnings; on older and on non-GNU systems the generated warnings
Paul Eggert's avatar
Paul Eggert committed
30
may be useful.
31

32 33 34
---
** Emacs uses libtinfo in preference to libncurses, if available.

35 36 37 38 39
---
** On FreeBSD and NetBSD, configure no longer adds /usr/local/lib and
/usr/pkg/lib to the linker search path.  You must add them yourself if
you want them.

40 41 42 43
---
** On Mac OS X, configure no longer automatically adds the Fink /sw
directories to the search path.  You must add them yourself if you want them.

Glenn Morris's avatar
Glenn Morris committed
44 45

* Startup Changes in Emacs 24.2
46 47 48 49 50

** Emacs no longer searches for `leim-list.el' files beneath the standard
lisp/ directory.  There should not be any there anyway.  If you have
been adding them there, put them somewhere else, eg site-lisp.

Glenn Morris's avatar
Glenn Morris committed
51 52 53

* Changes in Emacs 24.2

54 55 56
** New functions `system-users', `system-groups' return lists of the user
name, group names known to the system (where possible).

Glenn Morris's avatar
Glenn Morris committed
57 58 59
** If your Emacs was built from a bzr checkout, the new variable
`emacs-bzr-version' contains information about which bzr revision was used.

60 61 62
** ImageMagick support, if available, is automatically enabled.
It is no longer necessary to call `imagemagick-register-types'
explicitly to install ImageMagick image types; that function is called
63
automatically at startup or when customizing `imagemagick-types-inhibit'.
64 65

*** Setting `imagemagick-types-inhibit' to t now disables the use of
66 67
ImageMagick to view images.  You must call imagemagick-register-types
afterwards if you do not use customize to change this.
68

69 70 71 72
** String values for `initial-buffer-choice' also apply to emacsclient
frames, if emacsclient is only told to open a new frame without
specifying any file to visit or expression to evaluate.

73 74 75 76
+++
** You can prevent the creation of lock files by setting `create-lockfiles'
to nil.  Use with caution, and only if you really need to.

77
+++
78
** Using "unibyte: t" in Lisp source files is obsolete.
Glenn Morris's avatar
Glenn Morris committed
79
Use "coding: raw-text" instead.
80

Glenn Morris's avatar
Glenn Morris committed
81 82

* Editing Changes in Emacs 24.2
83 84 85 86

** M-x move-to-column, if called interactively with no prefix arg, now
prompts for a column number.

87 88 89
** `mouse-avoidance-banish-position' can now be used to customize
`mouse-avoidance-mode' further.

90 91 92
** `C-M-f' and `C-M-b' will now move to the path name separator
character when doing minibuffer filename prompts.

93 94
** `goto-char' is now bound to `M-g c'.

Glenn Morris's avatar
Glenn Morris committed
95 96

* Changes in Specialized Modes and Packages in Emacs 24.2
97

98 99 100 101 102 103
** VHDL-mode
- Support for ghdl (free vhdl compiler).  Now default.
- Add/update support for VHDL-AMS packages.
- Update to VHDL'02 standard.
- Accept \r and \f as whitespace.

104 105 106 107 108 109 110 111 112 113 114
** Diff mode

Faces for changes now use the same diff color scheme as in modern VCSes
where deletions are displayed in red (new faces `diff-refine-removed'
and `smerge-refined-removed' and new definition of `diff-removed'),
insertions in green (new faces `diff-refine-added' and
`smerge-refined-added' and new definition of `diff-added').
The variable `diff-use-changed-face' defines whether to use
the face `diff-changed', or `diff-removed' and `diff-added'
to highlight changes in context diffs.

115 116 117 118 119
** `sh-script'
*** Pairing of parens/quotes uses electric-pair-mode instead of skeleton-pair.
*** `sh-electric-here-document-mode' now controls auto-insertion of here-docs.
*** `sh-use-smie' lets you choose a new indentation and navigation code.

120 121 122
** reStructuredText mode

*** Nearly all keys are rebound making room for more keys and comply
Glenn Morris's avatar
Glenn Morris committed
123
better to usage in other modes.  Bindings are described with C-c C-h.
124

Glenn Morris's avatar
Glenn Morris committed
125 126
*** Major revision of indentation.  Now works very similarly to other modes.
TAB is your friend.
127

Glenn Morris's avatar
Glenn Morris committed
128 129
*** Major revision of filling.  Works fine with most of
reStructuredText syntax.  Auto-filling is also supported.
130 131 132

*** Major revision of comment handling.

Glenn Morris's avatar
Glenn Morris committed
133
*** Major revision of fontification.  Now works with `jit-lock-mode'.
134 135 136 137

*** reStructuredText syntax is covered more closely in many cases.
Among other things this improves the experience for Sphinx users.

Glenn Morris's avatar
Glenn Morris committed
138
*** `rst-insert-list' inserts a new list or continues existing lists.
139 140 141 142 143 144 145

*** Customization is extended, corrected and improved.

*** Negative prefix argument always works for `rst-adjust'.

*** Window configuration is reset after displaying TOC.

Glenn Morris's avatar
Glenn Morris committed
146
*** There is a package version in `rst-version'.
147

148 149
** New `derived-mode' filter for Ibuffer, bound to `/ M'.
`/ m' is now bound to filter by used-mode, which used to be bound to `/ M'.
150

Chong Yidong's avatar
Chong Yidong committed
151 152 153 154 155 156 157 158 159
** Apropos

*** The faces used by Apropos are now directly customizable.
These faces are named `apropos-symbol', `apropos-keybinding', and so on;
see the `apropos' Custom group for details.

**** The old options whose values specified faces to use were removed
(i.e. `apropos-symbol-face', `apropos-keybinding-face', etc.).

160 161
** Calendar

162 163
*** The calendars produced by cal-html include holidays.
Customize cal-html-holidays to change this.
164

165 166 167
** Customize

*** `custom-reset-button-menu' now defaults to t.
168

169 170 171 172
*** Non-option variables are never matched in `customize-apropos' and
`customize-apropos-options' (i.e. the prefix argument does nothing for
these commands now).

173
** erc will look up server/channel names via auth-source and use the
174
channel keys found, if any.
175

176 177 178 179 180 181
** FFAP

*** The option `ffap-url-unwrap-remote' can now be a list of strings,
specifying URL types which should be converted to remote file names at
the FFAP prompt.  The default is now '("ftp").

182 183 184 185 186 187 188
** Follow mode

*** The obsolete variable `follow-mode-off-hook' has been removed.

*** Follow mode no longer works by using advice.
The option `follow-intercept-processes' has been removed.

189 190
** The `server-auth-key' variable can be used to set a permanent
shared key for Emacs Server.
191 192 193 194

** In Perl mode, new option `perl-indent-parens-as-block' causes non-block
closing brackets to be aligned with the line of the opening bracket.

Glenn Morris's avatar
Glenn Morris committed
195 196
** FIXME something happened to ses.el, 2012-04-17.

197 198
** which-function-mode now applies to all applicable major modes by default.

199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228
** D-Bus

+++
*** New variables `dbus-compiled-version' and `dbus-runtime-version'.

+++
*** The D-Bus object manager interface is implemented.

+++
*** Variables of type :(u)int32 and :(u)int64 accept floating points,
if their value does not fit into Emacs's integer range.

+++
*** The function `dbus-call-method' works non-blocking now, it can be
interrupted by C-g.  `dbus-call-method-non-blocking' is obsolete.

+++
*** Signals can be sent also as unicast message.

+++
*** The argument list of `dbus-register-signal' has been extended,
according to the new match rule types of D-Bus.  See the manual for
details.

+++
*** `dbus-init-bus' supports private connections.

+++
*** There is a new function `dbus-setenv'.

229 230 231 232 233
+++
** notifications.el supports now version 1.2 of the Notifications API.
The function `notifications-get-capabilities' returns the supported
server properties.

234 235
** Tabulated List and packages derived from it

236
*** New command `tabulated-list-sort', bound to `S', sorts the column
237 238
at point, or the Nth column if a numeric prefix argument is given.

239 240 241 242 243 244 245 246 247 248 249 250
** URL

*** Structs made by `url-generic-parse-url' have nil `attributes' slot.
Previously, this slot stored semicolon-separated attribute-value pairs
appended to some imap URLs, but this is not compatible with RFC 3986.
So now the `filename' slot stores the entire path and query components
and the `attributes' slot is always nil.

*** New function `url-encode-url' for encoding a URI string.
The `url-retrieve' function now uses this to encode its URL argument,
in case that is not properly encoded.

Glenn Morris's avatar
Glenn Morris committed
251 252
** Obsolete packages:

253 254 255 256 257
*** assoc.el
In most cases, assoc+member+push+delq work just as well.
And in any case it's just a terrible package: ugly semantics, terrible
inefficiency, and not namespace-clean.

258 259
*** bruce.el

Glenn Morris's avatar
Glenn Morris committed
260
*** mailpost.el
261 262 263

*** mouse-sel.el

264 265
*** patcomp.el

Glenn Morris's avatar
Glenn Morris committed
266 267 268 269

* New Modes and Packages in Emacs 24.2

* Incompatible Lisp Changes in Emacs 24.2
270 271 272 273 274 275 276

+++
** Docstrings starting with `*' no longer indicate user options.
Only variables defined using `defcustom' are considered user options.
The function `user-variable-p' is now an obsolete alias for
`custom-variable-p'.

277 278 279
** `face-spec-set' no longer sets frame-specific attributes when the
third argument is a frame (that usage was obsolete since Emacs 22.2).

280 281 282 283 284
+++
** The arguments of `dbus-register-signal' are no longer just strings,
but keywords or keyword-string pairs.  The old argument list will
still be supported for Emacs 24.x.

285 286 287 288 289
** The following obsolete variables and varaliases have been removed:

*** `facemenu-unlisted-faces'
*** `rmail-decode-mime-charset'

Glenn Morris's avatar
Glenn Morris committed
290 291

* Lisp changes in Emacs 24.2
292

293 294 295 296
** New function `set-temporary-overlay-map'.

** New macros `setq-local' and `defvar-local'.

297
** New error type and new function `user-error'.  Doesn't trigger the debugger.
298

299 300 301 302 303 304 305
** Completion

*** New function `completion-table-with-quoting' to handle completion
in the presence of quoting, such as file completion in shell buffers.

*** New function `completion-table-subvert' to use an existing completion
table, but with a different prefix.
306 307 308 309 310 311

** Time

*** `current-time-string' no longer requires that its argument's year
must be in the range 1000..9999.  It now works with any year supported
by the underlying C implementation.
312 313

** `automount-dir-prefix' is obsolete.
314
** `buffer-has-markers-at' is obsolete.
315 316 317 318 319 320 321 322

* Changes in Emacs 24.2 on non-free operating systems

** New configure.bat options on MS-Windows:

*** --without-libxml2 omits support for libxml2, even if its presence
is detected.

323 324 325 326
** When invoked with the -nw switch to run on the Windows text-mode terminal,
Emacs now supports mouse highlight, help-echo (in the echo area), and
mouse-autoselect-window.

327

328
* Installation Changes in Emacs 24.1
Chong Yidong's avatar
Chong Yidong committed
329

330 331 332 333
** Emacs can be compiled with Gtk+ 3.0 if you pass --with-x-toolkit=gtk3
to configure.  Note that other libraries used by Emacs, RSVG and GConf,
also depend on Gtk+.  You can disable them with --without-rsvg and
--without-gconf.
334

335 336 337 338
** Emacs can be compiled with GnuTLS support.
This happens by default if a suitably recent version of the library is
found at build time.  To prevent this, use the configure option
`--without-gnutls'.  See below for GnuTLS features.
339

340 341 342 343
** Emacs can be compiled with SELinux support.
This happens by default if a suitably recent version of the library is
found at build time.  To prevent this, use the configure option
`--without-selinux'.  See below for SELinux features.
Glenn Morris's avatar
Glenn Morris committed
344

345 346 347 348
** Emacs can be compiled with ImageMagick support.
This happens by default if a suitably recent version of the library is
found at build time.  To prevent this, use the configure option
`--without-imagemagick'.  See below for ImageMagick features.
Glenn Morris's avatar
Glenn Morris committed
349
This feature is not available for the Nextstep or MS ports.
350

351 352 353 354 355
** Emacs can be compiled with libxml2 support.
This happens by default if a suitably recent version of the library is
found at build time.  To prevent this, use the configure option
`--without-xml2'.  See below for libxml2 features.

356 357 358 359
** By default, the installed Info and man pages are compressed.
You can disable this by configuring --without-compress-info.

** New configure option --with-wide-int.
Paul Eggert's avatar
Paul Eggert committed
360
With it, Emacs integers typically have 62 bits, even on 32-bit machines.
361 362
On 32-bit hosts, this raises the limit on buffer sizes from about 512 MiB
to about 2 GiB.
Paul Eggert's avatar
Paul Eggert committed
363

364
** New configure options: --with-mmdf, --with-mail-unlink, --with-mailhost.
365 366 367
These provide no new functionality, they just remove the need to edit
lib-src/Makefile by hand in order to use the associated features.

368
** New configure option --enable-use-lisp-union-type.
369 370
This is only useful for Emacs developers to debug certain types of bugs.
This is not a new feature; only the configure flag is new.
Chong Yidong's avatar
Chong Yidong committed
371 372 373 374 375 376 377

** The standalone programs digest-doc and sorted-doc are removed.
Emacs now uses Lisp commands `doc-file-to-man' and `doc-file-to-info'.

** The standalone program `fakemail' is removed.
If you need it, feedmail.el provides a superset of the functionality.

378

379
* Startup Changes in Emacs 24.1
380

381
** The --unibyte, --multibyte, --no-multibyte, and --no-unibyte
Glenn Morris's avatar
Glenn Morris committed
382 383
command line arguments, and the EMACS_UNIBYTE environment variable, no
longer have any effect.  (They were declared obsolete in Emacs 23.)
384

385
** New command line option `--no-site-lisp' removes site-lisp directories
386 387
from load-path.  -Q now implies this.  This option does not affect the
EMACSLOADPATH environment variable (and hence has no effect for
Glenn Morris's avatar
Glenn Morris committed
388
Nextstep builds).
389

390

391
* Changes in Emacs 24.1
392

393
** Completion
394

395 396 397
*** Many packages now use the `completion-at-point' command,
rather than implementing separate completion commands.

398
*** `completion-at-point' now handles tags and semantic completion.
399

400 401
*** Completion in a non-minibuffer now tries to detect the end of completion
and pops down the *Completions* buffer accordingly.
402 403 404 405

*** New option `completion-cycle-threshold' allows completion cycling.

*** New option `completion-category-overrides' for overriding the
406
default completion style in certain circumstances.
407

408
*** New completion style `substring'.
409 410 411 412

*** Completion of buffer names uses `substring' completion by default.

*** The option `widget-complete-field' has been removed.
413

414
** Mail changes
415

416 417 418 419 420 421
*** The first time you try sending mail, Emacs asks for a mail method.
This is implemented by a new default for `send-mail-function', which
is `sendmail-query-once'.  This offers to use the smtpmail package, or
to use the old defaults relying on external mail facilities
(`sendmail-send-it' on GNU/Linux and other Unix-like systems, and
`mailclient-send-it' on Windows).
422

423 424 425
*** Typing C-c m in the buffer made by M-x report-emacs-bug transfers
the report to your desktop's preferred mail client, if there is one.
This uses either the "xdg-email" utility, or Mac OS's "open" command.
426

427 428
*** See Changes in Specialized Modes and Packages for SMTPmail changes
and Mail mode changes
Glenn Morris's avatar
Glenn Morris committed
429

Chong Yidong's avatar
Chong Yidong committed
430
** Emacs server and client changes
431

432
*** New option `server-port' specifies the port for TCP Emacs servers.
433

Chong Yidong's avatar
Chong Yidong committed
434
*** New emacsclient argument -q/--quiet suppresses some status messages.
435

436 437
*** New emacsclient argument --frame-parameters specifies the frame
parameters of any newly-created graphical frame.
438 439 440 441

*** If emacsclient shuts down due to Emacs signaling an error,
its exit status is 1.

Chong Yidong's avatar
Chong Yidong committed
442 443 444 445
*** New emacsclient argument --parent-id ID.
This opens a client frame in parent X window ID, via XEmbed, similar
to the --parent-id argument to Emacs.

446 447 448
** Internationalization changes

*** Emacs now supports display and editing of bidirectional text.
449 450
Right-to-left (RTL) scripts, such as Arabic, Farsi, and Hebrew, are
displayed in the correct visual order as expected by users of those
451 452 453
scripts.  The display reordering is a "full bidirectionality" class
implementation of the Unicode Bidirectional Algorithm (UBA).  Buffers
with no RTL text should look exactly the same as before.
454

Chong Yidong's avatar
Chong Yidong committed
455
**** New buffer-local variable `bidi-display-reordering'.
456
To disable display reordering in a buffer, change this to nil.
457

Chong Yidong's avatar
Chong Yidong committed
458 459
**** New buffer-local variable `bidi-paragraph-direction'.
If nil (the default), Emacs determines the base direction of each
460 461 462
paragraph from its text, as specified by the UBA.  Setting the value
to `right-to-left' or `left-to-right' forces a base direction on each
paragraph.
463

464 465
Paragraphs with right-to-left base direction are displayed starting at
the right window edge.
466

467 468 469 470 471
*** Enhanced support for characters with no glyphs in available fonts,
or, on text terminals, characters that cannot be encoded by the
terminal coding system.  The new option `glyphless-char-display-control'
specifies how to display them: as a hexadecimal code in a box, a thin
1-pixel space, an empty box, etc.
472

473
*** New input methods: farsi, farsi-translit, bulgarian-alt-phonetic.
Chong Yidong's avatar
Chong Yidong committed
474

475 476 477
*** `nobreak-char-display' now also highlights Unicode hyphen chars
(U+2010 and U+2011).

478
*** New Hebrew translation of the Emacs Tutorial.
479 480 481
Type `C-u C-h t' to choose it in case your language setup doesn't
automatically select it.

482 483 484
** An Emacs Lisp package manager is now included.
This is a convenient way to download and install additional packages,
from a package repository at http://elpa.gnu.org.
485

486 487
*** M-x list-packages shows a list of packages, which can be
selected for installation.
488

489
*** New command `describe-package', bound to `C-h P'.
490

491 492 493
*** By default, all installed packages are loaded automatically when
Emacs starts up.  To disable this, set `package-enable-at-startup' to
nil.  To specify the packages to load, customize `package-load-list'.
Joakim Verona's avatar
Joakim Verona committed
494

495 496
** Custom theme changes

497 498
*** New command `M-x customize-themes', which provides a convenient
interface for enabling and disabling Custom themes.
499

500
*** New option `custom-theme-load-path' is the load path for themes.
501 502 503 504 505 506
Emacs no longer looks for Custom themes in `load-path'.  The default
value of `custom-theme-load-path' says to look for themes in
`custom-theme-directory', followed by a subdirectory of
`data-directory' named "themes/", which contains a small selection of
built-in Custom themes.

507 508 509 510
*** New option `custom-safe-themes' records known-safe theme files.
If a theme is not in this list, Emacs queries before loading it, and
offers to save the theme to `custom-safe-themes' automatically.  By
default, all themes included in Emacs are treated as safe.
511

512
** Improved GTK integration
513

514
*** GTK scroll-bars are now placed on the right by default.
515 516
The function `set-scroll-bar-mode' can change this.

517
*** GTK tool bars can have just text, just images or images and text.
518 519 520 521
Customize `tool-bar-style' to choose the style.  On a Gnome desktop,
the default is taken from desktop settings.

*** GTK tool bars can be placed on any edge of the frame.
522 523 524
The frame-parameter tool-bar-position controls this.  It takes the
values top, left, right or bottom.  The Options => Show/Hide menu has
entries for this.
525

526 527
*** The default colors for selected text (the `region' face) are taken
from the GTK theme when Emacs is built with GTK.
528

529 530
*** Emacs uses GTK tooltips by default if built with GTK.
You can disable this by changing `x-gtk-use-system-tooltips' to nil.
531

532 533 534 535 536 537 538 539 540 541 542 543 544
** Graphical interface changes

*** On graphical displays, the mode-line no longer ends in dashes.
Also, the first dash (which does not indicate anything) is just
displayed as a space.

*** `menu-bar-select-buffer-function' lets you choose another operation
instead of `switch-to-buffer' when selecting an item in the Buffers menu.

*** Lucid menus and dialogs can display antialiased fonts if Emacs is
built with Xft.  These fonts can be set via X resources, for example:
Emacs.pane.menubar.font: Courier-12

545
** Exiting changes
546

547
*** Emacs now calls `kill-emacs' if it receives SIGTERM or SIGHUP,
548 549
or if it receives a SIGINT signal in batch mode.

550 551 552
*** `kill-emacs-hook' is now also run in batch mode.
Third-party code which adds to `kill-emacs-hook' should check if they
do the right thing in batch mode.
553

Chong Yidong's avatar
Chong Yidong committed
554
** Scrolling changes
555

Chong Yidong's avatar
Chong Yidong committed
556
*** New scrolling commands `scroll-up-command' and `scroll-down-command'
Juanma Barranquero's avatar
Juanma Barranquero committed
557
(bound to C-v/[next] and M-v/[prior]) do not signal errors at top/bottom
558
of buffer at first key-press (instead they move to top/bottom of buffer)
559
when `scroll-error-top-bottom' is non-nil.
560 561 562

*** New option `scroll-error-top-bottom' (see above).

Chong Yidong's avatar
Chong Yidong committed
563
*** New scrolling commands `scroll-up-line' and `scroll-down-line'
564
scroll a line instead of full screen.
565

Chong Yidong's avatar
Chong Yidong committed
566
*** New property `scroll-command' should be set on a command's symbol to
Esa Peuha's avatar
Esa Peuha committed
567
define it as a scroll command affected by `scroll-preserve-screen-position'.
568

Chong Yidong's avatar
Chong Yidong committed
569
*** If you customize `scroll-conservatively' to a value greater than 100,
570 571 572 573
Emacs will never recenter point in the window when it scrolls due to
cursor motion commands or commands that move point (e.f., `M-g M-g').
Previously, you needed to use `most-positive-fixnum' as the value of
`scroll-conservatively' to achieve the same effect.
574

575
*** "Aggressive" scrolling now honors the scroll margins.
576 577 578 579 580
If you customize `scroll-up-aggressively' or
`scroll-down-aggressively' and move point off the window, Emacs now
scrolls the window so as to avoid positioning point inside the scroll
margin.

581 582
** Basic SELinux support has been added.
This requires Emacs to be linked with libselinux at build time.
583

584 585 586 587
*** Emacs preserves the SELinux file context when backing up.
Also, the function `copy-file' has an extra optional argument for
preserving SELinux context, and the return value of `backup-buffer'
now includes the SELinux context.
588

589
*** New functions `file-selinux-context' and `set-file-selinux-context'
590
get and set the SELinux context of a file.
591

592
** Trash changes
593

594 595
*** `delete-by-moving-to-trash' now only affects commands that specify
trashing.  This avoids inadvertently trashing temporary files.
596

597 598
*** Calling `delete-file' or `delete-directory' with a prefix argument
now forces true deletion, regardless of `delete-by-moving-to-trash'.
599

Chong Yidong's avatar
Chong Yidong committed
600
** File- and directory-local variable changes
601

Chong Yidong's avatar
Chong Yidong committed
602 603 604 605
*** You can stop directory local vars from applying to subdirectories.
Add an element (subdirs . nil) to the alist portion of any variables
settings to indicate that the section should not apply to
subdirectories.
606

Chong Yidong's avatar
Chong Yidong committed
607 608 609 610 611
*** Directory local variables can apply to some file-less buffers.
Affected modes include dired, vc-dir, and log-edit.  For example,
adding "(diff-mode . ((mode . whitespace)))" to .dir-locals.el will
turn on `whitespace-mode' for *vc-diff* buffers.  Modes should call
`hack-dir-local-variables-non-file-buffer' to support this.
612

Chong Yidong's avatar
Chong Yidong committed
613 614
*** Using "mode: MINOR-MODE" to enable a minor mode is deprecated.
Instead, use "eval: (minor-mode 1)".
Glenn Morris's avatar
Glenn Morris committed
615

Glenn Morris's avatar
Glenn Morris committed
616 617
*** The variable `inhibit-first-line-modes-regexps' has been renamed
to `inhibit-local-variables-regexps'.  As the name suggests, it now
618 619 620
applies to ALL file local variables, not just -*- lines.  The
associated `inhibit-first-line-modes-suffixes' has been renamed in the
corresponding way.
621

622 623
** Window changes

624 625 626
*** The `quit-window' command now restores the last buffer displayed
in the quitted window.

627 628 629 630
*** Resizing an Emacs frame now preserves proportional window sizes,
modulo restrictions like window minimum sizes and fixed-size windows.

*** The behavior of `display-buffer' is now customizable in detail.
631

632 633 634 635 636 637 638 639 640 641
**** New option `display-buffer-base-action' specifies a list of
user-determined display "actions" (functions and optional arguments
for choosing the displaying window).

This takes precedence over the default display action, which is
specified by `display-buffer-fallback-action'.

**** New option `display-buffer-alist' maps buffer name regexps to
display actions, taking precedence over `display-buffer-base-action'.

642 643 644 645
*** New option `window-combination-limit'.
The new option `window-combination-limit' allows to return the space
obtained for resizing or creating a window more reliably to the window
from which such space was obtained.
646

647 648 649 650 651
*** New option `window-combination-resize'.
The new option `window-combination-resize' allows to split a window that
otherwise cannot be split because it's too small by stealing space from
other windows in the same combination.  Subsequent resizing or deletion
of the window will resize all windows in the same combination as well.
652

653 654 655 656
*** New option `frame-auto-hide-function' lets you choose between
iconifying or deleting a frame when burying a buffer in a dedicated
frame, or quitting a window showing a buffer in a frame of its own.

657
*** New commands `maximize-window' and `minimize-window'.
Paul Eggert's avatar
Paul Eggert committed
658
These maximize and minimize the size of a window within its frame.
659 660 661 662 663

*** New commands `switch-to-prev-buffer' and `switch-to-next-buffer'.
These functions allow to navigate through the live buffers that have
been shown in a specific window.

664
** Minibuffer changes
665

666
*** The inactive minibuffer has its own major mode `minibuffer-inactive-mode'.
667 668
This is handy for minibuffer-only frames, and is also used for the feature
where mouse-1 pops up *Messages*"', which can now easily be changed.
Chong Yidong's avatar
Chong Yidong committed
669

670
*** Minibuffers set `truncate-lines' to nil.
Glenn Morris's avatar
NEWS  
Glenn Morris committed
671
If you want to change the value to something else, you could use
672 673 674 675 676
for example `minibuffer-setup-hook'.

** `auto-mode-case-fold' is now enabled by default.

** `backup-by-copying-when-mismatch' now defaults to t.
Glenn Morris's avatar
NEWS  
Glenn Morris committed
677

678 679 680 681 682 683 684 685 686
** New basic faces `error', `warning', `success'.
These are used to highlight text indicating failure, caution or
successful operation.

** New option `list-colors-sort' defines the color sort order
for `list-colors-display'.

** The variable `focus-follows-mouse' now always defaults to nil.

687

688
* Editing Changes in Emacs 24.1
689

690
** Search changes
691 692 693 694 695 696 697 698 699

*** C-y in Isearch is now bound to `isearch-yank-kill', instead of
`isearch-yank-line'.

*** M-y in Isearch is now bound to `isearch-yank-pop', instead of
`isearch-yank-kill'.

*** M-s C-e in Isearch is now bound to `isearch-yank-line'.

700
** New commands `count-words-region' and `count-words'.
701

702 703 704 705 706
*** M-= is bound to `count-words-region', not `count-lines-region'.
The `count-words-region' command, when called interactively, reports
the number of lines, words, and characters in the region.  It is a
superset of the old `count-lines-region', which is now an obsolete
alias for it.
Glenn Morris's avatar
Glenn Morris committed
707

708
** The command `just-one-space' (M-SPC), if given a negative argument,
709 710
also deletes newlines around point.

711
** Deletion changes
712

713
*** New option `delete-active-region'.
714
If non-nil, [delete] and DEL delete the region if it is active and no
715
prefix argument is given.  If set to `kill', those commands kill
716
instead.
717

718
*** New command `delete-forward-char', bound to [delete].
719 720
This is meant for interactive use, and obeys `delete-active-region'.
The command `delete-char' does not obey `delete-active-region'.
721

722 723
*** `delete-backward-char' is now a Lisp function.
Apart from obeying `delete-active-region', its behavior is unchanged.
724 725
However, the byte compiler now warns if it is called from Lisp; Lisp
callers should use delete-char with a negative argument instead.
726

727 728
*** The option `mouse-region-delete-keys' has been deleted.

729 730
** Selection changes.

731 732 733 734
The default handling of clipboard and primary selections has been
changed to conform with modern X applications.  In short, most
commands for killing and yanking text now use the clipboard, while
mouse commands use the primary selection.
735 736 737 738 739 740

In the following, we provide a list of these changes, followed by a
list of steps to get the old behavior back if you prefer that.

*** `select-active-regions' now defaults to t.
Merely selecting text (e.g. with drag-mouse-1) no longer puts it in
741
the kill ring.  The selected text is put in the primary selection, if
742 743 744 745 746 747 748 749
the system possesses a separate primary selection facility (e.g. X).

**** `select-active-regions' also accepts a new value, `only'.
This means to only set the primary selection for temporarily active
regions (usually made by mouse-dragging or shift-selection);
"ordinary" active regions, such as those made with C-SPC followed by
point motion, do not alter the primary selection.

750 751
**** `mouse-drag-copy-region' now defaults to nil.

752 753 754
*** mouse-2 is now bound to `mouse-yank-primary'.
This pastes from the primary selection, ignoring the kill-ring.
Previously, mouse-2 was bound to `mouse-yank-at-click'.
755

756
*** `x-select-enable-clipboard' now defaults to t on all platforms.
757

758 759 760 761 762
*** `x-select-enable-primary' now defaults to nil.
Thus, commands that kill text or copy it to the kill-ring (such as
M-w, C-w, and C-k) also use the clipboard---not the primary selection.

**** The "Copy", "Cut", and "Paste" items in the "Edit" menu are now
763
exactly equivalent to M-w, C-w, and C-y respectively.
764 765 766 767 768 769

**** Note that on MS-Windows, `x-select-enable-clipboard' was already
non-nil by default, as Windows does not support the primary selection
between applications.

*** To return to the previous behavior, do the following:
770

771
**** Change `select-active-regions' to nil.
772 773 774 775
**** Change `mouse-drag-copy-region' to t.
**** Change `x-select-enable-primary' to t (on X only).
**** Change `x-select-enable-clipboard' to nil.
**** Bind `mouse-yank-at-click' to mouse-2.
776

777
*** Support for X cut buffers has been removed.
778

779 780
*** X clipboard managers are now supported.
To inhibit this, change `x-select-enable-clipboard-manager' to nil.
781

782 783 784
** New command `C-x r N' (`rectangle-number-lines') numbers the lines
in the current rectangle.  With a prefix argument, this prompts for a
number to count from and for a format string.
785

786
** `redisplay-dont-pause' now defaults to t.
787 788 789 790 791
This makes Emacs feel more responsive to editing commands that arrive
at high rate, e.g. if you lean on some key, because stopping redisplay
in the middle (when this variable is nil) forces more expensive
updates later on, and Emacs appears to be unable to keep up.

792 793 794 795 796 797
** The behavior of <TAB> for active regions in Text mode has changed.
In Text and related modes, typing <TAB> (`indent-for-tab-command')
when the region is active causes Emacs to indent all the lines in the
region, aligning them with the line previous to the first line in the
region (or with the left margin if there is no previous line).

798 799 800 801 802 803
** When `occur' is called with a prefix argument, matching strings are
collected into the `*Occur*' buffer without line numbers.  If there
are parenthesized subexpressions in the specified regexp, `occur'
reads replacement text that may contain \\& and \\N whose convention
follows `replace-match'.

804

805
* Changes in Specialized Modes and Packages in Emacs 24.1
806

Chong Yidong's avatar
Chong Yidong committed
807
** Archive Mode has basic support for browsing and updating 7z archives.
808

809
** BibTeX mode
810

811
*** BibTeX mode now supports biblatex.
812 813 814 815
Use the variable `bibtex-dialect' to select different BibTeX dialects.
`bibtex-entry-field-alist' is now an obsolete alias for
`bibtex-BibTeX-entry-alist'.

816 817
*** New command `bibtex-search-entries', bound to C-c C-a.

818
*** New `bibtex-entry-format' option `sort-fields', disabled by default.
819

820 821
*** New variable `bibtex-search-entry-globally'.

822
** Browse-url
823

824
*** New option `browse-url-mailto-function' specifies how to handle "mailto:"s.
825

826 827 828
*** The default browser used by the package is now the "xdg-open" program,
on platforms that support it.  This calls your desktop's preferred browser.

Glenn Morris's avatar
Glenn Morris committed
829 830
** Calendar, Diary, and Appt

831
*** Diary entries can contain non-printing "comments".
Glenn Morris's avatar
Glenn Morris committed
832 833
See the variable `diary-comment-start'.

834 835 836
*** Appointments can specify their individual warning times.
See the variable `appt-warning-time-regexp'.

837 838 839 840
*** The function specified by `appt-disp-window-function' may be passed
lists of arguments if multiple appointments are due at similar times.
If you are using a custom function for this, you should update it.

841 842
*** New function `diary-hebrew-birthday'.

843 844 845
*** Elements of `calendar-day-abbrev-array' and `calendar-month-abbrev-array'
may no longer be nil, but must all be strings.

846 847 848
*** The obsolete (since Emacs 22.1) method of enabling the appt
package by adding `appt-make-list' to `diary-hook' has been removed.
Use `appt-activate' instead.
Glenn Morris's avatar
Glenn Morris committed
849 850 851 852 853 854 855 856

*** Some appt variables (obsolete since Emacs 22.1) have been removed:
appt-issue-message (use the function appt-activate)
appt-visible/appt-msg-window (use the variable appt-display-format)

*** Some diary function aliases (obsolete since Emacs 22.1) have been removed:
view-diary-entries, list-diary-entries, show-all-diary-entries

Alan Mackenzie's avatar
Alan Mackenzie committed
857
** CC Mode
858

Alan Mackenzie's avatar
Alan Mackenzie committed
859
*** New feature to "guess" the style in an existing buffer.
860
The main entry point is M-x c-guess.
Chong Yidong's avatar
Chong Yidong committed
861

Alan Mackenzie's avatar
Alan Mackenzie committed
862 863
*** Java Mode now supports Java 5.0 (Tiger) and 6 (Mustang).

864
*** `c-beginning-of-defun' and `c-end-of-defun' now respect nested scopes.
Alan Mackenzie's avatar
Alan Mackenzie committed
865 866 867
Thus C-M-a will, by default, go to the beginning of the immediate function,
not the top level.

868
*** "Macros with semicolons" can be registered for correct indentation.
Alan Mackenzie's avatar
Alan Mackenzie committed
869 870 871
Where such a macro ends a line (no semicolon) the next statement is no longer
parsed as a statement continuation.

872
** Comint and modes derived from it use the standard completion code.
Chong Yidong's avatar
Chong Yidong committed
873 874

** Compilation mode
875

876
*** Compilation mode can be used without Font Lock mode.
Chong Yidong's avatar
Chong Yidong committed
877 878
`compilation-parse-errors-function' is now obsolete.

879
*** New variable `compilation-filter-start', which is bound while
880 881
`compilation-filter-hook' runs.  It records the start position of the
text inserted by `compilation-filter'.
Chong Yidong's avatar
Chong Yidong committed
882

883 884
*** `compilation-error-screen-columns' and `compilation-first-column'
are obeyed in the editing buffer.  So programming language modes can
885 886
set them, whereas previously only the value in the *Compilation*
buffer was used.
887

888 889 890 891
** Customize

*** Customize buffers now contain a search field.
The search is performed using `customize-apropos'.
892
To turn off the search field, set `custom-search-field' to nil.
893 894 895 896 897 898 899

*** Custom options now start out hidden if at their default values.
Use the arrow to the left of the option name to toggle visibility.

*** custom-buffer-sort-alphabetically now defaults to t.

*** The color widget now has a "Choose" button, which allows you to
900
choose a color via `list-colors-display'.
901

Chong Yidong's avatar
Chong Yidong committed
902 903
** D-Bus

Glenn Morris's avatar
Glenn Morris committed
904 905
*** It is now possible to access buses other than the default system
or session bus.
Chong Yidong's avatar
Chong Yidong committed
906

907
*** The `dbus-register-method' and `dbus-register-property' functions
Glenn Morris's avatar
Glenn Morris committed
908
optionally do not register names.
Chong Yidong's avatar
Chong Yidong committed
909

910
*** The new function `dbus-register-service' registers a known service
911
name on a D-Bus without also registering a property or a method.
Chong Yidong's avatar
Chong Yidong committed
912

913
** Dired-x
Michael Albinus's avatar
Michael Albinus committed
914

915 916 917
*** C-x C-j (`dired-jump') and C-x 4 C-j (`dired-jump-other-window'),
if called with a prefix argument, read a file name from the minibuffer
instead of using the current buffer.
918

919
*** The "dired local variables" feature of Dired-x is obsolete.
920
The standard directory local variables feature replaces it.
921

Chong Yidong's avatar
Chong Yidong committed
922
** ERC changes
Michael Mauger's avatar
Michael Mauger committed
923

924 925
*** New options `erc-autojoin-timing' and `erc-autojoin-delay',
controlling attempts to autojoin a channel.
Chong Yidong's avatar
Chong Yidong committed
926 927 928 929 930

*** New variable `erc-coding-system-precedence': If we use `undecided'
as the server coding system, this variable will then be consulted.
The default is to decode strings that can be decoded as utf-8 as
utf-8, and do the normal `undecided' decoding for the rest.
Michael Mauger's avatar
Michael Mauger committed
931

Chong Yidong's avatar
Chong Yidong committed
932
** Eshell changes
Michael Mauger's avatar
Michael Mauger committed
933

Glenn Morris's avatar
Glenn Morris committed
934 935 936
*** The default value of `eshell-directory-name' has changed
to be an "eshell" directory in `user-emacs-directory'.
The old "~/.eshell/" directory is still used if it exists, though.
Chong Yidong's avatar
Chong Yidong committed
937 938

** gdb-mi
939 940

*** The M-x gdb command now uses the GDB Machine Interface protocol.
Glenn Morris's avatar
Glenn Morris committed
941 942
It now supports multithread non-stop debugging and simultaneous
debugging of several threads.
Michael Mauger's avatar
Michael Mauger committed
943

944 945
** Image mode

Glenn Morris's avatar
Glenn Morris committed
946 947
*** RET (`image-toggle-animation') toggles animation, if applicable.
Animation plays once, unless the option `image-animate-loop' is non-nil.
948

Chong Yidong's avatar
Chong Yidong committed
949
** Info
950

951
*** New command M-x info-display-manual displays a named Info manual.
952 953 954 955
If that manual is already visited in so