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

3
Copyright (C) 2010-2014 Free Software Foundation, Inc.
4
See the end of the file for license conditions.
Dave Love's avatar
#  
Dave Love committed
5

6
Please send Emacs bug reports to bug-gnu-emacs@gnu.org.
7 8
If possible, use M-x report-emacs-bug.

9
This file is about changes in Emacs version 24.
10

11 12
See files NEWS.23, NEWS.22, NEWS.21, NEWS.20, NEWS.19, NEWS.18,
and NEWS.1-17 for changes in older Emacs versions.
13 14 15

You can narrow news to a specific version by calling `view-emacs-news'
with a prefix argument or by typing C-u C-h C-n.
16

Glenn Morris's avatar
Glenn Morris committed
17
Temporary note:
Glenn Morris's avatar
Glenn Morris committed
18 19
+++ indicates that all necessary documentation updates are complete.
    (This means all relevant manuals in doc/ AND lisp doc-strings.)
20
--- means no change in the manuals is needed.
Glenn Morris's avatar
Glenn Morris committed
21
When you add a new item, use the appropriate mark if you are sure it applies,
22
otherwise leave it unmarked.
Glenn Morris's avatar
Glenn Morris committed
23

24 25 26

* Installation Changes in Emacs 24.5

Glenn Morris's avatar
Glenn Morris committed
27
+++
Paul Eggert's avatar
Paul Eggert committed
28 29
** Building Emacs now requires C99 or later.

30
** Building Emacs now requires GNU make, version 3.81 or later.
Glenn Morris's avatar
Glenn Morris committed
31

Paul Eggert's avatar
Paul Eggert committed
32 33 34 35 36 37 38
** By default, Emacs no longer works on IRIX.  We expect that Emacs
users are not affected by this, as SGI stopped supporting IRIX in
December 2013.  If you are affected, please send a bug report.  You
should be able to work around the problem either by porting the Emacs
undumping code to GCC under IRIX, or by configuring --with-wide-int,
or by sticking with Emacs 24.4.

39 40
---
** The configure option `--with-pkg-config-prog' has been removed.
41
Use './configure PKG_CONFIG=/full/name/of/pkg-config' if you need to.
42

43 44 45
** The configure option '--enable-silent-rules' and the command
'make V=0' now do a better job of suppressing chatter.

46 47 48 49 50 51

* Startup Changes in Emacs 24.5


* Changes in Emacs 24.5

52 53
** New var `truncate-string-ellipsis' to choose how to indicate truncation.

54 55 56
---
** The default value of `history-length' has increased to 100.

57 58 59 60 61
+++
** The new variable `term-file-aliases' replaces some files from lisp/term.
The function `tty-run-terminal-initialization' consults this variable
when deciding what terminal-specific initialization code to run.

62 63 64 65 66
---
** New variable `system-configuration-features', listing some of the
main features that Emacs was compiled with.  This is mainly intended
for use in Emacs bug reports.

67 68 69 70 71
+++
** A password is now hidden also when typed in batch mode.  Another
hiding character but the default `.' can be used by let-binding the
variable `read-hide-char'.

72 73
** The new functions `string-collate-lessp' and `string-collate-equalp'
preserve the collation order as defined by the system's locale(1)
74 75 76
environment.  For the time being this is implemented for modern POSIX
systems and for MS-Windows, for other systems they fall back to their
counterparts `string-lessp' and `string-equal'.
77

78 79 80 81
*** The ls-lisp package uses `string-collate-lessp' to sort file names.
If you want the old, locale-independent sorting, customize the new
option `ls-lisp-use-string-collate' to a nil value.

82 83 84 85 86 87 88
*** The MS-Windows specific variable `w32-collate-ignore-punctuation',
if set to a non-nil value, causes the above 2 functions to ignore
symbol and punctuation characters when collating strings.  This
emulates the behavior of modern Posix platforms when the locale's
codeset is "UTF-8" (as in "en_US.UTF-8").  This is needed because
MS-Windows doesn't support UTF-8 as codeset in its locales.

89 90 91

* Editing Changes in Emacs 24.5

Glenn Morris's avatar
Glenn Morris committed
92
** Emacs now supports "bracketed paste mode" when running on a terminal
93
that supports it.  This facility allows Emacs to understand pasted
Glenn Morris's avatar
Glenn Morris committed
94 95 96
chunks of text as strings to be inserted, instead of interpreting each
character in the pasted text as actual user input.  This results in a
paste experience similar to that under a window system, and significant
97 98
performance improvements when pasting large amounts of text.

99 100

* Changes in Specialized Modes and Packages in Emacs 24.5
101

102 103 104
** Lisp mode
*** Strings after `:documentation' are highlighted as docstrings.

105 106 107 108
** Rectangle editing
*** Rectangle Mark mode can have corners past EOL or in the middle of a TAB.
*** C-x C-x in rectangle-mark-mode now cycles through the four corners.
*** `string-rectangle' provides on-the-fly preview of the result.
109

Glenn Morris's avatar
Glenn Morris committed
110 111
** New font-lock functions font-lock-ensure and font-lock-flush, which
should be used instead of font-lock-fontify-buffer when called from Elisp.
112

113 114 115
** Macro `minibuffer-with-setup-hook' takes (:append FUN) to mean
appending FUN to `minibuffer-setup-hook'.

116 117 118 119 120
** Calendar and diary

+++
*** New commands to insert diary entries with Chinese dates:
`diary-chinese-insert-anniversary-entry' `diary-chinese-insert-entry'
Glenn Morris's avatar
Glenn Morris committed
121
`diary-chinese-insert-monthly-entry', `diary-chinese-insert-yearly-entry'.
122 123

