NEWS 161 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

Stefan Monnier's avatar
Stefan Monnier committed
25
* Installation Changes in Emacs 25.1
26

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

Stefan Monnier's avatar
Stefan Monnier committed
47
* Startup Changes in Emacs 25.1
48 49


Stefan Monnier's avatar
Stefan Monnier committed
50
* Changes in Emacs 25.1
51

Stefan Monnier's avatar
Stefan Monnier committed
52 53 54
** x-select-enable-clipboard is renamed gui-select-enable-clipboard.
Additionally it now also applies to OSX and GNUstep.

55 56 57
** `insert-register' now leaves point after the inserted text
when called interactively.  A prefix argument toggles this behavior.

58 59
** New var `truncate-string-ellipsis' to choose how to indicate truncation.

60 61 62
---
** The default value of `history-length' has increased to 100.

63 64 65 66 67
+++
** 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.

68 69 70 71 72
---
** 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.

73 74 75 76 77
+++
** 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'.

78 79
** The new functions `string-collate-lessp' and `string-collate-equalp'
preserve the collation order as defined by the system's locale(1)
80 81 82
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'.
83

84 85 86 87
*** 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.

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

95

Stefan Monnier's avatar
Stefan Monnier committed
96
* Editing Changes in Emacs 25.1
97

Glenn Morris's avatar
Glenn Morris committed
98
** Emacs now supports "bracketed paste mode" when running on a terminal
99
that supports it.  This facility allows Emacs to understand pasted
Glenn Morris's avatar
Glenn Morris committed
100 101 102
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
103 104
performance improvements when pasting large amounts of text.

105

Stefan Monnier's avatar
Stefan Monnier committed
106
* Changes in Specialized Modes and Packages in Emacs 25.1
107

108 109 110 111
** ElDoc
*** New minor mode global-eldoc-mode
*** eldoc-documentation-function now defaults to nil

112 113
** pcase
*** New UPatterns `quote' and `app'.
114
*** New UPatterns can be defined with `pcase-defmacro'.
115

116 117 118
** Lisp mode
*** Strings after `:documentation' are highlighted as docstrings.

119 120 121 122
** 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.
123

Leo Liu's avatar
Leo Liu committed
124 125 126
+++
** Macro `pcase' now supports vector qpattern.

Glenn Morris's avatar
Glenn Morris committed
127 128
** 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.
129

130 131 132
** Macro `minibuffer-with-setup-hook' takes (:append FUN) to mean
appending FUN to `minibuffer-setup-hook'.

133 134 135 136 137
** 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
138
`diary-chinese-insert-monthly-entry', `diary-chinese-insert-yearly-entry'.
139 140

+++
Glenn Morris's avatar
Glenn Morris committed
141 142 143
*** Calendar can list and mark diary entries with Chinese dates.
See `diary-chinese-list-entries' and `diary-chinese-mark-entries'.

144 145 146
*** The mode line of the calendar buffer will not be modified if
`calendar-mode-line-format' is nil.

147 148
** New ERT function `ert-summarize-tests-batch-and-exit'.

Glenn Morris's avatar
Glenn Morris committed
149 150 151 152
---
** The Rmail commands d, C-d and u now handle repeat counts to delete or
undelete multiple messages.

153 154 155 156 157 158
** Rmail can now render HTML mail messages if your Emacs was built with
libxml2 or if you have the Lynx browser installed.  By default, Rmail
will display the HTML version of a mail message that has both HTML and
plain text parts, if display of HTML email is possible; customize the
`rmail-mime-prefer-html' option to `nil' if you don't want that.

Glenn Morris's avatar
Glenn Morris committed
159
** SES now supports local printer functions; see `ses-define-local-printer'.
160

Glenn Morris's avatar
Glenn Morris committed
161 162 163
** 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).

164 165 166 167
** 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.

168 169 170 171
** Tramp

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

172 173 174 175 176 177 178 179 180
** SQL mode

*** New user variable `sql-default-directory' enables remote
connections using Tramp.

