NEWS 131 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 38 39 40
** The configure option `without-compress-info' has been generalized,
and renamed to `without-compress-install'.  It now prevents compression
of _any_ files during installation.

41
** The configure option --with-crt-dir has been removed.
42 43 44
It is no longer needed, as the crt*.o files are no longer linked
specially.

45 46 47
** Directories passed to configure option `--enable-locallisppath' are
no longer created during installation.

48 49
** Emacs can be compiled with zlib support.  If this library is present
(which it normally is on most systems), the function
50 51
`zlib-decompress-region' becomes available, which can decompress gzip-
and zlib-format compressed data.
52

53 54 55 56
---
** Emacs for NS (OSX, GNUStep) can be built with ImageMagick support.
pkg-config is required to find ImageMagick libraries.

57 58 59 60 61
** For OSX >= 10.5, the Core text based font backend from the Mac port is used.
For GNUStep and OSX 10.4 the old backend is used.
To use the old backend by default, do on the command line:
% defaults write org.gnu.Emacs FontBackend ns

Glenn Morris's avatar
Glenn Morris committed
62

63
* Startup Changes in Emacs 24.4
Glenn Morris's avatar
Glenn Morris committed
64 65


66
* Changes in Emacs 24.4
67

Eli Zaretskii's avatar
Eli Zaretskii committed
68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83
+++
** Emacs now supports menus on text-mode terminals.
If the terminal supports a mouse, clicking on the menu bar, or on
sensitive portions of the mode line or header line, will drop down the
menu defined at that position.  Likewise, clicking C-mouse-2 or
C-mouse-2 or C-mouse-3 on the text area will pop up the menus defined
for those locations.

If the text terminal does not support a mouse, you can activate the
first menu-bar menu by typing F10, which invokes `menu-bar-open'.

If you want the previous behavior, whereby F10 invoked `tmm-menubar',
customize the option `tty-menu-open-use-tmm' to a non-nil value.
(Typing M-` will always invoke `tmm-menubar', even if
`tty-menu-open-use-tmm' is nil.)

84 85
** Key ? also describes prefix bindings like C-h.

86 87 88 89
+++
** `cache-long-line-scans' has been renamed to `cache-long-scans'
because it affects caching of paragraph scanning results as well.

90 91 92 93 94 95 96
+++
** `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.

97 98 99 100
+++
** `eval-defun' on an already defined defcustom calls the :set function,
if there is one.

101 102 103 104
** 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.

105 106 107 108
** 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.

109 110 111
** `initial-buffer-choice' can now specify a function to set up the
initial buffer.

112 113 114 115
** The *Messages* buffer is created in a new major mode `messages-buffer-mode',
and read-only.  Code that might create the *Messages* buffer should
call the function `messages-buffer' to do so and set the mode.

116 117 118 119 120 121 122 123
** `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.

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

126 127 128 129 130
** 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
131 132 133
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.
134

135
** New option `scroll-bar-adjust-thumb-portion'.
136 137 138
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).
139

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

143 144
** In compiled Lisp files, the header no longer includes a timestamp.

145 146 147 148 149 150
** 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.

151 152 153 154 155 156 157 158
*** 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'.

159 160 161 162
** 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.

163 164 165 166 167
** The blink cursor stops blinking after 10 blinks (default) on X and NS.
You can change the default by customizing the variable blink-cursor-blinks.
Also timers for blinking are stopped when no blinking is done, so Emacs does
not consume CPU cycles.

168 169 170 171 172
** New command `frameset-to-register' is now bound to `C-x r f', replacing
`frame-configuration-to-register'.  It offers similar functionality, plus
some enhancements, like the ability to restore deleted frames.  Command
`frame-configuration-to-register' is still available, but unbound.