+++
Glenn Morris's avatar
Glenn Morris committed
124 125 126
*** Calendar can list and mark diary entries with Chinese dates.
See `diary-chinese-list-entries' and `diary-chinese-mark-entries'.

127 128
** New ERT function `ert-summarize-tests-batch-and-exit'.

Glenn Morris's avatar
Glenn Morris committed
129 130 131 132 133
---
** The Rmail commands d, C-d and u now handle repeat counts to delete or
undelete multiple messages.

** SES now supports local printer functions; see `ses-define-local-printer'.
134

Glenn Morris's avatar
Glenn Morris committed
135 136 137
** In sh-mode, you can now use `sh-shell' as a file-local variable to
specify the type of shell in use (bash, csh, etc).

138 139 140 141
** The URL package accepts now the protocols "ssh", "scp" and "rsync".
When `url-handler-mode' is enabled, file operations for these
protocols as well as for "telnet" and "ftp" are passed to Tramp.

142 143 144 145
** Tramp

*** New connection method "nc", which allows to access dumb busyboxes.

146 147 148 149 150 151
** VC and related modes

*** New option `vc-annotate-background-mode' controls whether
the color range from `vc-annotate-color-map' is applied to the
background or to the foreground.

152 153 154 155
** Calculator: decimal display mode uses "," groups, so it's more
fitting for use in money calculations; factorial works with
non-integer inputs.

156 157 158 159 160 161 162 163 164 165
** HideIfDef mode now support full C/C++ expressions, argumented macro expansions
, interactive macro evaluation and automatic scanning of #defined symbols.

*** New custom variable `hide-ifdef-header-regexp' to define C/C++ header file
name patterns. Default case-insensitive .h, .hh, .hpp and .hxx.
*** New custom variable `hide-ifdef-expand-reinclusion-protection' to prevent
reinclusion protected header files from being fully hidden.
*** New custom variable `hide-ifdef-exclude-define-regexp' to define symbol
name patterns (e.x. all "FOR_DOXYGEN_ONLY_*") to be excluded.

Glenn Morris's avatar
Glenn Morris committed
166 167 168 169 170
** Obsolete packages

---
*** gulp.el

171 172 173 174 175
---
*** crisp.el, tpu-edt.el, ws-mode.el
These emulations of old editors are believed to be no longer relevant
 - contact emacs-devel@gnu.org if you disagree.

Glenn Morris's avatar
Glenn Morris committed
176 177 178
---
*** vi.el, vip.el (try M-x viper instead)

179 180 181 182 183 184

* New Modes and Packages in Emacs 24.5


* Incompatible Lisp Changes in Emacs 24.5

Glenn Morris's avatar
Glenn Morris committed
185
** window-configurations no longer record the buffers's marks.
186

Glenn Morris's avatar
Glenn Morris committed
187
** inhibit-modification-hooks now also inhibits lock-file checks, as well as
188 189
active region handling.

190 191
** deactivate-mark is now buffer-local.

Glenn Morris's avatar
Glenn Morris committed
192
** `cl-the' now asserts that its argument is of the given type.
193

194 195 196 197 198 199
+++
** Mouse click events on mode line or header line no longer include
any reference to a buffer position.  The 6th member of the mouse
position list returned for such events is now nil.


200 201 202

* Lisp Changes in Emacs 24.5

203 204 205
*** call-process-shell-command and process-file-shell-command
don't take "&rest args" an more.

206 207 208 209
** New function `funcall-interactively', which works like `funcall'
but makes `called-interactively-p' treat the function as (you guessed it)
called interactively.

210 211
** New function `function-put' to use instead of `put' for function properties.

212
+++
213
** New properties that can be specified with `declare':
Glenn Morris's avatar
Glenn Morris committed
214
*** (interactive-only INSTEAD), says to use INSTEAD for non-interactive use.
215 216 217
*** (pure VAL), if VAL is non-nil, indicates the function is pure.
*** (side-effect-free VAL), if VAL is non-nil, indicates the function does not
have side effects.
218

219 220 221 222
+++
** New macro `with-file-modes', for evaluating expressions with default file
permissions set to temporary values (e.g., for creating private files).

223
** You can access the slots of structures using `cl-struct-slot-value'.
Daniel Colascione's avatar
Daniel Colascione committed
224

225 226 227
** Functions `rmail-delete-forward' and `rmail-delete-backward' take an
optional repeat-count argument.

228 229
** Function `sort' can deal with vectors.

230
---
231 232 233 234 235
** New utilities in subr-x.el:
*** New macros `if-let' and `when-let' allow defining bindings and to
    execute code depending whether all values are true.
*** New macros `thread-first' and `thread-last' allow threading a form
    as the first or last argument of subsequent forms.
236

237 238 239 240 241

* Changes in Frames and Windows Code in Emacs 24.5

** Emacs can now draw horizontal scroll bars on some platforms that
provide toolkit scroll bars, namely Gtk, Lucid, Motif and Windows.
Martin Rudalics's avatar
Martin Rudalics committed
242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268
Horizontal scroll bars are turned off by default.
*** New mode `horizontal-scroll-bar-mode' to toggle horizontal scroll
    bars on all existing and future frames.
*** New frame parameters `horizontal-scroll-bars' and
    `scroll-bar-height' to set horizontal scroll bars and their height
    for individual frames and in `default-frame-alist'.
