NEWS 103 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 27 28 29 30

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

Glenn Morris's avatar
Glenn Morris committed
31

32
* Startup Changes in Emacs 24.4
Glenn Morris's avatar
Glenn Morris committed
33 34


35
* Changes in Emacs 24.4
36

37 38 39 40 41 42 43
+++
** `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.

44 45 46 47
+++
** `eval-defun' on an already defined defcustom calls the :set function,
if there is one.

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

52 53 54 55
** 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.

56 57 58
** `initial-buffer-choice' can now specify a function to set up the
initial buffer.

59 60 61 62 63
** 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
64 65 66
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.
67

68
** New option `scroll-bar-adjust-thumb-portion'.
69 70 71
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).
72

Glenn Morris's avatar
Glenn Morris committed
73

74
* Editing Changes in Emacs 24.4
75

76 77
** New commands `toggle-frame-fullscreen' and `toggle-frame-maximized',
bound to <f11> and M-<f10>, respectively.
78

79 80 81
** In keymaps where SPC scrolls, S-SPC now scrolls in the reverse direction.
Eg View mode, etc.

82

83
* Changes in Specialized Modes and Packages in Emacs 24.4
84

85 86 87 88 89 90
** 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'.

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

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

96 97 98 99
** Battery

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

100 101 102 103 104 105 106
** cl-lib

*** New macro cl-tagbody.

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

107 108 109 110 111 112 113 114 115 116 117 118 119 120
** 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.

121 122
*** Support for ISO 8601 dates.

123 124 125 126
** Dired

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

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

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

138
** Image mode
139 140 141 142 143

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

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

150 151 152 153 154
** Isearch

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

Bill Wohler's avatar
Bill Wohler committed
155 156 157
** MH-E has been updated to MH-E version 8.4.
See MH-E-NEWS for details.

158 159 160 161 162 163 164 165
---
** 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.

166 167 168
+++
** New function `ses-rename-cell' to give SES cells arbitrary names.

169 170 171 172 173 174 175 176 177
** 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.

178 179 180 181 182
** New command `delete-duplicate-lines' has two types of operation:
when its arg ADJACENT is non-nil (when called interactively with C-u C-u)
it works like the utility `uniq'.  Otherwise by default it deletes
duplicate lines everywhere in the region without regard to adjacency.

183 184 185 186 187
** 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.

188 189 190 191 192
** Tramp
+++
*** New connection method "adb", which allows to access Android
devices by the Android Debug Bridge.  The variable `tramp-adb-sdk-dir'
must be set to the Android SDK installation directory.
193 194 195
+++
*** Handlers for `file-acl' and `set-file-acl' for remote machines
which support POSIX ACLs.
196

197 198 199 200 201
** Woman

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

Chong Yidong's avatar
Chong Yidong committed
202 203 204 205
** Obsolete packages:

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

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

Glenn Morris's avatar
Glenn Morris committed
208 209 210
+++
*** yow.el is obsolete; use fortune.el or cookie1.el instead.

211

212
* New Modes and Packages in Emacs 24.4
213 214 215 216 217 218 219
** 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
220

221
* Incompatible Lisp Changes in Emacs 24.4
222

223 224
** Removed inhibit-local-menu-bar-menus.

225 226 227 228
** 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.

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

233 234
** `defadvice' does not honor the `freeze' flag and cannot advise
special-forms any more.
235

236 237 238 239
** `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.

240 241 242 243 244 245
** 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
246

247
* Lisp Changes in Emacs 24.4
248

249 250 251
** Support for filesystem notifications.
Emacs now supports notifications of filesystem changes, such as
creation, modification, and deletion of files.  This requires the
252 253
'inotify' API on GNU/Linux systems.  On MS-Windows systems, this is
supported for Windows XP and newer versions.
254

255 256 257 258 259 260 261 262 263 264 265 266 267 268
** 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.

269 270 271 272 273 274 275 276 277 278
** 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).

279 280 281
*** New face characteristic (supports :underline (:style wave))
specifies whether or not the terminal can display a wavy line.

282
** time-to-seconds is not obsolete any more.
283
** New function special-form-p.
284 285 286
** Docstrings can be made dynamic by adding a `dynamic-docstring-function'
text-property on the first char.

287 288 289
** The `defalias-fset-function' property lets you catch calls to defalias
and redirect them to your own function instead of `fset'.

