NEWS 82.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
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.


24
* Installation Changes in Emacs 24.3
25

Paul Eggert's avatar
Paul Eggert committed
26
** New configure option '--without-all' to disable additional features.
27 28 29 30 31
This disables most of the features that are normally enabled by default.

** New configure option '--enable-link-time-optimization' to utilize
an appropriate feature provided by GCC since version 4.5.0.

32 33 34 35
** 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
36
may be useful.
37

38 39 40
** The configure option '--disable-maintainer-mode' has been removed,
as it was confusingly-named and rarely useful.

41 42 43 44 45
---
** You can use `NO_BIN_LINK=t make install' to prevent the installation
overwriting "emacs" in the installation bin/ directory with a link
to emacs-VERSION.

46 47 48
---
** Emacs uses libtinfo in preference to libncurses, if available.

49 50 51 52 53
---
** 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.

54 55 56 57
---
** 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
58 59 60 61 62
---
** The standalone scripts rcs-checkin and vcdiff have been removed
(from the bin and libexec directories, respectively).  The former is
no longer relevant, the latter is replaced by lisp (in vc-sccs.el).

63 64 65 66 67
** The configuration option '--enable-use-lisp-union-type' has been
renamed to '--enable-check-lisp-object-type', as the resulting
Lisp_Object type no longer uses a union to implement the compile time
check that this option enables.

Glenn Morris's avatar
Glenn Morris committed
68

69
* Startup Changes in Emacs 24.3
70 71 72 73 74

** 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
75 76 77
---
** The `--no-site-lisp' command line option now works for Nextstep builds.

Glenn Morris's avatar
Glenn Morris committed
78

79
* Changes in Emacs 24.3
Glenn Morris's avatar
Glenn Morris committed
80

81 82 83 84 85 86 87 88 89 90 91 92
** Help changes

*** `C-h f' (describe-function) can now perform autoloading.
When this command is called for an autoloaded function whose docstring
contains a key substitution construct, that function's library is
automatically loaded, so that the documentation can be shown
correctly.  To disable this, set `help-enable-auto-load' to nil.

*** `C-h f' now reports previously-autoloaded functions as "autoloaded",
even after their associated libraries have been loaded (and the
autoloads have been redefined as functions).

93 94 95 96 97 98 99
** The function `current-time' now returns extended-format time stamps
(HIGH LOW USEC PSEC) that use picosecond resolution; the PSEC
component is new.  PSEC is typically a multiple of 1000 on current
machines.  Other functions that use this format, such as
file-attributes and format-time-string, have been changed accordingly.
Old-format time stamps are still accepted.

100 101 102 103 104
** Emacs now generates backtraces on fatal errors.
On encountering a fatal error, Emacs now outputs a textual description
of the fatal signal, and a short backtrace on platforms like glibc
that support backtraces.

105 106 107
** 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
108 109 110
** If your Emacs was built from a bzr checkout, the new variable
`emacs-bzr-version' contains information about which bzr revision was used.

111 112 113
** 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
114 115
automatically at startup, or when customizing a relevant imagemagick-
option.
116 117

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

121
*** The new variable `imagemagick-enabled-types' also affects which
122 123 124
ImageMagick types are treated as images.  The function
`imagemagick-filter-types' returns the list of types that will be
treated as images.
125

126 127
*** Images displayed via ImageMagick now support transparency and the
:background image spec property.
128

129 130
** Internationalization changes

131
*** New language environment: Persian.
132

Glenn Morris's avatar
Glenn Morris committed
133 134 135
** Face underlining can now use a wave.
See the "Face Attributes" section of the Elisp manual.

136 137
** New fringe bitmap exclamation-mark.

138 139 140 141
** 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.

142 143 144 145
+++
** You can prevent the creation of lock files by setting `create-lockfiles'
to nil.  Use with caution, and only if you really need to.

146
+++
147
** Using "unibyte: t" in Lisp source files is obsolete.
Glenn Morris's avatar
Glenn Morris committed
148
Use "coding: raw-text" instead.
149

