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

3
Copyright (C) 2010-2013 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
Temporary note:
18 19 20 21
+++ indicates that all necessary updates to the manuals in doc/ are complete.
--- means no change in the manuals is needed.
When you add a new item, use the appropriate mark if you know it applies,
otherwise leave it unmarked.
Glenn Morris's avatar
Glenn Morris committed
22

23 24

* Installation Changes in Emacs 24.4
25

26
** Emacs can be compiled with ACL support.
27 28
This happens by default if a suitable support library is found at
build time, like libacl on GNU/Linux.  To prevent this, use the
29
configure option `--disable-acl'.
30

31
** Emacs can be compiled with file notification support.
32 33 34 35
This happens by default if a suitable system library is found at
build time.  To prevent this, use the configure option
`--with-file-notification-no'.  See below for file-notify features.
FIXME?  This feature is not available for the Nextstep port. (?)
36

37
** The configure option --with-crt-dir has been removed.
38 39 40
It is no longer needed, as the crt*.o files are no longer linked
specially.

41 42 43
** Directories passed to configure option `--enable-locallisppath' are
no longer created during installation.

44 45 46 47
---
** Emacs for NS (OSX, GNUStep) can be built with ImageMagick support.
pkg-config is required to find ImageMagick libraries.

Glenn Morris's avatar
Glenn Morris committed
48

49
* Startup Changes in Emacs 24.4
Glenn Morris's avatar
Glenn Morris committed
50 51


52
* Changes in Emacs 24.4
53

54 55
** Key ? also describes prefix bindings like C-h.

56 57 58 59 60 61 62
+++
** `apropos-variable' is now `apropos-user-option'
`apropos-user-option' shows all user options while `apropos-variable'
shows all variables.  When called with a universal prefix argument,
the two commands swap their behaviors.  When `apropos-do-all' is
non-nil, they output the same results.

63 64 65 66
+++
** `eval-defun' on an already defined defcustom calls the :set function,
if there is one.

67 68 69 70
** If the new variable `enable-dir-local-variables' is nil,
directory local variables are ignored.  May be useful for some modes
that want to ignore directory-locals while still respecting file-locals.

71 72 73 74
** The option `set-mark-default-inactive' has been deleted.
This unfinished feature was introduced by accident in Emacs 23.1;
simply disabling Transient Mark mode does the same thing.

75 76 77
** `initial-buffer-choice' can now specify a function to set up the
initial buffer.

78 79 80 81 82 83 84 85
** `remember-notes' creates a buffer whose content is saved on kill-emacs.
You may think of it as a *scratch* buffer whose content is preserved.
In fact, it was designed as a replacement for *scratch* buffer and can
be used that way by setting `initial-buffer-choice' to `remember-notes'
and `remember-notes-buffer-name' to "*scratch*".  Without the second
change, *scratch* buffer will still be there for notes that do not
need to be preserved.

86 87
** `write-region-inhibit-fsync' now defaults to t in batch mode.

88 89 90 91 92
** ACL support has been added.
+++
*** Emacs preserves the ACL entries of files when backing up.
+++
*** New functions `file-acl' and `set-file-acl' get and set the ACL
93 94 95
entries of a file.  On GNU/Linux, the POSIX ACL interface is used via
libacl.  On MS-Windows, the NT Security APIs are used to emulate the
POSIX ACL interfaces.
96

97
** New option `scroll-bar-adjust-thumb-portion'.
98 99 100
Available only on X, this option allows to control over-scrolling
using the scroll bar (i.e. dragging the thumb down even when the end
of the buffer is visible).
101

102 103 104
** New function `add-face-text-property' has been added, which can be
used to conveniently prepend/append new face attributes to text.

105 106
** In compiled Lisp files, the header no longer includes a timestamp.

107 108 109 110 111 112
** Multi-monitor support has been added.

*** New functions `display-monitor-attributes-list' and
`frame-monitor-attributes' can be used to obtain information about
each physical monitor on multi-monitor setups.

113 114 115 116 117 118 119 120
*** The functions `display-pixel-width' and `display-pixel-height' now
behave consistently among the platforms: they return the pixel width
or height for all physical monitors associated with the given display
as just they were on X11.  To get information for each physical
monitor, use the new functions above.  Similar notes also apply to
`x-display-pixel-width', `x-display-pixel-height', `display-mm-width',
`display-mm-height', `x-display-mm-width', and `x-display-mm-height'.

121 122 123 124
** New macro `alternatives-define' can be used to define generic commands.
Generic commands are interactive functions whose implementation can be
selected among several alternatives, as a matter of user preference.

Glenn Morris's avatar
Glenn Morris committed
125

126
* Editing Changes in Emacs 24.4
127

128 129 130 131 132
** `split-window' is no longer a command, just a non-interactive function.
As a command it was a special case of `split-window-below', and as such
superfluous.  After being reimplemented in Lisp, its interactive form
was mistakenly retained.

133 134
** New commands `toggle-frame-fullscreen' and `toggle-frame-maximized',
bound to <f11> and M-<f10>, respectively.
135

136 137 138
** In keymaps where SPC scrolls, S-SPC now scrolls in the reverse direction.
Eg View mode, etc.

139 140 141 142 143 144 145
+++
** New option `visual-order-cursor-movement'.
If this is non-nil, cursor motion with arrow keys will follow the
visual order of characters on the screen: <left> always moves to the
left, <right> always moves to the right, disregarding the surrounding
bidirectional context.

146 147
** New command `kmacro-to-register' to store keyboard macros in registers.