290 291 292 293 294 295 296 297 298 299 300
** 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'.

301 302 303 304
** The 6th argument to `copy-file' has been renamed to
`preserve-extended-attributes' as it now handles both SELinux context
and ACL entries.

Glenn Morris's avatar
Glenn Morris committed
305

306
* Changes in Emacs 24.4 on Non-Free Operating Systems
307

308 309 310 311 312
+++
** 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.

313 314 315 316 317 318
+++
** 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.

Glenn Morris's avatar
Glenn Morris committed
319 320 321 322 323
** 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
324

325
* Installation Changes in Emacs 24.3
326

327
** The default X toolkit is now Gtk+ version 3.
Glenn Morris's avatar
Glenn Morris committed
328 329 330
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
331
You can explicitly require a specific version by passing
Glenn Morris's avatar
Glenn Morris committed
332
`--with-x-toolkit=gtk2' or `--with-x-toolkit=gtk3' to configure.
333

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

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

Glenn Morris's avatar
Glenn Morris committed
340 341
** 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
342 343 344
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.
345

Glenn Morris's avatar
Glenn Morris committed
346
** The configure option `--enable-use-lisp-union-type' has been
347
renamed to `--enable-check-lisp-object-type', as the resulting
Glenn Morris's avatar
Glenn Morris committed
348 349 350
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
351
** The configure option `--disable-maintainer-mode' has been removed,
352 353
as it was confusingly-named and rarely useful.

Glenn Morris's avatar
Glenn Morris committed
354 355 356 357 358
** 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.
359

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

364 365
** Emacs uses libtinfo in preference to libncurses, if available.

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

370
** The standalone scripts `rcs-checkin' and `vcdiff' have been removed
Glenn Morris's avatar
Glenn Morris committed
371 372 373
(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
374

375
* Startup Changes in Emacs 24.3
376 377 378

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

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

Glenn Morris's avatar
Glenn Morris committed
383

384
* Changes in Emacs 24.3
Glenn Morris's avatar
Glenn Morris committed
385

386
** Help
387

388
*** `C-h f' (`describe-function') can now perform autoloading.
389 390 391 392 393 394 395 396 397
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).

398
** ImageMagick
399

400 401
*** Images displayed via ImageMagick now support transparency and the
:background image specification property.
402

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

408
*** Setting `imagemagick-types-inhibit' to t now disables the use of
Glenn Morris's avatar
Glenn Morris committed
409 410
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
411

412
*** The new variable `imagemagick-enabled-types' also affects which
413 414 415
ImageMagick types are treated as images.  The function
`imagemagick-filter-types' returns the list of types that will be
treated as images.
416

417 418 419 420
** Minibuffer

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

422 423 424 425 426 427 428 429 430 431 432 433 434 435
*** `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
436

Chong Yidong's avatar
Chong Yidong committed
437 438 439
*** 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
440

Chong Yidong's avatar
Chong Yidong committed
441 442 443 444 445
*** 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
446
that support backtraces.
447

448 449 450 451 452 453 454 455 456 457
** `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
458 459
** If your Emacs was built from a bzr checkout, the new variable
`emacs-bzr-version' contains information about the bzr revision used.
460

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

465 466
** New option `enable-remote-dir-locals', if non-nil, allows directory-local
variables on remote hosts.
467

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

471 472 473
** Using "unibyte: t" in Lisp source files is obsolete.
Use "coding: raw-text" instead.

474 475 476 477 478
** 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.

479
** Internationalization
Glenn Morris's avatar
Glenn Morris committed
480

Chong Yidong's avatar
Chong Yidong committed
481
*** New language environment: Persian.
Glenn Morris's avatar
Glenn Morris committed
482

Chong Yidong's avatar
Chong Yidong committed
483 484
*** New input method `vietnamese-vni'.

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

Glenn Morris's avatar
Glenn Morris committed
487
*** Support for fullscreen and the frame parameter fullscreen.
Glenn Morris's avatar
Glenn Morris committed
488

489 490 491
*** A file dialog is used for open/save operations initiated from the
menu/toolbar.

Glenn Morris's avatar
Glenn Morris committed
492

493
* Editing Changes in Emacs 24.3
494

495
** Search and Replace
496

Chong Yidong's avatar
Chong Yidong committed
497 498 499 500
*** 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
501
similar existing feature for regexp Isearch.)
Glenn Morris's avatar
Glenn Morris committed
502