*** New function `frame-scroll-bar-height' to return the height of
    horizontal scroll bars on a specific frame.
*** `set-window-scroll-bars' now accepts five parameters where the last
    two specify height and type of the window's horizontal scroll bar.

** The height of a frame's menu and tool bar are no more counted in the
frame's text height.  This means that the text height stands only for
the height of the frame's root window plus that of the echo area (if
present).  This was already the behavior for frames with external tool
and menu bars (like in the Gtk builds) but has now been extended to all
builds.

** Frames now do not necessarily preserve the number of columns or lines
they display when setting default font, menu bar, fringe width, or
scroll bars.  In particular, maximized and fullscreen frames are
conceptually never resized if such settings change.  For fullheight and
fullwidth frames, the behavior may depend on the toolkit used.
*** New option `frame-inhibit-implied-resize' if non-nil, means that
   setting default font, menu bar, fringe width, or scroll bars of a
   specific frame does not resize that frame in order to preserve the
   number of columns or lines it displays.
269 270 271

* Changes in Emacs 24.5 on Non-Free Operating Systems

Glenn Morris's avatar
Glenn Morris committed
272 273 274 275 276
---
** Building Emacs for MS-Windows requires at least Windows XP
or Windows Server 2003.  The built binaries still run on all versions
of Windows starting with Windows 9X.

277 278

* Installation Changes in Emacs 24.4
279

280
** Emacs can now be compiled with ACL (access control list) support.
281 282
This happens by default if a suitable support library is found at
build time, like libacl on GNU/Linux.  To prevent this, use the
283
configure option `--disable-acl'.  See below for the features this provides.
284

Chong Yidong's avatar
Chong Yidong committed
285
** Emacs can now be compiled with file notification support.
286 287
This happens by default if a suitable system library is found at
build time.  To prevent this, use the configure option
288
`--without-file-notification'.  See below for file-notify features.
Glenn Morris's avatar
Glenn Morris committed
289 290 291 292 293 294
This feature is not available for the Nextstep port.

** Emacs can now be compiled with zlib support.
This happens by default if zlib is present, which it normally is.
To prevent this, use the configure option `--without-zlib'.
This provides the function `zlib-decompress-region'; see below for details.
295

Chong Yidong's avatar
Chong Yidong committed
296 297
** The configure option `--without-compress-info' has been generalized,
and renamed to `--without-compress-install'.  It now prevents compression
298 299
of _any_ files during installation.

Chong Yidong's avatar
Chong Yidong committed
300
** The configure option `--with-crt-dir' has been removed.
301
It is no longer needed, as the crt*.o files are no longer linked specially.
302

303 304 305
** Directories passed to configure option `--enable-locallisppath' are
no longer created during installation.

306
** Emacs for Nextstep (Mac OS X, GNUstep) can be built with ImageMagick support.
Glenn Morris's avatar
Glenn Morris committed
307
This requires pkg-config to be available at build time.
308

Glenn Morris's avatar
Glenn Morris committed
309

310
* Startup Changes in Emacs 24.4
Glenn Morris's avatar
Glenn Morris committed
311

312 313 314 315 316 317 318 319 320
** When initializing `load-path', an empty element in the EMACSLOADPATH
environment variable (either leading, e.g., ":/foo"; trailing, e.g.,
"/foo:"; or embedded, e.g., "/foo::/bar") is replaced with the default
load-path (the one that would have been used if EMACSLOADPATH was unset).
This makes it easier to _extend_ the load-path via EMACSLOADPATH
(previously, EMACSLOADPATH had to specify the complete load-path,
including the defaults).  (In older versions of Emacs, an empty element
was replaced by ".", so use an explicit "." now if that is what you want.)

321
** The -L option, which normally prepends its argument to load-path,
322 323
will instead append, if the argument begins with `:' (or `;' on MS Windows;
i.e., `path-separator').
324

325 326 327 328 329
** If you use either site-load.el or site-init.el to customize the dumped
Emacs executable, any changes to `load-path' that these files make
will no longer be present after dumping.  To affect a permanent change
to `load-path', use the `--enable-locallisppath' option of `configure'.

Chong Yidong's avatar
Chong Yidong committed
330 331 332
** The user option `initial-buffer-choice' can now specify a function
to set up the initial buffer.

Glenn Morris's avatar
Glenn Morris committed
333

334
* Changes in Emacs 24.4
335

336 337 338 339 340
** Support for ACLs (access control lists).
This requires a suitable support library to be found at build time.
On GNU/Linux, the POSIX ACL interface is used via libacl.
On MS-Windows, the NT Security APIs are used to emulate the POSIX interface.
ACLs are extended file attributes, used e.g. for finer-grained permissions.
Glenn Morris's avatar
Glenn Morris committed
341

342
*** Emacs preserves the ACL entries of files when backing up.
343

344 345 346
*** New functions `file-acl' and `set-file-acl' get and set file ACLs.

** Support for menus on text-mode terminals.
Eli Zaretskii's avatar
Eli Zaretskii committed
347 348
If the terminal supports a mouse, clicking on the menu bar, or on
sensitive portions of the mode line or header line, will drop down the
349 350
menu defined at that position.  Likewise, clicking C-mouse-1, C-mouse-2, or
C-mouse-3 on the text area will pop up the menus defined for those locations.
Eli Zaretskii's avatar
Eli Zaretskii committed
351 352 353 354

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