148 149 150 151 152
** Shell Script mode

*** `sh-mode' now has the mode own `add-log-current-defun-function'.
You can pick the name of the function and the variables with `C-x 4 a'.

153

154
* Changes in Specialized Modes and Packages in Emacs 24.4
155

156 157 158 159 160 161 162 163 164 165 166 167
** `eshell' now supports visual subcommands and options
Eshell has been able to handle "visual" commands (interactive,
non-line oriented commands such as top that require display
capabilities not provided by eshell) by running them in an Emacs
terminal emulator.  See `eshell-visual-commands'.

This feature has been extended to subcommands and options that make a
usually line-oriented command a visual command.  Typical examples are
"git log" and "git <command> --help" which display their output in a
pager by default.  See `eshell-visual-subcommands' and
`eshell-visual-options'.

Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
168 169 170
** If your Emacs is compiled with libxml2 support, you can use the new
built-in web browser `eww'.

171 172 173 174 175 176
** `remember' can now store notes in separates files
You can use the new function `remember-store-in-files' within the
`remember-handler-functions' option.

See `remember-data-directory' and `remember-directory-file-name-format'
for new options related to this function.
177 178
** `ido-decorations' has been slightly extended to give a bit more control.

Stefan Monnier's avatar
Stefan Monnier committed
179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194
** More packages look for ~/.emacs.d/<foo> additionally to ~/.<foo>.
Affected files:
~/.emacs.d/timelog	replaces  ~/.timelog
~/.emacs.d/vip		replaces  ~/.vip
~/.emacs.d/viper	replaces  ~/.viper
~/.emacs.d/ido.last	replaces  ~/.ido.last
~/.emacs.d/kkcrc	replaces  ~/.kkcrc
~/.emacs.d/quickurls	replaces  ~/.quickurls
~/.emacs.d/idlwave	replaces  ~/.idlwave
~/.emacs.d/bdfcache.el	replaces  ~/.bdfcache.el
~/.emacs.d/places	replaces  ~/.emacs-places
~/.emacs.d/shadows	replaces  ~/.shadows
~/.emacs.d/shadow_todo	replaces  ~/.shadow_todo
~/.emacs.d/strokes	replaces  ~/.strokes
~/.emacs.d/notes	replaces  ~/.notes
~/.emacs.d/type-break	replaces  ~/.type-break
195 196 197 198 199
Also the following files used by the now obsolete otodo-mode.el:
~/.emacs.d/todo-do	replaces  ~/.todo-do
~/.emacs.d/todo-done	replaces  ~/.todo-done
~/.emacs.d/todo-top	replaces  ~/.todo-top

200

201 202
** Delphi mode is now called OPascal mode.
*** All delphi-* variables and functions have been renamed to opascal-*.
Juanma Barranquero's avatar
Juanma Barranquero committed
203 204
*** `delphi-newline-always-indents' is not supported any more.
Use `electric-indent-mode' instead.
205 206
*** `delphi-tab' is gone, replaced by `indent-for-tab-command'.

207 208
** Eldoc Mode works properly in the minibuffer.

209 210
** jit-lock-debug-mode lets you use the debuggers on code run via jit-lock.

211 212 213
** completing-read-multiple's separator can now be a regexp.
The default separator is changed to allow surrounding spaces around the comma.

214 215 216 217
** Battery

*** Battery information via the BSD `apm' utility is now supported.

218 219 220 221
** Buffer Menu

*** `M-s a C-o' shows lines matching a regexp in marked buffers using Occur.

222 223 224
** Calendar and Diary

+++
Glenn Morris's avatar
Glenn Morris committed
225
*** New variable `diary-from-outlook-function', used by the command
226 227
`diary-from-outlook'.

228 229 230 231 232 233 234
** cl-lib

*** New macro cl-tagbody.

+++
*** letf is now just an alias for cl-letf.

235 236 237 238 239 240 241 242 243 244 245 246 247 248
** Calc

*** Calc by default now uses the Gregorian calendar for all dates, and
uses January 1, 1 AD as its day number 1.  Previously Calc used the
Julian calendar for dates before September 14, 1752, and it used
December 31, 1 BC as its day number 1; the new scheme is more
consistent with Calendar's calendrical system and day numbering.

*** The new variable `calc-gregorian-switch' lets you configure the
date when Calc switches from the Julian to the Gregorian calendar.
Nil, the default value, means to always use the Gregorian calendar.
The value (YEAR MONTH DAY) means to start using the Gregorian calendar
on the given date.

249 250
*** Support for ISO 8601 dates.

251 252 253 254 255
** Desktop

*** `desktop-auto-save-timeout' defines the number of seconds between
auto-saves of the desktop.

Juanma Barranquero's avatar
Juanma Barranquero committed
256
*** `desktop-restore-frames' enables saving and restoring the window/frame
257 258
configuration.

259 260 261 262
** Dired

*** New minor mode `dired-hide-details-mode' hides details.

263 264 265 266 267 268
** ERC

*** New option `erc-accidental-paste-threshold-seconds'.
If set to a number, this can be used to avoid accidentally paste large
amounts of data into the ERC input.

269 270 271
---
** New F90 mode option `f90-smart-end-names'.

Juanma Barranquero's avatar
Juanma Barranquero committed
272
** Icomplete is a bit more like Ido.
273 274 275 276
*** key bindings to navigate through and select the completions.
*** The icomplete-separator is customizable, and its default has changed.
*** Removed icomplete-show-key-bindings.

