Newer Older
GNU Emacs NEWS -- history of user-visible changes.

Paul Eggert's avatar
Paul Eggert committed
Copyright (C) 2017-2019 Free Software Foundation, Inc.
See the end of the file for license conditions.
Dave Love's avatar
Dave Love committed

6 7
Please send Emacs bug reports to ''.
If possible, use 'M-x report-emacs-bug'.

This file is about changes in Emacs version 27.

Paul Eggert's avatar
Paul Eggert committed
See file HISTORY for a list of GNU Emacs versions and release dates.
12 13
See files NEWS.26, NEWS.25, ..., NEWS.18, and NEWS.1-17 for changes
in older Emacs versions.

Paul Eggert's avatar
Paul Eggert committed
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'.

Temporary note:
+++ indicates that all relevant manuals in doc/ have been updated.
--- means no change in the manuals is needed.
21 22
When you add a new item, use the appropriate mark if you are sure it
applies, and please also update docstrings as needed.
Eli Zaretskii's avatar
Eli Zaretskii committed

Michael Albinus's avatar
Michael Albinus committed
* Installation Changes in Emacs 27.1
Paul Eggert's avatar
Paul Eggert committed

27 28 29
** Emacs now uses GMP, the GNU Multiple Precision library.
By default, if 'configure' does not find a suitable libgmp, it
arranges for the included mini-gmp library to be built and used.
The new 'configure' option '--without-libgmp' uses mini-gmp even if a
suitable libgmp is available.
Tom Tromey's avatar
Tom Tromey committed

33 34
** Emacs can now use HarfBuzz as its shaping engine.
The new configure option '--with-harfbuzz' adds support for the
Paul Eggert's avatar
Paul Eggert committed
HarfBuzz text shaping engine.  It is on by default; use './configure
36 37
--without-harfbuzz' to build without it.  The HarfBuzz text shaping is
available via new font backend drivers 'xfthb' and 'ftcrhb' for Xft
and Cairo drawings, respectively, and via the 'harfbuzz' backend on
39 40 41 42 43
MS-Windows.  The Harfbuzz text shaping is preferred to the previously
supported ones, so the font backends that use older shaping engines
(FLT on GNU and Unix systems and Uniscribe on MS-Windows) are not
enabled by default; they can be enabled via the 'font-backend' frame
parameter or via X resources.
Paul Eggert's avatar
Paul Eggert committed

** The new configure option '--with-json' adds support for JSON using
the Jansson library.  It is on by default; use './configure
47 48 49 50 51
--with-json=no' to build without Jansson support.  The new JSON
functions 'json-serialize', 'json-insert', 'json-parse-string', and
'json-parse-buffer' are typically much faster than their Lisp
counterparts from json.el.

Michael Albinus's avatar
Michael Albinus committed
** The configure option '--with-cairo' is no longer experimental.
53 54 55
This builds Emacs with Cairo drawing, and supports built-in printing
when Emacs is built with GTK+.

56 57 58 59
** Emacs no longer defaults to using ImageMagick to display images,
due to security and stability concerns.  To override the default, use
'configure --with-imagemagick'.

60 61
** Several configure options now accept an option-argument 'ifavailable'.
For example, './configure --with-xpm=ifavailable' now configures Emacs
62 63 64
to attempt to use libxpm but to continue building even if libxpm is
absent.  The other affected options are '--with-gif', '--with-gnutls',
'--with-jpeg', '--with-png', and '--with-tiff'.

Paul Eggert's avatar
Paul Eggert committed
66 67 68 69 70 71 72
** The etags program now uses the C library's regular expression matcher
when possible, and a compatible regex substitute otherwise.  This will
let developers maintain Emacs's own regex code without having to also
support other programs.  The new configure option '--without-included-regex'
forces etags to use the C library's regex matcher even if the regex
substitute ordinarily would be used to work around compatibility problems.

** Emacs has been ported to the '-fcheck-pointer-bounds' option of GCC.
74 75 76 77 78 79
This causes Emacs to check bounds of some arrays addressed by its
internal pointers, which can be helpful when debugging the Emacs
interpreter or modules that it uses.  If your platform supports it you
can enable it when configuring, e.g., './configure CFLAGS="-g3 -O2
-mmpx -fcheck-pointer-bounds"' on Intel MPX platforms.

80 81 82
** Emacs now normally uses a C pointer type instead of a C integer
type to implement Lisp_Object, which is the fundamental machine word
type internal to the Emacs Lisp interpreter.  This change aims to
83 84
catch typos and supports '-fcheck-pointer-bounds'.  The 'configure'
option '--enable-check-lisp-object-type' is therefore no longer as
85 86 87
useful and so is no longer enabled by default in developer builds,
to reduce differences between developer and production builds.

88 89 90 91 92 93 94 95 96 97 98 99 100
** Emacs now uses a "portable dumper" instead of unexec.
This improves compatibility with memory allocation on modern systems,
and in particular better supports the Address Space Layout
Randomization (ASLR) feature, a security technique used by most modern
operating systems.