*** New command `sql-send-line-and-next' sends the current line to the
interactive buffer and advances to the next line, skipping whitespace
and comments.

Sam Steingold's avatar
Sam Steingold committed
181 182
*** Add support for Vertica SQL.

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

189 190 191 192
** Calculator: decimal display mode uses "," groups, so it's more
fitting for use in money calculations; factorial works with
non-integer inputs.

193 194 195 196 197 198 199 200 201 202
** 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.

203 204 205 206 207
** TeX mode

*** New custom variable `tex-print-file-extension' to help users who
use PDF instead of DVI.

Glenn Morris's avatar
Glenn Morris committed
208 209 210 211 212
** Obsolete packages

---
*** gulp.el

213 214 215 216 217
---
*** 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
218 219 220
---
*** vi.el, vip.el (try M-x viper instead)

221

Stefan Monnier's avatar
Stefan Monnier committed
222
* New Modes and Packages in Emacs 25.1
223 224


Stefan Monnier's avatar
Stefan Monnier committed
225
* Incompatible Lisp Changes in Emacs 25.1
226

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

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

232 233
** deactivate-mark is now buffer-local.

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

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

241 242 243
** Menu items in keymaps do not support the "key shortcut cache" any more.
These slots used to hold key-shortcut data, but have been obsolete since
Emacs-21.
244

245

Stefan Monnier's avatar
Stefan Monnier committed
246
* Lisp Changes in Emacs 25.1
247

248 249 250 251 252 253
** Some "x-*" were obsoleted:
*** x-select-text is renamed gui-select-text.
*** x-get-selection is renamed gui-get-selection.
*** x-get-clipboard and x-clipboard-yank are marked obsolete.
*** x-get-selection-value is renamed to gui-get-primary-selection.
*** x-set-selection is renamed to gui-set-selection
Stefan Monnier's avatar
Stefan Monnier committed
254 255

** call-process-shell-command and process-file-shell-command
256
don't take "&rest args" any more.
257

258 259
** New function `alist-get', which is also a valid place (aka lvalue).

260 261 262 263
** New function `funcall-interactively', which works like `funcall'
but makes `called-interactively-p' treat the function as (you guessed it)
called interactively.

264 265
** New function `function-put' to use instead of `put' for function properties.

266
+++
267
** New properties that can be specified with `declare':
Glenn Morris's avatar
Glenn Morris committed
268
*** (interactive-only INSTEAD), says to use INSTEAD for non-interactive use.
269 270 271
*** (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.
272

273 274 275 276
+++
** New macro `with-file-modes', for evaluating expressions with default file
permissions set to temporary values (e.g., for creating private files).

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

279 280 281
** Functions `rmail-delete-forward' and `rmail-delete-backward' take an
optional repeat-count argument.

282 283
** Function `sort' can deal with vectors.

284
---
285 286 287 288 289
** 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.
290

291

Stefan Monnier's avatar
Stefan Monnier committed
292
* Changes in Frames and Windows Code in Emacs 25.1
293 294 295

** 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
296
Horizontal scroll bars are turned off by default.
297 298
*** New function `horizontal-scroll-bars-available-p' telling whether
    horizontal scroll bars are available on the underlying system.
Martin Rudalics's avatar
Martin Rudalics committed
299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324
*** 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.
325

Stefan Monnier's avatar
Stefan Monnier committed
326
* Changes in Emacs 25.1 on Non-Free Operating Systems
327

Glenn Morris's avatar
Glenn Morris committed
328 329 330 331 332
---
** 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.

333 334

* Installation Changes in Emacs 24.4
335

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

Chong Yidong's avatar
Chong Yidong committed
341
** Emacs can now be compiled with file notification support.
342 343
This happens by default if a suitable system library is found at
build time.  To prevent this, use the configure option
344
`--without-file-notification'.  See below for file-notify features.
Glenn Morris's avatar
Glenn Morris committed
345 346 347 348 349 350
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.
351

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

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

359 360 361
** Directories passed to configure option `--enable-locallisppath' are
no longer created during installation.

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

Glenn Morris's avatar
Glenn Morris committed
365

366
* Startup Changes in Emacs 24.4
Glenn Morris's avatar
Glenn Morris committed
367

368 369 370 371 372 373 374 375 376
** 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.)

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