277
** Image mode
278 279 280 281 282

*** New commands `n' (`image-next-file') and `p' (`image-previous-file')
visit the next image file and the previous image file in the same
directory, respectively.

283 284 285 286
*** New commands to show specific frames of multi-frame images.
`f' (`image-next-frame') and `b' (`image-previous-frame') visit the
next or previous frame.  `F' (`image-goto-frame') shows a specific frame.

287 288 289 290 291 292
---
*** The command `image-mode-fit-frame' deletes other windows.
When toggling, it restores the frame's previous window configuration.
It also has an optional frame argument, which can be used by Lisp
callers to fit the image to a frame other than the selected frame.

293 294 295 296 297 298
** Info

*** New face `info-index-match' is used to highlight matches in index
entries displayed by `Info-index-next', `Info-virtual-index' and
`info-apropos'.

299 300 301 302 303 304 305 306 307 308
** Hi-Lock

*** New option `hi-lock-auto-select-face'.  When non-nil, hi-lock commands
will cycle through faces in `hi-lock-face-defaults' without prompting.

+++
*** New global command `M-s h .' (`highlight-symbol-at-point')
highlights the symbol found near point without prompting,
using the next face automatically.

309
** Search and Replace
310

311 312 313 314
*** New global command `M-s .' (`isearch-forward-symbol-at-point')
starts a symbol (identifier) incremental search forward with the
symbol found near point added to the search string initially.

315 316 317
*** `C-x 8 RET' in Isearch mode reads a character by its Unicode name
and adds it to the search string.

318 319 320
*** `M-s i' in Isearch mode toggles the variable `isearch-invisible'
between nil and the value of the option `search-invisible' (or `open'
when it's nil).
321

322 323 324
*** `query-replace' skips invisible text when `search-invisible' is nil,
and opens overlays with hidden text when `search-invisible' is `open'.

325 326 327 328
+++
*** By default, prefix arguments do not now terminate Isearch mode.
Set `isearch-allow-prefix' to nil to restore old behavior.

329 330 331 332
*** More Isearch commands accept prefix arguments, namely
`isearch-printing-char', `isearch-quote-char', `isearch-yank-word',
`isearch-yank-line'.

333 334 335 336 337 338 339 340
*** Word search now matches whitespace at the beginning/end
of the search string if it contains leading/trailing whitespace.
In an incremental word search or when using a non-nil LAX argument
of `word-search-regexp', the lax matching can also match part of
the first word (in addition to the lax matching of the last word).
The same rules are now applied to the symbol search with the difference
that it matches symbols, and non-symbol characters between symbols.

Bill Wohler's avatar
Bill Wohler committed
341
** MH-E has been updated to MH-E version 8.5.
Bill Wohler's avatar
Bill Wohler committed
342 343
See MH-E-NEWS for details.

344 345 346 347 348 349 350 351
---
** The unrmail command converts from BABYL to mboxrd rather than mboxo.
Customize `unrmail-mbox-format' to change this.

---
** Similarly, customize `rmail-mbox-format' to influence some minor aspects
of how Rmail displays non-MIME messages.

352 353 354
+++
** New function `ses-rename-cell' to give SES cells arbitrary names.

355 356 357 358 359 360 361 362 363
** trace-function was largely rewritten.
New features include:
- no prompting for the destination buffer, unless a prefix-arg was used.
- additionally to prompting for a destination buffer, when a prefix-arg is
  used, the user can enter a "context", i.e. Lisp expression whose value at the
  time the function is entered/exited will be printed along with the function
  name and arguments.  Useful to trace the value of (current-buffer) or
  (point) when the function is invoked.

364 365
** New command `delete-duplicate-lines' has new types of operation:
When its arg ADJACENT is non-nil (when called interactively with C-u C-u)
366 367
it works like the utility `uniq'.  Otherwise by default it deletes
duplicate lines everywhere in the region without regard to adjacency.
Juanma Barranquero's avatar
Juanma Barranquero committed
368 369
When its arg KEEP-BLANKS is non-nil (when called interactively with
C-u C-u C-u), duplicate blank lines are preserved.
370

371 372 373 374 375
** New `cycle-spacing' command allows cycling between having just one
space, no spaces, or reverting to the original spacing.  Like
`just-one-space' command it can handle or ignore newlines and
leave different number of spaces.

376 377 378 379 380
** Todo mode has been rewritten and enhanced.
New features include:
- support for multiple todo files and archive files of done items;
- renaming, reordering, moving, merging, and deleting categories;
- sortable tabular summaries of categories and the types of items they contain;
Paul Eggert's avatar
Paul Eggert committed
381
- cross-category lists of items filtered by specific criteria;
382 383 384 385 386 387 388 389 390 391 392 393 394
- more fine-grained interaction with the Emacs diary, by being able to decide
  for each todo item whether it appears in the Fancy Diary display;
- highly flexible new item insertion and item editing;
- moving items between categories, storing done items in their category or in
  archive files, undoing or unarchiving done items;
- reprioritizing items by inputting a numerical priority;
- extensive customizability of operation and display, including numerous faces.
To support some of these features, a new file format is used, which is
incompatible with the old format; however, you can convert old todo and done
item files to the new format on initializing the first new todo file, or at any
later time with the provided conversion command.  The old version of
todo-mode.el has been made obsolete and renamed otodo-mode.el.

395
** Tramp
396