Chong Yidong's avatar
Chong Yidong committed
503 504
*** 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
505

Chong Yidong's avatar
Chong Yidong committed
506 507 508
*** 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
509

510 511 512 513
*** 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.

514
** Navigation commands
515

516 517 518 519 520 521 522 523 524 525
*** 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').
526 527 528 529 530

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

533 534
** `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'.
535

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

540 541
** 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
542

543
** Registers
Chong Yidong's avatar
Chong Yidong committed
544

Glenn Morris's avatar
Glenn Morris committed
545
*** `C-x r +' is now overloaded to invoke `append-to-register'.
Chong Yidong's avatar
Chong Yidong committed
546 547

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

Glenn Morris's avatar
Glenn Morris committed
551

552
* Changes in Specialized Modes and Packages in Emacs 24.3
Julien Danjou's avatar
Julien Danjou committed
553

554
** Common Lisp emulation (CL)
Chong Yidong's avatar
Chong Yidong committed
555

556
*** CL's main entry is now (require 'cl-lib).
Glenn Morris's avatar
Glenn Morris committed
557 558 559
`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).
560

Glenn Morris's avatar
Glenn Morris committed
561 562 563 564 565
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*'.
566

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

570 571
*** `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
572 573
In particular, in cl-flet function definitions are lexically scoped,
whereas in flet the scoping is dynamic.
574 575

*** `cl-labels' is slightly different from `labels'.
Glenn Morris's avatar
Glenn Morris committed
576 577 578 579
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.
580

Glenn Morris's avatar
Glenn Morris committed
581
*** `cl-letf' is not exactly like `letf'.
582 583
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
584

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

Glenn Morris's avatar
Glenn Morris committed
589 590 591
*** 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
592 593
`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
594
`get-setf-method' no longer exists (see "Incompatible Lisp Changes")
Glenn Morris's avatar
Glenn Morris committed
595

596
** Diff mode
Chong Yidong's avatar
Chong Yidong committed
597

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

604 605 606
*** 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
607

608 609
*** The new command `diff-delete-trailing-whitespace' removes trailing
whitespace introduced by a diff.
Chong Yidong's avatar
Chong Yidong committed
610

611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630
** 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':
631
Comments are always considered as indentation markers.
632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666

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

Chong Yidong's avatar
Chong Yidong committed
668 669 670 671 672 673 674 675 676
** 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
677 678
*** 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
679

Glenn Morris's avatar
Glenn Morris committed
680
*** Signals can also be sent as unicast messages.
Chong Yidong's avatar
Chong Yidong committed
681 682

*** The argument list of `dbus-register-signal' has been extended,
683
according to the new match rule types of D-Bus.
Chong Yidong's avatar
Chong Yidong committed
684 685 686 687 688

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

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

689 690
** `desktop-path' no longer includes the "." directory.
Desktop files are now located in ~/.emacs.d by default.
Chong Yidong's avatar
Chong Yidong committed
691 692

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

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

Glenn Morris's avatar
Glenn Morris committed
698 699
*** 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
700
file at point.
Glenn Morris's avatar
Glenn Morris committed
701

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

Chong Yidong's avatar
Chong Yidong committed
706 707 708
*** 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
709

Chong Yidong's avatar
Chong Yidong committed
710 711 712
*** `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
713 714
** ERC

715 716
*** 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
717 718 719

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

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

724
** reStructuredText mode
Chong Yidong's avatar
Chong Yidong committed
725

726 727 728
*** 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
729

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

732 733
*** The reStructuredText syntax is more closely covered.
Sphinx support has been improved.
Chong Yidong's avatar
Chong Yidong committed
734

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

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

739
*** The window configuration is reset after displaying a TOC.
740

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

743
** Shell Script mode
744

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

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

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

751
** VHDL mode
752

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

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

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

759
*** Accepts \r and \f as whitespace.
760

761
** Apropos
762

763 764 765
*** 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.
766

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

770
** Buffer Menu
771

772
*** This package has been rewritten to use Tabulated List mode.
773

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

777 778 779 780 781 782
** Calc

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

783
** Calendar
784

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

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

790 791
*** The calendars produced by cal-html include holidays.
Customize `cal-html-holidays' to change this.
792

793
** Compile has a new option `compilation-always-kill'.
794

795
** Customize
Chong Yidong's avatar
Chong Yidong committed
796