When built with the portable dumping support (which is the default),
Emacs looks for the 'emacs.pdmp' file, generated during the build, in
its data directory at startup, and loads the dumped state from there.
The new command-line argument '--dump-file=FILE' allows to specify a
non-default '.pdmp' file to load the state from; see the node "Initial
Options" in the Emacs manual for more information.
Daniel Colascione's avatar
Daniel Colascione committed

An Emacs started via a dump file can create a new dump file only if it
Michael Albinus's avatar
Michael Albinus committed
was invoked with the '-batch' option.
104 105 106 107 108 109 110

Although the portable dumper has been tested, it may have a bug on
unusual platforms.  If you require traditional unexec dumping you can
use the configure-time option '--with-dumping=unexec'; however, please
file a bug report describing the situation, as unexec dumping is

Paul Eggert's avatar
Paul Eggert committed
111 112 113 114 115
** The new configure option '--enable-checking=structs' attempts to
check that the portable dumper code has been updated to match the last
change to one of the data structures that it relies on.

117 118 119
** The configure options '--enable-checking=conslist' and
'--enable-checking=xmallocoverrun' have been withdrawn.  The former
made Emacs irredeemably slow, and the latter made it crash.  Neither
120 121 122
option was useful with modern debugging tools such as AddressSanitizer.
(See etc/DEBUG for the details of using the modern replacements of the
removed configure options.)

124 125 126 127
** The distribution tarball now has test cases; 'make check' runs them.
This is intended mostly to help developers.

128 129 130 131
** Emacs now requires GTK 2.24 and GTK 3.10 for the GTK 2 and GTK 3
builds respectively.

Stefan Kangas's avatar
Stefan Kangas committed
132 133
** New make target 'help' shows a summary of common make targets.

* Startup Changes in Emacs 27.1

137 138
** Emacs now uses the XDG convention for init files.
139 140 141 142 143 144 145 146 147 148 149 150 151
For example, it looks for init.el in ~/.config/emacs/init.el, and
similarly for other init files.

The XDG_CONFIG_HOME environment variable (which defaults to ~/.config)
specifies the parent directory of these and other configuration files,
and will override their traditional locations (the home directory,
~/.emacs.d, etc.).

Emacs will still look for init files in their traditional locations if
XDG_CONFIG_HOME does not exist, so invoking Emacs with
XDG_CONFIG_HOME='/nowhere' might be useful if your new-location init
files are scrambled, or if you want to force Emacs to ignore files
under XDG_CONFIG_HOME for some other reason.

153 154 155 156 157 158 159 160 161
** Emacs can now be configured using an early init file.
The file is called 'early-init.el', in 'user-emacs-directory'.  It is
loaded very early in the startup process: before graphical elements
such as the tool bar are initialized, and before the package manager
is initialized.  The primary purpose is to allow customizing how the
package system is initialized given that initialization now happens
before loading the regular init file (see below).

162 163 164 165
We recommend against putting any customizations in this file that
don't need to be set up before initializing installed add-on packages,
because the early init file is read too early into the startup
process, and some important parts of the Emacs session, such as
'window-system' and other GUI features, are not yet set up, which could
167 168
make some customization fail to work.

** Installed packages are now activated *before* loading the init file.
171 172 173 174
This is part of a change intended to eliminate the behavior of
package.el inserting a call to 'package-initialize' into the init
file, which was previously done when Emacs was started.  As a result
of this change, it is no longer necessary to call 'package-initialize'
175 176
in your init file.

177 178 179 180 181 182 183 184
However, if your init file changes the values of 'package-load-list'
or 'package-user-dir', or sets 'package-enable-at-startup' to nil then
it won't work right without some adjustment:
- You can move that code to the early init file (see above), so those
  settings apply before Emacs tries to activate the packages.
- You can use the new 'package-quickstart' so activation of packages
  does not need to pay attention to 'package-load-list' or
  'package-user-dir' any more.

186 187 188 189 190
** Emacs now notifies systemd when startup finishes or shutdown begins.
Units that are ordered after 'emacs.service' will only be started
after Emacs has finished initialization and is ready for use.
(If your Emacs is installed in a non-standard location and you copied the
emacs.service file to eg "~/.config/systemd/user/", you will need to copy
192 193
the new version of the file again.)

* Changes in Emacs 27.1

197 198
** emacsclient

Michael Albinus's avatar
Michael Albinus committed
199 200 201
*** emacsclient no longer passes '--eval' arguments to an alternate editor.
Previously, '--eval' arguments were passed as file names to any
alternate editor started by '--alternate-editor'.

Glenn Morris's avatar
Glenn Morris committed
204 205 206
*** emacsclient now supports an 'EMACS_SOCKET_NAME' environment variable.
The command-line argument '--socket-name' overrides it.
(The same behavior as for the pre-existing 'EMACS_SERVER_FILE' variable.)

*** Emacs and emacsclient now default to "$XDG_RUNTIME_DIR/emacs"
as the directory for client/server sockets, if Emacs is running
under an X Window System desktop that sets the 'XDG_RUNTIME_DIR'
environment variable to indicate where session sockets should go.
To get the old, less-secure behavior, you can set the
'EMACS_SOCKET_NAME' environment variable to an appropriate value.

216 217 218 219
*** When run by root, emacsclient no longer connects to non-root sockets.
(Instead you can use Tramp methods to run root commands in a non-root Emacs.)