397 398
+++
*** New connection method "adb", which allows to access Android
399 400
devices by the Android Debug Bridge.  The variable `tramp-adb-program'
can be used to adapt the path of the "adb" program, if needed.
401

402 403 404 405
*** The connection methods "plink1", "ssh1", "ssh2", "scp1", "scp2",
"scpc" and "rsyncc" are discontinued.  The ssh option
"ControlMaster=auto" is set automatically in all ssh-based methods,
when possible.
406

407 408 409
+++
*** Handlers for `file-acl' and `set-file-acl' for remote machines
which support POSIX ACLs.
410

411 412 413 414
+++
*** Handlers for `file-notify-add-watch' and `file-notify-rm-watch'
for remote machines which support filesystem notifications.

Glenn Morris's avatar
Glenn Morris committed
415 416 417 418 419 420
** VHDL mode

*** New options: `vhdl-actual-generic-name', `vhdl-beautify-options'.

*** New commands: `vhdl-fix-statement-region', `vhdl-fix-statement-buffer'.

421 422 423
** Woman

*** The commands `woman-default-faces' and `woman-monochrome-faces'
Juanma Barranquero's avatar
Juanma Barranquero committed
424
are obsolete.  Customize the `woman-*' faces instead.
425

426 427
** Eshell

428
*** Added Eshell-Tramp module
429
External su and sudo commands are now the default; the internal,
430
Tramp-using variants can still be used by enabling the eshell-tramp
431 432
module.

433 434
** New term.el option `term-suppress-hard-newline'.

Chong Yidong's avatar
Chong Yidong committed
435 436 437 438
** Obsolete packages:

*** longlines.el is obsolete; use visual-line-mode instead.

Glenn Morris's avatar
Glenn Morris committed
439 440 441
+++
*** sup-mouse.el.

Chong Yidong's avatar
Chong Yidong committed
442 443
*** terminal.el is obsolete; use term.el instead.

444 445
*** The previous version of todo-mode.el is obsolete and renamed otodo-mode.el.

Michael Albinus's avatar
Michael Albinus committed
446 447
*** xesam.el.

Glenn Morris's avatar
Glenn Morris committed
448 449 450
+++
*** yow.el is obsolete; use fortune.el or cookie1.el instead.

Glenn Morris's avatar
Glenn Morris committed
451 452 453 454
---
*** The Info-edit command is obsolete.  Editing Info nodes by hand
has not been relevant for some time.

455

456
* New Modes and Packages in Emacs 24.4
Juanma Barranquero's avatar
Juanma Barranquero committed
457

Ted Zlatanov's avatar
Ted Zlatanov committed
458 459 460 461 462
** New `superword-mode' in subword.el
`superword-mode' overrides the default word motion commands to treat
symbol_words as a single word, similar to what `subword-mode' does and
using the same internal functions.

463 464 465 466 467 468 469
** New nadvice.el package offering lighter-weight advice facilities.
It is layered as:
- add-function/remove-function which can be used to add/remove code on any
  function-carrying place, such as process-filters or `<foo>-function' hooks.
- advice-add/advice-remove to add/remove a piece of advice on a named function,
  much like `defadvice' does.

470 471 472 473
** The package file-notify.el provides an interface for file system
notifications.  It requires, that Emacs is compiled with one of the
low-level libraries gfilenotify.c, inotify.c or w32notify.c.

Glenn Morris's avatar
Glenn Morris committed
474

475
* Incompatible Lisp Changes in Emacs 24.4
476

477 478 479
** The syntax of ?» and ?« is now punctuation instead of matched parens.
Some languages match those as »...« and others as «...» so better stay neutral.

480 481 482 483
** The default file coding for Emacs Lisp files is now utf-8.
(See file-coding-system-alist.)  In most cases, this change is transparent, but
files that contain unusual characters without specifying an explicit coding
system may fail to load with obscure errors.
Xue Fuqiao's avatar
Xue Fuqiao committed
484
You should either convert them to utf-8 or add an explicit `coding:' cookie.
485

486 487 488 489
** overriding-terminal-local-map does not replace the local keymaps any more.
It used to disable the minor mode, major mode, and text-property keymaps,
whereas now it simply has higher precedence.

Juanma Barranquero's avatar
Juanma Barranquero committed
490
** Default process filters and sentinels are not nil any more.
491 492
Instead they default to a function which does what the nil value used to do.

493 494 495 496 497
** `read-event' does not return decoded chars in ttys any more.
Just as was the case in Emacs-22 and before, decoding of tty input according to
keyboard-coding-system is not performed in read-event any more.  But contrary
to that past, it is still done before input-decode-map/function-key-map/...

498 499
** Removed inhibit-local-menu-bar-menus.

500 501 502 503
** frame-local variables that affect redisplay do not work any more.
More specifically, the redisplay does not bother to check for a frame-local
value when looking up variables.

504 505 506 507
** nil and "unbound" are indistinguishable in symbol-function.
`symbol-function' never signals `void-function' any more.
`fboundp' returns non-nil if the symbol was `fset' to nil.

508 509
** `defadvice' does not honor the `freeze' flag and cannot advise
special-forms any more.
510

511 512 513 514
** `dolist' in lexical-binding mode does not bind VAR in RESULT any more.
VAR was bound to nil which was not tremendously useful and just lead to
spurious warnings about an unused var.

515 516 517 518 519 520
** The return value of `backup-buffer' has changed.
The second argument is no longer an SELinux context, instead it is an
alist of extended attributes as returned by the new function
`file-extended-attributes'.  The attributes can be applied to another
file using `set-file-extended-attributes'.

