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

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

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

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

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

Paul Eggert's avatar
Paul Eggert committed
15
You can narrow news to a specific version by calling 'view-emacs-news'
16
with a prefix argument or by typing 'C-u C-h C-n'.
17

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

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

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.
30
The new 'configure' option '--without-libgmp' uses mini-gmp even if a
31
suitable libgmp is available.
Tom Tromey's avatar
Tom Tromey committed
32

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
35
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
38
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
44

45
** The new configure option '--with-json' adds support for JSON using
46
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.

52 53 54 55
** The configure option --with-cairo is no longer experimental.
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'.
65

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.

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

Portable dumping can be disabled at configure time via the configure
96 97 98
option '--with-dumping=unexec' (but we don't recommend that, unless
the portable dumping doesn't work on your system for some
reason---please report such systems to the Emacs developers as bugs).
99 100 101 102 103 104 105

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
106

Paul Eggert's avatar
Paul Eggert committed
107 108 109 110 111
+++
** 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.

112
+++
113 114 115
** 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
116 117 118
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.)
119

120 121 122 123
+++
** The distribution tarball now has test cases; 'make check' runs them.
This is intended mostly to help developers.

124 125 126 127
---
** Emacs now requires GTK 2.24 and GTK 3.10 for the GTK 2 and GTK 3
builds respectively.

128 129 130
---
** The toolbar now shows the equivalent key binding in its tooltips.

131

132
* Startup Changes in Emacs 27.1
133

134 135 136 137 138 139 140 141 142
+++
** 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).

143 144 145 146
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
147
'window-system' and other GUI features, are not yet set up, which could
148 149
make some customization fail to work.

150
+++
151
** Installed packages are now activated *before* loading the init file.
152 153 154 155
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'
156 157
in your init file.

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

167 168 169 170 171
---
** 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
172
emacs.service file to eg "~/.config/systemd/user/", you will need to copy
173 174
the new version of the file again.)

175 176 177 178 179 180
+++
** New option 'help-enable-completion-auto-load'.
This allows disabling the new feature introduced in Emacs 26.1 which
loads files during completion of 'C-h f' and 'C-h v' according to
'definition-prefixes'.

181

182
* Changes in Emacs 27.1
183

184 185
** emacsclient

186 187 188 189 190 191
*** Previously, when an alternate editor is started
(--alternate-editor/-a), and there was an --eval switch, these
parameters were used as file names for the alternate editor.
emacsclient will now instead start the alternate editor without these
parameters.

192
+++
193
*** emacsclient now supports the 'EMACS_SOCKET_NAME' environment variable.
Eli Zaretskii's avatar
Eli Zaretskii committed
194 195
The behavior is identical to 'EMACS_SERVER_FILE', in that the
command-line value specified via '--socket-name' will override the
196
environment, and the natural default to 'TMPDIR', then "/tmp", continues
Eli Zaretskii's avatar
Eli Zaretskii committed
197
to apply.
198

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

207 208 209 210
---
*** 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.)

211 212 213 214 215 216 217
---
** 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
218
+++
219
** The function 'read-passwd' uses "*" as default character to hide passwords.
Tino Calancha's avatar
Tino Calancha committed
220

221 222 223
** 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.
224

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

231
---
232
** Show mode line tooltips only if the corresponding action applies.
233 234 235 236
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.

237 238 239 240 241 242 243 244 245
+++
** 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.

Mark Oteiza's avatar
Mark Oteiza committed
246 247 248
+++
** New function 'logcount' calculates an integer's Hamming weight.

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

257
+++
258
** 'libxml-parse-xml-region' and 'libxml-parse-html-region' take
259 260
a parameter that's called DISCARD-COMMENTS, but it really only
discards the top-level comment.  Therefore this parameter is now
261
obsolete, and the new utility function 'xml-remove-comments' can be
262 263 264
used to remove comments before calling the libxml functions to parse
the data.

265 266
+++
** The Network Security Manager now allows more fine-grained control
267
of what checks to run via the 'network-security-protocol-checks'
268 269
variable.

270
+++
271 272 273 274 275 276 277 278 279
** TLS connections have their security tightened by default.
Most of the checks for outdated, believed-to-be-weak TLS algorithms
and ciphers are now switched on by default.  By default, the NSM will
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).
280

281 282 283
+++
** Native GnuTLS connections can now use client certificates.
Previously, this support was only available when using the external
284
'gnutls-cli' command.  Call 'open-network-stream' with
285 286 287
':client-certificate t' to trigger looking up of per-server
certificates via 'auth-source'.

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

