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

68 69 70 71 72 73 74 75
---
** The default toolkit has been changed to Gtk+ version 3.
If you don't pass --with-x-toolkit to configure or if you pass
--with-x-toolkit=gtk or --with-x-toolkit=yes, configure will try to build
with Gtk+ version 3, and if that fails, try Gtk+ version 2.
You can explicitly require a specific version by passing
--with-x-toolkit=gtk2 or --with-x-toolkit=gtk3 to configure.

Glenn Morris's avatar
Glenn Morris committed
76

77
* Startup Changes in Emacs 24.3
78 79 80 81 82

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

Glenn Morris's avatar
Glenn Morris committed
86

87
* Changes in Emacs 24.3
Glenn Morris's avatar
Glenn Morris committed
88

Chong Yidong's avatar
Chong Yidong committed
89 90 91 92 93 94 95 96 97 98 99 100 101 102 103
** Most y-or-n prompts now allow you to scroll the selected window.
Typing C-v or M-v at a y-or-n prompt scrolls forward or backward
respectively, without exiting from the prompt.

** In minibuffer filename prompts, `C-M-f' and `C-M-b' now move to the
next and previous path separator, respectively.

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

*** You can now click mouse-3 in the coding system indicator to
invokes `set-buffer-file-coding-system'.
Chong Yidong's avatar
Chong Yidong committed
104

105 106 107 108 109 110 111 112 113 114 115 116
** 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).

117 118 119
** 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
120 121
automatically at startup, or when customizing a relevant imagemagick-
option.
122 123

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

127
*** The new variable `imagemagick-enabled-types' also affects which
128 129 130
ImageMagick types are treated as images.  The function
`imagemagick-filter-types' returns the list of types that will be
treated as images.
131

132 133
*** Images displayed via ImageMagick now support transparency and the
:background image spec property.
134

Chong Yidong's avatar
Chong Yidong committed
135
** Server and client changes
136

Chong Yidong's avatar
Chong Yidong committed
137 138 139
*** emacsclient now obeys string values for `initial-buffer-choice',
if it is told to open a new frame without specifying any file to visit
or expression to evaluate.
140

Chong Yidong's avatar
Chong Yidong committed
141
*** New option `server-auth-key' specifies a shared server key.
Glenn Morris's avatar
Glenn Morris committed
142

Chong Yidong's avatar
Chong Yidong committed
143 144 145 146 147 148 149 150 151 152
** In the Package Menu, newly-available packages are listed as "new",
and sorted above the other "available" packages by default.

** `C-x C-q' is now bound to the new minor mode `read-only-mode'.
This minor mode replaces `toggle-read-only', which is now obsolete.

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

Chong Yidong's avatar
Chong Yidong committed
154 155
** If your Emacs was built from a bzr checkout, the new variable
`emacs-bzr-version' contains information about the bzr revision used.
156

157
+++
Chong Yidong's avatar
Chong Yidong committed
158 159 160
** New variable `create-lockfiles' specifies usage of lockfiles.
It defaults to t.  Changing it to nil inhibits the creation of lock
files (use this with caution).
161

162
+++
163
** Using "unibyte: t" in Lisp source files is obsolete.
Glenn Morris's avatar
Glenn Morris committed
164
Use "coding: raw-text" instead.
165

166 167 168 169
+++
** Setting `enable-remote-dir-locals' to non-nil allows directory
local variables on remote hosts.

Chong Yidong's avatar
Chong Yidong committed
170
---
Chong Yidong's avatar
Chong Yidong committed
171 172 173
** The entry for PCL-CVS has been removed from the Tools menu.
The PCL-CVS commands are still available via the keyboard.

Chong Yidong's avatar
Chong Yidong committed
174 175 176 177 178 179
** Internationalization changes
---
*** New language environment: Persian.
---
*** New input method `vietnamese-vni'.

Glenn Morris's avatar
Glenn Morris committed
180

181
* Editing Changes in Emacs 24.3
182

Chong Yidong's avatar
Chong Yidong committed
183 184 185 186 187
+++
** `C-x 8 RET' is now bound to `insert-char', which is now a command.
`ucs-insert' is now an obsolete alias for `insert-char'.

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