Paul Eggert's avatar
Paul Eggert committed
521 522 523
** `visited-file-modtime' now returns -1 for nonexistent files.
Formerly it returned a list (-1 LOW USEC PSEC), but this was ambiguous
in the presence of files with negative time stamps.
Glenn Morris's avatar
Glenn Morris committed
524

525
* Lisp Changes in Emacs 24.4
526

527 528
** New hook `tty-setup-hook'.

529 530 531
+++
** New macro with-eval-after-load.  Like eval-after-load, but better behaved.

532
** Obsoleted functions:
533
*** `log10'
534 535 536 537
*** `dont-compile'
*** `lisp-complete-symbol'
*** `field-complete'
*** `minibuffer-completion-contents'
538 539
*** `isearch-nonincremental-exit-minibuffer'
*** `isearch-filter-visible'
540
*** `generic-make-keywords-list'
541

542 543 544 545 546 547 548
** `with-wrapper-hook' is obsoleted by `add-function'.
The few hooks that used with-wrapper-hook are replaced as follows:
*** `abbrev-expand-function' obsoletes `abbrev-expand-functions'.
*** `completion-in-region-function' obsoletes `completion-in-region-functions'.
*** `filter-buffer-substring-function' obsoletes `filter-buffer-substring-functions'.


549 550
** `get-upcase-table' is obsoleted by the new `case-table-get-table'.

551 552 553
** Support for filesystem notifications.
Emacs now supports notifications of filesystem changes, such as
creation, modification, and deletion of files.  This requires the
554 555 556
`glib' API, or the 'inotify' API (on GNU/Linux systems only).  On
MS-Windows systems, this is supported for Windows XP and newer
versions.
557

558 559 560 561 562 563 564 565 566 567 568 569 570 571
** Changes in autorevert.el

---
*** If Emacs is compiled with file notification support, notifications
are used instead of checking the time stamp of the files.  You can
disable this by setting the user option `auto-revert-use-notify' to
nil.  Alternatively, a regular expression of directories to be
excluded from file notifications can be specified by
`auto-revert-notify-exclude-dir-regexp'.

---
*** The new user option `auto-revert-remote-files' enables reversion
of remote files when set to non-nil.

572 573
** Face changes

Juanma Barranquero's avatar
Juanma Barranquero committed
574
*** The function `face-spec-set' is now analogous to `setq' for face specs.
575 576 577 578 579 580 581
Its third arg now accepts values specifying exactly which face spec to
set (defface, custom, or user spec), and it directly sets the relevant
property using the supplied face spec.

*** Face specs set via Custom themes now replace the `defface' spec
rather than inheriting from it (as do face specs set via Customize).

582 583 584
*** New face characteristic (supports :underline (:style wave))
specifies whether or not the terminal can display a wavy line.

585 586 587 588 589 590 591 592 593 594 595 596 597 598 599
** Image API

+++
*** `image-animated-p' is now `image-multi-frame-p'.
It returns non-nil for any image that contains multiple frames,
whether or not it specifies a frame delay.

+++
*** When animating images that do not specify a frame delay,
Emacs uses `image-default-frame-delay'.

+++
*** New functions `image-current-frame' and `image-show-frame' for getting
and setting the current frame of a multi-frame image.

Paul Eggert's avatar
Paul Eggert committed
600 601 602
** The function `set-visited-file-modtime' now accepts a 0 or -1 argument
with the same interpretation as the returned value of `visited-file-modtime'.

603
** time-to-seconds is not obsolete any more.
604
** New function special-form-p.
605 606 607
** Docstrings can be made dynamic by adding a `dynamic-docstring-function'
text-property on the first char.

608 609 610
** The `defalias-fset-function' property lets you catch calls to defalias
and redirect them to your own function instead of `fset'.

611
** The lock for 'DIR/FILE' is now 'DIR/.#FILE' and may be a regular file.
612 613 614 615 616 617 618
When you edit DIR/FILE, Emacs normally creates a symbolic link
DIR/.#FILE as a lock that warns other instances of Emacs that DIR/FILE
is being edited.  Formerly, if there was already a non-symlink file
named DIR/.#FILE, Emacs fell back on the lock names DIR/.#FILE.0
through DIR/.#FILE.9.  These fallbacks have been removed, so that
Emacs now no longer locks DIR/FILE in that case.

619 620
On file systems that do not support symbolic links, the lock is now a
regular file with contents being what would have been in the symlink.
621

622 623 624 625 626 627 628 629 630 631 632
** The 9th element returned by `file-attributes' is now unspecified.
Formerly, it was t if the file's gid would change if file were deleted
and recreated.  This value has been inaccurate for years on many
platforms, and nobody seems to have noticed or cared.

** The function `file-ownership-preserved-p' now has an optional
argument GROUP which causes it check for file group too.  This can be
used in place of the 9th element of `file-attributes'.

** New functions `group-gid' and `group-real-gid'.

633 634 635 636
** The 6th argument to `copy-file' has been renamed to
`preserve-extended-attributes' as it now handles both SELinux context
and ACL entries.

637 638 639
** Changes to the Emacs Lisp Coding Conventions in Emacs 24.4

*** The package descriptor and name of global variables, constants,
Paul Eggert's avatar
Paul Eggert committed
640
and functions should be separated by two hyphens if the symbol is not
641 642
meant to be used by other packages.