220 221 222
** New function 'network-lookup-address-info'.
This does IPv4 and/or IPv6 address lookups on hostnames.

223 224 225 226 227 228 229
** Control of the threshold for using the 'distant-foreground' color.
The threshold for color distance below which the 'distant-foreground'
color of the face will be used instead of the foreground color can now
be controlled via the new variable 'face-near-same-color-threshold'.
The default value is 30000, as the previously hard-coded threshold.

Tino Calancha's avatar
Tino Calancha committed
** The function 'read-passwd' uses "*" as default character to hide passwords.
Tino Calancha's avatar
Tino Calancha committed

233 234 235
** Lexical binding is now used when evaluating interactive Elisp forms.
More specifically, lexical-binding is now used for 'M-:', '--eval', as
well as in the "*scratch*" and "*ielm*" buffers.

237 238 239 240 241 242
** The new option 'tooltip-resize-echo-area' avoids truncating tooltip text
on GUI frames when tooltips are displayed in the echo area.  Instead,
it resizes the echo area as needed to accommodate the full tool-tip

** Show mode line tooltips only if the corresponding action applies.
245 246 247 248
Customize the option 'mode-line-default-help-echo' to restore the old
behavior where the tooltip text is also shown when the corresponding
action does not apply.

249 250 251 252 253 254 255 256 257
** New hook 'server-after-make-frame-hook'.
This hook is a convenient place to perform initializations in daemon
mode which require GUI features to be available.  One example is
restoration of the previous session using the desktop.el package: put
the call to 'desktop-read' in this hook, if you want the GUI settings
to be restored, or if desktop.el needs to interact with you during
restoration of the session.

258 259 260 261 262
** The functions 'set-frame-height' and 'set-frame-width' are now
commands, and will set the currently selected frame to the height/
width specified by the numeric prefix.

Mark Oteiza's avatar
Mark Oteiza committed
263 264 265
** New function 'logcount' calculates an integer's Hamming weight.

266 267 268 269 270 271 272 273
** New function 'libxml-available-p'.
This function returns non-nil if libxml support is both compiled in
and available at run time.  Lisp programs should use this function to
detect built-in libxml support, instead of testing for that
indirectly, e.g., by checking that functions like
'libxml-parse-html-region' return nil.

** 'libxml-parse-xml-region' and 'libxml-parse-html-region' take
276 277
a parameter that's called DISCARD-COMMENTS, but it really only
discards the top-level comment.  Therefore this parameter is now
obsolete, and the new utility function 'xml-remove-comments' can be
279 280 281
used to remove comments before calling the libxml functions to parse
the data.

282 283
** The Network Security Manager now allows more fine-grained control
of what checks to run via the 'network-security-protocol-checks'
285 286

288 289
** TLS connections have their security tightened by default.
Most of the checks for outdated, believed-to-be-weak TLS algorithms
Lars Ingebrigtsen's avatar
Lars Ingebrigtsen committed
290 291
and ciphers are now switched on by default.  (In addition, several new
TLS weaknesses are now warned about.)  By default, the NSM will
292 293 294 295 296 297
flag connections using these weak algorithms and ask users whether to
allow them.  To get the old behavior back (where certificates are
checked for validity, but no warnings about weak cryptography are
issued), you can either set 'network-security-protocol-checks' to nil,
or adjust the elements in that variable to only happen on the 'high'
security level (assuming you use the 'medium' level).

299 300 301 302 303 304 305 306
** New user option 'nsm-trust-local-network'.
Allows skipping Network Security Manager checks for hosts on your
local subnet(s).  It defaults to nil.  Usually, there should be no
need to set this non-nil, and doing that risks opening your local
network connections to attacks.  So be sure you know what you are
doing before changing the value.

307 308 309
** Native GnuTLS connections can now use client certificates.
Previously, this support was only available when using the external
'gnutls-cli' command.  Call 'open-network-stream' with
311 312 313
':client-certificate t' to trigger looking up of per-server
certificates via 'auth-source'.

314 315 316 317 318
** New function 'fill-polish-nobreak-p', to be used in 'fill-nobreak-predicate'.
It blocks line breaking after a one-letter word, also in the case when
this word is preceded by a non-space, but non-alphanumeric character.

319 320 321 322 323 324 325
** The limit on repetitions in regexps has been raised to 2^16-1.
It was previously limited to 2^15-1.  For example, the following
regular expression was previously invalid, but is now accepted:


326 327 328
** The German prefix and postfix input methods now support Capital sharp S.

** New input methods 'hawaiian-postfix' and 'hawaiian-prefix'.

332 333 334
** New input methods 'georgian-qwerty' and 'georgian-nuskhuri'.

335 336 337 338 339 340 341
** New input methods for several variants of the Sami language.
The Sami input methods include: 'norwegian-sami-prefix',
'bergsland-hasselbrink-sami-prefix', 'southern-sami-prefix',
'ume-sami-prefix', 'northern-sami-prefix', 'inari-sami-prefix',
'skolt-sami-prefix', and 'kildin-sami-prefix'.

342 343 344 345 346
** In Japanese environments that do not specify encodings and are not
based on MS-Windows, the default encoding is now utf-8 instead of