150 151 152 153 154 155
** Mode line changes

*** New option `mode-line-default-help-echo' specifies the help text
(shown in a tooltip or in the echo area) for any part of the mode line
that does not have its own specialized help text.

156 157 158
*** You can now click mouse-3 in the coding system indicator to
invokes `set-buffer-file-coding-system'.

159 160 161 162
+++
** Setting `enable-remote-dir-locals' to non-nil allows directory
local variables on remote hosts.

Chong Yidong's avatar
Chong Yidong committed
163
+++
164 165 166
** `insert-char' is now a command, and `ucs-insert' an obsolete alias
for it.

Chong Yidong's avatar
Chong Yidong committed
167 168 169
** The entry for PCL-CVS has been removed from the Tools menu.
The PCL-CVS commands are still available via the keyboard.

Glenn Morris's avatar
Glenn Morris committed
170

171
* Editing Changes in Emacs 24.3
172

173
** The `z' key no longer has a binding in most special modes.
174 175
It used to be bound to `kill-this-buffer', but `z' is too easy to
accidentally type.
176

177 178 179 180
** New option `yank-handled-properties' allows processing of text
properties on yanked text, in more ways that are more general than
just removing them, as done by `yank-excluded-properties'.

Juanma Barranquero's avatar
Juanma Barranquero committed
181 182
** New option `delete-trailing-lines' specifies whether the M-x
delete-trailing-whitespace command should delete trailing lines at the
183 184
end of the buffer.  It defaults to t.

185 186 187 188 189 190
** Search changes

*** Global `M-s _' starts a symbol (identifier) incremental search,
and `M-s _' in Isearch toggles symbol search mode.
`M-s c' in Isearch toggles search case-sensitivity.

191 192 193 194 195 196 197 198
*** `M-s SPC' in Isearch toggles whitespace matching mode
in both ordinary and regexp incremental search, so that each
sequence of spaces in the search string matches any combination
of one or more whitespace characters defined by the variable
`search-whitespace-regexp'.  In ordinary incremental search,
`isearch-toggle-lax-whitespace' toggles the value of the variable
`isearch-lax-whitespace'.  In regexp incremental search, it toggles
the value of the variable `isearch-regexp-lax-whitespace'.
199

200 201 202 203 204 205 206
** query-replace changes

*** When new option `replace-lax-whitespace' is non-nil,
and you enter a space or spaces in the strings or regexps
to be replaced, `query-replace' will match any sequence matched
by the regexp `search-whitespace-regexp'.

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

210 211 212
** `mouse-avoidance-banish-position' can now be used to customize
`mouse-avoidance-mode' further.

213
** `C-u M-=' now counts lines/words/characters in the entire buffer.
214

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

218 219
** `goto-char' is now bound to `M-g c'.

220 221 222
** New command `C-x r M-w' (copy-rectangle-as-kill).
It copies the region-rectangle as the last rectangle kill.

223 224
** New input method `vietnamese-vni'.

Glenn Morris's avatar
Glenn Morris committed
225

226
* Changes in Specialized Modes and Packages in Emacs 24.3
227

228 229
** Compilation has a new `compilation-always-kill' configuration variable.

Julien Danjou's avatar
Julien Danjou committed
230 231 232 233
** Term changes

The variables `term-default-fg-color' and `term-default-bg-color' are
now deprecated in favor of the `term-face' face, that you can
Paul Eggert's avatar
Paul Eggert committed
234 235
customize.  Also, it is now possible to customize how are displayed the
ANSI terminal colors and styles by customizing the corresponding
Julien Danjou's avatar
Julien Danjou committed
236 237 238
`term-color-<COLOR>', `term-color-underline' and `term-color-bold'
faces.

239 240
** CL
*** CL's main entry is now (require 'cl-lib).
241
`cl-lib' is like the old `cl' except that it uses the namespace cleanly,
242 243
i.e. all its definitions have the "cl-" prefix (and internal definitions use
the "cl--" prefix).
244 245 246 247 248 249