Glenn Morris's avatar
Glenn Morris committed
643

644
* Changes in Emacs 24.4 on Non-Free Operating Systems
645

646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664
** Emacs for MS-Windows can now be built by running the configure script
using the MSYS environment and MinGW development tools.
This is from now on the preferred method of building Emacs on
MS-Windows.  The Windows-specific configure.bat and makefile.w32-in
files are deprecated.  See the file nt/INSTALL.MSYS for detailed
instructions.

Using the Posix configure script and Makefile's also means a change in
the directory structure of the Emacs installation on Windows.  It is
now the same as on GNU and Unix systems.  In particular, the auxiliary
programs, such as cmdproxy.exe and hexl.exe, are in
libexec/emacs/VERSION/i686-pc-mingw32 (where VERSION is the Emacs
version), version-independent site-lisp is in share/emacs/site-lisp,
version-specific Lisp files are in share/emacs/VERSION/lisp and in
share/emacs/VERSION/site-lisp, Info docs are in share/info, and data
files are in share/emacs/VERSION/etc.  (Emacs knows about all these
directories and will find the files in there automatically; there's no
need to set any variables due to this change.)

665 666 667 668 669
+++
** The "generate a backtrace on fatal error" feature now works on MS Windows.
The backtrace is written to the 'emacs_backtrace.txt' file in the
directory where Emacs was running.

670 671 672 673 674 675
+++
** The variable `buffer-file-type' is no longer supported.
Setting it has no effect, and %t in the mode-line format is ignored.
Likewise, `file-name-buffer-file-type-alist' is now obsolete, and
modifying it has no effect.

676 677 678 679 680 681 682
---
** Lock files now work on MS-Windows.
This allows to avoid losing your edits if the same file is being
edited in another Emacs session or by another user.  See the node
"Interlocking" in the Emacs User Manual for the details.  To disable
file locking, customize `create-lockfiles' to nil.

Glenn Morris's avatar
Glenn Morris committed
683 684 685 686 687
** Improved fullscreen support on Mac OS X.
Both native (>= OSX 10.7) and "old style" fullscreen are supported.
Customize `ns-use-native-fullscreen' to change style.  For >= 10.7
native is the default.

Glenn Morris's avatar
Glenn Morris committed
688

689
* Installation Changes in Emacs 24.3
690

691
** The default X toolkit is now Gtk+ version 3.
Glenn Morris's avatar
Glenn Morris committed
692 693 694
If you don't pass `--with-x-toolkit' to configure, or if you use
`--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.
Glenn Morris's avatar
Glenn Morris committed
695
You can explicitly require a specific version by passing
Glenn Morris's avatar
Glenn Morris committed
696
`--with-x-toolkit=gtk2' or `--with-x-toolkit=gtk3' to configure.
697

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

Glenn Morris's avatar
Glenn Morris committed
701 702
** New configure option `--without-all' to disable most of the optional
features (image support, etc.) that are normally enabled by default.
703

Glenn Morris's avatar
Glenn Morris committed
704 705
** New configure option `--enable-gcc-warnings' (for developing/debugging
Emacs).  If building with GCC, this enables compile-time checks that
Glenn Morris's avatar
Glenn Morris committed
706 707 708
warn/give errors about possibly-questionable C code.  On a recent GNU
system there should be no warnings; on older and on non-GNU systems
the results may be useful to developers.
709

Glenn Morris's avatar
Glenn Morris committed
710
** The configure option `--enable-use-lisp-union-type' has been
711
renamed to `--enable-check-lisp-object-type', as the resulting
Glenn Morris's avatar
Glenn Morris committed
712 713 714
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
715
** The configure option `--disable-maintainer-mode' has been removed,
716 717
as it was confusingly-named and rarely useful.

Glenn Morris's avatar
Glenn Morris committed
718 719 720 721 722
** The configure options `--program-prefix', `--program-suffix', and
`--program-transform-name' apply to more than just the installed
binaries.  Now they also affect the man pages, icons, and the
etc/emacs.desktop file; but not the info pages, since this would break
links between the various manuals.
723

Glenn Morris's avatar
Glenn Morris committed
724 725
** You can use `NO_BIN_LINK=t make install' to prevent the installation
overwriting "emacs" in the installation bin/ directory with a link
726
to "emacs-VERSION".
Glenn Morris's avatar
Glenn Morris committed
727

728 729
** Emacs uses libtinfo in preference to libncurses, if available.

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

734
** The standalone scripts `rcs-checkin' and `vcdiff' have been removed
Glenn Morris's avatar
Glenn Morris committed
735 736 737
(from the bin and libexec directories, respectively).  The former is
no longer relevant, the latter is replaced by lisp (in vc-sccs.el).

Glenn Morris's avatar
Glenn Morris committed
738

739
* Startup Changes in Emacs 24.3
740 741 742

** Emacs no longer searches for `leim-list.el' files beneath the standard
lisp/ directory.  There should not be any there anyway.  If you have
Glenn Morris's avatar
Glenn Morris committed
743
been adding them there, put them somewhere else; e.g., site-lisp.
744

Glenn Morris's avatar
Glenn Morris committed
745 746
** The `--no-site-lisp' command line option now works for Nextstep builds.

Glenn Morris's avatar
Glenn Morris committed
747

748
* Changes in Emacs 24.3
Glenn Morris's avatar
Glenn Morris committed
749

750
** Help
751