381 382 383 384 385
** 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
386 387 388
** The user option `initial-buffer-choice' can now specify a function
to set up the initial buffer.

Glenn Morris's avatar
Glenn Morris committed
389

390
* Changes in Emacs 24.4
391

392 393 394 395 396
** 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
397

398
*** Emacs preserves the ACL entries of files when backing up.
399

400 401 402
*** 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
403 404
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
405 406
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
407 408 409 410

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

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

416 417 418 419 420
** 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.
421

422
** Multi-monitor support
423 424 425 426 427

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

428 429 430
*** 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
431
as if they were on X.  To get information for each physical
432 433 434 435
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'.

436 437 438 439 440 441 442 443 444
** 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
445
You can change the default by customizing `blink-cursor-blinks'.
446

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

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

453
** Help
Glenn Morris's avatar
Glenn Morris committed
454

Chong Yidong's avatar
Chong Yidong committed
455
*** The command `apropos-variable' is renamed to `apropos-user-option'.
456
`apropos-user-option' shows all user options, while `apropos-variable'
Chong Yidong's avatar
Chong Yidong committed
457 458 459
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.
460

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

Glenn Morris's avatar
Glenn Morris committed
463
*** The command `describe-function' has been extended for EIEIO.
464
Running it on constructors will show a full description of the
David Engster's avatar
David Engster committed
465
generated class.  For generic functions, it will show all
466 467 468 469
implementations together with links to the source.  The old commands
`describe-class', `describe-constructor' and `describe-generic' were
removed.

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

Glenn Morris's avatar
Glenn Morris committed
473
** Frame and window handling
474

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

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

481 482 483 484
*** 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
485 486 487 488 489 490 491 492 493 494 495 496 497 498 499
*** 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.
500

501 502 503 504
*** The functions `window-body-height' and `window-body-width' now never
count partially visible lines or columns if called with a nil PIXELWISE
argument.

505 506 507 508 509 510 511 512 513 514
*** 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.

515 516 517
*** 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
518 519 520 521 522 523 524
`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.

525
*** `fit-window-to-buffer' can now resize windows in both dimensions.
526
This behavior is controlled by the new option
527
`fit-window-to-buffer-horizontally'.  The new option
528
`fit-frame-to-buffer' allows you to fit the window's frame to its buffer.
529

530 531
*** `fit-frame-to-buffer' now fits frames in both dimensions.  The new
options `fit-frame-to-buffer-margins' and `fit-frame-to-buffer-sizes'
532 533
control the size of the frame and its position on screen.

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

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

546 547 548
*** The functions `window-size' and `window-total-size' now have an
optional argument to return a rounded size value.

549
*** `window-state-put' now allows you to put a window state into internal
550 551
windows too.

Chong Yidong's avatar
Chong Yidong committed
552
*** New option `scroll-bar-adjust-thumb-portion'.
553 554
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
555 556
of the buffer is visible).

557
*** New display actions functions for `display-buffer':
558

559 560
**** `display-buffer-at-bottom' chooses or creates a window at the
bottom of the selected frame.
561

562
**** `display-buffer-no-window' to not display the buffer in a window.
Xue Fuqiao's avatar
Xue Fuqiao committed
563 564

*** New display action alist entry `allow-no-window' to indicate the
565 566
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
567

Glenn Morris's avatar
Glenn Morris committed
568 569 570
*** `display-buffer-in-previous-window' is now a member of
`display-buffer-fallback-action'.

Glenn Morris's avatar
Glenn Morris committed
571
** Lisp evaluation
572

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

Glenn Morris's avatar
Glenn Morris committed
576
*** The commands `eval-expression' (`M-:'), `eval-last-sexp' (`C-x C-e'),
577 578 579
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
580
`(eval-expression-)print-level' to nil.  Additionally, it causes integers
581
to be printed in other formats (octal, hexadecimal, and character).
Chong Yidong's avatar
Chong Yidong committed
582

583 584 585
*** New hook `eval-expression-minibuffer-setup-hook' run by
`eval-expression' on entering the minibuffer.

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

590 591
** `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
592

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

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

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

Chong Yidong's avatar
Chong Yidong committed
602 603 604

* Editing Changes in Emacs 24.4

Glenn Morris's avatar
Glenn Morris committed
605
** Indentation
Chong Yidong's avatar
Chong Yidong committed
606

607
*** `electric-indent-mode' is now enabled by default.
608 609 610
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 `{').
611

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

Chong Yidong's avatar
Chong Yidong committed
614 615 616 617 618
*** 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.
619

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

Glenn Morris's avatar
Glenn Morris committed
624
** Uniquify is enabled by default, with `post-forward-angle-brackets' style.
Glenn Morris's avatar
Glenn Morris committed
625 626 627 628
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
629 630 631

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

633 634 635 636 637 638
** 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.

639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655
** 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
656

657 658 659
*** 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.
660 661
Interactive commands that read registers and want to make use of this
should use `register-read-with-preview' to read register names.
662

Glenn Morris's avatar
Glenn Morris committed
663 664 665 666 667 668
*** 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.)

669 670
*** New command `C-x C-k x' (`kmacro-to-register') stores keyboard
macros in registers.
671