348 349 350 351
** New function 'exec-path'.
This function by default returns the value of the corresponding
variable, but can optionally return the equivalent of 'exec-path'
from a remote host.
352 353

354 355
** The function 'executable-find' supports an optional argument REMOTE.
This triggers to search the program on the remote host as indicated by
356 357

358 359 360 361 362
** New variable 'auto-save-no-message'.
When set to t, no message will be shown when auto-saving (default
value: nil).

363 364 365 366 367 368
** The value of 'make-cursor-line-fully-visible' can now be a function.
In addition to nil or non-nil, the value can now be a predicate
function.  Follow mode uses this to control scrolling of its windows
when the last screen line in a window is not fully visible.

369 370 371 372
** New variable 'emacs-repository-branch'.
It reports the git branch from which Emacs was built.

373 374
** New user option 'switch-to-buffer-obey-display-actions'.
375 376 377
When non-nil, 'switch-to-buffer' uses 'pop-to-buffer-same-window' that
respects display actions specified by 'display-buffer-alist' and

** New 'flex' completion style
An implementation of popular "flex/fuzzy/scatter" completion which
381 382 383 384
matches strings where the pattern appears as a subsequence.  Put
simply, makes "foo" complete to both "barfoo" and "frodo".  Add 'flex'
to 'completion-styles' or 'completion-category-overrides' to use it.

385 386 387 388 389 390 391 392
** Connection-local variables

*** Connection-local variables are applied by default like file-local
and directory-local variables.

*** The macro 'with-connection-local-variables' has been renamed from
'with-connection-local-profiles'.  No argument PROFILES needed any longer.

396 397
** New variable 'next-error-verbose' controls when 'next-error' outputs
a message about the error locus.
398 399

** New variable 'grep-search-path' defines the directories searched for
grep hits (this used to be controlled by 'compilation-search-path').
402 403

404 405 406
** New variable 'emacs-lisp-compilation-search-path' defines the
directories searched for byte-compiler error messages (this used to
be controlled by 'compilation-search-path').

408 409 410
** Multicolor fonts such as "Noto Color Emoji" can be displayed on
Emacs configured with Cairo drawing and linked with cairo >= 1.16.0.

412 413
** Emacs now optionally displays a fill column indicator.

This is similar to what 'fill-column-indicator' package provides, but
much faster and compatible with 'show-trailing-whitespace'.
416 417 418 419 420

Customize the buffer-local variables 'display-fill-column-indicator'
and 'display-fill-column-indicator-character' to activate the

The indicator is not displayed at all in minibuffer windows and
422 423 424
in tooltips, as it is not useful there.

There are 2 new buffer local variables and 1 face to customize this
mode they are described in the manual "(emacs) Display".

427 428 429
** 'progress-reporter-update' accepts a suffix string to display.

Stephen Leake's avatar
Stephen Leake committed
430 431 432
** New variable 'xref-file-name-display' controls the display of file
names in xref buffers.
Eli Zaretskii's avatar
Eli Zaretskii committed

434 435
** New customizable variable 'byte-count-to-string-function'.
It is used for displaying file sizes and disk space in some cases.

437 438 439 440 441 442
** Emacs now interprets RGB triplets like HTML, SVG, and CSS do.

The X convention previously used differed slightly, particularly for
RGB triplets with a single hexadecimal digit per component.

443 444 445
** The toolbar now shows the equivalent key binding in its tooltips.

* Editing Changes in Emacs 27.1

449 450 451 452 453
** The 'newline-and-indent' command (commonly bound to 'RET' in many
modes) now takes an optional numeric argument to specify how many
times is should insert newlines (and indent).

454 455 456
** New command 'make-empty-file'.

457 458 459 460 461
** New variable 'x-wait-for-event-timeout'.
This controls how long Emacs will wait for updates to the graphical
state to take effect (making a frame visible, for example).

463 464 465 466
** New user option 'electric-quote-replace-double'.
This option controls whether '"' is replaced in 'electric-quote-mode',
in addition to other quote characters.  If non-nil, ASCII double-quote
characters that quote text "like this" are replaced by double
467 468
typographic quotes, “like this”, in text modes, and in comments in
non-text modes.

470 471 472 473 474 475 476
** New user option 'flyspell-case-fold-duplications'.
This option controls whether Flyspell mode considers consecutive words
to be duplicates if they are not in the same case.  If non-nil, the
default, words are considered to be duplicates even if their letters'
case does not match.

477 478 479 480 481
** 'write-abbrev-file' now includes special properties.
'write-abbrev-file' now writes special properties like ':case-fixed'
for abbrevs that have them.

Allen Li's avatar
Allen Li committed
Allen Li's avatar
Allen Li committed
483 484 485
** 'write-abbrev-file' skips empty tables.
'write-abbrev-file' now skips inserting a 'define-abbrev-table' form for
tables which do not have any non-system abbrevs to save.
Allen Li's avatar
Allen Li committed

488 489
** The new functions and commands 'text-property-search-forward' and
'text-property-search-backward' have been added.  These provide an
interface that's more like functions like 'search-forward'.