If `cl' provided a feature under the name `foo', then `cl-lib' provides it
under the name `cl-foo' instead, with the exceptions of the few definitions
that had to use `foo*' to avoid conflicts with pre-existing Elisp entities,
which have not been renamed to `cl-foo*' but just `cl-foo'.

250
The old `cl' is now deprecated and is just a bunch of aliases that
251 252
provide the old non-prefixed names.

253 254 255 256 257 258 259 260 261 262 263 264
*** `cl-flet' is not like `flet' (which is deprecated).
Instead it obeys the behavior of Common-Lisp's `flet'.

*** `cl-labels' is slightly different from `labels'.
The difference is that it relies on the `lexical-binding' machinery (as opposed
to the `lexical-let' machinery used previously) to capture definitions in
closures, so such closures will only work if `lexical-binding' is in use.

*** `progv' was rewritten to use the `let' machinery.
A side effect is that vars without corresponding value are bound to nil
rather than making them unbound.

Chong Yidong's avatar
Chong Yidong committed
265 266 267 268 269
** Desktop

*** `desktop-path' no longer includes the "." directory.  Desktop
files are now located in ~/.emacs.d by default.

Glenn Morris's avatar
Glenn Morris committed
270 271 272
** Python mode

A new version of python.el, which provides several new features, including:
273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324
per-buffer shells, better indentation, Python 3 support, and improved
shell-interaction compatible with iPython (and virtually any other
text based shell).

*** Some user options have been replaced/renamed:
Old defcustom:                | New defcustom:
python-indent                 | python-indent-offset
python-guess-indent           | python-indent-guess-indent-offset
python-pdbtrack-do-tracking-p | python-pdbtrack-activate
python-use-skeletons          | python-skeleton-autoinsert

*** Some user options have been removed:

**** `python-indent-string-contents': Strings are never indented.

**** `python-honour-comment-indentation':
Comments are never considered as indentation markers themselves.

**** `python-continuation-offset': Indentation is automatically
calculated in a pep8 compliant way depending on the context.

**** `python-shell-prompt-alist', `python-shell-continuation-prompt-alist':
Have no direct mapping as the shell interaction is completely different.

**** `python-python-command', `python-jython-command':
Replaced by `python-shell-interpreter'.

**** `inferior-python-filter-regexp', `python-remove-cwd-from-path',
`python-pdbtrack-minor-mode-string', `python-source-modes':
No longer relevant.

*** Some commands have been replaced:
Old command               | New command
python-insert-class       | python-skeleton-class
python-insert-def         | python-skeleton-def
python-insert-for         | python-skeleton-for
python-insert-if          | python-skeleton-if
python-insert-try/except  | python-skeleton-try
python-insert-try/finally | python-skeleton-try
python-insert-while       | python-skeleton-while
python-find-function      | python-nav-jump-to-defun
python-next-statement     | python-nav-forward-sentence
python-previous-statement | python-nav-backward-sentence
python-send-buffer        | python-shell-send-buffer
python-send-defun         | python-shell-send-defun
python-send-region        | python-shell-send-region
python-send-region-and-go | Emulate with python-shell-send-region and
                            python-shell-switch-to-shell
python-send-string        | python-shell-send-string
python-switch-to-python   | python-shell-switch-to-shell
python-describe-symbol    | python-eldoc-at-point

Glenn Morris's avatar
Glenn Morris committed
325 326 327 328 329 330 331 332 333
** VHDL mode

*** The free software compiler GHDL is supported (and now the default).

*** Support for the VHDL-AMS packages has been added/updated.

*** Updated to the 2002 revision of the VHDL standard.

*** Accepts \r and \f as whitespace.
334

335 336 337 338 339 340 341 342 343 344 345
** 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.

346 347 348
** Ediff now uses the same color scheme as Diff mode
on high color displays.

349 350 351 352
** Flymake uses fringe bitmaps to indicate errors and warnings.
See flymake-fringe-indicator-position, flymake-error-bitmap and
flymake-warning-bitmap.