355
If you want the previous behavior, where F10 invoked `tmm-menubar',
Eli Zaretskii's avatar
Eli Zaretskii committed
356
customize the option `tty-menu-open-use-tmm' to a non-nil value.
Glenn Morris's avatar
Glenn Morris committed
357 358
(Typing M-` always invokes `tmm-menubar', even if `tty-menu-open-use-tmm'
is nil.)
Eli Zaretskii's avatar
Eli Zaretskii committed
359

360 361 362 363 364
** New option `load-prefer-newer' affects how the `load' function chooses
the file to load.  If this is non-nil, then when both .el and .elc
versions of a file exist, and the caller did not explicitly specify
which one to load, then the newer file is loaded.  The default, nil,
means to always load the .elc file.
365

366
** Multi-monitor support
367 368 369 370 371

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

372 373 374
*** The functions `display-pixel-width' and `display-pixel-height' now
behave consistently among the platforms: they return the pixel width
or height for all physical monitors associated with the given display
375
as if they were on X.  To get information for each physical
376 377 378 379
monitor, use the new functions above.  Similar notes also apply to
`x-display-pixel-width', `x-display-pixel-height', `display-mm-width',
`display-mm-height', `x-display-mm-width', and `x-display-mm-height'.

380 381 382 383 384 385 386 387 388
** New function `zlib-decompress-region', which decompresses gzip- and
zlib-format compressed data using built-in zlib support (if available).

** The *Messages* buffer is created in `messages-buffer-mode',
a new major mode, with read-only status.  Any code that might create
the *Messages* buffer should call the function `messages-buffer' to do
so and set up the mode.

** The cursor stops blinking after 10 blinks (by default) on X and Nextstep.
Chong Yidong's avatar
Chong Yidong committed
389
You can change the default by customizing `blink-cursor-blinks'.
390

Chong Yidong's avatar
Chong Yidong committed
391 392 393
** In keymaps where SPC scrolls forward, S-SPC now scrolls backward.
This affects View mode, etc.

Glenn Morris's avatar
Glenn Morris committed
394
** The default value of `make-backup-file-name-function' is no longer nil.
Glenn Morris's avatar
Glenn Morris committed
395 396
Instead it defaults to a function that does what the nil value used to.

397
** Help
Glenn Morris's avatar
Glenn Morris committed
398

Chong Yidong's avatar
Chong Yidong committed
399
*** The command `apropos-variable' is renamed to `apropos-user-option'.
400
`apropos-user-option' shows all user options, while `apropos-variable'
Chong Yidong's avatar
Chong Yidong committed
401 402 403
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.
404

Chong Yidong's avatar
Chong Yidong committed
405
*** The key `?' now describes prefix bindings, like `C-h'.
406

Glenn Morris's avatar
Glenn Morris committed
407
*** The command `describe-function' has been extended for EIEIO.
408
Running it on constructors will show a full description of the
David Engster's avatar
David Engster committed
409
generated class.  For generic functions, it will show all
410 411 412 413
implementations together with links to the source.  The old commands
`describe-class', `describe-constructor' and `describe-generic' were
removed.

414
*** The function `quail-help' is no longer an interactive command.
Glenn Morris's avatar
Glenn Morris committed
415
Use `C-h C-\' (`describe-input-method') instead.
416

Glenn Morris's avatar
Glenn Morris committed
417
** Frame and window handling
418

Chong Yidong's avatar
Chong Yidong committed
419 420
*** New commands `toggle-frame-fullscreen' and `toggle-frame-maximized',
bound to <f11> and M-<f10>, respectively.
421

Chong Yidong's avatar
Chong Yidong committed
422 423 424
*** New hooks `focus-in-hook', `focus-out-hook'.
These are normal hooks run when an Emacs frame gains or loses input focus.

425 426 427 428
*** The function `window-in-direction' now takes additional arguments
for specifying a reference point, wrapping the selection around frame
borders, and specifying ways to select the minibuffer window.

Glenn Morris's avatar
Glenn Morris committed
429 430 431 432 433 434 435 436 437 438 439 440 441 442 443
*** Emacs can now change frame sizes in units of pixels, rather than
text rows or columns.  When maximizing a frame or making it fullscreen,
remaining extra pixels are no longer given to the minibuffer, the rightmost
fringe, or other unusable space, but are distributed among the text
areas of the frame's windows.  If the new option `frame-resize-pixelwise'
is non-nil, all frame size changes happen pixelwise and set the
corresponding size hints for the window manager.

*** Emacs can now change window sizes in units of pixels.
Mouse-dragging a mode line or window divider now changes the size of
adjacent windows pixelwise.  If the new option `window-resize-pixelwise'
is non-nil, functions like `balance-windows-area' and `fit-window-to-buffer'
resize windows pixelwise.  Most functions for changing or accessing
window sizes now have an additional argument that allows changes to apply,
or values to be returned, in pixels instead of lines/columns.
444

445 446 447 448
*** The functions `window-body-height' and `window-body-width' now never
count partially visible lines or columns if called with a nil PIXELWISE
argument.

449 450 451 452 453 454 455 456 457 458
*** Emacs can now draw dividers between adjacent windows.  To put
dividers between side-by-side/vertically stacked windows customize the
frame parameters `right-divider-width' and `bottom-divider-width' to
some positive integer.  You can drag dividers with the mouse (they show
a corresponding cursor when the mouse hovers over them).  You can change
the appearance of dividers by customizing the faces `window-divider',
`window-divider-first-pixel', and `window-divider-last-pixel'.  The last
two are useful to provide a 3D effect, or to better distinguish dividers
from surrounding display objects.