Chong Yidong's avatar
Chong Yidong committed
192 193 194
** New option `delete-trailing-lines' specifies whether
M-x delete-trailing-whitespace should delete trailing lines at the end
of the buffer.  It defaults to t.
195

Chong Yidong's avatar
Chong Yidong committed
196
** Search and Replace changes
197

Chong Yidong's avatar
Chong Yidong committed
198 199 200 201 202
*** Non-regexp Isearch now performs "lax" space matching.
Each sequence of spaces in the supplied search string may match any
sequence of one or more whitespace characters, as specified by the
variable `search-whitespace-regexp'.  (This variable is also used by a
similar existing feature for regexp Isearch).
203

Chong Yidong's avatar
Chong Yidong committed
204 205
*** New Isearch command `M-s SPC' toggles lax space matching.
This applies to both ordinary and regexp Isearch.
206

Chong Yidong's avatar
Chong Yidong committed
207 208 209
*** New option `replace-lax-whitespace'.
If non-nil, `query-replace' uses flexible whitespace matching too.
The default is nil.
210 211 212 213 214

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

Chong Yidong's avatar
Chong Yidong committed
215 216 217 218 219 220 221
** Register changes
+++
*** `C-x r +' is now overloaded to invoke `append-to-register.
+++
*** New option `register-separator' specifies the register containing
the text to put between collected texts for use with M-x
append-to-register and M-x prepend-to-register.
222

Chong Yidong's avatar
Chong Yidong committed
223
** `C-u M-=' now counts lines/words/characters in the entire buffer.
224

Chong Yidong's avatar
Chong Yidong committed
225
** New binding `M-g c' for `goto-char'.
226

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

230 231 232
** New command `C-x r M-w' (copy-rectangle-as-kill).
It copies the region-rectangle as the last rectangle kill.

Chong Yidong's avatar
Chong Yidong committed
233 234 235
** 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'.
236

Glenn Morris's avatar
Glenn Morris committed
237

238
* Changes in Specialized Modes and Packages in Emacs 24.3
239

Chong Yidong's avatar
Chong Yidong committed
240
** Apropos
241

Chong Yidong's avatar
Chong Yidong committed
242 243 244
*** 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.
Julien Danjou's avatar
Julien Danjou committed
245

Chong Yidong's avatar
Chong Yidong committed
246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261
**** The old options whose values specified faces to use were removed
(i.e. `apropos-symbol-face', `apropos-keybinding-face', etc.).

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

** Calendar

*** You can customize the header text that appears above each calendar month.
See the variable `calendar-month-header'.

*** The calendars produced by cal-html include holidays.
Customize cal-html-holidays to change this.
Julien Danjou's avatar
Julien Danjou committed
262

263
** CL
Chong Yidong's avatar
Chong Yidong committed
264

265
*** CL's main entry is now (require 'cl-lib).
266
`cl-lib' is like the old `cl' except that it uses the namespace cleanly,
267 268
i.e. all its definitions have the "cl-" prefix (and internal definitions use
the "cl--" prefix).
269 270 271 272 273 274

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

275
The old `cl' is now deprecated and is just a bunch of aliases that
276 277
provide the old non-prefixed names.

278 279 280 281 282 283 284 285 286 287 288 289
*** `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
290 291 292 293 294 295 296 297 298 299 300 301
** Compilation mode

*** New option `compilation-always-kill'.

** Customize

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

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

Chong Yidong's avatar
Chong Yidong committed
302 303 304 305 306
** Desktop

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

Chong Yidong's avatar
Chong Yidong committed
307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412
** 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'.

** Diff mode

*** Changes are now highlighted using the same color scheme as in
modern VCSes.  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.

*** The new command `diff-remove-trailing-whitespace' fixes trailing
whitespace problems introduced by the diff.