353 354 355 356 357
** `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.

358 359
** reStructuredText mode

360 361
*** Rebind nearly all keys making room for more keys and complying
better to usage in other modes.  Describe bindings with C-c C-h.
362

363 364
*** Major revision of indentation working very similar to other
modes.  TAB is your friend.
365

366 367
*** Major revision of filling working fine with most of
reStructuredText syntax.  Support auto-filling.
368 369 370

*** Major revision of comment handling.

371
*** Major revision of fontification working with `jit-lock-mode'.
372

373 374
*** Cover reStructuredText syntax more closely.  Improve
the experience for Sphinx users.
375

376
*** `rst-insert-list' inserts new list or continues existing lists.
377

378
*** Extend correct and improve customization.
379 380 381

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

382
*** Reset window configuration after displaying TOC.
383

384
*** Package version in `rst-version'.
385

386 387
** 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'.
388

Chong Yidong's avatar
Chong Yidong committed
389 390 391 392 393 394 395 396 397
** 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.).

398 399 400 401 402 403
** Buffer Menu
This package has been rewritten to use Tabulated List mode.

*** Option `Buffer-menu-buffer+size-width' is now obsolete.
Use `Buffer-menu-name-width' and `Buffer-menu-size-width' instead.

404 405
** Calendar

406 407
*** The calendars produced by cal-html include holidays.
Customize cal-html-holidays to change this.
408

409 410 411
** Customize

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

413 414 415 416
*** Non-option variables are never matched in `customize-apropos' and
`customize-apropos-options' (i.e. the prefix argument does nothing for
these commands now).

417
** erc will look up server/channel names via auth-source and use the
418
channel keys found, if any.
419

420 421 422 423
** Dired

*** `dired-do-async-shell-command' executes each file sequentially
if the command ends in `;' (when operating on multiple files).
Paul Eggert's avatar
Paul Eggert committed
424
Otherwise, it executes the command on each file in parallel.
425

426 427 428 429 430 431
** Shell

*** New option `async-shell-command-buffer' specifies what buffer to use
for a new asynchronous shell command when the default output buffer
`*Async Shell Command*' is already taken by another running command.

432 433 434 435 436 437
** 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").

438 439 440 441 442 443 444
** 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.

445 446
** The `server-auth-key' variable can be used to set a permanent
shared key for Emacs Server.
447 448 449 450

** 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
451 452
** FIXME something happened to ses.el, 2012-04-17.

453 454
** which-function-mode now applies to all applicable major modes by default.

Michael Albinus's avatar
Michael Albinus committed
455 456 457 458 459 460 461 462 463
** Tramp

+++
*** The syntax has been extended in order to allow ad-hoc proxy
definitions.  See the manual for details.

+++
*** Remote processes are now supported also on remote Windows host.

464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493
** 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'.

494 495 496 497 498
+++
** notifications.el supports now version 1.2 of the Notifications API.
The function `notifications-get-capabilities' returns the supported
server properties.

499 500 501 502 503
** Package Menu

*** Newly-available packages are listed in the Package Menu as "new",
and sorted above the other "available" packages by default.

504 505
** Tabulated List and packages derived from it

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

509 510 511 512 513 514 515 516 517 518 519 520
** 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
521 522
** Obsolete packages:

523 524 525 526 527
*** 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.

528 529
*** bruce.el

Glenn Morris's avatar
Glenn Morris committed
530 531
*** ledit.el

Glenn Morris's avatar
Glenn Morris committed
532
*** mailpost.el
533 534 535

*** mouse-sel.el

536 537
*** patcomp.el

538 539
*** cust-print.el

Glenn Morris's avatar
Glenn Morris committed
540

541
* New Modes and Packages in Emacs 24.3
Glenn Morris's avatar
Glenn Morris committed
542

543
* Incompatible Lisp Changes in Emacs 24.3
544

545 546 547 548 549
** (random) by default now returns a different random sequence in
every Emacs run.  Use (random S), where S is a string, to set the
random seed to a value based on S, in order to get a repeatable
sequence in later calls.