672

673
* Changes in Specialized Modes and Packages in Emacs 24.4
674

Chong Yidong's avatar
Chong Yidong committed
675
** Backtrace and debugger
676

Glenn Morris's avatar
Glenn Morris committed
677
*** New Lisp debugger command `v' (`debugger-toggle-locals') toggles the
678
display of local variables of the current stack frame.
Glenn Morris's avatar
Glenn Morris committed
679 680 681 682

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

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

686
** Battery information can now be retrieved from BSD's `apm' utility.
687

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

690 691 692 693 694 695 696 697
** 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
698 699
*** The new option `calc-gregorian-switch' lets you configure if
(and when) Calc switches from the Julian to the Gregorian calendar.
700

701 702
*** Support for ISO 8601 dates.

703 704 705 706 707 708 709 710 711 712 713 714
** 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
715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731
** 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++.
732
They are also displayed by the summarize feature in the mode line.
Chong Yidong's avatar
Chong Yidong committed
733 734 735 736

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

737 738
**** 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
739 740 741

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

742 743 744 745 746 747 748 749
** 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
750 751
** cl-lib

752
*** New macro `cl-tagbody'.
753
This executes statements while allowing for control transfer to labels.
Chong Yidong's avatar
Chong Yidong committed
754 755 756 757 758

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

** CUA mode

Chong Yidong's avatar
Chong Yidong committed
759
*** CUA mode now uses `delete-selection-mode' and `shift-select-mode'.
Glenn Morris's avatar
Glenn Morris committed
760 761
Hence, you can now enable it independently from those modes, and from
`transient-mark-mode'.
Chong Yidong's avatar
Chong Yidong committed
762 763 764

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

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

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

771 772
** Desktop

Glenn Morris's avatar
Glenn Morris committed
773 774 775
*** `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).
776

777 778 779 780
*** 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'.
781

782
** New Dired minor mode `dired-hide-details-mode' toggles whether details,
783 784 785
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.
786

Glenn Morris's avatar
Glenn Morris committed
787 788 789
** 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.
790

791 792
** Electric Pair mode

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

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

Glenn Morris's avatar
Glenn Morris committed
801
*** New option `electric-pair-delete-adjacent-pairs', enabled by default.
802 803 804 805
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
806
*** New option `electric-pair-open-newline-between-pairs', enabled by default.
807 808 809 810
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
811 812 813 814
*** 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'.
815 816 817

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

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

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

Glenn Morris's avatar
Glenn Morris committed
829
** New ERT macro `skip-unless' allows skipping ERT tests.
Chong Yidong's avatar
Chong Yidong committed
830 831 832

** Eshell

Glenn Morris's avatar
Glenn Morris committed
833
*** `eshell' now supports visual subcommands and options.
Chong Yidong's avatar
Chong Yidong committed
834 835 836 837 838 839 840
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
841
"git log" and "git <command> --help", which display their output in a
842
pager by default.  See `eshell-visual-subcommands' and `eshell-visual-options'.
Chong Yidong's avatar
Chong Yidong committed
843

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

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

850 851 852 853 854 855 856 857 858 859 860 861 862
** 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
863
** Icomplete is now more similar to Ido.
864

Glenn Morris's avatar
Glenn Morris committed
865 866 867 868
*** 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).
869

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

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

Glenn Morris's avatar
Glenn Morris committed
876 877 878 879
*** 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
880 881

** Ido
882

883
*** An Ido user manual is now included.
884

885 886 887
*** 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.
888

889 890
*** 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
891 892 893 894 895 896 897 898 899 900 901 902

** Image mode