** Dired

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

*** Typing M-n in the minibuffer of `dired-do-chmod', `dired-do-chgrp',
`dired-do-chown', `dired-do-touch' pulls the file attributes of the
file at point.

*** When the region is active, `m' (`dired-mark'), `u' (`dired-unmark'),
`DEL' (`dired-unmark-backward'), `d' (`dired-flag-file-deletion')
mark/unmark/flag all files in the active region.

*** The minibuffer default for `=' (`dired-diff) has changed.
It is now the backup file for the file at point, if one exists.
In Transient Mark mode the default is the file at the active mark.

*** `M-=' is no longer bound to `dired-backup-diff' in Dired buffers.
The global binding for `M-=', `count-words-region' is in effect.

** Ediff now uses the same color scheme as Diff mode.

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

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

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

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

** Ibuffer

*** New `derived-mode' filter, bound to `/ M'.
The old binding for `/ M' (filter by used-mode) is now bound to `/ m'.

** Mouse Avoidance mode

The new variable `mouse-avoidance-banish-position' can now be used to
customize Mouse Avoidance mode further.

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

** 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
413 414 415
** Python mode

A new version of python.el, which provides several new features, including:
416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467
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

468 469
** reStructuredText mode

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

473 474
*** Major revision of indentation working very similar to other
modes.  TAB is your friend.
475

476 477
*** Major revision of filling working fine with most of
reStructuredText syntax.  Support auto-filling.
478 479 480

*** Major revision of comment handling.

481
*** Major revision of fontification working with `jit-lock-mode'.
482

483 484
*** Cover reStructuredText syntax more closely.  Improve
the experience for Sphinx users.
485

486
*** `rst-insert-list' inserts new list or continues existing lists.
487

488
*** Extend correct and improve customization.
489 490 491

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

492
*** Reset window configuration after displaying TOC.
493

494
*** Package version in `rst-version'.
495

496 497
*** Support `imenu' and `which-func'.

Chong Yidong's avatar
Chong Yidong committed
498
** SH Script mode
499

Chong Yidong's avatar
Chong Yidong committed
500
*** Pairing of parens/quotes uses electric-pair-mode instead of skeleton-pair.
501

Chong Yidong's avatar
Chong Yidong committed
502
*** `sh-electric-here-document-mode' now controls auto-insertion of here-docs.
Chong Yidong's avatar
Chong Yidong committed
503

Chong Yidong's avatar
Chong Yidong committed
504
*** `sh-use-smie' lets you choose a new indentation and navigation code.
Chong Yidong's avatar
Chong Yidong committed
505

506 507 508 509 510 511
** 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.

Chong Yidong's avatar
Chong Yidong committed
512
** SQL Mode
513

Chong Yidong's avatar
Chong Yidong committed
514
*** DB2 added `sql-db2-escape-newlines'
515

Chong Yidong's avatar
Chong Yidong committed
516 517 518
If non-nil, newlines sent to the command interpreter will be escaped
by a backslash.  The default does not escape the newlines and assumes
that the sql statement will be terminated by a semicolon.
519

Chong Yidong's avatar
Chong Yidong committed
520
** Tabulated List and packages derived from it
521

Chong Yidong's avatar
Chong Yidong committed
522 523
*** New command `tabulated-list-sort', bound to `S', sorts the column
at point, or the Nth column if a numeric prefix argument is given.
524

Chong Yidong's avatar
Chong Yidong committed
525
** Term
Glenn Morris's avatar
Glenn Morris committed
526