550 551 552 553
** The function `x-select-font' can return a font spec, instead of a
font name as a string.  Whether it returns a font spec or a font name
depends on the graphical library.

554 555 556 557
** If the NEWTEXT arg to `replace-match' contains a substring "\?",
that substring is inserted literally even if the LITERAL arg is
non-nil, instead of causing an error to be signaled.

558 559 560 561 562 563
+++
** 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'.

564 565 566 567 568 569
+++
** The return values of `defalias', `defun' and `defmacro' have changed,
and are now undefined.  For backwards compatibility, defun and
defmacro currently return the name of the newly defined function/macro
but this should not be relied upon.

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

573 574 575 576 577
+++
** 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.

578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606
** Spelling changes.
Some Lisp symbols have been renamed to avoid problems with spelling
that is incorrect or inconsistent with how Emacs normally spells a word.

*** Renamed functions

**** hangul-input-method-inactivate -> hangul-input-method-deactivate
**** inactivate-input-method -> deactivate-input-method
**** quail-inactivate -> quail-deactivate
**** robin-inactivate -> robin-deactivate
**** viper-inactivate-input-method -> viper-deactivate-input-method
**** viper-inactivate-input-method-action ->
     viper-deactivate-input-method-action
**** ucs-input-inactivate -> ucs-input-deactivate

*** Renamed hooks
The old hooks are still supported for backward compatibility, but they
are deprecated and will be removed eventually.

**** input-method-inactivate-hook -> input-method-deactivate-hook
**** robin-inactivate-hook -> robin-deactivate-hook
**** quail-inactivate-hook -> quail-deactivate-hook

*** Renamed Lisp variables

**** follow-deactive-menu -> follow-inactive-menu
**** inactivate-current-input-method-function ->
     deactivate-current-input-method-function

607 608 609 610
** The following obsolete variables and varaliases have been removed:

*** `facemenu-unlisted-faces'
*** `rmail-decode-mime-charset'
Chong Yidong's avatar
Chong Yidong committed
611
*** `last-input-char' and `last-command-char'
612

Glenn Morris's avatar
Glenn Morris committed
613

614
* Lisp changes in Emacs 24.3
615

616 617 618 619 620 621 622
** Interpreted files get eagerly macro-expanded during load.
This can significantly speed up execution of non-byte-compiled code, but can
also bump into harmless and previously unnoticed cyclic dependencies.
These should not be fatal: they will simply cause the macro-calls to be left
for later expansion (as before), but will also result in a warning describing
the cycle.

623 624
** New minor mode `read-only-mode' to replace toggle-read-only (now obsolete).

625 626
** New functions `autoloadp' and `autoload-do-load'.

627 628
** New function `posnp' to test if an object is a `posn'.

629 630
** `function-get' fetches the property of a function, following aliases.

631 632 633
** `toggle-read-only' accepts a second argument specifying whether to
print a message, if called from Lisp.

634 635 636
** CL-style generalized variables are now in core Elisp.
`setf' is autoloaded and `push' and `pop' accept generalized variables.

637 638 639 640 641
** `defun' also accepts a (declare DECLS) form, like `defmacro'.
The interpretation of the DECLS is determined by `defun-declarations-alist'.

** `macro-declaration-function' is obsolete, use `macro-declarations-alist'.

642 643 644 645
** New function `set-temporary-overlay-map'.

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

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

648 649
** New option `debugger-bury-or-kill'.

650 651 652
+++
** New utility function `buffer-narrowed-p'.

653 654 655
** Window changes

*** The functions get-lru-window, get-mru-window and get-largest-window
Paul Eggert's avatar
Paul Eggert committed
656
now accept a third argument to avoid choosing the selected window.
657

658 659 660
*** New macro `with-temp-buffer-window'.

*** New option `temp-buffer-resize-frames'.
661

662 663
*** New function `fit-frame-to-buffer' and new option
    `fit-frame-to-buffer-bottom-margin'.
664

665 666
*** New display action functions `display-buffer-below-selected' and
`display-buffer-in-previous-window'.
667

668 669 670
*** New display action alist entry `inhibit-switch-frame', if non-nil,
tells display action functions to avoid changing which frame is
selected.
671

