NEWS 113 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 18 19 20 21 22
Temporary note:
+++ indicates that the appropriate manual has already been updated.
--- means no change in the manuals is called for.
When you add a new item, please add it without either +++ or ---
so we will look at it and add it to the manual.

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
** The configure option --with-crt-dir has been removed.
32 33 34 35 36 37 38 39 40
It is no longer needed, as the crt*.o files are no longer linked
specially.

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

Glenn Morris's avatar
Glenn Morris committed
42

43
* Startup Changes in Emacs 24.4
Glenn Morris's avatar
Glenn Morris committed
44 45


46
* Changes in Emacs 24.4
47

48 49
** Key ? also describes prefix bindings like C-h.

50 51 52 53 54 55 56
+++
** `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.

57 58 59 60
+++
** `eval-defun' on an already defined defcustom calls the :set function,
if there is one.

61 62 63 64
** 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.

65 66 67 68
** 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.

69 70 71
** `initial-buffer-choice' can now specify a function to set up the
initial buffer.

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

74 75 76 77 78
** 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
79 80 81
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.
82

83
** New option `scroll-bar-adjust-thumb-portion'.
84 85 86
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).
87

88 89
** In compiled Lisp files, the header no longer includes a timestamp.

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

Glenn Morris's avatar
Glenn Morris committed
96

97
* Editing Changes in Emacs 24.4
98

99 100 101 102 103
** `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.

104 105
** New commands `toggle-frame-fullscreen' and `toggle-frame-maximized',
bound to <f11> and M-<f10>, respectively.
106

107 108 109
** In keymaps where SPC scrolls, S-SPC now scrolls in the reverse direction.
Eg View mode, etc.

110 111
** New command `kmacro-to-register' to store keyboard macros in registers.

112 113 114 115 116
** 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'.

117

118
* Changes in Specialized Modes and Packages in Emacs 24.4
119

120 121 122 123 124 125
** `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.
126 127
** `ido-decorations' has been slightly extended to give a bit more control.

Stefan Monnier's avatar
Stefan Monnier committed
128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146
** More packages look for ~/.emacs.d/<foo> additionally to ~/.<foo>.
Affected files:
~/.emacs.d/timelog	replaces  ~/.timelog
~/.emacs.d/todo-do	replaces  ~/.todo-do
~/.emacs.d/todo-done	replaces  ~/.todo-done
~/.emacs.d/todo-top	replaces  ~/.todo-top
~/.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
147

148 149 150 151 152 153
** Delphi mode is now called OPascal mode.
*** All delphi-* variables and functions have been renamed to opascal-*.
*** `delphi-newline-always-indents' is not supported any more
use `electric-indent-mode' instead.
*** `delphi-tab' is gone, replaced by `indent-for-tab-command'.

154 155
** Eldoc Mode works properly in the minibuffer.

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

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

161 162 163 164
** Battery

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

165 166 167
** Calendar and Diary

+++
Glenn Morris's avatar
Glenn Morris committed
168
*** New variable `diary-from-outlook-function', used by the command
169 170
`diary-from-outlook'.

171 172 173 174 175 176 177
** cl-lib

*** New macro cl-tagbody.

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

178 179 180 181 182 183 184 185 186 187 188 189 190 191
** 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.

192 193
*** Support for ISO 8601 dates.

194 195 196 197 198
** Desktop

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

199 200 201 202
** Dired

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

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

209 210 211
---
** New F90 mode option `f90-smart-end-names'.

212 213 214 215 216
** Icomplete is a bit more like IDO.
*** key bindings to navigate through and select the completions.
*** The icomplete-separator is customizable, and its default has changed.
*** Removed icomplete-show-key-bindings.

217
** Image mode
218 219 220 221 222

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

223 224 225 226
*** 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.

227 228 229 230 231 232
---
*** 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.

233 234 235 236 237 238
** 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'.

239
** Search and Replace
240 241 242 243

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

244 245 246
*** `query-replace' skips invisible text when `search-invisible' is nil,
and opens overlays with hidden text when `search-invisible' is `open'.

Bill Wohler's avatar
Bill Wohler committed
247
** MH-E has been updated to MH-E version 8.5.
Bill Wohler's avatar
Bill Wohler committed
248 249
See MH-E-NEWS for details.

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