173 174 175
** The command `quail-help' is deleted.  Use `C-h C-\'
(`describe-input-method') instead.

176 177 178
** The default value of `comment-use-global-state' is changed to t,
and this variable has been marked obsolete.

Glenn Morris's avatar
Glenn Morris committed
179

180
* Editing Changes in Emacs 24.4
181

182 183 184
** New command `rectangle-mark' makes a rectangular region.
Most commands are still unaware of it, but kill/yank do work on the rectangle.

185 186 187
** C-x TAB enters a transient interactive mode.
You can then use the left/right cursor keys to move the block of text.

Xue Fuqiao's avatar
Xue Fuqiao committed
188 189 190
** `tab-stop-list' is now implicitly extended to infinity by repeating
the last step.  Its default value is changed to nil which means a tab
stop every `tab-width' columns.
191

192 193 194 195 196
** `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.

197 198
** New commands `toggle-frame-fullscreen' and `toggle-frame-maximized',
bound to <f11> and M-<f10>, respectively.
199

200 201 202
** In keymaps where SPC scrolls, S-SPC now scrolls in the reverse direction.
Eg View mode, etc.

203 204 205 206 207 208 209
+++
** 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.

210 211
** All register commands can now show help with preview.

212 213
** New command `kmacro-to-register' to store keyboard macros in registers.

214 215 216 217 218
** 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'.

219

220
* Changes in Specialized Modes and Packages in Emacs 24.4
221

222
** prolog-use-smie has been removed, along with the non-SMIE indentation code.
223

224 225 226 227 228 229
** SMIE indentation can be customized via `smie-config'.
The customizaton can be guessed by Emacs by providing a sample indented
file and letting SMIE learn from it.

** sh-script now uses its SMIE indentation algorithm by default.

230 231 232 233
** The debugger's `e' command evaluates the code in the context at point.
This includes using the lexical environment at point, which means that
`e' now lets you access lexical variables as well.

234 235 236 237 238 239 240 241 242 243 244 245
** `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
246 247 248
** If your Emacs is compiled with libxml2 support, you can use the new
built-in web browser `eww'.

249 250 251 252 253 254
** `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.
255

Johan Bockgård's avatar
Johan Bockgård committed
256
** More packages look for ~/.emacs.d/<foo> additionally to ~/.<foo>.
Stefan Monnier's avatar
Stefan Monnier committed
257 258 259 260 261 262 263 264 265 266 267 268 269 270 271
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
272 273 274 275 276
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

277

278 279
** Delphi mode is now called OPascal mode.
*** All delphi-* variables and functions have been renamed to opascal-*.
Juanma Barranquero's avatar
Juanma Barranquero committed
280 281
*** `delphi-newline-always-indents' is not supported any more.
Use `electric-indent-mode' instead.
282 283
*** `delphi-tab' is gone, replaced by `indent-for-tab-command'.

284 285
** Eldoc Mode works properly in the minibuffer.

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

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

291 292 293 294
** Battery

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

295 296 297 298
** Buffer Menu

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

299 300
** Calendar and Diary

301 302 303 304 305 306 307
*** New faces: `calendar-weekday-header', `calendar-weekend-header',
`calendar-month-header'.

*** New option `calendar-day-header-array'.

*** The variable `calendar-font-lock-keywords' is obsolete.

308
+++
Glenn Morris's avatar
Glenn Morris committed
309
*** New variable `diary-from-outlook-function', used by the command
310 311
`diary-from-outlook'.

Xue Fuqiao's avatar
Xue Fuqiao committed
312
** VC and related modes
Xue Fuqiao's avatar
Xue Fuqiao committed
313

Xue Fuqiao's avatar
Xue Fuqiao committed
314 315 316 317 318 319
*** In VC directory mode, `D' displays diffs between VC-controlled
whole tree revisions.

*** In VC directory mode, `L' lists the change log for the current VC
controlled tree in a window.

320 321 322
*** In VC directory mode, `I' shows a log of changes that will be
received with a pull operation.

Xue Fuqiao's avatar
Xue Fuqiao committed
323 324 325
*** `C-x v G' (globally) and `G' (in VC directory mode) ignores a file
under current version control system.  When called with a prefix
argument, you can remove a file from the ignored file list.
Xue Fuqiao's avatar
Xue Fuqiao committed
326

327 328 329
*** `cvs-append-to-ignore' has been renamed to `vc-cvs-append-to-ignore'
because it is moved to vc-cvs.el.

330 331 332 333 334 335 336
** cl-lib

*** New macro cl-tagbody.

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

337 338 339 340 341 342 343 344 345 346 347 348 349 350
** 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.

351 352
*** Support for ISO 8601 dates.

353 354 355 356 357
** Desktop

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

358
*** `desktop-restore-frames', enabled by default, allows saving and
359
restoring the frame/window configuration (frameset).  Additional options
360
`desktop-restore-in-current-display', `desktop-restore-reuses-frames'
361
and `desktop-restore-forces-onscreen' offer further customization.
362

363 364 365 366
** Dired

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

367 368 369 370 371 372
** 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.

373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388
** EPA

*** New option `epa-mail-aliases'.

You can set this to a list of alias expansions for keys to use
in `epa-mail-encrypt'.

If one element of the variable's value is ("foo@bar.com" "foo@hello.org"),
that means: when one of the recipients of the message being encrypted
is `foo@bar.com', encrypt the message for `foo@hello.org' instead.

If one element of the variable's value is ("foo@bar.com"),
that means: when one of the recipients of the message being encrypted
is `foo@bar.com', ignore that name as regards encryption.
This is useful to avoid a query when you have no key for that name.

389 390 391
---
** New F90 mode option `f90-smart-end-names'.

Juanma Barranquero's avatar
Juanma Barranquero committed
392
** Icomplete is a bit more like Ido.
393 394 395
*** key bindings to navigate through and select the completions.
*** The icomplete-separator is customizable, and its default has changed.
*** Removed icomplete-show-key-bindings.
Xue Fuqiao's avatar
Xue Fuqiao committed
396 397 398 399
*** Icomplete-mode by defaults applies to all forms of minibuffer completion.
(setq icomplete-with-completion-tables '(internal-complete-buffer))
will revert to the old behavior.

400

Xue Fuqiao's avatar
Xue Fuqiao committed
401 402
** Ido
*** Ido has a manual now.
Xue Fuqiao's avatar
Xue Fuqiao committed
403 404
*** `ido-use-virtual-buffers' takes a new value 'auto.
*** `ido-decorations' has been slightly extended to give a bit more control.
Xue Fuqiao's avatar
Xue Fuqiao committed
405

406
** Image mode
407 408 409 410 411

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

412 413 414 415
*** 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.

416 417
*** New commands to speed up, slow down, or reverse animation.

418 419 420 421 422 423
---
*** 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.

424 425 426 427 428 429
** 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'.

430 431 432 433 434 435 436 437 438 439
** 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.

440
** Search and Replace
441

442 443 444 445
*** 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.

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

449 450 451
*** `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).
452

453 454 455
*** `query-replace' skips invisible text when `search-invisible' is nil,
and opens overlays with hidden text when `search-invisible' is `open'.

456 457 458 459
+++
*** By default, prefix arguments do not now terminate Isearch mode.
Set `isearch-allow-prefix' to nil to restore old behavior.

460 461 462 463
*** More Isearch commands accept prefix arguments, namely
`isearch-printing-char', `isearch-quote-char', `isearch-yank-word',
`isearch-yank-line'.

464 465 466 467 468 469 470 471
*** 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
472
** MH-E has been updated to MH-E version 8.5.
Bill Wohler's avatar
Bill Wohler committed
473 474
See MH-E-NEWS for details.

475 476 477 478 479 480 481 482
---
** 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.

483 484 485
+++
** New function `ses-rename-cell' to give SES cells arbitrary names.

486 487 488 489 490 491 492 493 494
** 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.

495 496
** 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)
497 498
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
499 500
When its arg KEEP-BLANKS is non-nil (when called interactively with
C-u C-u C-u), duplicate blank lines are preserved.
501

502 503 504 505 506
** 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.

507 508 509 510 511
** 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
512
- cross-category lists of items filtered by specific criteria;
513 514 515 516 517 518 519
- 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.
520
The Todo mode user manual describes all commands and most user options.
521 522 523 524 525 526
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.

527
** Tramp
528

529 530
*** The experimental url syntax for remote file names is withdrawn.

531 532
+++
*** New connection method "adb", which allows to access Android
533 534
devices by the Android Debug Bridge.  The variable `tramp-adb-program'
can be used to adapt the path of the "adb" program, if needed.
535

536 537 538 539
*** 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.
540

541 542 543
+++
*** Handlers for `file-acl' and `set-file-acl' for remote machines
which support POSIX ACLs.
544

545 546 547 548
+++
*** 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
549 550 551 552 553 554
** VHDL mode

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

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

555 556 557
** Woman

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

560 561
** Eshell

562
*** Added Eshell-Tramp module
563
External su and sudo commands are now the default; the internal,
564
Tramp-using variants can still be used by enabling the eshell-tramp
565 566
module.

567 568 569
** Package

*** The format of `archive-contents' files, generated by package
Dmitry Gutov's avatar
Dmitry Gutov committed
570 571
repositories, has changed to allow a new (fifth) element in the data
vectors, containing an associative list with extra properties.
572 573 574 575

*** `describe-package' buffer uses the `:url' extra property to
display a `Homepage' header, if it's present.

576 577
** New term.el option `term-suppress-hard-newline'.

Chong Yidong's avatar
Chong Yidong committed
578 579 580 581
** Obsolete packages:

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

Glenn Morris's avatar
Glenn Morris committed
582 583 584
+++
*** sup-mouse.el.

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

587 588
*** The previous version of todo-mode.el is obsolete and renamed otodo-mode.el.

Michael Albinus's avatar
Michael Albinus committed
589 590
*** xesam.el.

Glenn Morris's avatar
Glenn Morris committed
591 592 593
+++
*** yow.el is obsolete; use fortune.el or cookie1.el instead.

Glenn Morris's avatar
Glenn Morris committed
594 595 596 597
---
*** The Info-edit command is obsolete.  Editing Info nodes by hand
has not been relevant for some time.

598 599 600 601 602 603 604
** Shell

*** `explicit-bash-args' now always defaults to use --noediting.
During initialization, Emacs no longer expends a process to decide
whether it is safe to use Bash's --noediting option.  These days
--noediting is ubiquitous; it was introduced in 1996 in Bash version 2.

605 606 607
+++
** There is a new macro `skip-unless' for skipping ERT tests.  See the manual.

608

609
* New Modes and Packages in Emacs 24.4
Juanma Barranquero's avatar
Juanma Barranquero committed
610

Ted Zlatanov's avatar
Ted Zlatanov committed
611 612 613 614 615
** 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.

616 617 618 619 620 621 622
** 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.

623 624 625 626 627 628
** New frameset.el package.
It provides a set of operations to save a frameset (the state of all
or a subset of the existing frames and windows, somewhat similar to a
frame configuration), both in-session and persistently, and restore it
at some point in the future.

Michael Albinus's avatar
Michael Albinus committed
629 630
+++
** The package filenotify.el provides an interface for file system
631 632 633
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
634

635
* Incompatible Lisp Changes in Emacs 24.4
636

637 638
** `kill-region' lost its `yank-handler' optional argument.

639 640 641
** `(input-pending-p)' no longer runs other timers which are ready to
run.  The new optional CHECK-TIMERS param allows for the prior behavior.

642 643
** `defvar' and `defcustom' in a let-binding affect the "external" default.

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

647 648 649 650
** 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
651
You should either convert them to utf-8 or add an explicit `coding:' cookie.
652

653 654 655 656
** 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
657
** Default process filters and sentinels are not nil any more.
658 659
Instead they default to a function which does what the nil value used to do.

660 661 662 663 664
** `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/...

665 666
** Removed inhibit-local-menu-bar-menus.

667 668 669 670
** 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.

671 672 673 674
** 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.

675 676
** `defadvice' does not honor the `freeze' flag and cannot advise
special-forms any more.
677

678 679 680 681
** `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.

682 683 684 685 686 687
** 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
688 689 690
** `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.
691 692

** The cars of the elements in `interpreter-mode-alist' are now treated
693 694 695
as regexps rather than literal strings.  Technically this is an
incompatible change, but unless you are using interpreter-mode-alist
for something (not just adding elements to it), it ought not to affect you.
696

Glenn Morris's avatar
Glenn Morris committed
697

698
* Lisp Changes in Emacs 24.4
699

700 701
** New hook `pre-redisplay-function'.

702
+++
Eli Zaretskii's avatar
Eli Zaretskii committed
703 704
** Functions that pop up menus and dialogs now work on all terminal types,
including TTYs.
Eli Zaretskii's avatar
Eli Zaretskii committed
705 706 707
This includes `x-popup-menu', `x-popup-dialog', `message-box',
`yes-or-no-p', etc.

708 709 710 711
The function `display-popup-menus-p' will now return non-nil for a
display or frame whenever a mouse is supported on that display or
frame.

712 713 714 715 716 717
** New bool-vector set operation functions:
*** `bool-vector-exclusive-or'
*** `bool-vector-union'
*** `bool-vector-intersection'
*** `bool-vector-set-difference'
*** `bool-vector-not'
Xue Fuqiao's avatar
Xue Fuqiao committed
718
*** `bool-vector-subsetp'
719 720 721
*** `bool-vector-count-matches'
*** `bool-vector-count-matches-at'

722 723
** Comparison functions =, <, >, <=, >= now take many arguments.

724 725 726
** The second argument of `eval' can now be a lexical-environment.

** `with-demoted-errors' takes an additional argument `format'.
727 728 729
+++
** New function `define-error'.

730 731
** New hook `tty-setup-hook'.

732 733 734
+++
** New macro with-eval-after-load.  Like eval-after-load, but better behaved.

735
** Obsoleted functions:
736
*** `log10'
737 738 739 740
*** `dont-compile'
*** `lisp-complete-symbol'
*** `field-complete'
*** `minibuffer-completion-contents'
741 742
*** `isearch-nonincremental-exit-minibuffer'
*** `isearch-filter-visible'
743
*** `generic-make-keywords-list'
744

745 746 747 748 749 750
** `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'.

751 752 753
** `split-string' now takes an optional argument TRIM.
The value, if non-nil, is a regexp that specifies what to trim from
the start and end of each substring.
754

755 756
** `get-upcase-table' is obsoleted by the new `case-table-get-table'.

757 758 759
** Support for filesystem notifications.
Emacs now supports notifications of filesystem changes, such as
creation, modification, and deletion of files.  This requires the
760 761 762
`glib' API, or the 'inotify' API (on GNU/Linux systems only).  On
MS-Windows systems, this is supported for Windows XP and newer
versions.
763

764 765 766 767 768 769 770 771 772 773 774 775 776 777
** 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.

778 779
** Face changes

Juanma Barranquero's avatar
Juanma Barranquero committed
780
*** The function `face-spec-set' is now analogous to `setq' for face specs.
781 782 783 784 785 786 787
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).

788 789 790
*** New face characteristic (supports :underline (:style wave))
specifies whether or not the terminal can display a wavy line.

Jan Djärv's avatar
Jan Djärv committed
791
*** New face spec attribute :distant-foreground
Xue Fuqiao's avatar
Xue Fuqiao committed
792 793
specifies foreground to use if background color is near the foreground
color that would otherwise have been used.
Jan Djärv's avatar
Jan Djärv committed
794

795 796 797 798 799 800 801 802 803 804 805 806 807 808 809
** 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.

810 811
*** You can change the speed of animated images.

812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840
** Changes in encoding and decoding of text

---
*** New coding-system `prefer-utf-8'.
This is like `undecided' but prefers UTF-8 on decoding if the text to
be decoded does not contain any invalid UTF-8 sequences.  On encoding,
any non-ASCII characters are automatically encoded as UTF-8.

---
*** New attributes of coding-systems whose type is `undecided'.
Two new attributes, `:inhibit-null-byte-detection' and
`:inhibit-iso-escape-detection', determine how to detect encoding of
text that includes null bytes and ISO-2022 escape sequences,
respectively.  Each of these attributes can be either nil, zero, or
t.  If it is t, decoding text ignores null bytes and, respectively,
ISO-2022 sequences.  If it is nil, null bytes cause text to be decoded
with no-conversion and ISO-2022 sequences cause Emacs to assume the
text is encoded in one of the ISO-2022 encodings, such as
iso-2022-7bit.  If the value is zero, Emacs consults the variables
inhibit-null-byte-detection and inhibit-iso-escape-detection, which
see.
The new attribute `:prefer-utf-8', if non-nil, causes Emacs to prefer
UTF-8 encoding and decoding, whenever possible.

These attributes are only meaningful for coding-systems of type
`undecided'.  (The type of a coding-system is determined by its
`:coding-type' attribute and can be accessed by calling the
`coding-system-type' function.)

Paul Eggert's avatar
Paul Eggert committed
841 842 843
** 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'.

844
** time-to-seconds is not obsolete any more.
845
** New functions special-form-p and macrop.
846 847 848
** Docstrings can be made dynamic by adding a `dynamic-docstring-function'
text-property on the first char.

849 850 851
** The `defalias-fset-function' property lets you catch calls to defalias
and redirect them to your own function instead of `fset'.

852
** The lock for 'DIR/FILE' is now 'DIR/.#FILE' and may be a regular file.
853 854 855 856 857 858 859
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.

860 861
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.
862

863 864 865 866 867 868 869 870 871 872 873
** 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'.

874 875 876 877
** The 6th argument to `copy-file' has been renamed to
`preserve-extended-attributes' as it now handles both SELinux context
and ACL entries.

878 879 880 881 882
** The `common-substring' argument of display-completion-list is obsolete.
Either use `completion-all-completions' which already returns highlighted
strings (including for partial or substring completion) or call
`completion-hilit-commonality' to add the highlight.

883 884 885
** 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
886
and functions should be separated by two hyphens if the symbol is not
887 888
meant to be used by other packages.

Glenn Morris's avatar
Glenn Morris committed
889

890
* Changes in Emacs 24.4 on Non-Free Operating Systems
891

892 893 894 895
** The procedure for building Emacs on MS-Windows has changed.
It is now built by running the same configure script as on all other
platforms.  This requires the MSYS environment and MinGW development
tools.  See the updated instructions in nt/INSTALL for details.
896 897 898 899 900 901 902 903 904 905 906 907 908

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

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

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

920 921 922 923 924 925 926
---
** 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
927 928 929 930 931
** 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
932

933
* Installation Changes in Emacs 24.3
934

935
** The default X toolkit is now Gtk+ version 3.
Glenn Morris's avatar
Glenn Morris committed
936 937 938
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
939
You can explicitly require a specific version by passing
Glenn Morris's avatar
Glenn Morris committed
940
`--with-x-toolkit=gtk2' or `--with-x-toolkit=gtk3' to configure.
941

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

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

Glenn Morris's avatar
Glenn Morris committed
948 949
** 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
950 951 952
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.
953

Glenn Morris's avatar
Glenn Morris committed
954
** The configure option `--enable-use-lisp-union-type' has been
955
renamed to `--enable-check-lisp-object-type', as the resulting
Glenn Morris's avatar
Glenn Morris committed
956 957 958
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
959
** The configure option `--disable-maintainer-mode' has been removed,
960 961
as it was confusingly-named and rarely useful.

Glenn Morris's avatar
Glenn Morris committed
962 963 964 965 966
** 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.
967

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

972 973
** Emacs uses libtinfo in preference to libncurses, if available.

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

978
** The standalone scripts `rcs-checkin' and `vcdiff' have been removed
Glenn Morris's avatar
Glenn Morris committed
979 980 981
(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
982

983
* Startup Changes in Emacs 24.3
984 985 986

** 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
987
been adding them there, put them somewhere else; e.g., site-lisp.
988

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

Glenn Morris's avatar
Glenn Morris committed
991

992
* Changes in Emacs 24.3
Glenn Morris's avatar
Glenn Morris committed
993

994
** Help
995

996
*** `C-h f' (`describe-function') can now perform autoloading.
997 998 999 1000 1001 1002 1003 1004 1005
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).

1006
** ImageMagick
1007

1008 1009
*** Images displayed via ImageMagick now support transparency and the
:background image specification property.
1010

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

1016
*** Setting `imagemagick-types-inhibit' to t now disables the use of
Glenn Morris's avatar
Glenn Morris committed
1017 1018
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
1019

1020
*** The new variable `imagemagick-enabled-types' also affects which
1021 1022 1023
ImageMagick types are treated as images.  The function
`imagemagick-filter-types' returns the list of types that will be
treated as images.
1024

1025 1026 1027
*** ImageMagick images now support the :max-width and :max-height
keywords.

1028
*** Some data types aren't auto-detected by ImageMagick.  Adding
1029 1030
:format to `create-image' may help if the content type is in the
new variable `image-format-suffixes'.
1031

1032 1033 1034 1035
** Minibuffer

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

1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050
*** `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
1051

Chong Yidong's avatar
Chong Yidong committed
1052 1053 1054
*** 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
1055

Chong Yidong's avatar
Chong Yidong committed
1056 1057 1058 1059 1060
*** 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
1061
that support backtraces.
1062

1063 1064 1065 1066 1067 1068 1069 1070 1071 1072
** `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
1073 1074
** If your Emacs was built from a bzr checkout, the new variable
`emacs-bzr-version' contains information about the bzr revision used.
1075

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

1080 1081
** New option `enable-remote-dir-locals', if non-nil, allows directory-local
variables on remote hosts.
1082

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

1086 1087 1088
** Using "unibyte: t" in Lisp source files is obsolete.
Use "coding: raw-text" instead.

1089 1090 1091 1092 1093
** 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.

1094
** Internationalization
Glenn Morris's avatar
Glenn Morris committed
1095

Chong Yidong's avatar
Chong Yidong committed
1096
*** New language environment: Persian.
Glenn Morris's avatar
Glenn Morris committed
1097

Chong Yidong's avatar
Chong Yidong committed
1098