672 673
*** New display action alist entry `pop-up-frame-parameters', if
non-nil, specifies frame parameters to give any newly-created frame.
674

675 676
*** New display action alist entry `previous-window', if non-nil,
specifies window to reuse in `display-buffer-in-previous-window'.
677

678 679 680
*** The following variables are obsolete, as they can be replaced by
appropriate entries in the `display-buffer-alist' function introduced
in Emacs 24.1:
681
+++
682 683 684 685 686 687
**** `display-buffer-reuse-frames'
**** `special-display-regexps'
**** `special-display-frame-alist'
**** `special-display-buffer-names'
**** `special-display-function'

688 689 690 691 692 693 694
** 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.
695 696 697 698 699 700

** 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.
701

Glenn Morris's avatar
Glenn Morris committed
702 703
** New function file-name-base.

704 705
** New function `tty-top-frame' returns the topmost frame of a text terminal.

706
** `automount-dir-prefix' is obsolete.
707
** `buffer-has-markers-at' is obsolete.
708
** `window-system-version' is obsolete.
709

710
* Changes in Emacs 24.3 on non-free operating systems
711 712 713 714 715 716

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

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

717 718 719 720
** 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.

721
** On MS-Windows Vista and later Emacs now supports symbolic links.
722 723 724

* Changes in Emacs 24.2

Glenn Morris's avatar
Glenn Morris committed
725
** This is mainly a bug-fix release.
726

727

728
* Installation Changes in Emacs 24.1
Chong Yidong's avatar
Chong Yidong committed
729

730 731 732 733
** 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.
734

735 736 737 738
** 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.
739

740 741 742 743
** 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
744

745 746 747 748
** 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
749
This feature is not available for the Nextstep or MS ports.
750

751 752 753 754 755
** 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.

756 757 758 759
** 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
760
With it, Emacs integers typically have 62 bits, even on 32-bit machines.
761 762
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
763

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

768
** New configure option --enable-use-lisp-union-type.
769 770
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
771 772 773 774 775 776 777

** 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.

778

779
* Startup Changes in Emacs 24.1
780

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

785
** New command line option `--no-site-lisp' removes site-lisp directories
786 787
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
788
Nextstep builds).
789

790

791
* Changes in Emacs 24.1
792

793
** Completion
794

795 796 797
*** Many packages now use the `completion-at-point' command,
rather than implementing separate completion commands.

798
*** `completion-at-point' now handles tags and semantic completion.
799

800 801
*** Completion in a non-minibuffer now tries to detect the end of completion
and pops down the *Completions* buffer accordingly.
802 803 804 805

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

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

808
*** New completion style `substring'.
809 810 811 812

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

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

814
** Mail changes
815

816 817 818 819 820 821
*** 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).
822

823 824 825
*** 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.
826

827 828
*** See Changes in Specialized Modes and Packages for SMTPmail changes
and Mail mode changes
Glenn Morris's avatar
Glenn Morris committed
829

Chong Yidong's avatar
Chong Yidong committed
830
** Emacs server and client changes
831

832
*** New option `server-port' specifies the port for TCP Emacs servers.
833

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

836 837
*** New emacsclient argument --frame-parameters specifies the frame
parameters of any newly-created graphical frame.
838 839 840 841

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

Chong Yidong's avatar
Chong Yidong committed
842 843 844 845
*** 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.

846 847 848
** Internationalization changes

*** Emacs now supports display and editing of bidirectional text.
849 850
Right-to-left (RTL) scripts, such as Arabic, Farsi, and Hebrew, are
displayed in the correct visual order as expected by users of those
851 852 853
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.
854

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