Chong Yidong's avatar
Chong Yidong committed
527 528 529 530 531 532
The variables `term-default-fg-color' and `term-default-bg-color' are
now deprecated in favor of the `term-face' face, that you can
customize.  Also, it is now possible to customize how are displayed the
ANSI terminal colors and styles by customizing the corresponding
`term-color-<COLOR>', `term-color-underline' and `term-color-bold'
faces.
533

Michael Albinus's avatar
Michael Albinus committed
534 535 536 537 538 539 540
** 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.

541 542 543 544 545 546 547 548 549 550 551 552
** 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.

Chong Yidong's avatar
Chong Yidong committed
553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568
** 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.

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


** FIXME something happened to ses.el, 2012-04-17.


Glenn Morris's avatar
Glenn Morris committed
569 570
** Obsolete packages:

571 572 573 574 575
*** 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.

576 577
*** bruce.el

Glenn Morris's avatar
Glenn Morris committed
578 579
*** ledit.el

Glenn Morris's avatar
Glenn Morris committed
580
*** mailpost.el
581 582 583

*** mouse-sel.el

584 585
*** patcomp.el

586 587
*** cust-print.el

Glenn Morris's avatar
Glenn Morris committed
588

589
* New Modes and Packages in Emacs 24.3
Glenn Morris's avatar
Glenn Morris committed
590

591
* Incompatible Lisp Changes in Emacs 24.3
592

593 594 595 596 597
** (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.

598 599 600 601
** 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.

602 603 604 605
** 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.

606 607 608 609 610 611
+++
** 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'.

612 613 614 615 616 617
+++
** 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.

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

621 622 623 624 625
+++
** 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.

626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654
** 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

Chong Yidong's avatar
Chong Yidong committed
655
** Some obsolete variables and variable aliases were removed:
656 657 658

*** `facemenu-unlisted-faces'
*** `rmail-decode-mime-charset'
Stefan Monnier's avatar
Stefan Monnier committed
659
*** `last-input-char', `last-command-char', `unread-command-char'.
660

Glenn Morris's avatar
Glenn Morris committed
661

662
* Lisp changes in Emacs 24.3
663

664
** CL-style generalized variables are now in core Elisp.
Chong Yidong's avatar
Chong Yidong committed
665
`setf' is autoloaded; `push' and `pop' accept generalized variables.
666

667 668 669
** `defun' also accepts a (declare DECLS) form, like `defmacro'.
The interpretation of the DECLS is determined by `defun-declarations-alist'.

Chong Yidong's avatar
Chong Yidong committed
670
** Completion
671

Chong Yidong's avatar
Chong Yidong committed
672 673
*** New function `completion-table-with-quoting' to handle completion
in the presence of quoting, such as file completion in shell buffers.
674

Chong Yidong's avatar
Chong Yidong committed
675 676 677 678
*** New function `completion-table-subvert' to use an existing completion
table, but with a different prefix.

** Debugger changes
679

Chong Yidong's avatar
Chong Yidong committed
680 681
*** New error type and new function `user-error'.
These do not trigger the debugger.
682

683 684 685 686 687 688 689 690
*** New option `debugger-bury-or-kill'.

*** Set `debug-on-message' to enter the debugger when a certain
message is displayed in the echo area.  This can be useful when trying
to work out which code is doing something.

*** New var `inhibit-debugger', automatically set to prevent accidental
recursive invocations.
691

Chong Yidong's avatar
Chong Yidong committed
692 693 694 695 696 697 698
** Minibuffer

*** `read-regexp' has a new argument HISTORY; the first argument PROMPT
of `read-regexp' accepts a string ending with a colon and space, and its
second argument DEFAULTS can be a list of strings accessible via M-n
in the minibuffer ahead of other hard-coded useful regexp-related values.
More commands use `read-regexp' now to read their regexp arguments.
699

700 701 702
** Window changes

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

705 706
*** Additional values recognized for option `window-combination-limit'.

707 708
*** New macro `with-temp-buffer-window'.

709 710 711 712 713
*** New options `temp-buffer-resize-frames' and
`temp-buffer-resize-regexps'.

*** `temp-buffer-resize-mode' no longer resizes windows that have been
reused.
714

715
*** New function `fit-frame-to-buffer' and new option
716
`fit-frame-to-buffer-bottom-margin'.
717

718 719
*** New display action functions `display-buffer-below-selected',
`display-buffer-at-bottom' and `display-buffer-in-previous-window'.
720