Juri Linkov's avatar
Juri Linkov committed
492 493
** More commands support noncontiguous rectangular regions, namely
494 495
'upcase-dwim', 'downcase-dwim', 'replace-string', 'replace-regexp',
and 'delimit-columns-region'.
Juri Linkov's avatar
Juri Linkov committed

497 498 499 500 501 502 503
** When asked to visit a large file, Emacs now offers visiting it literally.
Previously, Emacs would only ask for confirmation before visiting
large files.  Now it also offers a third alternative: to visit the
file literally, as in 'find-file-literally', which speeds up
navigation and editing of large files.

505 506 507 508
** 'add-dir-local-variable' now uses dotted pair notation syntax to
write alists of variables to ".dir-locals.el".  This is the same
syntax that you can see in the example of a ".dir-locals.el" file in
the node "(emacs) Directory Variables" of the user manual.

** Network connections using 'local' can now use IPv6.
'make-network-process' now uses the correct loopback address when
asked to use ':host 'local' and ':family 'ipv6'.

** The new function 'replace-region-contents' replaces the current
region using a given replacement-function in a non-destructive manner
(in terms of 'replace-buffer-contents').
519 520

** The command 'replace-buffer-contents' now has two optional
522 523 524
arguments mitigating performance issues when operating on huge

526 527 528 529
** The command 'delete-indentation' now operates on the active region.
If the region is active, the command joins all the lines in the
region.  When there's no active region, the command works on the
current and the previous or the next line, as before.

Michael Albinus's avatar
Michael Albinus committed
* Changes in Specialized Modes and Packages in Emacs 27.1

534 535 536 537
** 'autoconf-mode' is now used instead of 'm4-mode' for the
acinclude.m4/aclocal.m4/acsite.m4 files.

Lars Ingebrigtsen's avatar
Lars Ingebrigtsen committed
539 540
** On GNU/Linux, 'M-x battery' will now list all batteries, no matter
what they're named, and the 'battery-linux-sysfs-regexp' variable has
541 542
been removed.

543 544 545
** The 'list-processes' command now includes port numbers in the
network connection information (in addition to the host name).

Lars Ingebrigtsen's avatar
Lars Ingebrigtsen committed
** The 'cl' package is now officially deprecated in favor of 'cl-lib'.
Stefan Monnier's avatar
Stefan Monnier committed

548 549
** winner
Michael Albinus's avatar
Michael Albinus committed
*** A new variable, 'winner-boring-buffers-regexp', has been added.

** table
Michael Albinus's avatar
Michael Albinus committed
** 'table-generate-source' and friends now support outputting wiki and
554 555
mediawiki format tables.

556 557
** telnet-mode
Michael Albinus's avatar
Michael Albinus committed
*** Reverting a buffer in 'telnet-mode' will restart a closed connection.

Phil Sainty's avatar
Phil Sainty committed
560 561 562
** goto-addr
*** A way to more conveniently specify what URI address schemes that
should be ignored have been added via the
Michael Albinus's avatar
Michael Albinus committed
'goto-address-uri-schemes-ignored' variable.
Phil Sainty's avatar
Phil Sainty committed

** tex-mode
*** 'latex-noindent-commands' controls indentation of certain commands.
You can use this new variable to control indentation of arguments of
\emph, \footnote, and similar commands.

** byte compiler
Michael Albinus's avatar
Michael Albinus committed
*** 'byte-compile-dynamic' is now obsolete.
573 574 575 576
This is because on the one hand it suffers from various misbehaviors in corner
cases that have plagued it for years, and on the other experiments indicated
that it doesn't bring any measurable benefit.

577 578
** compile.el
579 580
*** In 'compilation-error-regexp-alist', 'line' (and 'end-line') can
be functions.
581 582 583 584 585
*** 'compilation-context-lines' can now take the value t; this is like
nil, but instead of scrolling the current line to the top of the
screen when there is no left fringe, it inserts a visible arrow before
column zero.

** cl-lib.el
589 590
*** 'cl-defstruct' has a new ':noinline' argument to prevent inlining
its functions.

*** 'cl-defstruct' slots accept a ':documentation' property

Michael Albinus's avatar
Michael Albinus committed
*** 'cl-values-list' will now signal an error if its argument isn't a list.

598 599
** doc-view.el
*** New commands 'doc-view-presentation' and 'doc-view-fit-window-to-page'.
*** Added support for password-protected PDF files

602 603 604 605 606
** Ido
*** New user option 'ido-big-directories' to mark directories whose
names match certain regular expressions as big.  Ido won't attempt to
list the contents of such directories when completing file names.

607 608 609 610 611 612
** Minibuffer

*** Minibuffer now uses 'minibuffer-message' to display error messages
at the end of the active minibuffer.

** map.el
614 615
*** Now also understands plists.
*** Now defined via generic functions that can be extended via 'cl-defmethod'.
*** Deprecate the 'map-put' macro in favor of a new 'map-put!' function.
*** 'map-contains-key' now returns a boolean rather than the key.
*** Deprecate the 'testfn' args of 'map-elt' and 'map-contains-key'.
*** New generic function 'map-insert'.

621 622 623 624 625
** seq.el
New convenience functions 'seq-first' and 'seq-rest' give easy access
to respectively the first and all but the first elements of sequences.