258 259 260
+++
** New function `ses-rename-cell' to give SES cells arbitrary names.

261 262 263 264 265 266 267 268 269
** 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.

270 271
** 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)
272 273
it works like the utility `uniq'.  Otherwise by default it deletes
duplicate lines everywhere in the region without regard to adjacency.
274 275
When it arg KEEP-BLANKS is non-nil (when called interactively with C-u C-u C-u),
duplicate blank lines are preserved.
276

277 278 279 280 281
** 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.

282
** Tramp
283

284 285
+++
*** New connection method "adb", which allows to access Android
286 287
devices by the Android Debug Bridge.  The variable `tramp-adb-program'
can be used to adapt the path of the "adb" program, if needed.
288

289 290 291 292
*** 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.
293

294 295 296
+++
*** Handlers for `file-acl' and `set-file-acl' for remote machines
which support POSIX ACLs.
297

Glenn Morris's avatar
Glenn Morris committed
298 299 300 301 302 303
** VHDL mode

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

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

304 305 306 307 308
** Woman

*** The commands `woman-default-faces' and `woman-monochrome-faces'
are obsolete.  Customize the `woman-* faces instead.

309 310 311 312 313 314 315
** Eshell

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

Chong Yidong's avatar
Chong Yidong committed
316 317 318 319
** Obsolete packages:

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

Glenn Morris's avatar
Glenn Morris committed
320 321 322
+++
*** sup-mouse.el.

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

Michael Albinus's avatar
Michael Albinus committed
325 326
*** xesam.el.

Glenn Morris's avatar
Glenn Morris committed
327 328 329
+++
*** yow.el is obsolete; use fortune.el or cookie1.el instead.

Glenn Morris's avatar
Glenn Morris committed
330 331 332 333
---
*** The Info-edit command is obsolete.  Editing Info nodes by hand
has not been relevant for some time.

334

335
* New Modes and Packages in Emacs 24.4
Ted Zlatanov's avatar
Ted Zlatanov committed
336 337 338 339 340
** 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.

341 342 343 344 345 346 347
** 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.

Glenn Morris's avatar
Glenn Morris committed
348

349
* Incompatible Lisp Changes in Emacs 24.4
350

351 352 353
** Default process filers and sentinels are not nil any more.
Instead they default to a function which does what the nil value used to do.

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

359 360
** Removed inhibit-local-menu-bar-menus.

361 362 363 364
** 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.

365 366 367 368
** 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.

369 370
** `defadvice' does not honor the `freeze' flag and cannot advise
special-forms any more.
371

372 373 374 375
** `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.

376 377 378 379 380 381
** 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'.

Glenn Morris's avatar
Glenn Morris committed
382

383
* Lisp Changes in Emacs 24.4
384

385 386 387 388 389
** Obsoleted functions:
*** `dont-compile'
*** `lisp-complete-symbol'
*** `field-complete'
*** `minibuffer-completion-contents'
390 391
*** `isearch-nonincremental-exit-minibuffer'
*** `isearch-filter-visible'
392

393 394 395 396 397 398 399
** `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'.


400 401
** `get-upcase-table' is obsoleted by the new `case-table-get-table'.

402 403 404
** Support for filesystem notifications.
Emacs now supports notifications of filesystem changes, such as
creation, modification, and deletion of files.  This requires the
405 406
'inotify' API on GNU/Linux systems.  On MS-Windows systems, this is
supported for Windows XP and newer versions.
407

408 409 410 411 412 413 414 415 416 417 418 419 420 421
** 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.

422 423 424 425 426 427 428 429 430 431
** Face changes

*** The `face-spec-set' is now analogous to `setq' for face specs.
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).

432 433 434
*** New face characteristic (supports :underline (:style wave))
specifies whether or not the terminal can display a wavy line.

435 436 437 438 439 440 441 442 443 444 445 446 447 448 449
** 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.