721 722 723
*** New display action alist entry `inhibit-switch-frame', if non-nil,
tells display action functions to avoid changing which frame is
selected.
724

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

728 729
*** New display action alist entry `previous-window', if non-nil,
specifies window to reuse in `display-buffer-in-previous-window'.
730

731 732 733
*** The following variables are obsolete, as they can be replaced by
appropriate entries in the `display-buffer-alist' function introduced
in Emacs 24.1:
734
+++
735 736 737 738 739
**** `display-buffer-reuse-frames'
**** `special-display-regexps'
**** `special-display-frame-alist'
**** `special-display-buffer-names'
**** `special-display-function'
740
**** `display-buffer-function'
741

742 743 744 745 746
** 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.
747

Chong Yidong's avatar
Chong Yidong committed
748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784
*** `current-time' now returns extended-format time stamps
(HIGH LOW USEC PSEC), where the new PSEC slot specifies picoseconds.
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.

*** The format of timers in timer-list and timer-idle-list is now
[TRIGGERED-P HI-SECS LO-SECS USECS REPEAT-DELAY FUNCTION ARGS IDLE-DELAY PSECS].
The PSECS slot is new, and uses picosecond resolution.  It can be
accessed via the new timer--psecs accessor.

** Floating point functions now always return special values like NaN,
instead of signaling errors, if given invalid args, e.g. (log -1.0).
Previously, they returned NaNs on some platforms but signaled errors
on others.  The affected functions are acos, asin, tan, exp, expt,
log, log10, sqrt, and mod.

** Interpreted files are 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.

** Misc new functions:

*** `autoloadp'
*** `autoload-do-load'.
*** `buffer-narrowed-p' tests if the buffer is narrowed.
*** `file-name-base' returns a file name sans directory and extension.
*** `function-get' fetches a function property, following aliases.
*** `posnp' tests if an object is a `posn'.
*** `set-temporary-overlay-map' sets up a temporary overlay map.
*** `system-users' returns the user names on the system.
*** `system-groups' returns the group names on the system.
*** `tty-top-frame' returns the topmost frame of a text terminal.
785

Chong Yidong's avatar
Chong Yidong committed
786 787 788 789 790 791
** New macros `setq-local' and `defvar-local'.

** New fringe bitmap exclamation-mark.

** Face underlining can now use a wave.
See the "Face Attributes" section of the Elisp manual.
792

Chong Yidong's avatar
Chong Yidong committed
793
** The following functions and variables are obsolete:
Glenn Morris's avatar
Glenn Morris committed
794

Chong Yidong's avatar
Chong Yidong committed
795 796 797 798
*** `automount-dir-prefix'
*** `buffer-has-markers-at'
*** `macro-declaration-function' (use `macro-declarations-alist').
*** `window-system-version'
799

800

801
* Changes in Emacs 24.3 on non-free operating systems
802 803 804 805 806 807

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

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

808 809 810 811
** 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.

812
** On MS-Windows Vista and later Emacs now supports symbolic links.
813 814 815

* Changes in Emacs 24.2

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

818

819
* Installation Changes in Emacs 24.1
Chong Yidong's avatar
Chong Yidong committed
820

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

826 827 828 829
** 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.
830

831 832 833 834
** 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
835

836 837 838 839
** 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
840
This feature is not available for the Nextstep or MS ports.
841

842 843 844 845 846
** 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.

847 848 849 850
** 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
851
With it, Emacs integers typically have 62 bits, even on 32-bit machines.
852 853
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
854

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

859
** New configure option --enable-use-lisp-union-type.
860 861
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
862 863 864 865 866 867 868

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

869

870
* Startup Changes in Emacs 24.1
871

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

876
** New command line option `--no-site-lisp' removes site-lisp directories
877 878
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
879
Nextstep builds).
880

881

882
* Changes in Emacs 24.1
883

884
** Completion
885

886 887 888
*** Many packages now use the `completion-at-point' command,
rather than implementing separate completion commands.

889
*** `completion-at-point' now handles tags and semantic completion.
890