459 460 461
*** New functions to return the pixel sizes of window components, namely
`window-scroll-bar-width', `window-mode-line-height',
`window-header-line-height', `window-right-divider-width', and
462 463 464 465 466 467 468
`window-bottom-divider-width'.

*** The new function `window-text-pixel-size' returns the size of the
text of a window's buffer in pixels.  This allows functions like
`fit-frame-to-buffer' and `fit-window-to-buffer' to accurately fit a
window to its buffer as it will be displayed.

469
*** `fit-window-to-buffer' can now resize windows in both dimensions.
470
This behavior is controlled by the new option
471
`fit-window-to-buffer-horizontally'.  The new option
472
`fit-frame-to-buffer' allows you to fit the window's frame to its buffer.
473

474 475
*** `fit-frame-to-buffer' now fits frames in both dimensions.  The new
options `fit-frame-to-buffer-margins' and `fit-frame-to-buffer-sizes'
476 477
control the size of the frame and its position on screen.

478 479 480 481 482 483
*** Temp Buffer Resize Mode can now adjust the height and width of
windows and frames.  The new option `temp-buffer-max-width' allows you to
control the width of temporary buffer windows.  Moreover, if the new
option `fit-frame-to-buffer' is non-nil and the buffer appears in the
root window of a frame, Temp Buffer Resize Mode will try to adjust the
width and/or height of the frame.
484

Chong Yidong's avatar
Chong Yidong committed
485 486 487 488
*** `split-window' is now a non-interactive function, not a command.
As a command, it was a special case of `C-x 2' (`split-window-below'),
and as such superfluous.  After being reimplemented in Lisp, its
interactive form was mistakenly retained.
489

490 491 492
*** The functions `window-size' and `window-total-size' now have an
optional argument to return a rounded size value.

493
*** `window-state-put' now allows you to put a window state into internal
494 495
windows too.

Chong Yidong's avatar
Chong Yidong committed
496
*** New option `scroll-bar-adjust-thumb-portion'.
497 498
Available only on X, this option allows you to control over-scrolling
using the scroll bar (i.e., dragging the thumb down even when the end
Chong Yidong's avatar
Chong Yidong committed
499 500
of the buffer is visible).

501
*** New display actions functions for `display-buffer':
502

503 504
**** `display-buffer-in-previous-window' displays a buffer in a window
previously showing that buffer.
505

506 507
**** `display-buffer-at-bottom' chooses or creates a window at the
bottom of the selected frame.
508

509
**** `display-buffer-no-window' to not display the buffer in a window.
Xue Fuqiao's avatar
Xue Fuqiao committed
510 511

*** New display action alist entry `allow-no-window' to indicate the
512 513
caller of `display-buffer' is ready to handle the case of not displaying
the buffer in a window.
Xue Fuqiao's avatar
Xue Fuqiao committed
514

Glenn Morris's avatar
Glenn Morris committed
515
** Lisp evaluation
516

Chong Yidong's avatar
Chong Yidong committed
517 518 519
*** `eval-defun' on an already defined defcustom calls the :set function,
if there is one.

Glenn Morris's avatar
Glenn Morris committed
520
*** The commands `eval-expression' (`M-:'), `eval-last-sexp' (`C-x C-e'),
521 522 523
and `eval-print-last-sexp' (`C-j' in Lisp Interaction mode) can take a
zero prefix argument.  This disables truncation of lists in the output,
equivalent to setting `(eval-expression-)print-length' and
Xue Fuqiao's avatar
Xue Fuqiao committed
524
`(eval-expression-)print-level' to nil.  Additionally, it causes integers
525
to be printed in other formats (octal, hexadecimal, and character).
Chong Yidong's avatar
Chong Yidong committed
526

527 528 529
*** New hook `eval-expression-minibuffer-setup-hook' run by
`eval-expression' on entering the minibuffer.

530
** `cache-long-line-scans' is now non-nil, and renamed to `cache-long-scans',
Chong Yidong's avatar
Chong Yidong committed
531
because it affects caching of paragraph scanning results as well.
532
There is no reason to set this to nil except for debugging purposes.
533

534 535
** `emacs-bzr-version' has been renamed to `emacs-repository-version',
and works for git too, if you fetch the repository notes.
Chong Yidong's avatar
Chong Yidong committed
536

Glenn Morris's avatar
Glenn Morris committed
537
** The default value of `comment-use-global-state' is now t,
Chong Yidong's avatar
Chong Yidong committed
538 539
and this variable has been marked obsolete.

540
** `write-region-inhibit-fsync' now defaults to t in batch mode.
Glenn Morris's avatar
Glenn Morris committed
541

542 543 544
** 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.
Chong Yidong's avatar
Chong Yidong committed
545

Chong Yidong's avatar
Chong Yidong committed
546 547 548

* Editing Changes in Emacs 24.4

Glenn Morris's avatar
Glenn Morris committed
549
** Indentation
Chong Yidong's avatar
Chong Yidong committed
550