626 627 628
The new predicate function 'seq-contains-p' should be used instead of
the now obsolete 'seq-contains'.

629 630 631 632
** Follow mode
In the current follow group of windows, "ghost" cursors are no longer
displayed in the non-selected follow windows.  To get the old behavior
back, customize 'follow-hide-ghost-cursors' to nil.

635 636 637
** New variable 'warning-fill-column' for 'display-warning'.

638 639
** Windmove

640 641 642
*** 'windmove-create-window' when non-nil makes a new window on moving off
the edge of the frame.

*** Windmove supports directional window display and selection.
644 645
The new command 'windmove-display-default-keybindings' binds default
keys with provided modifiers (by default, Shift-Meta) to the commands
that display the next buffer in the window at the specified direction.
This is like 'windmove-default-keybindings' that binds keys to commands
648 649
that select the window in the specified direction, but additionally it
displays the buffer from the next command in that window.  For example,
'S-M-right C-h i' displays the "*Info*" buffer in the right window,
651 652
creating the window if necessary.  A special key can be customized to
display the buffer in the same window, for example, 'S-M-0 C-h e'
displays the "*Messages*" buffer in the same window.

655 656
*** Windmove also supports directional window deletion.
The new command 'windmove-delete-default-keybindings' binds default
657 658
keys with provided prefix (by default, 'C-x') and modifiers (by default,
'Shift') to the commands that delete the window in the specified
direction.  For example, 'C-x S-down' deletes the window below.
With a prefix arg 'C-u', also kills the buffer in that window.
With 'M-0', deletes the selected window and selects the window
that was in the specified direction.

664 665 666 667
*** New command 'windmove-swap-states-in-direction' binds default keys
to the commands that swap the states of the selected window with the
window in the specified direction.

668 669 670 671
** Octave mode
The mode is automatically enabled in files that start with the
'function' keyword.

Stefan Monnier's avatar
Stefan Monnier committed
** project.el

*** New commands 'project-search' and 'project-query-replace-regexp'.
Stefan Monnier's avatar
Stefan Monnier committed

676 677
*** New customizable variable 'project-read-file-name-function'.

Stefan Monnier's avatar
Stefan Monnier committed
** Etags

Stefan Monnier's avatar
Stefan Monnier committed
681 682 683
*** 'next-file' is now an obsolete alias of 'tags-next-file'.

*** 'tags-loop-revert-buffers' is an obsolete alias of
685 686 687

*** The 'tags-loop-continue' function along with the
'tags-loop-operate' and 'tags-loop-scan' variables are now obsolete;
use the new 'fileloop-initialize' and 'fileloop-continue' functions
Stefan Monnier's avatar
Stefan Monnier committed

691 692 693
*** etags is now able to read Zstandard-compressed files.

** bibtex
695 696

*** New commands 'bibtex-next-entry' and 'bibtex-previous-entry'.
In 'bibtex-mode-map', 'forward-paragraph' and 'backward-paragraph' are
699 700
remapped to these, respectively.

701 702
** Dired

704 705
*** New command 'dired-create-empty-file'.

Michael Albinus's avatar
Michael Albinus committed
707 708
*** New command and keystroke 'dired-number-of-marked-files' bound to
'* N'.

710 711 712
*** The marking commands now report how many files were marked by the
command itself, not how many files are marked in total.

*** A new face, 'dired-special', is used to highlight sockets, named
715 716
pipes, block devices and character devices.

717 718 719 720 721
** Find-Dired

*** New customizable variable 'find-dired-refine-function'.
The default value is 'find-dired-sort-by-filename'.

722 723
*** New sorting options for the variable 'find-ls-option'.

724 725 726 727
*** Zstandard compression is now supported for 'dired-do-compress' and

728 729
** Change Logs and VC

*** New command 'log-edit-generate-changelog-from-diff', bound to C-c C-w.
732 733
This generates ChangeLog entries from the VC fileset diff.

Eli Zaretskii's avatar
Eli Zaretskii committed
734 735 736 737 738 739 740 741
*** Recording ChangeLog entries doesn't require an actual file.
If a ChangeLog file doesn't exist, and if the new variable
'add-log-dont-create-changelog-file' is non-nil (which is the
default), commands such as 'C-x 4 a' will add log entries to a
suitable named temporary buffer.  (An existing ChangeLog file will
still be used if it exists.)  Set the variable to nil to get the
previous behavior of always creating a buffer that visits a ChangeLog

743 744 745
*** New customizable variable 'vc-find-revision-no-save'.
With non-nil, 'vc-find-revision' doesn't write the created buffer to file.

746 747 748 749
*** 'vc-dir-ignore' now takes a prefix argument to ignore all marked

750 751
*** New customizable variable 'vc-git-grep-template'.
This new variable allows customizing the default arguments passed to
'git-grep' when 'vc-git-grep' is used.

*** Command 'vc-git-stash' now respects marks in the "*vc-dir*" buffer.
755 756 757
When some files are marked, only those are stashed.
When no files are marked, all modified files are stashed, as before.

758 759
*** The new hook 'vc-retrieve-tag-hook' runs after retrieving a tag.