797
*** `custom-reset-button-menu' now defaults to t.
Chong Yidong's avatar
Chong Yidong committed
798

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

Chong Yidong's avatar
Chong Yidong committed
803
** Term
804

Glenn Morris's avatar
Glenn Morris committed
805 806
*** The variables `term-default-fg-color' and `term-default-bg-color'
are now deprecated in favor of the customizable face `term'.
807

Glenn Morris's avatar
Glenn Morris committed
808 809 810
*** You can customize how to display ANSI terminal colors and styles
by customizing the corresponding `term-color-<COLOR>',
`term-color-underline' and `term-color-bold' faces.
811

Michael Albinus's avatar
Michael Albinus committed
812
** Tramp
Glenn Morris's avatar
Glenn Morris committed
813

Glenn Morris's avatar
Glenn Morris committed
814
*** The syntax has been extended in order to allow ad-hoc proxy definitions.
Michael Albinus's avatar
Michael Albinus committed
815

Glenn Morris's avatar
Glenn Morris committed
816
*** Remote processes are now also supported on remote MS-Windows hosts.
Michael Albinus's avatar
Michael Albinus committed
817

818
** URL
Glenn Morris's avatar
Glenn Morris committed
819

820 821 822
*** Structs made by `url-generic-parse-url' have nil `attributes' slot.
Previously, this slot stored semicolon-separated attribute-value pairs
appended to some imap URLs, but this is not compatible with RFC 3986.
Glenn Morris's avatar
Glenn Morris committed
823
So now the `filename' slot stores the entire path and query components,
824
and the `attributes' slot is always nil.
Glenn Morris's avatar
Glenn Morris committed
825

826 827 828 829
*** New function `url-encode-url' for encoding a URI string.
The `url-retrieve' function now uses this to encode its URL argument,
in case that is not properly encoded.

830 831 832
** notifications.el supports now version 1.2 of the Notifications API.
The function `notifications-get-capabilities' returns the supported
server properties.
Chong Yidong's avatar
Chong Yidong committed
833

834 835 836
** Flymake uses fringe bitmaps to indicate errors and warnings.
See `flymake-fringe-indicator-position', `flymake-error-bitmap' and
`flymake-warning-bitmap'.
Chong Yidong's avatar
Chong Yidong committed
837

838 839 840
** The FFAP option `ffap-url-unwrap-remote' can now be a list of strings,
specifying URL types that should be converted to remote file names at
the FFAP prompt.  The default is now '("ftp").
Chong Yidong's avatar
Chong Yidong committed
841

842 843
** New Ibuffer `derived-mode' filter, bound to `/ M'.
The old binding for `/ M' (filter by used-mode) is now bound to `/ m'.
Chong Yidong's avatar
Chong Yidong committed
844

845 846
** New option `mouse-avoidance-banish-position' specifies where the
`banish' mouse avoidance setting moves the mouse.
847

848 849
** In Perl mode, new option `perl-indent-parens-as-block' causes non-block
closing brackets to be aligned with the line of the opening bracket.
Chong Yidong's avatar
Chong Yidong committed
850

851
** In Proced mode, new command `proced-renice' renices marked processes.
Chong Yidong's avatar
Chong Yidong committed
852

853 854 855
** New option `async-shell-command-buffer' specifies the buffer to use
for a new asynchronous `shell-command' when the default output buffer
`*Async Shell Command*' is already in use.
Chong Yidong's avatar
Chong Yidong committed
856

857 858 859 860
** SQL mode has a new option `sql-db2-escape-newlines'.
If non-nil, newlines sent to the command interpreter will be escaped
by a backslash.  The default does not escape the newlines and assumes
that the sql statement will be terminated by a semicolon.
Chong Yidong's avatar
Chong Yidong committed
861

862 863 864
** New command `tabulated-list-sort', bound to `S' in Tabulated List mode
(and modes that derive from it), sorts the column at point, or the Nth
column if a numeric prefix argument is given.
Chong Yidong's avatar
Chong Yidong committed
865

Glenn Morris's avatar
Glenn Morris committed
866
** `which-func-modes' now defaults to t, so Which Function mode, when
867
enabled, applies to all applicable major modes.
Chong Yidong's avatar
Chong Yidong committed
868

869
** `winner-mode-hook' now runs when the mode is disabled, as well as when
Glenn Morris's avatar
Glenn Morris committed
870
it is enabled.
Chong Yidong's avatar
Chong Yidong committed
871