293 294 295 296 297 298 299
+++
** 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:

   x\{32768\}

300 301 302
---
** The German prefix and postfix input methods now support Capital sharp S.

303
---
304
** New input methods 'hawaiian-postfix' and 'hawaiian-prefix'.
305

306 307 308 309 310 311 312
---
** 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'.

313 314 315 316 317
+++
** In Japanese environments that do not specify encodings and are not
based on MS-Windows, the default encoding is now utf-8 instead of
japanese-iso-8bit.

318
+++
319 320 321 322
** 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.
323 324

+++
325 326
** The function 'executable-find' supports an optional argument REMOTE.
This triggers to search the program on the remote host as indicated by
327 328
'default-directory'.

329 330 331 332 333
+++
** New variable 'auto-save-no-message'.
When set to t, no message will be shown when auto-saving (default
value: nil).

334 335 336 337 338 339
---
** 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.

340 341 342 343
+++
** New variable 'emacs-repository-branch'.
It reports the git branch from which Emacs was built.

344 345
+++
** New user option 'switch-to-buffer-obey-display-actions'.
346 347 348
When non-nil, 'switch-to-buffer' uses 'pop-to-buffer-same-window' that
respects display actions specified by 'display-buffer-alist' and
'display-buffer-overriding-action'.
349

350 351 352 353 354 355
** New 'flex' completion style
An implementation of popular "flx/fuzzy/scatter" completion which
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.

356 357 358 359 360 361 362 363
** 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
364
'with-connection-local-profiles'.  No argument PROFILES needed any longer.
365

366
---
367 368
** New variable 'next-error-verbose' controls when 'next-error' outputs
a message about the error locus.
369 370

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

---
375 376 377
** 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').
378

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

382
+++
383 384
** Emacs now optionally displays a fill column indicator.

385
This is similar to what 'fill-column-indicator' package provides, but
386
much faster and compatible with 'show-trailing-whitespace'.
387 388 389 390 391

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

392
The indicator is not displayed at all in minibuffer windows and
393 394 395
in tooltips, as it is not useful there.

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

398 399 400 401
+++
** 'progress-reporter-update' accepts a suffix string to display.


402

403
* Editing Changes in Emacs 27.1
404

405 406 407
+++
** New command 'make-empty-file'.

408 409 410 411 412
---
** 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).

413
+++
414 415 416 417
** 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
418 419
typographic quotes, “like this”, in text modes, and in comments in
non-text modes.
420

421 422 423 424 425 426 427
---
** 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.

428 429 430 431 432
---
** '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
433
+++
Allen Li's avatar
Allen Li committed
434 435 436
** '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
437

438
+++
439 440
** The new functions and commands 'text-property-search-forward' and
'text-property-search-backward' have been added.  These provide an
441
interface that's more like functions like 'search-forward'.
442

Juri Linkov's avatar
Juri Linkov committed
443 444
---
** More commands support noncontiguous rectangular regions, namely
445 446
'upcase-dwim', 'downcase-dwim', 'replace-string', 'replace-regexp',
and 'delimit-columns-region'.
Juri Linkov's avatar
Juri Linkov committed
447

448 449 450 451 452 453 454
+++
** 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.

455
---
456 457 458 459
** '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.
460

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

466
+++
467
** The new function 'replace-region-contents' replaces the current
468
region using a given replacement-function in a non-destructive manner
469
(in terms of 'replace-buffer-contents').
470 471

+++
472
** The command 'replace-buffer-contents' now has two optional
473 474 475
arguments mitigating performance issues when operating on huge
buffers.

476
+++
477 478 479 480
** 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.
481

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

485 486 487 488
+++
** winner
*** A new variable, `winner-boring-buffers-regexp', has been added.

489 490 491 492
** table
** `table-generate-source' and friends now support outputting wiki and
mediawiki format tables.

493 494 495 496 497
---
** telnet-mode
*** Reverting a buffer in `telnet-mode' will restart a closed
connection.

Phil Sainty's avatar
Phil Sainty committed
498 499 500 501 502
** goto-addr
*** A way to more conveniently specify what URI address schemes that
should be ignored have been added via the
`goto-address-uri-schemes-ignored' variable.

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

509 510 511 512 513 514
** byte compiler
*** byte-compile-dynamic is now obsolete
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.

515 516
** compile.el
---
517 518
*** In 'compilation-error-regexp-alist', 'line' (and 'end-line') can
be functions.
519

520
** cl-lib.el
521
+++
522 523
*** 'cl-defstruct' has a new ':noinline' argument to prevent inlining
its functions.
524