Eli Zaretskii's avatar
Eli Zaretskii committed
760 761 762
*** 'vc-hg' now invokes 'smerge-mode' when visiting files.
Code that attempted to invoke 'smerge-mode' when visiting an Hg file
763 764 765 766
with conflicts existed in earlier versions of Emacs, but incorrectly
never detected a conflict due to invalid assumptions about cached

767 768 769 770
*** 'C-u C-x v D' ('vc-root-version-diff') prompts for two revisions
and compares their entire trees.

Ian Dunn's avatar
Ian Dunn committed
*** New user option 'vc-hg-revert-switches' specifies switches to pass
to Hg revert.
Ian Dunn's avatar
Ian Dunn committed

774 775 776 777
*** 'C-x v M D' ('vc-diff-mergebase') and 'C-x v M L' ('vc-log-mergebase')
print diffs and logs between the merge base (common ancestor) of two
given revisions.

Michael Albinus's avatar
Michael Albinus committed
*** The new 'd' command ('vc-dir-clean-files') in 'vc-dir-mode'
780 781 782 783
buffers will delete the marked files (or if no files are marked, the
file under point).  This command does not notify the VC backend, and
is mostly useful for unregistered files.

784 785
*** New command 'vc-log-search' asks for a pattern, searches it
in the revision log, and displays matched log entries in the
786 787 788 789 790 791
log buffer.  For example, 'M-x vc-log-search RET bug#36644 RET'
displays all entries whose log messages match the bug number.
With a prefix argument asks for a command, so for example,
'C-u M-x vc-log-search RET git log -1 f302475 RET' will display
just one log entry found by its revision number.

792 793 794 795
*** 'C-x v =' can now mimic Magit's diff format.
Set the new user option 'diff-font-lock-prettify' to t for that, see
below under "Diff mode".

** Diff mode
797 798
*** Hunks are now automatically refined by font-lock.
To disable refinement, set the new user option 'diff-refine' to nil.
800 801
To get back the old behavior where hunks are refined as you navigate
through a diff, set 'diff-refine' to the symbol 'navigate'.

803 804 805 806
*** 'diff-auto-refine-mode' is deprecated in favor of 'diff-refine'.
It is no longer enabled by default and binding it no longer has any

808 809 810 811 812 813
*** Better syntax highlighting of Diff hunks.
Fragments of source in Diff hunks are now by default highlighted
according to the appropriate major mode.  Customize the new option
'diff-font-lock-syntax' to nil to disable this.

*** File headers can be shortened, mimicking Magit's diff format.
To enable it, set the new user option 'diff-font-lock-prettify' to t.
816 817
On GUI frames, this option also displays the insertion and deletion
indicators on the left fringe.

820 821 822 823
*** Prefix arg of 'diff-goto-source' means jump to the old revision
of the file under version control if point is on an old changed line,
or to the new revision of the file otherwise.

824 825 826
** Texinfo

*** New function for inserting '@pxref', '@xref', or '@ref' commands.
828 829
The function 'texinfo-insert-dwim-@ref', bound to 'C-c C-c r' by
default, inserts one of three types of references based on the text
830 831
surrounding point, namely '@pxref' near a parenthesis, '@xref' at the
start of a sentence or at '(point-min)', else '@ref'.

** Browse-url

835 836 837 838
*** The function 'browse-url-emacs' can now visit a URL in selected window.
It now treats the optional 2nd argument to mean that the URL should be
shown in the currently selected window.

839 840 841 842 843
*** A new function, 'browse-url-add-buttons' can be used to add clickable
links to most ordinary special-mode buffers that display text that
have URLs embedded.  'browse-url-button-regexp' controls what's
considered a button.

*** A new variable, 'browse-url-secondary-browser-function', has been added.
** Comint

*** 'send-invisible' is now an obsolete alias for 'comint-send-invisible'.
849 850
Also, 'shell-strip-ctrl-m' is declared obsolete.

*** 'C-c .' ('comint-insert-previous-argument') no longer interprets '&'.
853 854 855 856 857 858 859 860 861 862 863 864 865 866
This feature caused problems when '&&' was present in the previous
command.  Since this command emulates 'M-.' in Bash and zsh, neither
of which treats '&' specially, the feature was removed for
compatibility with these shells.

*** 'comint-insert-previous-argument' can now count arguments from the end.
By default, invoking 'C-c .' with a numeric argument N would copy the
Nth argument, counting from the first one.  But if the new option
'comint-insert-previous-argument-from-end' is non-nil, it will copy
the Nth argument counting from the last one.  Thus 'C-c .' can now
better emulate 'M-.' in both Bash and zsh, since the former counts
from the beginning of the arguments, while the latter counts from the

868 869 870 871
*** 'comint-run' can now accept a list of switches to pass to the program.
'C-u M-x comint-run' will prompt for the switches interactively.

872 873
** SQL

874 875 876 877 878 879 880 881 882 883 884 885 886
*** SQL Indent Minor Mode
SQL Mode now supports the ELPA 'sql-indent' package for assisting
sophisticated SQL indenting rules.  Note, however, that SQL is not
like other programming languages like C, Java, or Python where code is
sparse and rules for formatting are fairly well established. Instead
SQL is more like COBOL (from which it came) and code tends to be very
dense and line ending decisions driven by syntax and line length
considerations to make readable code.  Experienced SQL developers may
prefer to rely upon existing Emacs facilities for formatting code but
the 'sql-indent' package provides facilities to aid more casual SQL
developers layout queries and complex expressions.