872 873 874 875
** Follow mode no longer works by using advice.
The option `follow-intercept-processes' has been removed.

** `javascript-generic-mode' is now an obsolete alias for `js-mode'.
Chong Yidong's avatar
Chong Yidong committed
876

Stefan Monnier's avatar
Stefan Monnier committed
877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899
** Hooks renamed to avoid obsolete "-hooks" suffix:
*** semantic-lex-reset-hooks -> semantic-lex-reset-functions
*** semantic-change-hooks -> semantic-change-functions
*** semantic-edits-new-change-hooks -> semantic-edits-new-change-functions
*** semantic-edits-delete-change-hooks -> semantic-edits-delete-change-functions
*** semantic-edits-reparse-change-hooks -> semantic-edits-reparse-change-functions
*** semanticdb-save-database-hooks -> semanticdb-save-database-functions
*** c-prepare-bug-report-hooks -> c-prepare-bug-report-hook
*** rcirc-sentinel-hooks -> rcirc-sentinel-functions
*** rcirc-receive-message-hooks -> rcirc-receive-message-functions
*** rcirc-activity-hooks -> rcirc-activity-functions
*** rcirc-print-hooks -> rcirc-print-functions
*** dbus-event-error-hooks -> dbus-event-error-functions
*** eieio-pre-method-execution-hooks -> eieio-pre-method-execution-functions
*** checkdoc-style-hooks -> checkdoc-style-functions
*** checkdoc-comment-style-hooks -> checkdoc-comment-style-functions
*** archive-extract-hooks -> archive-extract-hook
*** filesets-cache-fill-content-hooks -> filesets-cache-fill-content-hook
*** hfy-post-html-hooks -> hfy-post-html-hook
*** nndiary-request-create-group-hooks -> nndiary-request-create-group-functions
*** nndiary-request-update-info-hooks -> nndiary-request-update-info-functions
*** nndiary-request-accept-article-hooks -> nndiary-request-accept-article-functions
*** gnus-subscribe-newsgroup-hooks -> gnus-subscribe-newsgroup-functions
Chong Yidong's avatar
Chong Yidong committed
900

901
** Obsolete packages
Glenn Morris's avatar
Glenn Morris committed
902

903 904 905 906
*** assoc.el
In most cases, assoc+member+push+delq work just as well.
And in any case it's just a terrible package: ugly semantics, terrible
inefficiency, and not namespace-clean.
907
*** bruce.el
Glenn Morris's avatar
Glenn Morris committed
908
*** cust-print.el
Glenn Morris's avatar
Glenn Morris committed
909
*** ledit.el
Glenn Morris's avatar
Glenn Morris committed
910
*** mailpost.el
911
*** mouse-sel.el
912
*** patcomp.el
913

Glenn Morris's avatar
Glenn Morris committed
914

915
* Incompatible Lisp Changes in Emacs 24.3
916

917 918 919 920
** Docstrings starting with `*' no longer indicate user options.
Only variables defined using `defcustom' are considered user options.
The function `user-variable-p' is now an obsolete alias for
`custom-variable-p'.
921

922 923 924 925
** The return values of `defalias', `defun' and `defmacro' have changed,
and are now undefined.  For backwards compatibility, `defun' and
`defmacro' currently return the name of the newly defined
function/macro, but this should not be relied upon.
926

Glenn Morris's avatar
Glenn Morris committed
927 928
** `random' by default now returns a different random sequence in
every Emacs run.  Use `(random S)', where S is a string, to set the
929 930 931
random seed to a value based on S, in order to get a repeatable
sequence in later calls.

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

936 937 938
** `select-window' now always makes the window's buffer current.
It does so even if the window was selected before.

939 940 941
** The function `x-select-font' can return a font spec, instead of a
font name as a string.  Whether it returns a font spec or a font name
depends on the graphical library.
942

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

946
** `set-buffer-multibyte' now signals an error in narrowed buffers.
947

948 949 950 951 952 953
** The CL package's `get-setf-method' function no longer exists.
Generalized variables are now part of core Emacs Lisp, and implemented
differently to the way cl.el used to do it.  It is not possible to
define a compatible replacement for `get-setf-method'.  See the file
gv.el for internal details of the new implementation.

954 955 956
** The arguments of `dbus-register-signal' are no longer just strings,
but keywords or keyword-string pairs.  The old argument list will
still be supported for Emacs 24.x.
957