Chong Yidong's avatar
Chong Yidong committed
858 859
**** New buffer-local variable `bidi-paragraph-direction'.
If nil (the default), Emacs determines the base direction of each
860 861 862
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.
863

864 865
Paragraphs with right-to-left base direction are displayed starting at
the right window edge.
866

867 868 869 870 871
*** 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.
872

Glenn Morris's avatar
Glenn Morris committed
873 874
*** New input methods for Farsi and Bulgarian
(farsi-isiri-9147, farsi-transliterate-banan, bulgarian-alt-phonetic).
Chong Yidong's avatar
Chong Yidong committed
875

876 877 878
*** `nobreak-char-display' now also highlights Unicode hyphen chars
(U+2010 and U+2011).

879
*** New Hebrew translation of the Emacs Tutorial.
880 881 882
Type `C-u C-h t' to choose it in case your language setup doesn't
automatically select it.

883 884 885
** 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.
886

887 888
*** M-x list-packages shows a list of packages, which can be
selected for installation.
889

890
*** New command `describe-package', bound to `C-h P'.
891

892 893 894
*** 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
895

896 897
** Custom theme changes

898 899
*** New command `M-x customize-themes', which provides a convenient
interface for enabling and disabling Custom themes.
900

901
*** New option `custom-theme-load-path' is the load path for themes.
902 903 904 905 906 907
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.

908 909 910 911
*** 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.
912

913
** Improved GTK integration
914

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

918
*** GTK tool bars can have just text, just images or images and text.
919 920 921 922
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.
923 924 925
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.
926

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

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

933 934 935 936 937 938 939 940 941 942 943 944 945
** 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

946
** Exiting changes
947

948
*** Emacs now calls `kill-emacs' if it receives SIGTERM or SIGHUP,
949 950
or if it receives a SIGINT signal in batch mode.

951 952 953
*** `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.
954

Chong Yidong's avatar
Chong Yidong committed
955
** Scrolling changes
956

Chong Yidong's avatar
Chong Yidong committed
957
*** New scrolling commands `scroll-up-command' and `scroll-down-command'
Juanma Barranquero's avatar
Juanma Barranquero committed
958
(bound to C-v/[next] and M-v/[prior]) do not signal errors at top/bottom
959
of buffer at first key-press (instead they move to top/bottom of buffer)
960
when `scroll-error-top-bottom' is non-nil.
961 962 963

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

Chong Yidong's avatar
Chong Yidong committed
964
*** New scrolling commands `scroll-up-line' and `scroll-down-line'
965
scroll a line instead of full screen.
966

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

Chong Yidong's avatar
Chong Yidong committed
970
*** If you customize `scroll-conservatively' to a value greater than 100,
971 972 973 974
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.
975

976
*** "Aggressive" scrolling now honors the scroll margins.
977 978 979 980 981
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.

982 983
** Basic SELinux support has been added.
This requires Emacs to be linked with libselinux at build time.
984

985 986 987 988
*** 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.
989

990
*** New functions `file-selinux-context' and `set-file-selinux-context'
991
get and set the SELinux context of a file.
992

993
** Trash changes
994

995 996
*** `delete-by-moving-to-trash' now only affects commands that specify
trashing.  This avoids inadvertently trashing temporary files.
997

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

Chong Yidong's avatar
Chong Yidong committed
1001
** File- and directory-local variable changes
1002

Chong Yidong's avatar
Chong Yidong committed
1003 1004 1005 1006
*** 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.
1007

Chong Yidong's avatar
Chong Yidong committed
1008 1009 1010 1011 1012
*** 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.
1013

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

Glenn Morris's avatar
Glenn Morris committed
1017 1018
*** The variable `inhibit-first-line-modes-regexps' has been renamed
to `inhibit-local-variables-regexps'.  As the name suggests, it now
1019 1020 1021
applies to ALL file local variables, not just -*- lines.  The
associated `inhibit-first-line-modes-suffixes' has been renamed in the
corresponding way.
1022

1023 1024
** Window changes

1025 1026 1027
*** The `quit-window' command now restores the last buffer displayed
in the quitted window.

1028 1029 1030 1031
*** 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.
1032

1033 1034 1035 1036 1037 1038 1039 1040 1041 1042
**** 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'.

1043 1044 1045 1046
*** 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.