450
** time-to-seconds is not obsolete any more.
451
** New function special-form-p.
452 453 454
** Docstrings can be made dynamic by adding a `dynamic-docstring-function'
text-property on the first char.

455 456 457
** The `defalias-fset-function' property lets you catch calls to defalias
and redirect them to your own function instead of `fset'.

458
** The lock for 'DIR/FILE' is now 'DIR/.#FILE' and may be a regular file.
459 460 461 462 463 464 465
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.

466 467
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.
468

469 470 471 472 473 474 475 476 477 478 479
** 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'.

480 481 482 483
** The 6th argument to `copy-file' has been renamed to
`preserve-extended-attributes' as it now handles both SELinux context
and ACL entries.

484 485 486
** 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
487
and functions should be separated by two hyphens if the symbol is not
488 489
meant to be used by other packages.

Glenn Morris's avatar
Glenn Morris committed
490

491
* Changes in Emacs 24.4 on Non-Free Operating Systems
492

493 494 495 496 497
+++
** 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.

498 499 500 501 502 503
+++
** 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.

504 505 506 507 508 509 510
---
** 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
511 512 513 514 515
** 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
516

517
* Installation Changes in Emacs 24.3
518

519
** The default X toolkit is now Gtk+ version 3.
Glenn Morris's avatar
Glenn Morris committed
520 521 522
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
523
You can explicitly require a specific version by passing
Glenn Morris's avatar
Glenn Morris committed
524
`--with-x-toolkit=gtk2' or `--with-x-toolkit=gtk3' to configure.
525

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

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

Glenn Morris's avatar
Glenn Morris committed
532 533
** 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
534 535 536
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.
537

Glenn Morris's avatar
Glenn Morris committed
538
** The configure option `--enable-use-lisp-union-type' has been
539
renamed to `--enable-check-lisp-object-type', as the resulting
Glenn Morris's avatar
Glenn Morris committed
540 541 542
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
543
** The configure option `--disable-maintainer-mode' has been removed,
544 545
as it was confusingly-named and rarely useful.

Glenn Morris's avatar
Glenn Morris committed
546 547 548 549 550
** 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.
551

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

556 557
** Emacs uses libtinfo in preference to libncurses, if available.

558 559 560 561
** 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.

562
** The standalone scripts `rcs-checkin' and `vcdiff' have been removed
Glenn Morris's avatar
Glenn Morris committed
563 564 565
(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
566

567
* Startup Changes in Emacs 24.3
568 569 570

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

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

Glenn Morris's avatar
Glenn Morris committed
575

576
* Changes in Emacs 24.3
Glenn Morris's avatar
Glenn Morris committed
577

578
** Help
579

580
*** `C-h f' (`describe-function') can now perform autoloading.
581 582 583 584 585 586 587 588 589
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).

590
** ImageMagick
591

592 593
*** Images displayed via ImageMagick now support transparency and the
:background image specification property.
594

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

600
*** Setting `imagemagick-types-inhibit' to t now disables the use of
Glenn Morris's avatar
Glenn Morris committed
601 602
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
603

604
*** The new variable `imagemagick-enabled-types' also affects which
605 606 607
ImageMagick types are treated as images.  The function
`imagemagick-filter-types' returns the list of types that will be
treated as images.
608

609 610 611 612
** Minibuffer

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

614 615 616 617 618 619 620 621 622 623 624 625 626 627
*** `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
628

Chong Yidong's avatar
Chong Yidong committed
629 630 631
*** 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
632

Chong Yidong's avatar
Chong Yidong committed
633 634 635 636 637
*** 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
638
that support backtraces.
639

640 641 642 643 644 645 646 647 648 649
** `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
650 651
** If your Emacs was built from a bzr checkout, the new variable
`emacs-bzr-version' contains information about the bzr revision used.
652

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

657 658
** New option `enable-remote-dir-locals', if non-nil, allows directory-local
variables on remote hosts.
659

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

663 664 665
** Using "unibyte: t" in Lisp source files is obsolete.
Use "coding: raw-text" instead.

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

671
** Internationalization
Glenn Morris's avatar
Glenn Morris committed
672

Chong Yidong's avatar
Chong Yidong committed
673
*** New language environment: Persian.
Glenn Morris's avatar
Glenn Morris committed
674

Chong Yidong's avatar
Chong Yidong committed
675 676
*** New input method `vietnamese-vni'.

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