752
*** `C-h f' (`describe-function') can now perform autoloading.
753 754 755 756 757 758 759 760 761
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).

762
** ImageMagick
763

764 765
*** Images displayed via ImageMagick now support transparency and the
:background image specification property.
766

767
*** When available, ImageMagick support is automatically enabled.
768 769
It is no longer necessary to call `imagemagick-register-types'
explicitly to install ImageMagick image types; that function is called
770
automatically at startup, or when customizing an imagemagick- option.
Glenn Morris's avatar
Glenn Morris committed
771

772
*** Setting `imagemagick-types-inhibit' to t now disables the use of
Glenn Morris's avatar
Glenn Morris committed
773 774
ImageMagick to view images.  (You must call `imagemagick-register-types'
afterwards if you do not use customize to change this.)
Glenn Morris's avatar
Glenn Morris committed
775

776
*** The new variable `imagemagick-enabled-types' also affects which
777 778 779
ImageMagick types are treated as images.  The function
`imagemagick-filter-types' returns the list of types that will be
treated as images.
780

781 782 783
*** ImageMagick images now support the :max-width and :max-height
keywords.

784 785 786 787
** Minibuffer

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

789 790 791 792 793 794 795 796 797 798 799 800 801 802
*** `minibuffer-electric-default-mode' can shorten "(default ...)" to "[...]"
in minibuffer prompts.  Just set `minibuffer-eldef-shorten-default'
non-nil before enabling the mode.

** Mode line

*** 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 invoke
`set-buffer-file-coding-system'.

** Server and client
Glenn Morris's avatar
Glenn Morris committed
803

Chong Yidong's avatar
Chong Yidong committed
804 805 806
*** 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.
Glenn Morris's avatar
Glenn Morris committed
807

Chong Yidong's avatar
Chong Yidong committed
808 809 810 811 812
*** New option `server-auth-key' specifies a shared server key.

** 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
813
that support backtraces.
814

815 816 817 818 819 820 821 822 823 824
** `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.

** 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 the Package Menu, newly-available packages are listed as "new",
and sorted above the other "available" packages by default.

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

828
** New option `create-lockfiles' specifies usage of lockfiles.
Chong Yidong's avatar
Chong Yidong committed
829 830
It defaults to t.  Changing it to nil inhibits the creation of lock
files (use this with caution).
831

832 833
** New option `enable-remote-dir-locals', if non-nil, allows directory-local
variables on remote hosts.
834

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

838 839 840
** Using "unibyte: t" in Lisp source files is obsolete.
Use "coding: raw-text" instead.

841 842 843 844 845
** In the buffer made by `M-x report-emacs-bug', the `C-c m' binding
has been changed to `C-c M-i' (`report-emacs-bug-insert-to-mailer').
The previous binding, introduced in Emacs 24.1, was a mistake, because
`C-c LETTER' bindings are reserved for user customizations.

846
** Internationalization
Glenn Morris's avatar
Glenn Morris committed
847

Chong Yidong's avatar
Chong Yidong committed
848
*** New language environment: Persian.
Glenn Morris's avatar
Glenn Morris committed
849

Chong Yidong's avatar
Chong Yidong committed
850 851
*** New input method `vietnamese-vni'.

852
** Nextstep (GNUstep / Mac OS X) port
Glenn Morris's avatar
Glenn Morris committed
853

Glenn Morris's avatar
Glenn Morris committed
854
*** Support for fullscreen and the frame parameter fullscreen.
Glenn Morris's avatar
Glenn Morris committed
855

856 857 858
*** A file dialog is used for open/save operations initiated from the
menu/toolbar.

Glenn Morris's avatar
Glenn Morris committed
859

860
* Editing Changes in Emacs 24.3
861

862
** Search and Replace
863

Chong Yidong's avatar
Chong Yidong committed
864 865 866 867
*** 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
Glenn Morris's avatar
Glenn Morris committed
868
similar existing feature for regexp Isearch.)
Glenn Morris's avatar
Glenn Morris committed
869

Chong Yidong's avatar
Chong Yidong committed
870 871
*** New Isearch command `M-s SPC' toggles lax space matching.
This applies to both ordinary and regexp Isearch.
Glenn Morris's avatar
Glenn Morris committed
872

Chong Yidong's avatar
Chong Yidong committed
873 874 875
*** New option `replace-lax-whitespace'.
If non-nil, `query-replace' uses flexible whitespace matching too.
The default is nil.
Glenn Morris's avatar
Glenn Morris committed
876

877 878 879 880
*** 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.

881
** Navigation commands
882

883 884 885 886 887 888 889 890 891 892
*** New binding `M-g c' for `goto-char'.

*** New binding `M-g TAB' for `move-to-column'.

*** `M-g TAB' (`move-to-column') prompts for a column number if called
interactively with no prefix arg.  Previously, it moved to column 1.

** New option `yank-handled-properties' allows processing of text
properties on yanked text, in ways that are more general than just
removing them (as is done by `yank-excluded-properties').
893 894 895 896 897

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

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

900 901
** `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'.
902

903 904 905
** The `z' key no longer has a binding in most special modes.
It used to be bound to `kill-this-buffer', but `z' is too easy to
accidentally type.
Chong Yidong's avatar
Chong Yidong committed
906

907 908
** 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
909

910
** Registers
Chong Yidong's avatar
Chong Yidong committed
911

Glenn Morris's avatar
Glenn Morris committed
912
*** `C-x r +' is now overloaded to invoke `append-to-register'.
Chong Yidong's avatar
Chong Yidong committed
913 914