525 526
** doc-view.el
*** New commands 'doc-view-presentation' and 'doc-view-fit-window-to-page'.
527
*** Added support for password-protected PDF files
528

529 530 531 532 533
** 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.

534 535 536 537 538 539
** Minibuffer

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

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

548 549 550 551 552
+++
** 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.

553 554 555
The new predicate function 'seq-contains-p' should be used instead of
the now obsolete 'seq-contains'.

556 557 558 559
---
** 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
560
back, customize 'follow-hide-ghost-cursors' to nil.
561

562 563 564
+++
** New variable 'warning-fill-column' for 'display-warning'.

565 566
** Windmove

567 568 569
*** 'windmove-create-window' when non-nil makes a new window on moving off
the edge of the frame.

570
*** Windmove supports directional window display and selection.
571 572
The new command 'windmove-display-default-keybindings' binds default
keys with provided modifiers (by default, Shift-Meta) to the commands
573
that display the next buffer in the window at the specified direction.
574
This is like 'windmove-default-keybindings' that binds keys to commands
575 576
that select the window in the specified direction, but additionally it
displays the buffer from the next command in that window.  For example,
577
'S-M-right C-h i' displays the "*Info*" buffer in the right window,
578 579
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'
580
displays the "*Messages*" buffer in the same window.
581

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

591 592 593 594
*** 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.

595 596 597 598
** Octave mode
The mode is automatically enabled in files that start with the
'function' keyword.

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

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

603 604
*** New customizable variable 'project-read-file-name-function'.

Stefan Monnier's avatar
Stefan Monnier committed
605
** Etags
606

Stefan Monnier's avatar
Stefan Monnier committed
607
+++
608 609 610
*** 'next-file' is now an obsolete alias of 'tags-next-file'.

*** 'tags-loop-revert-buffers' is an obsolete alias of
611
'fileloop-revert-buffers'.
612 613 614

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

618 619 620
+++
*** etags is now able to read Zstandard-compressed files.

621
** bibtex
622 623

---
624
*** New commands 'bibtex-next-entry' and 'bibtex-previous-entry'.
625
In 'bibtex-mode-map', 'forward-paragraph' and 'backward-paragraph' are
626 627
remapped to these, respectively.

628 629
** Dired

630
+++
631 632
*** New command 'dired-create-empty-file'.

633 634 635 636
+++
*** New command and keystroke `dired-number-of-marked-files' bound to
`* N'.

637 638 639
*** The marking commands now report how many files were marked by the
command itself, not how many files are marked in total.

640 641 642 643 644
** Find-Dired

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

645 646
*** New sorting options for the variable 'find-ls-option'.

647 648 649 650
---
*** Zstandard compression is now supported for 'dired-do-compress' and
'dired-do-compress-to'.

651 652
** Change Logs and VC

Eli Zaretskii's avatar
Eli Zaretskii committed
653 654 655 656 657 658 659 660
*** 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
file.
661

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

665 666
*** New customizable variable 'vc-git-grep-template'.
This new variable allows customizing the default arguments passed to
667
'git-grep' when 'vc-git-grep' is used.
668

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

673 674
*** The new hook 'vc-retrieve-tag-hook' runs after retrieving a tag.

Eli Zaretskii's avatar
Eli Zaretskii committed
675 676 677
---
*** 'vc-hg' now invokes 'smerge-mode' when visiting files.
Code that attempted to invoke 'smerge-mode' when visiting an Hg file
678 679 680 681
with conflicts existed in earlier versions of Emacs, but incorrectly
never detected a conflict due to invalid assumptions about cached
values.

682 683 684 685
+++
*** '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
686
*** New user option 'vc-hg-revert-switches' specifies switches to pass
687
to Hg revert.
Ian Dunn's avatar
Ian Dunn committed
688

689 690 691 692
*** '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.

693
** Diff mode
694 695
+++
*** Hunks are now automatically refined by font-lock.
696
To disable refinement, set the new user option 'diff-refine' to nil.
697 698
To get back the old behavior where hunks are refined as you navigate
through a diff, set 'diff-refine' to the symbol 'navigate'.
699

700 701 702 703
+++
*** '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
effect.
704

705 706 707 708 709 710
+++
*** 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.

711
*** File headers can be shortened, mimicking Magit's diff format.
712
To enable it, set the new user option 'diff-font-lock-prettify' to t.
713

714
+++
715 716 717 718
*** 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.

719 720 721
** Texinfo