Glenn Morris's avatar
Glenn Morris committed
679
*** Support for fullscreen and the frame parameter fullscreen.
Glenn Morris's avatar
Glenn Morris committed
680

681 682 683
*** A file dialog is used for open/save operations initiated from the
menu/toolbar.

Glenn Morris's avatar
Glenn Morris committed
684

685
* Editing Changes in Emacs 24.3
686

687
** Search and Replace
688

Chong Yidong's avatar
Chong Yidong committed
689 690 691 692
*** 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
693
similar existing feature for regexp Isearch.)
Glenn Morris's avatar
Glenn Morris committed
694

Chong Yidong's avatar
Chong Yidong committed
695 696
*** 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
697

Chong Yidong's avatar
Chong Yidong committed
698 699 700
*** 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
701

702 703 704 705
*** 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.

706
** Navigation commands
707

708 709 710 711 712 713 714 715 716 717
*** 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').
718 719 720 721 722

** 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
723
** `C-u M-=' now counts lines/words/characters in the entire buffer.
724

725 726
** `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'.
727

728 729 730
** 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
731

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

735
** Registers
Chong Yidong's avatar
Chong Yidong committed
736

Glenn Morris's avatar
Glenn Morris committed
737
*** `C-x r +' is now overloaded to invoke `append-to-register'.
Chong Yidong's avatar
Chong Yidong committed
738 739

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

Glenn Morris's avatar
Glenn Morris committed
743

744
* Changes in Specialized Modes and Packages in Emacs 24.3
Julien Danjou's avatar
Julien Danjou committed
745

746
** Common Lisp emulation (CL)
Chong Yidong's avatar
Chong Yidong committed
747

748
*** CL's main entry is now (require 'cl-lib).
Glenn Morris's avatar
Glenn Morris committed
749 750 751
`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).
752

Glenn Morris's avatar
Glenn Morris committed
753 754 755 756 757
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*'.
758

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

762 763
*** `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
764 765
In particular, in cl-flet function definitions are lexically scoped,
whereas in flet the scoping is dynamic.
766 767

*** `cl-labels' is slightly different from `labels'.
Glenn Morris's avatar
Glenn Morris committed
768 769 770 771
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.
772

Glenn Morris's avatar
Glenn Morris committed
773
*** `cl-letf' is not exactly like `letf'.
774 775
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
776

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

Glenn Morris's avatar
Glenn Morris committed
781 782 783
*** 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
784 785
`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
786
`get-setf-method' no longer exists (see "Incompatible Lisp Changes")
Glenn Morris's avatar
Glenn Morris committed
787

788
** Diff mode
Chong Yidong's avatar
Chong Yidong committed
789

790 791 792 793 794
*** 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
795

796 797 798
*** 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
799

800 801
*** The new command `diff-delete-trailing-whitespace' removes trailing
whitespace introduced by a diff.
Chong Yidong's avatar
Chong Yidong committed
802

803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822
** 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':
823
Comments are always considered as indentation markers.
824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858

**** `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
859

Chong Yidong's avatar
Chong Yidong committed
860 861 862 863 864 865 866 867 868
** 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
869 870
*** 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
871

Glenn Morris's avatar
Glenn Morris committed
872
*** Signals can also be sent as unicast messages.
Chong Yidong's avatar
Chong Yidong committed
873 874

*** The argument list of `dbus-register-signal' has been extended,
875
according to the new match rule types of D-Bus.
Chong Yidong's avatar
Chong Yidong committed
876 877 878 879 880

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

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

881 882
** `desktop-path' no longer includes the "." directory.
Desktop files are now located in ~/.emacs.d by default.
Chong Yidong's avatar
Chong Yidong committed
883 884

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