891 892
*** Completion in a non-minibuffer now tries to detect the end of completion
and pops down the *Completions* buffer accordingly.
893 894 895 896

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

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

899
*** New completion style `substring'.
900 901 902 903

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

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

905
** Mail changes
906

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

914 915 916
*** 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.
917

918 919
*** See Changes in Specialized Modes and Packages for SMTPmail changes
and Mail mode changes
Glenn Morris's avatar
Glenn Morris committed
920

Chong Yidong's avatar
Chong Yidong committed
921
** Emacs server and client changes
922

923
*** New option `server-port' specifies the port for TCP Emacs servers.
924

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

927 928
*** New emacsclient argument --frame-parameters specifies the frame
parameters of any newly-created graphical frame.
929 930 931 932

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

Chong Yidong's avatar
Chong Yidong committed
933 934 935 936
*** 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.

937 938 939
** Internationalization changes

*** Emacs now supports display and editing of bidirectional text.
940 941
Right-to-left (RTL) scripts, such as Arabic, Farsi, and Hebrew, are
displayed in the correct visual order as expected by users of those
942 943 944
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.
945

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

Chong Yidong's avatar
Chong Yidong committed
949 950
**** New buffer-local variable `bidi-paragraph-direction'.
If nil (the default), Emacs determines the base direction of each
951 952 953
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.
954

955 956
Paragraphs with right-to-left base direction are displayed starting at
the right window edge.
957

958 959 960 961 962
*** 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.
963

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

967 968 969
*** `nobreak-char-display' now also highlights Unicode hyphen chars
(U+2010 and U+2011).

970
*** New Hebrew translation of the Emacs Tutorial.
971 972 973
Type `C-u C-h t' to choose it in case your language setup doesn't
automatically select it.

974 975 976
** 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.
977

978 979
*** M-x list-packages shows a list of packages, which can be
selected for installation.
980

981
*** New command `describe-package', bound to `C-h P'.
982

983 984 985
*** 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
986

987 988
** Custom theme changes

989 990
*** New command `M-x customize-themes', which provides a convenient
interface for enabling and disabling Custom themes.
991

992
*** New option `custom-theme-load-path' is the load path for themes.
993 994 995 996 997 998
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.

999 1000 1001 1002
*** 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.
1003

1004
** Improved GTK integration
1005

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

1009
*** GTK tool bars can have just text, just images or images and text.
1010 1011 1012 1013
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.
1014 1015 1016
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.
1017

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

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

1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036
** 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

1037
** Exiting changes
1038

1039
*** Emacs now calls `kill-emacs' if it receives SIGTERM or SIGHUP,
1040 1041
or if it receives a SIGINT signal in batch mode.

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

Chong Yidong's avatar
Chong Yidong committed
1046
** Scrolling changes
1047

Chong Yidong's avatar
Chong Yidong committed
1048
*** New scrolling commands `scroll-up-command' and `scroll-down-command'
Juanma Barranquero's avatar
Juanma Barranquero committed
1049
(bound to C-v/[next] and M-v/[prior]) do not signal errors at top/bottom
1050
of buffer at first key-press (instead they move to top/bottom of buffer)
1051
when `scroll-error-top-bottom' is non-nil.
1052 1053 1054

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

Chong Yidong's avatar
Chong Yidong committed
1055
*** New scrolling commands `scroll-up-line' and `scroll-down-line'
1056
scroll a line instead of full screen.
1057

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

Chong Yidong's avatar
Chong Yidong committed
1061
*** If you customize `scroll-conservatively' to a value greater than 100,
1062 1063 1064 1065
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.
1066

1067
*** "Aggressive" scrolling now honors the scroll margins.
1068 1069 1070 1071 1072
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.

1073 1074
** Basic SELinux support has been added.
This requires Emacs to be linked with libselinux at build time.
1075

1076 1077 1078 1079
*** 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.
1080

1081
*** New functions `file-selinux-context' and `set-file-selinux-context'