+++
722
*** New function for inserting '@pxref', '@xref', or '@ref' commands.
723 724
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
725 726
surrounding point, namely '@pxref' near a parenthesis, '@xref' at the
start of a sentence or at '(point-min)', else '@ref'.
727

728
** Browse-url
729

730 731 732 733
*** 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.

734
** Comint
735

736
+++
737
*** 'send-invisible' is now an obsolete alias for 'comint-send-invisible'.
738 739
Also, 'shell-strip-ctrl-m' is declared obsolete.

740
+++
741
*** 'C-c .' ('comint-insert-previous-argument') no longer interprets '&'.
742 743 744 745 746 747 748 749 750 751 752 753 754 755
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
end.
756

757 758 759 760
+++
*** '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.

761 762
** SQL

763 764 765 766 767 768 769 770 771 772 773 774 775
*** 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.
776
The 'sql-indent' package from ELPA must be installed to get the
777 778
indentation support in 'sql-mode' and 'sql-interactive-mode'.

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

784 785 786 787 788 789 790 791 792 793
*** 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.

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

800 801 802 803 804
** Term

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

805 806 807
** Flymake

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

812
*** New customizable variable 'flymake-start-on-save-buffer'.
813 814
Control whether Flymake starts checking the buffer on save.

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

819
+++
820 821
*** 'flymake-start-syntax-check-on-newline' is now obsolete,
use 'post-self-insert-hook' to check on newline.
822

Dmitry Gutov's avatar
Dmitry Gutov committed
823 824 825 826 827
** Ruby

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

828 829
*** Rubocop is called with 'bundle exec' if Gemfile mentions it.

830 831
*** New command 'ruby-find-library-file' bound to 'C-c C-f'.

832
** Package
833

834 835 836 837 838 839
*** 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.

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

843
*** New 'package-quickstart' feature.
844 845 846 847 848 849 850
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.
851 852 853

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