Chong Yidong's avatar
Chong Yidong committed
886 887 888
*** `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
889

Glenn Morris's avatar
Glenn Morris committed
890 891
*** 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
892
file at point.
Glenn Morris's avatar
Glenn Morris committed
893

Chong Yidong's avatar
Chong Yidong committed
894
*** When the region is active, `m' (`dired-mark'), `u' (`dired-unmark'),
Glenn Morris's avatar
Glenn Morris committed
895
`DEL' (`dired-unmark-backward'), and `d' (`dired-flag-file-deletion')
Chong Yidong's avatar
Chong Yidong committed
896
mark/unmark/flag all files in the active region.
Glenn Morris's avatar
Glenn Morris committed
897

Chong Yidong's avatar
Chong Yidong committed
898 899 900
*** The minibuffer default for `=' (`dired-diff) has changed.
It is now the backup file for the file at point, if one exists.
In Transient Mark mode the default is the file at the active mark.
Glenn Morris's avatar
Glenn Morris committed
901

Chong Yidong's avatar
Chong Yidong committed
902 903 904
*** `M-=' is no longer bound to `dired-backup-diff' in Dired buffers.
The global binding for `M-=', `count-words-region' is in effect.

Glenn Morris's avatar
Glenn Morris committed
905 906
** ERC

907 908
*** New module "notifications", which can send a notification when you
receive a private message or your nickname is mentioned.
Glenn Morris's avatar
Glenn Morris committed
909 910 911

*** ERC will look up server/channel names via auth-source and use any
channel keys found.
Chong Yidong's avatar
Chong Yidong committed
912

Glenn Morris's avatar
Glenn Morris committed
913 914
*** New option `erc-lurker-hide-list', similar to `erc-hide-list', but
only applies to messages sent by lurkers.
915

916
** reStructuredText mode
Chong Yidong's avatar
Chong Yidong committed
917

918 919 920
*** Keybindings (see `C-c C-h'), TAB indentation, filling and auto-filling,
fontification, comment handling, and customization have all been revised
and improved.
Chong Yidong's avatar
Chong Yidong committed
921

922
*** Support for `imenu' and `which-function-mode'.
Chong Yidong's avatar
Chong Yidong committed
923

924 925
*** The reStructuredText syntax is more closely covered.
Sphinx support has been improved.
Chong Yidong's avatar
Chong Yidong committed
926

927
*** `rst-insert-list' inserts new list or continues existing lists.
Chong Yidong's avatar
Chong Yidong committed
928

929
*** A negative prefix argument always works for `rst-adjust'.
Chong Yidong's avatar
Chong Yidong committed
930

931
*** The window configuration is reset after displaying a TOC.
932

933
*** The constant `rst-version' describes the rst.el package version.
Glenn Morris's avatar
Glenn Morris committed
934

Glenn Morris's avatar
Glenn Morris committed
935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957
** Ruby mode

*** Support for percent literals and recognition of regular expressions
in method calls without parentheses with more methods, including Cucumber
steps definitions.

*** Improved syntax highlighting and indentation.

*** New command `ruby-toggle-block', bound to `C-c {'.

*** Some non-standard keybindings/commands have been removed:

**** `ruby-electric-brace'; use `electric-indent-mode' instead.

**** `ruby-mark-defun'; use `mark-defun'.

**** `ruby-beginning-of-defun' and `ruby-end-of-defun' are replaced by
appropriate settings for the variables `beginning-of-defun-function'
and `end-of-defun-function'.

**** Non-standard keybindings for `backward-kill-word', `comment-region',
`reindent-then-newline-and-indent' and `newline' have been removed.

958
** Shell Script mode
959

960
*** Pairing of parens/quotes uses `electric-pair-mode' instead of skeleton-pair.
961

962
*** `sh-electric-here-document-mode' now controls auto-insertion of here-docs.
963

964
*** `sh-use-smie' lets you choose a new indentation and navigation code.
965

966
** VHDL mode
967

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

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

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

974
*** Accepts \r and \f as whitespace.
975

976
** Apropos
977

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

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

985
** Buffer Menu
986

987
*** This package has been rewritten to use Tabulated List mode.
988

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

992 993 994 995 996 997
** Calc

*** Algebraic simplification mode is now the default.
To restrict to the limited simplifications given by the former
default simplification mode, use `m I'.

998
** Calendar
999

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

1003
*** New LaTeX calendar style, produced by `cal-tex-cursor-week2-summary'.
1004

1005 1006
*** The calendars produced by cal-html include holidays.
Customize `cal-html-holidays' to change this.
1007

Glenn Morris's avatar
Glenn Morris committed
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 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051