551
*** `electric-indent-mode' is now enabled by default.
552 553 554
Typing RET reindents the current line and indents the new line.
`C-j' inserts a newline but does not indent.  In some programming modes,
additional characters are electric (eg `{').
555

Glenn Morris's avatar
Glenn Morris committed
556 557
*** New buffer-local `electric-indent-local-mode'.

Chong Yidong's avatar
Chong Yidong committed
558 559 560 561 562
*** The behavior of `C-x TAB' (`indent-rigidly') has changed.
When invoked without a prefix argument, it now activates a transient
mode in which typing <left>, <right>, <S-left>, and <S-right> adjusts
the text indentation in the region.  Typing any other key resumes
normal editing behavior.
563

Chong Yidong's avatar
Chong Yidong committed
564
*** `tab-stop-list' is now implicitly extended to infinity by repeating
Glenn Morris's avatar
Glenn Morris committed
565
the last step.  Its default value is changed to nil, which means a tab
Xue Fuqiao's avatar
Xue Fuqiao committed
566
stop every `tab-width' columns.
567

Glenn Morris's avatar
Glenn Morris committed
568
** Uniquify is enabled by default, with `post-forward-angle-brackets' style.
Glenn Morris's avatar
Glenn Morris committed
569 570 571 572
In other words, if you visit two files that have the same base name,
then rather than creating buffers basename and basename<2>,
Emacs uses basename<dirA> and basename<dirB>.  To change this,
customize `uniquify-buffer-name-style'.  Set it to nil for the old behavior.
Chong Yidong's avatar
Chong Yidong committed
573 574 575

** New command `C-x SPC' (`rectangle-mark-mode') makes a rectangular region.
Most commands are still unaware of it, but kill/yank do work on the rectangle.
576

577 578 579 580 581 582
** New option `visual-order-cursor-movement'.
If this is non-nil, cursor motion with arrow keys will follow the
visual order of characters on the screen: <left> always moves to the
left, <right> always moves to the right, disregarding the surrounding
bidirectional context.

583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599
** New command `delete-duplicate-lines'.
This searches the region for identical lines, and removes all but one
copy of each repeated line.  The lines need not be sorted.

** New command `cycle-spacing' acts like a smarter `just-one-space'.
When called in succession, it cycles between spacing conventions:
one space, no spaces, original spacing.

** `blink-matching-paren' now only highlights the matching open-paren
by default, instead of moving the cursor.  Set this variable to `jump' to
restore the old behavior.

** The new function `fill-single-char-nobreak-p' can stop fill from breaking
a line after a one-letter word, which is an error in some typographical
conventions.  To use it, add it to the `fill-nobreak-predicate' hook.

** Registers
600

601 602 603
*** All interactive commands that read a register (`copy-to-register', etc.)
now display a temporary window after `register-preview-delay' seconds
that summarizes existing registers.  To disable this, set that option to nil.
604 605
Interactive commands that read registers and want to make use of this
should use `register-read-with-preview' to read register names.
606

Glenn Morris's avatar
Glenn Morris committed
607 608 609 610 611 612
*** New command `frameset-to-register' bound to `C-x r f', replacing
`frame-configuration-to-register'.  It offers similar functionality,
plus enhancements like the ability to restore deleted frames.
(`frame-configuration-to-register' still exists, but no longer has a
key binding.)

613 614
*** New command `C-x C-k x' (`kmacro-to-register') stores keyboard
macros in registers.
615

616

617
* Changes in Specialized Modes and Packages in Emacs 24.4
618

Chong Yidong's avatar
Chong Yidong committed
619
** Backtrace and debugger
620

Glenn Morris's avatar
Glenn Morris committed
621
*** New Lisp debugger command `v' (`debugger-toggle-locals') toggles the
622
display of local variables of the current stack frame.
Glenn Morris's avatar
Glenn Morris committed
623 624 625 626

*** The Lisp debugger's `e' command (`debugger-eval-expression') now includes
the lexical environment when evaluating the code in the context at point
(and so allows you to access lexical variables).
627

Glenn Morris's avatar
Glenn Morris committed
628
*** New minor mode `jit-lock-debug-mode' helps you debug code run via JIT Lock.
629

630
** Battery information can now be retrieved from BSD's `apm' utility.
631

632
** In the Buffer Menu, `M-s a C-o' shows matches for a regexp in marked buffers.
633

634 635 636 637 638 639 640 641
** 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.

Glenn Morris's avatar
Glenn Morris committed
642 643
*** The new option `calc-gregorian-switch' lets you configure if
(and when) Calc switches from the Julian to the Gregorian calendar.
644

645 646
*** Support for ISO 8601 dates.

647 648 649 650 651 652 653 654 655 656 657 658
** Calendar and Diary

*** New faces `calendar-weekday-header', `calendar-weekend-header',
and `calendar-month-header'.

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

*** New variable `diary-from-outlook-function', used by the command
`diary-from-outlook'.

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

Chong Yidong's avatar
Chong Yidong committed
659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675
** CEDET

*** EDE

**** The cpp-root project now supports executing a compile command.
It can be set through the new :compile-command slot or the
buffer-local variable `compile-command'.

**** Better selection of include directories for the 'linux' project.
Include directories now support out-of-tree build directories and
target architecture auto-detection.

*** Semantic

**** Improved detection of used namespaces in current scope in C++.

**** Parsing of default values for variables and function arguments in C/C++.
676
They are also displayed by the summarize feature in the mode line.
Chong Yidong's avatar
Chong Yidong committed
677 678 679 680

**** Improved parsing of function pointers in C/C++.
This also includes parsing of function pointers as function arguments.

681 682
**** Parsing of C/C++ preprocessor macros that open new scope.
For example, this enables parsing of macros that open new namespaces.
Chong Yidong's avatar
Chong Yidong committed
683 684 685

**** Support for 'this' pointer in inline member functions in C++.

686 687 688 689 690 691 692 693
** CFEngine mode

*** Support for completion, ElDoc, and Flycheck has been added.

*** The current CFEngine syntax is parsed from "cf-promises -s json".
There is a fallback syntax available if you don't have cf-promises or
if your version doesn't support that option.  See option `cfengine-cf-promises'.

Chong Yidong's avatar
Chong Yidong committed
694 695
** cl-lib

696
*** New macro `cl-tagbody'.
697
This executes statements while allowing for control transfer to labels.
Chong Yidong's avatar
Chong Yidong committed
698 699 700 701 702

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

** CUA mode

Chong Yidong's avatar
Chong Yidong committed
703
*** CUA mode now uses `delete-selection-mode' and `shift-select-mode'.
Glenn Morris's avatar
Glenn Morris committed
704 705
Hence, you can now enable it independently from those modes, and from
`transient-mark-mode'.
Chong Yidong's avatar
Chong Yidong committed
706 707 708

*** `cua-highlight-region-shift-only' is now obsolete.
You can disable `transient-mark-mode' to get the same result.
Chong Yidong's avatar
Chong Yidong committed
709

710 711
*** CUA's rectangles can now be used without CUA by calling the command
`cua-rectangle-mark-mode'.
Chong Yidong's avatar
Chong Yidong committed
712

713
** Delete Selection mode can now be used without Transient Mark mode.
Chong Yidong's avatar
Chong Yidong committed
714

715 716
** Desktop

Glenn Morris's avatar
Glenn Morris committed
717 718 719
*** `desktop-save-mode' by default now auto-saves an existing desktop file
after `desktop-auto-save-timeout'.  To disable this, customize that option
to nil (or zero).
720

721 722 723 724
*** Desktop now saves and restores the frame/window configuration.
To disable this, set `desktop-restore-frames' to nil.
See also related options `desktop-restore-reuses-frames',
`desktop-restore-in-current-display', and `desktop-restore-forces-onscreen'.
725

726
** New Dired minor mode `dired-hide-details-mode' toggles whether details,
727 728 729
such as file ownership or permissions, are visible in Dired buffers.
See the new options `dired-hide-details-hide-symlink-targets' and
`dired-hide-details-hide-information-lines' for customizing what to hide.
730

Glenn Morris's avatar
Glenn Morris committed
731 732 733
** You can enable ElDoc inside the `eval-expression' minibuffer with:
  (add-hook 'eval-expression-minibuffer-setup-hook 'eldoc-mode)
The results display in the mode line.
734

735 736
** Electric Pair mode

Glenn Morris's avatar
Glenn Morris committed
737 738
*** New option `electric-pair-preserve-balance', enabled by default.
If non-nil, pairing/skipping only kicks in when that help the balance
739
of parentheses and quotes; i.e., the buffer should end up at least as
740 741
balanced as before.

Paul Eggert's avatar
Paul Eggert committed
742
You can further control this behavior by adjusting the predicates
Glenn Morris's avatar
Glenn Morris committed
743
stored in `electric-pair-inhibit-predicate' and `electric-pair-skip-self'.
744

Glenn Morris's avatar
Glenn Morris committed
745
*** New option `electric-pair-delete-adjacent-pairs', enabled by default.
746 747 748 749
In `electric-pair-mode', the commands `backward-delete-char' and
`backward-delete-char-untabify' are now bound to electric variants
that delete the closer when invoked between adjacent pairs.

Glenn Morris's avatar
Glenn Morris committed
750
*** New option `electric-pair-open-newline-between-pairs', enabled by default.
751 752 753 754
In `electric-pair-mode', inserting a newline between adjacent pairs
opens an extra newline after point, which is indented if
`electric-indent-mode' is also set.

Glenn Morris's avatar
Glenn Morris committed
755 756 757 758
*** New option `electric-pair-skip-whitespace', enabled by default.
This controls if skipping over closing delimiters should jump over any
whitespace slack.  Setting it to `chomp' makes it delete this
whitespace.  See also the variable `electric-pair-skip-whitespace-chars'.
759 760 761

*** New variables control the pairing in strings and comments.
You can customize `electric-pair-text-pairs' and
Paul Eggert's avatar
Paul Eggert committed
762
`electric-pair-text-syntax-table' to tweak pairing behavior inside
763 764
strings and comments.

765
** New EPA option `epa-mail-aliases'.
Glenn Morris's avatar
Glenn Morris committed
766 767
You can set this to a list of email address aliases that `epa-mail-encrypt'
should use to find keys.
768

769
** New ERC option `erc-accidental-paste-threshold-seconds'.
Glenn Morris's avatar
Glenn Morris committed
770
If set to a number, this can be used to avoid accidentally pasting large
Chong Yidong's avatar
Chong Yidong committed
771 772
amounts of data into the ERC input.

Glenn Morris's avatar
Glenn Morris committed
773
** New ERT macro `skip-unless' allows skipping ERT tests.
Chong Yidong's avatar
Chong Yidong committed
774 775 776

** Eshell

Glenn Morris's avatar
Glenn Morris committed
777
*** `eshell' now supports visual subcommands and options.
Chong Yidong's avatar
Chong Yidong committed
778 779 780 781 782 783 784
Eshell has been able to handle "visual" commands (interactive,
non-line oriented commands such as top that require display
capabilities not provided by eshell) by running them in an Emacs
terminal emulator.  See `eshell-visual-commands'.

This feature has been extended to subcommands and options that make a
usually line-oriented command a visual command.  Typical examples are
Glenn Morris's avatar
Glenn Morris committed
785
"git log" and "git <command> --help", which display their output in a
786
pager by default.  See `eshell-visual-subcommands' and `eshell-visual-options'.
Chong Yidong's avatar
Chong Yidong committed
787

Glenn Morris's avatar
Glenn Morris committed
788
*** New Eshell-Tramp module.
Chong Yidong's avatar
Chong Yidong committed
789
External su and sudo commands are now the default; the internal,
790
Tramp-using variants can still be used by enabling the eshell-tramp module.
Chong Yidong's avatar
Chong Yidong committed
791

792
** New F90 mode option `f90-smart-end-names'.
Chong Yidong's avatar
Chong Yidong committed
793

794 795 796 797 798 799 800 801 802 803 804 805 806
** New option `gnutls-verify-error', if non-nil, means that Emacs
should reject SSL/TLS certificates that GnuTLS determines as invalid.
(This option defaults to nil at present, but this is expected to change
in a future release.)

** Hi-Lock

*** New global command `M-s h .' (`highlight-symbol-at-point') highlights
the symbol near point.

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

Glenn Morris's avatar
Glenn Morris committed
807
** Icomplete is now more similar to Ido.
808

Glenn Morris's avatar
Glenn Morris committed
809 810 811 812
*** Icomplete by default now applies to all forms of minibuffer completion.
The variable `icomplete-with-completion-tables' (now a user option)
controls this.  To restore the old behavior, set it back to
'(internal-complete-buffer).
813

Glenn Morris's avatar
Glenn Morris committed
814 815
*** You can navigate through and select completions using the keys
from `icomplete-minibuffer-map'.
816

Glenn Morris's avatar
Glenn Morris committed
817 818
*** The string that separates potential completions is now a customizable
option (`icomplete-separator').  The default is " | " rather than ",".
819

Glenn Morris's avatar
Glenn Morris committed
820 821 822 823
*** New face `icomplete-first-match'; and new options
`icomplete-hide-common-prefix' and `icomplete-show-matches-on-no-input'.

*** The option `icomplete-show-key-bindings' has been removed.
Chong Yidong's avatar
Chong Yidong committed
824 825

** Ido
826

827
*** An Ido user manual is now included.
828

829 830 831
*** The option `ido-use-virtual-buffers' can now take the value `auto'.
This means to use virtual buffers if the current ido input does not match
an existing buffer.
832

833 834
*** The variable `ido-decorations' can optionally have two new elements,
which are the brackets to use around the sole remaining completion.
Chong Yidong's avatar
Chong Yidong committed
835 836 837 838 839 840 841 842 843 844 845 846

** Image mode

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

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

*** New commands to speed up, slow down, or reverse animation.
847 848 849 850
`a +' (`image-increase-speed') and `a -' (`image-decrease-speed') to
speed up and slow down the animation.  `a r' (`image-reverse-speed')
to reverse it and `a 0' (`image-reset-speed') to reset it.

Chong Yidong's avatar
Chong Yidong committed
851 852 853 854 855
*** 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.

Glenn Morris's avatar
Glenn Morris committed
856
** New Imenu option `imenu-generic-skip-comments-and-strings'.
Chong Yidong's avatar
Chong Yidong committed
857

Glenn Morris's avatar
Glenn Morris committed
858 859 860
** Info

*** New Info face `info-index-match', used to highlight matches in index
Chong Yidong's avatar
Chong Yidong committed
861 862 863
entries displayed by `Info-index-next', `Info-virtual-index' and
`info-apropos'.

Glenn Morris's avatar
Glenn Morris committed
864 865 866
*** The Info-edit command is obsolete.  Editing Info nodes by hand
has not been relevant for some time.

Chong Yidong's avatar
Chong Yidong committed
867 868
** JS Mode

Glenn Morris's avatar
Glenn Morris committed
869 870
*** New option `js-switch-indent-offset'.

Chong Yidong's avatar
Chong Yidong committed
871
*** Better indentation of multiple-variable declarations.
Glenn Morris's avatar
Glenn Morris committed
872
If a declaration spans several lines, variables on the following lines
Chong Yidong's avatar
Chong Yidong committed
873 874
are lined up to the first one.

Glenn Morris's avatar
Glenn Morris committed
875
*** Recognition and better indentation of continuations in array comprehensions.
Chong Yidong's avatar
Chong Yidong committed
876

Glenn Morris's avatar
Glenn Morris committed
877
** MH-E has been updated to version 8.5 - see separate MH-E-NEWS file.
Chong Yidong's avatar
Chong Yidong committed
878 879

** Octave mode
Glenn Morris's avatar
Glenn Morris committed
880

Xue Fuqiao's avatar
Xue Fuqiao committed
881
*** Font locking for Texinfo comments and new keywords.
Glenn Morris's avatar
Glenn Morris committed
882 883 884

*** Completion in Octave file buffers.

Glenn Morris's avatar
Glenn Morris committed
885
*** ElDoc support.
Glenn Morris's avatar
Glenn Morris committed
886 887 888 889

*** Jump to definition.

*** Documentation lookup/search.
Chong Yidong's avatar
Chong Yidong committed
890

Glenn Morris's avatar
Glenn Morris committed
891
** OPascal mode is the new name for Delphi mode
Chong Yidong's avatar
Chong Yidong committed
892 893

*** All delphi-* variables and functions have been renamed to opascal-*.