854 855 856
---
*** Imenu support has been added to `package-menu-mode'.

857 858 859 860 861 862 863 864 865
** Info

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

866 867 868 869 870 871 872
** 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.

873 874 875 876 877
+++
*** 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.

878
---
879 880
*** 'xref-find-definitions' now sets the mark at the buffer position
where it was invoked.
881

882
---
883
*** New xref faces 'xref-file-header', 'xref-line-number', 'xref-match'.
884

885 886 887 888 889 890 891 892 893 894 895 896
*** New variable 'xref-show-definitions-function'.
It encapsulates the logic pertinent to showing the result of
'xref-find-definitions'.  The user can change it to customize its
behavior and the display of results.

*** Search results show the buffer even for one hit.
The search-type Xref commands (e.g. 'xref-find-references' or
'project-find-regexp') now show the results buffer even when there is
only one hit.  This can be altered by changing
'xref-show-xrefs-function'.

*** Xref buffers support refreshing the search results.
897
A new command 'xref-revert-buffer' is bound to 'g'.
898

899
** Ecomplete
900

901
*** The ecomplete sorting has changed to a decay-based algorithm.
902
This can be controlled by the new 'ecomplete-sort-predicate' variable.
903

904 905
*** The 'ecompleterc' file is now placed in '~/.emacs.d/ecompleterc' by default.
Of course it will still find it if you have it in '~/.ecompleterc'.
906

Paul Eggert's avatar
Paul Eggert committed
907
** Gnus
908

909 910 911 912 913 914
---
*** Gnus now maps imaps to 993 only on old MS-Windows versions.
The nnimap backend used to do this unconditionally to work around
problems on old versions of MS-Windows.  This is now done only for
Windows XP and older.

915 916 917 918 919
+++
*** The nnimap backend now has support for IMAP namespaces.
This feature can be enabled by setting the new 'nnimap-use-namespaces'
server variable to non-nil.

920
+++
921
*** A prefix argument to 'gnus-summary-limit-to-score' will limit reverse.
922 923
Limit to articles with score at below.

Paul Eggert's avatar
Paul Eggert committed
924 925 926
*** The function 'gnus-score-find-favorite-words' has been renamed
from 'gnus-score-find-favourite-words'.

927 928 929 930
---
*** Gmane has been removed as an nnir backend, since Gmane no longer
has a search engine.

931
+++
932 933
*** Splitting mail on common mailing list headers has been added.
See the concept index in the Gnus manual for the 'match-list' entry.
934

935
+++
936
*** nil is no longer an allowed value for 'mm-text-html-renderer'.
937

938
+++
939 940
*** A new Gnus summary mode command, 'S A'
('gnus-summary-attach-article') can be used to attach the current
941 942 943
article(s) to a pre-existing Message buffer, or create a new Message
buffer with the article(s) attached.

944 945 946 947 948
+++
*** A new Gnus summary mode command, 'w'
('gnus-summary-browse-url') scans the article buffer for URLs, and
offers them to the user to open with 'browse-url'.

949 950 951 952 953
---
*** New option 'nnir-notmuch-filter-group-names-function'.
This option controls whether and how to use Gnus search groups as
'path:' search terms to 'notmuch'.

954 955 956
** erc

---
957
*** 'erc-button-google-url' has been renamed to 'erc-button-search-url'
958 959
and its value has been changed to Duck Duck Go.

960 961 962
---
*** `erc-send-pre-hook' and `erc-send-this' have been obsoleted.  The
variable to use instead to alter text to be sent is now
963
`erc-pre-send-functions'.
964

965 966 967 968
** EUDC

*** XEmacs support has been removed.

969 970
** eww/shr

971 972 973 974 975
+++
*** The 'eww' command can now create a new EWW buffer.
Invoking the command with a prefix argument will cause it to create a
new EWW buffer for the URL instead of reusing the default one.

Eli Zaretskii's avatar
Eli Zaretskii committed
976 977 978 979 980
+++
*** The 'd' ('eww-download') command now falls back to current page's URL.
If this command is invoked with no URL at point, it now downloads the
current page instead of signaling an error.

981
*** When opening external links in eww/shr (typically with the
982 983
'C-u RET' keystroke on a link), the link will be flashed with the new
'shr-selected-link' face to give the user feedback that the command
984 985
has been executed.

986 987 988 989 990
+++
*** New option 'shr-discard-aria-hidden'.
If set, shr will not render tags with attribute 'aria-hidden="true"'.
This attribute is meant to tell screen readers to ignore a tag.

Eli Zaretskii's avatar
Eli Zaretskii committed
991
---
992 993
*** 'shr-tag-ol' now respects the ordered list 'start' attribute.

Nick Drozd's avatar
Nick Drozd committed
994
---
995
*** The following tags are now handled: <code>, <abbr>, and <acronym>.
Nick Drozd's avatar
Nick Drozd committed
996

Paul Eggert's avatar
Paul Eggert committed
997
** Htmlfontify
998

Paul Eggert's avatar
Paul Eggert committed
999 1000 1001 1002 1003
*** The functions 'hfy-color', 'hfy-color-vals' and
'hfy-fallback-color-values' and the variables 'hfy-fallback-color-map'
and 'hfy-rgb-txt-color-map' have been renamed from names that used
'colour' instead of 'color'.

1004 1005 1006
+++
** Enriched mode supports the 'charset' text property.
You can add or modify the 'charset' text properties of text using the
1007
'Edit->Text Properties->Special Properties' menu, or by invoking the
1008 1009 1010 1011
'facemenu-set-charset' command.  Documents in Enriched mode will be
saved with the charset properties, and those properties will be
restored when the file is visited.

1012
** Smtpmail
1013

1014
Authentication mechanisms can be added via external packages, by
1015
defining new 'cl-defmethod' of 'smtpmail-try-auth-method'.
1016

1017
** Footnote mode
1018

1019 1020 1021 1022
*** Support Hebrew-style footnotes
*** Footnote text lines are now aligned.
Can be controlled via the new variable 'footnote-align-to-fn-text'.

1023 1024 1025 1026 1027 1028 1029
** CSS mode

---
*** A new command 'css-cycle-color-format' for cycling between color
formats (e.g. "black" => "#000000" => "rgb(0, 0, 0)") has been added,
bound to 'C-c C-f'.

1030 1031 1032
---
*** CSS mode, SCSS mode, and Less CSS mode now have support for Imenu.

1033 1034 1035 1036 1037 1038 1039
** SGML mode

---
*** 'sgml-quote' now handles double quotes and apostrophes
when escaping text and in addition all numeric entities when
unescaping text.

1040 1041 1042 1043 1044 1045 1046
** Python mode

---
*** Python mode supports three different font lock decoration levels.
The maximum level is used by default; customize
'font-lock-maximum-decoration' to tone down the decoration.

1047 1048 1049 1050 1051 1052 1053
** Dired

+++
*** The new user option 'dired-create-destination-dirs' controls whether
'dired-do-copy' and 'dired-rename-file' should create non-existent
directories in the destination.

1054 1055
** Help

1056
---
1057
*** Description of variables and functions give an estimated first release.
1058