*** New option `register-separator' specifies the register containing
Glenn Morris's avatar
Glenn Morris committed
915 916
the text to put between collected texts for use with
M-x append-to-register and M-x prepend-to-register.
917

Glenn Morris's avatar
Glenn Morris committed
918

919
* Changes in Specialized Modes and Packages in Emacs 24.3
Julien Danjou's avatar
Julien Danjou committed
920

921
** Common Lisp emulation (CL)
Chong Yidong's avatar
Chong Yidong committed
922

923
*** CL's main entry is now (require 'cl-lib).
Glenn Morris's avatar
Glenn Morris committed
924 925 926
`cl-lib' is like the old `cl' except that it uses the namespace cleanly;
i.e., all its definitions have the "cl-" prefix (and internal definitions
use the "cl--" prefix).
927

Glenn Morris's avatar
Glenn Morris committed
928 929 930 931 932
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 `cl' definitions that had to use `foo*' to avoid conflicts with
pre-existing Elisp entities.  These have been renamed to `cl-foo'
rather than `cl-foo*'.
933

Glenn Morris's avatar
Glenn Morris committed
934
The old `cl' is now deprecated and is mainly just a bunch of aliases that
Glenn Morris's avatar
Glenn Morris committed
935
provide the old, non-prefixed names.  Some exceptions are listed below:
936

937 938
*** `cl-flet' is not like `flet' (which is deprecated).
Instead it obeys the behavior of Common-Lisp's `flet'.
Glenn Morris's avatar
Glenn Morris committed
939 940
In particular, in cl-flet function definitions are lexically scoped,
whereas in flet the scoping is dynamic.
941 942

*** `cl-labels' is slightly different from `labels'.
Glenn Morris's avatar
Glenn Morris committed
943 944 945 946
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.
947

Glenn Morris's avatar
Glenn Morris committed
948
*** `cl-letf' is not exactly like `letf'.
949 950
The only difference is in details that relate to some deprecated usage
of `symbol-function' in place forms.
Glenn Morris's avatar
Glenn Morris committed
951

952
*** `progv' was rewritten to use the `let' machinery.
Glenn Morris's avatar
Glenn Morris committed
953 954
A side effect is that variables without corresponding values are bound
to nil rather than being made unbound.
955

Glenn Morris's avatar
Glenn Morris committed
956 957 958
*** The following methods of extending `setf' are obsolete
(use features from gv.el instead):
`define-modify-macro' (use `gv-letplace')
Glenn Morris's avatar
Glenn Morris committed
959 960
`defsetf' (use `gv-define-simple-setter' or `gv-define-setter')
`define-setf-expander' (use `gv-define-setter' or `gv-define-expander')
Glenn Morris's avatar
Glenn Morris committed
961
`get-setf-method' no longer exists (see "Incompatible Lisp Changes")
Glenn Morris's avatar
Glenn Morris committed
962

963
** Diff mode
Chong Yidong's avatar
Chong Yidong committed
964

965 966 967 968 969
*** 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').
Chong Yidong's avatar
Chong Yidong committed
970

971 972 973
*** 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.
Glenn Morris's avatar
Glenn Morris committed
974

975 976
*** The new command `diff-delete-trailing-whitespace' removes trailing
whitespace introduced by a diff.
Chong Yidong's avatar
Chong Yidong committed
977

978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997
** Ediff now uses the same color scheme as Diff mode.

** Python mode

A new version of python.el, which provides several new features, including:
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, including (old -> new):
**** 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, including:

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

**** `python-honour-comment-indentation':
998
Comments are always considered as indentation markers.
999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033

**** `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 -> new):
**** 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-beginning-of-defun-function -> python-nav-beginning-of-defun
**** python-end-of-defun-function -> python-nav-end-of-defun
**** 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
Chong Yidong's avatar
Chong Yidong committed
1034

Chong Yidong's avatar
Chong Yidong committed
1035 1036 1037 1038 1039 1040 1041 1042 1043
** 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.

Glenn Morris's avatar
Glenn Morris committed
1044 1045
*** The function `dbus-call-method' is now non-blocking.
It can be interrupted by `C-g'.  `dbus-call-method-non-blocking' is obsolete.
Chong Yidong's avatar
Chong Yidong committed
1046

Glenn Morris's avatar
Glenn Morris committed
1047
*** Signals can also be sent as unicast messages.
Chong Yidong's avatar
Chong Yidong committed
1048 1049

*** The argument list of `dbus-register-signal' has been extended,
1050
according to the new match rule types of D-Bus.
Chong Yidong's avatar
Chong Yidong committed
1051 1052 1053 1054 1055

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

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

1056 1057
** `desktop-path' no longer includes the "." directory.
Desktop files are now located in ~/.emacs.d by default.
Chong Yidong's avatar
Chong Yidong committed
1058 1059

** Dired
Glenn Morris's avatar
Glenn Morris committed
1060

Chong Yidong's avatar
Chong Yidong committed
1061 1062 1063
*** `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.
Glenn Morris's avatar
Glenn Morris committed
1064

Glenn Morris's avatar
Glenn Morris committed
1065 1066
*** Typing `M-n' in the minibuffer of `dired-do-chmod', `dired-do-chgrp',
`dired-do-chown', and `dired-do-touch' yanks the attributes of the
Chong Yidong's avatar
Chong Yidong committed
1067
file at point.