**** 'sql-use-indent-support' (default t) enables SQL indention support.
The 'sql-indent' package from ELPA must be installed to get the
888 889
indentation support in 'sql-mode' and 'sql-interactive-mode'.

**** 'sql-mode-hook' and 'sql-interactive-mode-hook' changed.
Both hook variables have had 'sql-indent-enable' added to their
default values. If you have existing customizations to these variables,
893 894
you should make sure that the new default entry is included.

895 896 897 898 899 900 901 902 903 904
*** Connection Wallet
Database passwords can now by stored in NETRC or JSON data files that
may optionally be encrypted. When establishing an interactive session
with the database via 'sql-connect' or a product specific function,
like 'sql-mysql' or 'my-postgres', the password wallet will be
searched for the password. The 'sql-product', 'sql-server',
'sql-database', and the 'sql-username' will be used to identify the
appropriate authorization. This eliminates the discouraged practice of
embedding database passwords in your Emacs initialization.

See the 'auth-source' module for complete documentation on the file
formats.  By default, the wallet file is expected to be in the
'user-emacs-directory', named 'sql-wallet' or '.sql-wallet', with
908 909 910
'.json' (JSON) or no (NETRC) suffix.  Both file formats can optionally
be encrypted with GPG by adding an additional '.gpg' suffix.

911 912 913 914 915
** Term

*** 'term-read-noecho' is now obsolete, use 'read-passwd' instead.

Michael Albinus's avatar
Michael Albinus committed
*** 'serial-term' now takes an optional parameter to leave the
918 919
emulator in line mode.

920 921 922
** Flymake

*** The variable 'flymake-diagnostic-types-alist' is obsolete.
924 925 926
You should instead set properties on known diagnostic symbols, like
':error' and ':warning', as demonstrated in the Flymake manual.

*** New customizable variable 'flymake-start-on-save-buffer'.
928 929
Control whether Flymake starts checking the buffer on save.

*** Flymake and backend functions may exchange hints about buffer changes.
931 932 933
This enables more efficient backends.  See the docstring of
'flymake-diagnostic-functions' or the Flymake manual for details.

935 936
*** 'flymake-start-syntax-check-on-newline' is now obsolete,
use 'post-self-insert-hook' to check on newline.

Dmitry Gutov's avatar
Dmitry Gutov committed
938 939 940 941 942
** Ruby

*** The Rubocop Flymake diagnostic function will only run Lint cops if
it can't find the config file.

943 944
*** Rubocop is called with 'bundle exec' if Gemfile mentions it.

945 946
*** New command 'ruby-find-library-file' bound to 'C-c C-f'.

** Package

949 950 951 952 953 954
*** Change of 'package-check-signature' for packages with multiple sigs
In previous Emacsen, 't' checked that all signatures are valid.
Now 't' only checks that at least one signature is valid and the new 'all'
value needs to be used if you want to enforce that all signatures
are valid.  This only affects packages with multiple signatures.

Michael Albinus's avatar
Michael Albinus committed
*** The meaning of 'allow-unsigned' in 'package-check-signature' has
957 958 959 960
changed slightly: If a usable OpenPGP configuration can't be found
(for instance, if gpg isn't installed), it now has the same meaning as

*** New function 'package-get-version' lets packages query their own version.
Example use in auctex.el: '(defconst auctex-version (package-get-version))'

*** New 'package-quickstart' feature.
965 966 967 968 969 970 971
When 'package-quickstart' is non-nil, package.el precomputes a big
autoloads file so that activation of packages can be done much faster,
which can speed up your startup significantly.
It also causes variables like 'package-user-dir' and
'package-load-list' to be consulted when 'package-quickstart-refresh'
is run rather than at startup so you don't need to set them in your
early init file.
972 973 974

*** New function 'package-activate-all'.

Michael Albinus's avatar
Michael Albinus committed
*** Imenu support has been added to 'package-menu-mode'.

978 979
** Info

980 981 982 983 984
*** Clicking on the left/right arrow icon in the Info tool-bar while
holding down the Ctrl key pops up a menu of previously visited Info nodes
where you can select a node to go back (like in browsers).

985 986 987 988 989 990 991
*** Info can now follow 'file://' protocol URLs.
The 'file://' URLs in Info documents can now be followed by passing
them to the 'browse-url' function, like the other protocols: ftp,
http, and https.  This allows to have references to local HTML files,
for example.

992 993 994 995 996 997 998
** Xref

*** New command 'xref-find-definitions-at-mouse'.
This command finds definitions of the identifier at the place of a
mouse click event, and is intended to be bound to a mouse event.

999 1000 1001 1002 1003
*** Changing 'xref-marker-ring-length' works after 'xref.el' is loaded.
Previously, setting 'xref-marker-ring-length' would only take effect
if set before 'xref.el' was loaded.

1005 1006
*** 'xref-find-definitions' now sets the mark at the buffer position
where it was invoked.