Simplify make-progress-reporter vs float-time
[emacs.git] / etc / NEWS
blob97b21f7dd86bb2405ebe7933230311789287cbbd
1 GNU Emacs NEWS -- history of user-visible changes.
3 Copyright (C) 2016-2017 Free Software Foundation, Inc.
4 See the end of the file for license conditions.
6 Please send Emacs bug reports to bug-gnu-emacs@gnu.org.
7 If possible, use M-x report-emacs-bug.
9 This file is about changes in Emacs version 26.
11 See file HISTORY for a list of GNU Emacs versions and release dates.
12 See files NEWS.25, NEWS.24, ..., NEWS.18, and NEWS.1-17 for changes
13 in older Emacs versions.
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.
18 Temporary note:
19 +++ indicates that all necessary documentation updates have been done.
20     (This means all the relevant manuals in doc/ AND lisp doc-strings.)
21 --- means doc strings are updated, and no change in the manuals is needed.
22 When you add a new item, use the appropriate mark if you are sure it applies,
25 * Installation Changes in Emacs 26.1
27 ** By default libgnutls is now required when building Emacs.
28 Use 'configure --with-gnutls=no' to build even when GnuTLS is missing.
30 ** GnuTLS version 2.12.2 or later is now required, instead of merely
31 version 2.6.6 or later.
33 ** The new option 'configure --with-mailutils' causes Emacs to rely on
34 GNU Mailutils to retrieve email.  It is recommended, and is the
35 default if GNU Mailutils is installed.  When --with-mailutils is not
36 in effect, the Emacs build procedure by default continues to build and
37 install a limited 'movemail' substitute that retrieves POP3 email only
38 via insecure channels.  To avoid this problem, use either
39 --with-mailutils or --without-pop when configuring; --without-pop
40 is the default on platforms other than native MS-Windows.
42 ** The new option 'configure --enable-gcc-warnings=warn-only' causes
43 GCC to issue warnings without stopping the build.  This behavior is
44 now the default in developer builds.  As before, use
45 '--disable-gcc-warnings' to suppress GCC's warnings, and
46 '--enable-gcc-warnings' to stop the build if GCC issues warnings.
48 ** When GCC warnings are enabled, '--enable-check-lisp-object-type' is
49 now enabled by default when configuring.
51 +++
52 ** The Emacs server now has socket-launching support.  This allows
53 socket based activation, where an external process like systemd can
54 invoke the Emacs server process upon a socket connection event and
55 hand the socket over to Emacs.  Emacs uses this socket to service
56 emacsclient commands.  This new functionality can be disabled with the
57 configure option '--disable-libsystemd'.
59 +++
60 ** A systemd user unit file is provided.  Use it in the standard way:
61 'systemctl --user enable emacs'.
62 (If your Emacs is installed in a non-standard location, you may
63 need to copy the emacs.service file to eg ~/.config/systemd/user/)
65 ** New configure option '--disable-build-details' attempts to build an
66 Emacs that is more likely to be reproducible; that is, if you build
67 and install Emacs twice, the second Emacs is a copy of the first.
68 Deterministic builds omit the build date from the output of the
69 'emacs-version' and 'erc-cmd-SV' functions, and the leave the
70 following variables nil: 'emacs-build-system', 'emacs-build-time',
71 'erc-emacs-build-time'.
73 ---
74 ** Emacs can now be built with support for Little CMS.
76 If the lcms2 library is installed, Emacs will enable features built on
77 top of that library.  The new configure option '--without-lcms2' can
78 be used to build without lcms2 support even if it is installed.  Emacs
79 linked to Little CMS exposes color management functions in Lisp: the
80 color metrics 'lcms-cie-de2000' and 'lcms-cam02-ucs', as well as
81 functions for conversion to and from CIE CAM02 and CAM02-UCS.
83 ** The configure option '--with-gameuser' now defaults to 'no',
84 as this appears to be the most common configuration in practice.
85 When it is 'no', the shared game directory and the auxiliary program
86 update-game-score are no longer needed and are not installed.
88 ** Emacs no longer works on IRIX.  We expect that Emacs users are not
89 affected by this, as SGI stopped supporting IRIX in December 2013.
92 * Startup Changes in Emacs 26.1
94 +++
95 ** New option '--fg-daemon'.  This is the same as '--daemon', except
96 it runs in the foreground and does not fork.  This is intended for
97 modern init systems such as systemd, which manage many of the traditional
98 aspects of daemon behavior themselves.  '--bg-daemon' is now an alias
99 for '--daemon'.
102 ** New option '--module-assertions'.
103 When given this option, Emacs will perform expensive correctness
104 checks when dealing with dynamic modules.  This is intended for module
105 authors that wish to verify that their module conforms to the module
106 requirements.  The option makes Emacs abort if a module-related
107 assertion triggers.
110 ** Emacs now supports 24-bit colors on capable text terminals.
111 Terminal is automatically initialized to use 24-bit colors if the
112 required capabilities are found in terminfo.  See the FAQ node
113 "(efaq) Colors on a TTY" for more information.
116 ** Emacs now obeys the X resource "scrollBar" at startup.
117 The effect is similar to that of "toolBar" resource on the tool bar.
120 * Changes in Emacs 26.1
123 ** Option 'buffer-offer-save' can be set to new value, 'always'.  When
124 set to 'always', the command 'save-some-buffers' will always offer
125 this buffer for saving.
127 ** Security vulnerability related to Enriched Text mode is removed.
130 *** Enriched Text mode does not evaluate Lisp in 'display' properties.
131 This feature allows saving 'display' properties as part of text.
132 Emacs 'display' properties support evaluation of arbitrary Lisp forms
133 as part of processing the property for display, so displaying Enriched
134 Text could be vulnerable to executing arbitrary malicious Lisp code
135 included in the text (e.g., sent as part of an email message).
136 Therefore, execution of arbitrary Lisp forms in 'display' properties
137 decoded by Enriched Text mode is now disabled by default.  Customize
138 the new option 'enriched-allow-eval-in-display-props' to a non-nil
139 value to allow Lisp evaluation in decoded 'display' properties.
141 This vulnerability was introduced in Emacs 21.1.  To work around that
142 in Emacs versions before 25.3, append the following to your ~/.emacs
143 init file:
145   (eval-after-load "enriched"
146     '(defun enriched-decode-display-prop (start end &optional param)
147        (list start end)))
150 ** Functions in 'write-contents-functions' can fully short-circuit the
151 'save-buffer' process.  Previously, saving a buffer that was not
152 visiting a file would always prompt for a file name.  Now it only does
153 so if 'write-contents-functions' is nil (or all its functions return
154 nil).
157 ** New variable 'executable-prefix-env' for inserting magic signatures.
158 This variable affects the format of the interpreter magic number
159 inserted by 'executable-set-magic'.  If non-nil, the magic number now
160 takes the form "#!/usr/bin/env interpreter", otherwise the value
161 determined by 'executable-prefix', which is by default
162 "#!/path/to/interpreter".  By default, 'executable-prefix-env' is nil,
163 so the default behavior is not changed.
166 ** The variable 'emacs-version' no longer includes the build number.
167 This is now stored separately in a new variable, 'emacs-build-number'.
170 ** Emacs now provides a limited form of concurrency with Lisp threads.
171 Concurrency in Emacs Lisp is "mostly cooperative", meaning that
172 Emacs will only switch execution between threads at well-defined
173 times: when Emacs waits for input, during blocking operations related
174 to threads (such as mutex locking), or when the current thread
175 explicitly yields.  Global variables are shared among all threads, but
176 a 'let' binding is thread-local.  Each thread also has its own current
177 buffer and its own match data.
179 See the chapter "(elisp) Threads" in the ELisp manual for full
180 documentation of these facilities.
183 ** The new user variable 'electric-quote-chars' provides a list
184 of curved quotes for 'electric-quote-mode', allowing user to choose
185 the types of quotes to be used.
188 ** The new user option 'electric-quote-context-sensitive' makes
189 'electric-quote-mode' context sensitive.  If it is non-nil, you can
190 type an ASCII apostrophe to insert an opening or closing quote,
191 depending on context.  Emacs will replace the apostrophe by an opening
192 quote character at the beginning of the buffer, the beginning of a
193 line, after a whitespace character, and after an opening parenthesis;
194 and it will replace the apostrophe by a closing quote character in all
195 other cases.
198 ** The new variable 'electric-quote-inhibit-functions' controls when
199 to disable electric quoting based on context.  Major modes can add
200 functions to this list; Emacs will temporarily disable
201 'electric-quote-mode' whenever any of the functions returns non-nil.
202 This can be used by major modes that derive from 'text-mode' but allow
203 inline code segments, such as 'markdown-mode'.
206 ** The new user variable 'dired-omit-case-fold' allows the user to
207 customize the case-sensitivity of dired-omit-mode.  It defaults to
208 the same sensitivity as that of the filesystem for the corresponding
209 dired buffer.
212 ** Emacs now uses double buffering to reduce flicker when editing and
213 resizing graphical Emacs frames on the X Window System.  This support
214 requires the DOUBLE-BUFFER extension, which major X servers have
215 supported for many years.  If your system has this extension, but an
216 Emacs built with double buffering misbehaves on some displays you use,
217 you can disable the feature by adding
219   '(inhibit-double-buffering . t)
221 to default-frame-alist.  Or inject this parameter into the selected
222 frame by evaluating this form:
224   (modify-frame-parameters nil '((inhibit-double-buffering . t)))
227 ** The customization group 'wp', whose label was "text", is now
228 deprecated.  Use the new group 'text', which inherits from 'wp',
229 instead.
232 ** The new function 'call-shell-region' executes a command in an
233 inferior shell with the buffer region as input.
236 ** The new user option 'shell-command-dont-erase-buffer' controls
237 if the output buffer is erased between shell commands; if non-nil,
238 the output buffer is not erased; this variable also controls where
239 to set the point in the output buffer: beginning of the output,
240 end of the buffer or save the point.
241 When 'shell-command-dont-erase-buffer' is nil, the default value,
242 the behavior of 'shell-command', 'shell-command-on-region' and
243 'async-shell-command' is as usual.
246 ** The new user option 'async-shell-command-display-buffer' controls
247 whether the output buffer of an asynchronous command is shown
248 immediately, or only when there is output.
251 ** The new user option 'mouse-select-region-move-to-beginning'
252 controls the position of point when double-clicking mouse-1 on the end
253 of a parenthetical grouping or string-delimiter: the default value nil
254 keeps point at the end of the region, setting it to non-nil moves
255 point to the beginning of the region.
258 ** The new user option 'mouse-drag-and-drop-region' allows to drag the
259 entire region of text to another place or another buffer.
262 ** The new user option 'confirm-kill-processes' allows the user to
263 skip a confirmation prompt for killing subprocesses when exiting
264 Emacs.  When set to t (the default), Emacs will prompt for
265 confirmation before killing subprocesses on exit, which is the same
266 behavior as before.
269 ** 'find-library-name' will now fall back on looking at 'load-history'
270 to try to locate libraries that have been loaded with an explicit path
271 outside 'load-path'.
274 ** Faces in 'minibuffer-prompt-properties' no longer overwrite properties
275 in the text in functions like 'read-from-minibuffer', but instead are
276 added to the end of the face list.  This allows users to say things
277 like '(read-from-minibuffer (propertize "Enter something: " 'face 'bold))'.
280 ** The new variable 'extended-command-suggest-shorter' has been added
281 to control whether to suggest shorter 'M-x' commands or not.
284 ** icomplete now respects 'completion-ignored-extensions'.
287 ** Non-breaking hyphens are now displayed with the 'nobreak-hyphen'
288 face instead of the 'escape-glyph' face.
291 ** Approximations to quotes are now displayed with the new 'homoglyph'
292 face instead of the 'escape-glyph' face.
295 ** New face 'header-line-highlight'.
296 This face is the header-line analogue of 'mode-line-highlight'; it
297 should be the preferred mouse-face for mouse-sensitive elements in the
298 header line.
301 ** 'C-x h' ('mark-whole-buffer') will now avoid marking the prompt
302 part of minibuffers.
305 ** 'fill-paragraph' no longer marks the buffer as changed unless it
306 actually changed something.
309 ** The locale language name 'ca' is now mapped to the language
310 environment 'Catalan', which has been added.
313 ** 'align-regexp' has a separate history for its interactive argument.
314 'align-regexp' no longer shares its history with all other
315 history-less functions that use 'read-string'.
318 ** The networking code has been reworked so that it's more
319 asynchronous than it was (when specifying :nowait t in
320 'make-network-process').  How asynchronous it is varies based on the
321 capabilities of the system, but on a typical GNU/Linux system the DNS
322 resolution, the connection, and (for TLS streams) the TLS negotiation
323 are all done without blocking the main Emacs thread.  To get
324 asynchronous TLS, the TLS boot parameters have to be passed in (see
325 the manual for details).
327 Certain process oriented functions (like 'process-datagram-address')
328 will block until socket setup has been performed.  The recommended way
329 to deal with asynchronous sockets is to avoid interacting with them
330 until they have changed status to "run".  This is most easily done
331 from a process sentinel.
334 ** 'make-network-process' and 'open-network-stream' sometimes allowed
335 :service to be an integer string (e.g., :service "993") and sometimes
336 required an integer (e.g., :service 993).  This difference has been
337 eliminated, and integer strings work everywhere.
340 ** It is possible to disable attempted recovery on fatal signals.
341 Two new variables support disabling attempts to recover from stack
342 overflow and to avoid automatic auto-save when Emacs is delivered a
343 fatal signal.  'attempt-stack-overflow-recovery', if set to nil,
344 will disable attempts to recover from C stack overflows; Emacs will
345 then crash as with any other fatal signal.
346 'attempt-orderly-shutdown-on-fatal-signal', if set to nil, will
347 disable attempts to auto-save the session and shut down in an orderly
348 fashion when Emacs receives a fatal signal; instead, Emacs will
349 terminate immediately.  Both variables are non-nil by default.
350 These variables are for users who would like to avoid the small
351 probability of data corruption due to techniques Emacs uses to recover
352 in these situations.
355 ** File local and directory local variables are now initialized each
356 time the major mode is set, not just when the file is first visited.
357 These local variables will thus not vanish on setting a major mode.
360 ** A second dir-local file (.dir-locals-2.el) is now accepted.
361 See the variable 'dir-locals-file-2' for more information.
364 ** Connection-local variables can be used to specify local variables
365 with a value depending on the connected remote server.  For details,
366 see the node "(elisp) Connection Local Variables" in the ELisp manual.
369 ** International domain names (IDNA) are now encoded via the new
370 puny.el library, so that one can visit Web sites with non-ASCII URLs.
373 ** The new 'list-timers' command lists all active timers in a buffer,
374 where you can cancel them with the 'c' command.
377 ** 'switch-to-buffer-preserve-window-point' now defaults to t.
378 Applications that call 'switch-to-buffer' and want to show the buffer at
379 the position of its point should use 'pop-to-buffer-same-window' in lieu
380 of 'switch-to-buffer'.
383 ** The new variable 'debugger-stack-frame-as-list' allows displaying
384 all call stack frames in a Lisp backtrace buffer as lists.  Both
385 debug.el and edebug.el have been updated to heed to this variable.
388 ** Values in call stack frames are now displayed using 'cl-prin1'.
389 The old behavior of using 'prin1' can be restored by customizing the
390 new option 'debugger-print-function'.
393 ** NUL bytes in text copied to the system clipboard are now replaced with "\0".
396 ** The new variable 'x-ctrl-keysym' has been added to the existing
397 roster of X keysyms.  It can be used in combination with another
398 variable of this kind to swap modifiers in Emacs.
401 ** New input methods: 'cyrillic-tuvan', 'polish-prefix'.
404 ** The 'dutch' input method no longer attempts to support Turkish too.
405 Also, it no longer converts 'IJ' and 'ij' to the compatibility
406 characters U+0132 LATIN CAPITAL LIGATURE IJ and U+0133 LATIN SMALL
407 LIGATURE IJ.
410 ** File name quoting by adding the prefix "/:" is now possible for the
411 local part of a remote file name.  Thus, if you have a directory named
412 "/~" on the remote host "foo", you can prevent it from being
413 substituted by a home directory by writing it as "/foo:/:/~/file".
416 ** The new variable 'maximum-scroll-margin' allows having effective
417 settings of 'scroll-margin' up to half the window size, instead of
418 always restricting the margin to a quarter of the window.
421 ** Emacs can scroll horizontally using mouse, touchpad, and trackbar.
422 You can enable this by customizing 'mwheel-tilt-scroll-p'.  If you
423 want to reverse the direction of the scroll, customize
424 'mwheel-flip-direction'.
427 ** Emacsclient has a new option '-u' / '--suppress-output'.
428 This option suppresses display of return values from the server
429 process.
432 ** Emacsclient has a new option '-T' / '--tramp'.
433 This helps with using a local Emacs session as the server for a remote
434 emacsclient.  With appropriate setup, one can now set the EDITOR
435 environment variable on a remote machine to emacsclient, and
436 use the local Emacs to edit remote files via Tramp.  See the node
437 "(emacs) emacsclient Options" in the user manual for the details.
440 ** New user option 'dig-program-options' and extended functionality
441 for DNS-querying functions 'nslookup-host', 'dns-lookup-host',
442 and 'run-dig'.  Each function now accepts an optional name server
443 argument interactively (with a prefix argument) and non-interactively.
446 ** 'describe-key-briefly' now ignores mouse movement events.
449 ** The new variable 'eval-expression-print-maximum-character' prevents
450 large integers from being displayed as characters by 'M-:' and similar
451 commands.
454 ** Two new commands for finding the source code of Emacs Lisp
455 libraries: 'find-library-other-window' and 'find-library-other-frame'.
458 ** The new variable 'display-raw-bytes-as-hex' allows to change the
459 display of raw bytes from octal to hex.
462 ** You can now provide explicit field numbers in format specifiers.
463 For example, '(format "%2$s %1$s %2$s" "X" "Y")' produces "Y X Y".
466 ** Emacs now supports optional display of line numbers in the buffer.
467 This is similar to what 'linum-mode' provides, but much faster and
468 doesn't usurp the display margin for the line numbers.  Customize the
469 buffer-local variable 'display-line-numbers' to activate this optional
470 display.  Alternatively, you can use the 'display-line-numbers-mode'
471 minor mode or the global 'global-display-line-numbers-mode'.  When
472 using these modes, customize 'display-line-numbers-type' with the same
473 value as you would use with 'display-line-numbers'.
475 Line numbers are not displayed at all in minibuffer windows and in
476 tooltips, as they are not useful there.
478 Lisp programs can disable line-number display for a particular screen
479 line by putting the 'display-line-numbers-disable' text property or
480 overlay property on the first character of that screen line.  This is
481 intended for add-on packages that need a finer control of the display.
483 Lisp programs that need to know how much screen estate is used up for
484 line-number display in a window can use the new function
485 'line-number-display-width'.
487 'linum-mode' and all similar packages are henceforth becoming obsolete.
488 Users and developers are encouraged to switch to this new feature
489 instead.
492 ** emacsclient now accepts command-line options in ALTERNATE_EDITOR
493 and '--alternate-editor'. For example, ALTERNATE_EDITOR="emacs -Q -nw".
494 Arguments may be quoted "like this", so that for example an absolute
495 path containing a space may be specified; quote escaping is not
496 supported.
498 ** The new user option 'arabic-shaper-ZWNJ-handling' controls how to
499 handle ZWNJ in Arabic text rendering.
502 * Editing Changes in Emacs 26.1
505 ** New variable 'column-number-indicator-zero-based'.
506 Traditionally, in Column Number mode, the displayed column number
507 counts from zero starting at the left margin of the window.  This
508 behavior is now controlled by 'column-number-indicator-zero-based'.
509 If you would prefer for the displayed column number to count from one,
510 you may set this variable to nil.  (Behind the scenes, there is now a
511 new mode line construct, '%C', which operates exactly as '%c' does
512 except that it counts from one.)
515 ** New single-line horizontal scrolling mode.
516 The 'auto-hscroll-mode' variable can now have a new special value,
517 'current-line', which causes only the line where the cursor is
518 displayed to be horizontally scrolled when lines are truncated on
519 display and point moves outside the left or right window margin.
522 ** New mode line constructs '%o' and '%q', and user option
523 'mode-line-percent-position'.  '%o' displays the "degree of travel" of
524 the window through the buffer.  Unlike the default '%p', this
525 percentage approaches 100% as the window approaches the end of the
526 buffer.  '%q' displays the percentage offsets of both the start and
527 the end of the window, e.g. "5-17%".  The new option
528 'mode-line-percent-position' makes it easier to switch between '%p',
529 '%P', and these new constructs.
532 ** Two new user options 'list-matching-lines-jump-to-current-line' and
533 'list-matching-lines-current-line-face' to show the current line
534 highlighted in *Occur* buffer.
537 ** The 'occur' command can now operate on the region.
540 ** New bindings for 'query-replace-map'.
541 'undo', undo the last replacement; bound to 'u'.
542 'undo-all', undo all replacements; bound to 'U'.
545 ** 'delete-trailing-whitespace' deletes whitespace after form feed.
546 In modes where form feed was treated as a whitespace character,
547 'delete-trailing-whitespace' would keep lines containing it unchanged.
548 It now deletes whitespace after the last form feed thus behaving the
549 same as in modes where the character is not whitespace.
552 ** Emacs no longer prompts about editing a changed file when the file's
553 content is unchanged.  Instead of only checking the modification time,
554 Emacs now also checks the file's actual content before prompting the user.
557 ** Various casing improvements.
559 *** 'upcase', 'upcase-region' et al. convert title case characters
560 (such as Dz) into their upper case form (such as DZ).
562 *** 'capitalize', 'upcase-initials' et al. make use of title-case forms
563 of initial characters (correctly producing for example Džungla instead
564 of incorrect DŽungla).
566 *** Characters which turn into multiple ones when cased are correctly handled.
567 For example, fi ligature is converted to FI when upper cased.
569 *** Greek small sigma is correctly handled when at the end of the word.
570 Strings such as ΌΣΟΣ are now correctly converted to Όσος when
571 capitalized instead of incorrect Όσοσ (compare lowercase sigma at the
572 end of the word).
575 ** Emacs can now auto-save buffers to visited files in a more robust
576 manner via the new mode 'auto-save-visited-mode'.  Unlike
577 'auto-save-visited-file-name', this mode uses the normal saving
578 procedure and therefore obeys saving hooks.
579 'auto-save-visited-file-name' is now obsolete.
582 ** New behavior of 'mark-defun'.
583 Prefix argument selects that many (or that many more) defuns.
584 Negative prefix arg flips the direction of selection.  Also,
585 'mark-defun' between defuns correctly selects N following defuns (or
586 -N previous for negative arguments).  Finally, comments preceding the
587 defun are selected unless they are separated from the defun by a blank
588 line.
590 ** New command 'replace-buffer-contents'.
591 This command replaces the contents of the accessible portion of the
592 current buffer with the contents of the accessible portion of a
593 different buffer while keeping point, mark, markers, and text
594 properties as intact as possible.
597 ** New commands 'apropos-local-variable' and 'apropos-local-value'.
598 These are buffer-local versions of 'apropos-variable' and
599 'apropos-value', respectively.  They show buffer-local variables whose
600 names and values, respectively, match a given pattern.
603 ** More user control of reordering bidirectional text for display.
604 The two new variables, 'bidi-paragraph-start-re' and
605 'bidi-paragraph-separate-re', allow customization of what exactly are
606 paragraphs, for the purposes of bidirectional display.
609 ** New variable 'x-wait-for-event-timeout'.
610 This controls how long Emacs will wait for updates to the graphical
611 state to take effect (making a frame visible, for example).
614 * Changes in Specialized Modes and Packages in Emacs 26.1
617 ** Emacs 26.1 comes with Org v9.1.2.
618 See the file ORG-NEWS for user-visible changes in Org.
621 ** New function 'cl-generic-p'.
623 ** Dired
626 *** You can answer 'all' in 'dired-do-delete' to delete recursively all
627 remaining directories without more prompts.
630 *** Dired supports wildcards in the directory part of the file names.
633 *** You can now use '`?`' in 'dired-do-shell-command'.
634 It gets replaced by the current file name, like ' ? '.
637 *** A new option 'dired-always-read-filesystem' defaulting to nil.
638 If non-nil, buffers visiting files are reverted before they are
639 searched; for instance, in 'dired-mark-files-containing-regexp' a
640 non-nil value of this option means the file is revisited in a
641 temporary buffer; this temporary buffer is the actual buffer searched:
642 the original buffer visiting the file is not modified.
645 *** Users can now customize mouse clicks in Dired in a more flexible way.
646 The new command 'dired-mouse-find-file' can be bound to a mouse click
647 and used to visit files/directories in Dired in the selected window.
648 The new command 'dired-mouse-find-file-other-frame' similarly visits
649 files/directories in another frame.  You can write your own commands
650 that invoke 'dired-mouse-find-file' with non-default optional
651 arguments, to tailor the effects of mouse clicks on file names in
652 Dired buffers.
655 *** In wdired, when editing files to contain slash characters,
656 the resulting directories are automatically created.  Whether to do
657 this is controlled by the 'wdired-create-parent-directories' variable.
660 *** 'W' is now bound to 'browse-url-of-dired-file', and is useful for
661 viewing HTML files and the like.
664 *** New variable 'dired-clean-confirm-killing-deleted-buffers'
665 controls whether Dired asks to kill buffers visiting deleted files and
666 directories.  The default is t, so Dired asks for confirmation, to
667 keep previous behavior.
670 ** html2text is now marked obsolete.
673 ** smerge-refine-regions can refine regions in separate buffers.
676 ** Info menu and index completion uses substring completion by default.
677 This can be customized via the 'info-menu' category in
678 'completion-category-overrides'.
681 ** The ancestor buffer is shown by default in 3-way merges.
682 A new option 'ediff-show-ancestor' and a new toggle
683 'ediff-toggle-show-ancestor'.
686 ** TeX: Add luatex and xetex as alternatives to pdftex
688 ** Electric-Buffer-menu
691 *** Key 'U' is bound to 'Buffer-menu-unmark-all' and key 'M-DEL' is
692 bound to 'Buffer-menu-unmark-all-buffers'.
694 ** bs
697 *** Two new commands 'bs-unmark-all', bound to 'U', and
698 'bs-unmark-previous', bound to <backspace>.
700 ** Buffer-menu
703 *** Two new commands 'Buffer-menu-unmark-all', bound to 'U' and
704 'Buffer-menu-unmark-all-buffers', bound to 'M-DEL'.
707 ** Checkdoc
709 *** 'checkdoc-arguments-in-order-flag' now defaults to nil.
711 ** Gnus
714 *** The ~/.newsrc file will now only be saved if the native select
715 method is an NNTP select method.
718 *** A new command for sorting articles by readedness marks has been
719 added: 'C-c C-s C-m C-m'.
723 *** In 'message-citation-line-format' the '%Z' format is now the time
724 zone name instead of the numeric form.  The '%z' format continues to
725 be the numeric form.  The new behavior is compatible with
726 'format-time-string'.
728 ** Ibuffer
731 *** New command 'ibuffer-jump'.
734 *** New filter commands 'ibuffer-filter-by-basename',
735 'ibuffer-filter-by-file-extension', 'ibuffer-filter-by-directory',
736 'ibuffer-filter-by-starred-name', 'ibuffer-filter-by-modified'
737 and 'ibuffer-filter-by-visiting-file'; bound respectively
738 to '/b', '/.', '//', '/*', '/i' and '/v'.
741 *** Two new commands 'ibuffer-filter-chosen-by-completion'
742 and 'ibuffer-and-filter', the second bound to '/&'.
745 *** The commands 'ibuffer-pop-filter', 'ibuffer-pop-filter-group',
746 'ibuffer-or-filter' and 'ibuffer-filter-disable' have the alternative
747 bindings '/<up>', '/S-<up>', '/|' and '/DEL', respectively.
750 *** The data format specifying filters has been extended to allow
751 explicit logical 'and', and a more flexible form for logical 'not'.
752 See 'ibuffer-filtering-qualifiers' doc string for full details.
755 *** A new command 'ibuffer-copy-buffername-as-kill'; bound
756 to 'B'.
759 *** New command 'ibuffer-change-marks'; bound to '* c'.
762 *** A new command 'ibuffer-mark-by-locked' to mark
763 all locked buffers;  bound to '% L'.
766 *** A new option 'ibuffer-locked-char' to indicate
767 locked buffers; Ibuffer shows a new column displaying
768 'ibuffer-locked-char' for locked buffers.
771 *** A new command 'ibuffer-unmark-all-marks' to unmark
772 all buffers without asking confirmation;  bound to
773 'U'; 'ibuffer-do-replace-regexp' bound to 'r'.
776 *** A new command 'ibuffer-mark-by-content-regexp' to mark buffers
777 whose content matches a regexp; bound to '% g'.
780 *** Two new options 'ibuffer-never-search-content-name' and
781 'ibuffer-never-search-content-mode' used by
782 'ibuffer-mark-by-content-regexp'.
784 ** Browse-URL
787 *** Support for opening links to man pages in Man or WoMan mode.
789 ** Comint
792 *** New user option 'comint-move-point-for-matching-input' to control
793 where to place point after 'C-c M-r' and 'C-c M-s'.
795 ** Compilation mode
798 *** Messages from CMake are now recognized.
801 *** The number of errors, warnings, and informational messages is now
802 displayed in the mode line.  These are updated as compilation
803 proceeds.
805 ** Grep
808 *** Grep commands will now use GNU grep's '--null' option if
809 available, which allows distinguishing the filename from contents if
810 they contain colons.  This can be controlled by the new custom option
811 'grep-use-null-filename-separator'.
814 *** The grep/rgrep/lgrep functions will now ask about saving files
815 before running.  This is controlled by the 'grep-save-buffers'
816 variable.
818 ** Edebug
821 *** Edebug can be prevented from pausing 1 second after reaching a
822 breakpoint (e.g. with "f" and "o") by customizing the new option
823 'edebug-sit-on-break'.
826 *** New customizable option 'edebug-max-depth'.
827 This allows to enlarge the maximum recursion depth when instrumenting
828 code.
830 ** Eshell
833 *** 'eshell-input-filter's value is now a named function
834 'eshell-input-filter-default', and has a new custom option
835 'eshell-input-filter-initial-space' to ignore adding commands prefixed
836 with blank space to eshell history.
838 ** eww
841 *** New 'M-RET' command for opening a link at point in a new eww buffer.
844 *** A new 's' command for switching to another eww buffer via the minibuffer.
847 *** The 'o' command ('shr-save-contents') has moved to 'O' to avoid collision
848 with the 'o' command from 'image-map'.
851 *** A new command 'C' ('eww-toggle-colors') can be used to toggle
852 whether to use the HTML-specified colors or not.  The user can also
853 customize the 'shr-use-colors' variable.
856 *** Images that are being loaded are now marked with gray
857 "placeholder" images of the size specified by the HTML.  They are then
858 replaced by the real images asynchronously, which will also now
859 respect width/height HTML specs (unless they specify widths/heights
860 bigger than the current window).
863 *** The 'w' command on links is now 'shr-maybe-probe-and-copy-url'.
864 'shr-copy-url' now only copies the url at point; users who wish to
865 avoid accidentally accessing remote links may rebind 'w' and 'u' in
866 'eww-link-keymap' to it.
868 ** Ido
871 *** The commands 'find-alternate-file-other-window',
872 'dired-other-window', 'dired-other-frame', and
873 'display-buffer-other-window' are now remapped to Ido equivalents if
874 Ido mode is active.
876 ** Images
879 *** Images are automatically scaled before displaying based on the
880 'image-scaling-factor' variable (if Emacs supports scaling the images
881 in question).
884 *** It's now possible to specify aspect-ratio preserving combinations
885 of :width/:max-height and :height/:max-width keywords.  In either
886 case, the "max" keywords win.  (Previously some combinations would,
887 depending on the aspect ratio of the image, just be ignored and in
888 other instances this would lead to the aspect ratio not being
889 preserved.)
892 *** Images inserted with 'insert-image' and related functions get a
893 keymap put into the text properties (or overlays) that span the
894 image.  This keymap binds keystrokes for manipulating size and
895 rotation, as well as saving the image to a file.  These commands are
896 also available in 'image-mode'.
899 *** A new library for creating and manipulating SVG images has been
900 added.  See the "(elisp) SVG Images" section in the ELisp reference
901 manual for details.
904 *** New setf-able function to access and set image parameters is
905 provided: 'image-property'.
908 *** New commands 'image-scroll-left' and 'image-scroll-right'
909 for 'image-mode' that complement 'image-scroll-up' and
910 'image-scroll-down': they have the same prefix arg behavior and stop
911 at image boundaries.
913 ** Image-Dired
916 *** Now provides a minor mode 'image-dired-minor-mode' which replaces
917 the function 'image-dired-setup-dired-keybindings'.
920 *** Thumbnail generation is now asynchronous.
921 The number of concurrent processes is limited by the variable
922 'image-dired-thumb-job-limit'.
925 *** 'image-dired-thumbnail-storage' has a new option 'standard-large'
926 for generating 256x256 thumbnails according to the Thumbnail Managing
927 Standard.
930 *** Inherits movement keys from 'image-mode' for viewing full images.
931 This includes the usual char, line, and page movement commands.
934 *** All the -options types have been changed to argument lists
935 instead of shell command strings.  This change affects
936 'image-dired-cmd-create-thumbnail-options',
937 'image-dired-cmd-create-temp-image-options',
938 'image-dired-cmd-rotate-thumbnail-options',
939 'image-dired-cmd-rotate-original-options',
940 'image-dired-cmd-write-exif-data-options',
941 'image-dired-cmd-read-exif-data-options', and introduces
942 'image-dired-cmd-pngnq-options', 'image-dired-cmd-pngcrush-options',
943 'image-dired-cmd-create-standard-thumbnail-options'.
946 *** Recognizes more tools by default, including pngnq-s9 and OptiPNG.
949 *** 'find-file' and related commands now work on thumbnails and
950 displayed images, providing a default argument of the original file name
951 via an addition to 'file-name-at-point-functions'.
954 ** The default 'Info-default-directory-list' no longer checks some obsolete
955 directory suffixes (gnu, gnu/lib, gnu/lib/emacs, emacs, lib, lib/emacs)
956 when searching for info directories.
959 ** The commands that add ChangeLog entries now prefer a VCS root directory
960 for the ChangeLog file, if none already exists.  Customize
961 'change-log-directory-files' to nil for the old behavior.
964 ** Support for non-string values of 'time-stamp-format' has been removed.
966 ** Message
969 *** 'message-use-idna' now defaults to t (because Emacs comes with
970 built-in IDNA support now).
973 *** When sending HTML messages with embedded images, and you have
974 exiftool installed, and you rotate images with EXIF data (i.e.,
975 JPEGs), the rotational information will be inserted into the outgoing
976 image in the message.  (The original image will not have its
977 orientation affected.)
980 *** The 'message-valid-fqdn-regexp' variable has been removed, since
981 there are now top-level domains added all the time.  Message will no
982 longer warn about sending emails to top-level domains it hasn't heard
983 about.
985 *** 'message-beginning-of-line' (bound to 'C-a') understands folded headers.
986 In 'visual-line-mode' it will look for the true beginning of a header
987 while in non-'visual-line-mode' it will move the point to the indented
988 header's value.
990 ** Package
993 *** The new variable 'package-gnupghome-dir' has been added to control
994 where the GnuPG home directory (used for signature verification) is
995 located and whether GnuPG's option '--homedir' is used or not.
998 *** Deleting a package no longer respects 'delete-by-moving-to-trash'.
1000 ** Tramp
1003 *** The method part of remote file names is mandatory now.
1004 A valid remote file name starts with "/method:host:" or
1005 "/method:user@host:".
1008 *** The new pseudo method "-" is a marker for the default method.
1009 "/-::" is the shortest remote file name then.
1012 *** The command 'tramp-change-syntax' allows to choose an alternative
1013 remote file name syntax.
1016 *** New connection method "sg", which supports editing files under a
1017 different group ID.
1020 *** New connection method "doas" for OpenBSD hosts.
1023 *** New connection method "gdrive", which allows to access Google
1024 Drive onsite repositories.
1027 *** Gateway methods in Tramp have been removed.
1028 Instead, the Tramp manual documents how to configure ssh and PuTTY
1029 accordingly.
1032 *** Setting the "ENV" environment variable in
1033 'tramp-remote-process-environment' enables reading of shell
1034 initialization files.
1037 *** Tramp is able now to send SIGINT to remote asynchronous processes.
1040 *** Variable 'tramp-completion-mode' is obsoleted.
1043 ** 'auto-revert-use-notify' is set back to t in 'global-auto-revert-mode'.
1045 ** JS mode
1048 *** JS mode now sets 'comment-multi-line' to t.
1051 *** New variable 'js-indent-align-list-continuation', when set to nil,
1052 will not align continuations of bracketed lists, but will indent them
1053 by the fixed width 'js-indent-level'.
1055 ** CSS mode
1058 *** Support for completing attribute values, at-rules, bang-rules,
1059 HTML tags, classes and IDs using the 'completion-at-point' command.
1060 Completion candidates for HTML classes and IDs are retrieved from open
1061 HTML mode buffers.
1064 *** CSS mode now binds 'C-h S' to a function that will show
1065 information about a CSS construct (an at-rule, property, pseudo-class,
1066 pseudo-element, with the default being guessed from context).  By
1067 default the information is looked up on the Mozilla Developer Network,
1068 but this can be customized using 'css-lookup-url-format'.
1071 *** CSS colors are fontified using the color they represent as the
1072 background.  For instance, #ff0000 would be fontified with a red
1073 background.
1076 ** Emacs now supports character name escape sequences in character and
1077 string literals.  The syntax variants '\N{character name}' and
1078 '\N{U+code}' are supported.
1081 ** Prog mode has some support for multi-mode indentation.
1082 This allows better indentation support in modes that support multiple
1083 programming languages in the same buffer, like literate programming
1084 environments or ANTLR programs with embedded Python code.
1086 A major mode can provide indentation context for a sub-mode through
1087 the 'prog-indentation-context' variable.  To support this, modes that
1088 provide indentation should use 'prog-widen' instead of 'widen' and
1089 'prog-first-column' instead of a literal zero.  See the node
1090 "(elisp) Mode-Specific Indent" in the ELisp manual for more details.
1092 ** ERC
1095 *** New variable 'erc-default-port-tls' used to connect to TLS IRC
1096 servers.
1098 ** URL
1101 *** The new function 'url-cookie-delete-cookie' can be used to
1102 programmatically delete all cookies, or cookies from a specific
1103 domain.
1106 *** 'url-retrieve-synchronously' now takes an optional timeout parameter.
1109 *** The URL package now supports HTTPS over proxies supporting CONNECT.
1112 *** 'url-user-agent' now defaults to 'default', and the User-Agent
1113 string is computed dynamically based on 'url-privacy-level'.
1115 ** VC and related modes
1118 *** The VC state indicator in the mode line now defaults to more
1119 colorful faces to make it more obvious to the user what the state is.
1120 See the 'vc-faces' customization group.
1123 *** 'vc-dir-mode' now binds 'vc-log-outgoing' to 'O'; and has various
1124 branch-related commands on a keymap bound to 'B'.
1127 *** 'vc-region-history' is now bound to 'C-x v h', replacing the older
1128 'vc-insert-headers' binding.
1130 ** CC mode
1133 *** Opening a .h file will turn C or C++ mode depending on language used.
1134 This is done with the help of 'c-or-c++-mode' function which analyses
1135 contents of the buffer to determine whether it's a C or C++ source
1136 file.
1139 ** New DNS mode command 'dns-mode-ipv6-to-nibbles' to convert IPv6 addresses
1140 to a format suitable for reverse lookup zone files.
1142 ** Ispell
1145 *** Enchant is now supported as a spell-checker.
1147 Enchant is a meta-spell-checker that uses providers such as Hunspell
1148 to do the actual checking.  With it, users can use spell-checkers not
1149 directly supported by Emacs, such as Voikko, Hspell and AppleSpell,
1150 more easily share personal word-lists with other programs, and
1151 configure different spelling-checkers for different languages.
1152 (Version 2.1.0 or later of Enchant is required.)
1154 ** Flymake
1157 *** Flymake has been completely redesigned
1159 Flymake now annotates arbitrary buffer regions, not just lines.  It
1160 supports arbitrary diagnostic types, not just errors and warnings (see
1161 variable 'flymake-diagnostic-types-alist').
1163 It also supports multiple simultaneous backends, meaning that you can
1164 check your buffer from different perspectives (see variable
1165 'flymake-diagnostic-functions').  Backends for Emacs Lisp mode are
1166 provided.
1168 The old Flymake behavior is preserved in the so-called "legacy
1169 backend", which has been updated to benefit from the new UI features.
1172 * New Modes and Packages in Emacs 26.1
1174 ** New Elisp data-structure library 'radix-tree'.
1176 ** New library 'xdg' with utilities for some XDG standards and specs.
1178 ** HTML
1181 *** A new submode of 'html-mode', 'mhtml-mode', is now the default
1182 mode for *.html files.  This mode handles indentation,
1183 fontification, and commenting for embedded JavaScript and CSS.
1185 ** New mode 'conf-toml-mode' is a sub-mode of 'conf-mode', specialized
1186 for editing TOML files.
1188 ** New mode 'conf-desktop-mode' is a sub-mode of 'conf-unix-mode',
1189 specialized for editing freedesktop.org desktop entries.
1191 ** New minor mode 'pixel-scroll-mode' provides smooth pixel-level scrolling.
1193 ** New major mode 'less-css-mode' (a minor variant of 'css-mode') for
1194 editing Less files.
1197 * Incompatible Lisp Changes in Emacs 26.1
1200 ** 'password-data' is now a hash-table so that 'password-read' can use
1201 any object for the 'key' argument.
1204 ** Command 'dired-mark-extension' now automatically prepends a '.' to the
1205 extension when not present.  The new command 'dired-mark-suffix' behaves
1206 similarly but it doesn't prepend a '.'.
1209 ** Certain cond/pcase/cl-case forms are now compiled using a faster jump
1210 table implementation.  This uses a new bytecode op 'switch', which
1211 isn't compatible with previous Emacs versions.  This functionality can
1212 be disabled by setting 'byte-compile-cond-use-jump-table' to nil.
1215 ** The alist 'ucs-names' is now a hash table.
1218 ** 'if-let' and 'when-let' are subsumed by 'if-let*' and 'when-let*'.
1219 The incumbent 'if-let' and 'when-let' are now marked obsolete.
1220 'if-let*' and 'when-let*' do not accept the single tuple special case.
1221 New macro 'and-let*' is an implementation of the Scheme SRFI-2 syntax
1222 of the same name.  'if-let*' and 'when-let*' now accept the same
1223 binding syntax as 'and-let*'.
1226 ** 'C-up', 'C-down', 'C-left' and 'C-right' are now defined in term
1227 mode to send the same escape sequences that xterm does.  This makes
1228 things like 'forward-word' in readline work.
1231 ** hideshow mode got four key bindings that are analogous to outline
1232 mode bindings: 'C-c @ C-a', 'C-c @ C-t', 'C-c @ C-d', and 'C-c @ C-e'.
1235 ** Customizable variable 'query-replace-from-to-separator'
1236 now doesn't propertize the string value of the separator.
1237 Instead, text properties are added by 'query-replace-read-from'.
1238 Additionally, the new nil value restores pre-24.5 behavior
1239 of not providing replacement pairs via the history.
1242 ** Some obsolete functions, variables, and faces have been removed:
1244 *** 'make-variable-frame-local'.  Variables cannot be frame-local any more.
1246 *** From subr.el: 'window-dot', 'set-window-dot', 'read-input',
1247 'show-buffer', 'eval-current-buffer', 'string-to-int'.
1249 *** 'icomplete-prospects-length'.
1251 *** All the default-FOO variables that hold the default value of the
1252 FOO variable.  Use 'default-value' and 'setq-default' to access and
1253 change FOO, respectively.  The exhaustive list of removed variables is:
1254 'default-mode-line-format', 'default-header-line-format',
1255 'default-line-spacing', 'default-abbrev-mode', 'default-ctl-arrow',
1256 'default-truncate-lines', 'default-left-margin', 'default-tab-width',
1257 'default-case-fold-search', 'default-left-margin-width',
1258 'default-right-margin-width', 'default-left-fringe-width',
1259 'default-right-fringe-width', 'default-fringes-outside-margins',
1260 'default-scroll-bar-width', 'default-vertical-scroll-bar',
1261 'default-indicate-empty-lines', 'default-indicate-buffer-boundaries',
1262 'default-fringe-indicator-alist', 'default-fringe-cursor-alist',
1263 'default-scroll-up-aggressively', 'default-scroll-down-aggressively',
1264 'default-fill-column', 'default-cursor-type',
1265 'default-cursor-in-non-selected-windows',
1266 'default-buffer-file-coding-system', 'default-major-mode', and
1267 'default-enable-multibyte-characters'.
1269 *** Many variables obsoleted in 22.1 referring to face symbols.
1272 ** The variable 'text-quoting-style' is now a customizable option.  It
1273 controls whether to and how to translate ASCII quotes in messages and
1274 help output.  Its possible values and their semantics remain unchanged
1275 from Emacs 25.  In particular, when this variable's value is 'grave',
1276 all quotes in formats are output as-is.
1279 ** Functions like 'check-declare-file' and 'check-declare-directory'
1280 now generate less chatter and more-compact diagnostics.  The auxiliary
1281 function 'check-declare-errmsg' has been removed.
1284 ** The regular expression character class '[:blank:]' now matches
1285 Unicode horizontal whitespace as defined in the Unicode Technical
1286 Standard #18.  If you only want to match space and tab, use '[ \t]'
1287 instead.
1290 ** 'min' and 'max' no longer round their results.
1291 Formerly, they returned a floating-point value if any argument was
1292 floating-point, which was sometimes numerically incorrect.  For
1293 example, on a 64-bit host (max 1e16 10000000000000001) now returns its
1294 second argument instead of its first.
1297 ** The variable 'old-style-backquotes' has been made internal and
1298 renamed to 'lread--old-style-backquotes'.  No user code should use
1299 this variable.
1302 ** To avoid confusion caused by "smart quotes", the reader no longer
1303 accepts Lisp symbols which begin with the following quotation
1304 characters: ‘’‛“”‟〞"', unless they are escaped with backslash.
1307 ** 'default-file-name-coding-system' now defaults to a coding system
1308 that does not process CRLF.  For example, it defaults to 'utf-8-unix'
1309 instead of to 'utf-8'.  Before this change, Emacs would sometimes
1310 mishandle file names containing these control characters.
1313 ** 'file-attributes', 'file-symlink-p' and 'make-symbolic-link' no
1314 longer quietly mutate the target of a local symbolic link, so that
1315 Emacs can access and copy them reliably regardless of their contents.
1316 The following changes are involved.
1319 *** 'file-attributes' and 'file-symlink-p' no longer prepend "/:" to
1320 symbolic links whose targets begin with "/" and contain ":".  For
1321 example, if a symbolic link "x" has a target "/y:z:", '(file-symlink-p
1322 "x")' now returns "/y:z:" rather than "/:/y:z:".
1325 *** 'make-symbolic-link' no longer looks for file name handlers of
1326 target when creating a symbolic link.  For example,
1327 '(make-symbolic-link "/y:z:" "x")' now creates a symbolic link to
1328 "/y:z:" instead of failing.
1331 *** 'make-symbolic-link' removes the remote part of a link target if
1332 target and newname have the same remote part.  For example,
1333 '(make-symbolic-link "/x:y:a" "/x:y:b")' creates a link with the
1334 literal string "a"; and '(make-symbolic-link "/x:y:a" "/x:z:b")'
1335 creates a link with the literal string "/x:y:a" instead of failing.
1338 *** 'make-symbolic-link' now expands a link target with leading "~"
1339 only when the optional third arg is an integer, as when invoked
1340 interactively.  For example, '(make-symbolic-link "~y" "x")' now
1341 creates a link with target the literal string "~y"; to get the old
1342 behavior, use '(make-symbolic-link (expand-file-name "~y") "x")'.  To
1343 avoid this expansion in interactive use, you can now prefix the link
1344 target with "/:".  For example, '(make-symbolic-link "/:~y" "x" 1)'
1345 now creates a link to literal "~y".
1348 ** 'file-truename' returns a quoted file name if the target of a
1349 symbolic link has remote file name syntax.
1352 ** Module functions are now implemented slightly differently; in
1353 particular, the function 'internal--module-call' has been removed.
1354 Code that depends on undocumented internals of the module system might
1355 break.
1358 ** The argument LOCKNAME of 'write-region' is propagated to file name
1359 handlers now.
1362 ** When built against recent versions of GTK+, Emacs always uses
1363 gtk_window_move for moving frames and ignores the value of the
1364 variable 'x-gtk-use-window-move'.  The variable is now obsolete.
1367 ** Several functions that create or rename files now treat their
1368 destination argument specially only when it is a directory name, i.e.,
1369 when it ends in '/' on GNU and other POSIX-like systems.  When the
1370 destination argument D of one of these functions is an existing
1371 directory and the intent is to act on an entry in that directory, D
1372 should now be a directory name.  For example, (rename-file "e" "f/")
1373 renames to 'f/e'.  Although this formerly happened sometimes even when
1374 D was not a directory name, as in (rename-file "e" "f") where 'f'
1375 happened to be a directory, the old behavior often contradicted the
1376 documentation and had inherent races that led to security holes.  A
1377 call like (rename-file C D) that used the old, undocumented behavior
1378 can be written as (rename-file C (file-name-as-directory D)), a
1379 formulation portable to both older and newer versions of Emacs.
1380 Affected functions include 'add-name-to-file', 'copy-directory',
1381 'copy-file', 'format-write-file', 'gnus-copy-file',
1382 'make-symbolic-link', 'rename-file', 'thumbs-rename-images', and
1383 'write-file'.
1386 ** The list returned by 'overlays-at' is now in decreasing priority order.
1387 The documentation of this function always said the order should be
1388 that of decreasing priority, if the 2nd argument of the function is
1389 non-nil, but the code returned the list in the increasing order of
1390 priority instead.  Now the code does what the documentation says it
1391 should do.
1394 ** 'format' now avoids allocating a new string in more cases.
1395 'format' was previously documented to return a newly-allocated string,
1396 but this documentation was not correct, as (eq x (format x)) returned
1397 t when x was the empty string.  'format' is no longer documented to
1398 return a newly-allocated string, and the implementation now takes
1399 advantage of the doc change to avoid making copies of strings in
1400 common cases like (format "foo") and (format "%s" "foo").
1403 ** The function 'eldoc-message' now accepts a single argument.
1404 Programs that called it with multiple arguments before should pass
1405 them through 'format' first.  Even that is discouraged: for ElDoc
1406 support, you should set 'eldoc-documentation-function' instead of
1407 calling 'eldoc-message' directly.
1410 * Lisp Changes in Emacs 26.1
1413 ** The function 'assoc' now takes an optional third argument TESTFN.
1414 This argument, when non-nil, is used for comparison instead of
1415 'equal'.
1418 ** New optional argument TESTFN in 'alist-get', 'map-elt' and 'map-put'.
1419 If non-nil, the argument specifies a function to use for comparison,
1420 instead of, respectively, 'assq' and 'eql'.
1423 ** New function 'seq-set-equal-p' to check if SEQUENCE1 and SEQUENCE2
1424 contain the same elements, regardless of the order.
1427 ** The new function 'mapbacktrace' applies a function to all frames of
1428 the current stack trace.
1431 ** The new function 'file-name-case-insensitive-p' tests whether a
1432 given file is on a case-insensitive filesystem.
1435 ** Several accessors for the value returned by 'file-attributes'
1436 have been added.  They are: 'file-attribute-type',
1437 'file-attribute-link-number', 'file-attribute-user-id',
1438 'file-attribute-group-id', 'file-attribute-access-time',
1439 'file-attribute-modification-time',
1440 'file-attribute-status-change-time', 'file-attribute-size',
1441 'file-attribute-modes', 'file-attribute-inode-number',
1442 'file-attribute-device-number' and 'file-attribute-collect'.
1445 ** The new function 'buffer-hash' computes a fast, non-consing hash of
1446 a buffer's contents.
1449 ** 'interrupt-process' now consults the list 'interrupt-process-functions',
1450 to determine which function has to be called in order to deliver the
1451 SIGINT signal.  This allows Tramp to send the SIGINT signal to remote
1452 asynchronous processes.  The hitherto existing implementation has been
1453 moved to 'internal-default-interrupt-process'.
1456 ** The new function 'read-multiple-choice' prompts for multiple-choice
1457 questions, with a handy way to display help texts.
1460 ** 'comment-indent-function' values may now return a cons to specify a
1461 range of indentation.
1464 ** New optional argument TEXT in 'make-temp-file'.
1467 ** New function 'define-symbol-prop'.
1470 ** New function 'secure-hash-algorithms' to list the algorithms that
1471 'secure-hash' supports.
1472 See the node "(elisp) Checksum/Hash" in the ELisp manual for details.
1475 ** Emacs now exposes the GnuTLS cryptographic API with the functions
1476 'gnutls-macs' and 'gnutls-hash-mac'; 'gnutls-digests' and
1477 'gnutls-hash-digest'; 'gnutls-ciphers' and 'gnutls-symmetric-encrypt'
1478 and 'gnutls-symmetric-decrypt'.
1479 See the node "(elisp) GnuTLS Cryptography" in the ELisp manual for details.
1482 ** Emacs now supports records for user-defined types, via the new
1483 functions 'make-record', 'record', and 'recordp'.  Records are now
1484 used internally to represent cl-defstruct and defclass instances, for
1485 example.
1488 ** 'save-some-buffers' now uses 'save-some-buffers-default-predicate'
1489 to decide which buffers to ask about, if the PRED argument is nil.
1490 The default value of 'save-some-buffers-default-predicate' is nil,
1491 which means ask about all file-visiting buffers.
1494 ** string-(to|as|make)-(uni|multi)byte are now declared obsolete.
1497 ** New variable 'while-no-input-ignore-events' which allow
1498 setting which special events 'while-no-input' should ignore.
1499 It is a list of symbols.
1502 ** New function 'undo-amalgamate-change-group' to get rid of
1503 undo-boundaries between two states.
1506 ** New var 'definition-prefixes' is a hash table mapping prefixes to
1507 the files where corresponding definitions can be found.  This can be
1508 used to fetch definitions that are not yet loaded, for example for
1509 'C-h f'.
1512 ** New var 'syntax-ppss-table' to control the syntax-table used in
1513 'syntax-ppss'.
1516 ** 'define-derived-mode' can now specify an :after-hook form, which
1517 gets evaluated after the new mode's hook has run.  This can be used to
1518 incorporate configuration changes made in the mode hook into the
1519 mode's setup.
1522 ** Autoload files can be generated without timestamps,
1523 by setting 'autoload-timestamps' to nil.
1524 FIXME As an experiment, nil is the current default.
1525 If no insurmountable problems before next release, it can stay that way.
1528 ** 'gnutls-boot' now takes a parameter ':complete-negotiation' that
1529 says that negotiation should complete even on non-blocking sockets.
1532 ** There is now a new variable 'flyspell-sort-corrections-function'
1533 that allows changing the way corrections are sorted.
1536 ** The new command 'fortune-message' has been added, which displays
1537 fortunes in the echo area.
1540 ** New function 'func-arity' returns information about the argument list
1541 of an arbitrary function.  This generalizes 'subr-arity' for functions
1542 that are not built-in primitives.  We recommend using this new
1543 function instead of 'subr-arity'.
1546 ** New function 'region-bounds' can be used in the interactive spec
1547 to provide region boundaries (for rectangular regions more than one)
1548 to an interactively callable function as a single argument instead of
1549 two separate arguments 'region-beginning' and 'region-end'.
1552 ** 'parse-partial-sexp' state has a new element.  Element 10 is
1553 non-nil when the last character scanned might be the first character
1554 of a two character construct, i.e., a comment delimiter or escaped
1555 character.  Its value is the syntax of that last character.
1558 ** 'parse-partial-sexp's state, element 9, has now been confirmed as
1559 permanent and documented, and may be used by Lisp programs.  Its value
1560 is a list of currently open parenthesis positions, starting with the
1561 outermost parenthesis.
1564 ** 'read-color' will now display the color names using the color itself
1565 as the background color.
1568 ** The function 'redirect-debugging-output' now works on platforms
1569 other than GNU/Linux.
1572 ** The new function 'string-version-lessp' compares strings by
1573 interpreting consecutive runs of numerical characters as numbers, and
1574 compares their numerical values.  According to this predicate,
1575 "foo2.png" is smaller than "foo12.png".
1578 ** Numeric comparisons and 'logb' no longer return incorrect answers
1579 due to internal rounding errors.  For example, '(< most-positive-fixnum
1580 (+ 1.0 most-positive-fixnum))' now correctly returns t on 64-bit hosts.
1583 ** The functions 'ffloor', 'fceiling', 'ftruncate' and 'fround' now
1584 accept only floating-point arguments, as per their documentation.
1585 Formerly, they quietly accepted integer arguments and sometimes
1586 returned nonsensical answers, e.g., '(< N (ffloor N))' could return t.
1589 ** On hosts like GNU/Linux x86-64 where a 'long double' fraction
1590 contains at least EMACS_INT_WIDTH - 3 bits, 'format' no longer returns
1591 incorrect answers due to internal rounding errors when formatting
1592 Emacs integers with '%e', '%f', or '%g' conversions.  For example, on
1593 these hosts '(eql N (string-to-number (format "%.0f" N)))' now returns
1594 t for all Emacs integers N.
1597 ** Calls that accept floating-point integers (for use on hosts with
1598 limited integer range) now signal an error if arguments are not
1599 integral.  For example '(decode-char 'ascii 0.5)' now signals an error.
1602 ** The new function 'char-from-name' converts a Unicode name string
1603 to the corresponding character code.
1606 ** New functions 'sxhash-eq' and 'sxhash-eql' return hash codes of a
1607 Lisp object suitable for use with 'eq' and 'eql' correspondingly.  If
1608 two objects are 'eq' ('eql'), then the result of 'sxhash-eq'
1609 ('sxhash-eql') on them will be the same.
1612 ** Function 'sxhash' has been renamed to 'sxhash-equal' for
1613 consistency with the new functions.  For compatibility, 'sxhash'
1614 remains as an alias to 'sxhash-equal'.
1617 ** 'make-hash-table' now defaults to a rehash threshold of 0.8125
1618 instead of 0.8, to avoid rounding glitches.
1621 ** New function 'add-variable-watcher' can be used to call a function
1622 when a symbol's value is changed.  This is used to implement the new
1623 debugger command 'debug-on-variable-change'.
1626 ** Time conversion functions that accept a time zone rule argument now
1627 allow it to be OFFSET or a list (OFFSET ABBR), where the integer
1628 OFFSET is a count of seconds east of Universal Time, and the string
1629 ABBR is a time zone abbreviation.  The affected functions are
1630 'current-time-string', 'current-time-zone', 'decode-time',
1631 'format-time-string', and 'set-time-zone-rule'.
1634 ** 'format-time-string' now formats '%q' to the calendar quarter.
1637 ** New built-in function 'mapcan'.
1638 It avoids unnecessary consing (and garbage collection).
1641 ** 'car' and 'cdr' compositions 'cXXXr' and 'cXXXXr' are now part of Elisp.
1644 ** 'gensym' is now part of Elisp.
1647 ** Low-level list functions like 'length' and 'member' now do a better
1648 job of signaling list cycles instead of looping indefinitely.
1651 ** The new functions 'make-nearby-temp-file' and 'temporary-file-directory'
1652 can be used for creation of temporary files of remote or mounted directories.
1655 ** On GNU platforms when operating on a local file, 'file-attributes'
1656 no longer suffers from a race when called while another process is
1657 altering the filesystem.  On non-GNU platforms 'file-attributes'
1658 attempts to detect the race, and returns nil if it does so.
1661 ** The new function 'file-local-name' can be used to specify arguments
1662 of remote processes.
1665 ** The new functions 'file-name-quote', 'file-name-unquote' and
1666 'file-name-quoted-p' can be used to quote / unquote file names with
1667 the prefix "/:".
1670 ** The new error 'file-missing', a subcategory of 'file-error', is now
1671 signaled instead of 'file-error' if a file operation acts on a file
1672 that does not exist.
1675 ** The function 'delete-directory' no longer signals an error when
1676 operating recursively and when some other process deletes the directory
1677 or its files before 'delete-directory' gets to them.
1680 *** New error type 'user-search-failed' like 'search-failed' but
1681 avoids debugger like 'user-error'.
1684 ** The function 'line-number-at-pos' now takes a second optional
1685 argument 'absolute'.  If this parameter is nil, the default, this
1686 function keeps on returning the line number taking potential narrowing
1687 into account.  If this parameter is non-nil, the function ignores
1688 narrowing and returns the absolute line number.
1691 ** The function 'color-distance' now takes a second optional argument
1692 'metric'.  When non-nil, it should be a function of two arguments that
1693 accepts two colors and returns a number.
1695 ** Changes in Frame and Window Handling
1698 *** Resizing a frame no longer runs 'window-configuration-change-hook'.
1699 'window-size-change-functions' should be used instead.
1702 *** The new function 'frame-size-changed-p' can tell whether a frame has
1703 been resized since the last time 'window-size-change-functions' has been
1704 run.
1707 *** The function 'frame-geometry' now also returns the width of a
1708 frame's outer border.
1711 *** New frame parameters and changed semantics for older ones:
1714 **** 'z-group' positions a frame above or below all others.
1717 **** 'min-width' and 'min-height' specify the absolute minimum size of a
1718 frame.
1721 **** 'parent-frame' makes a frame the child frame of another Emacs
1722 frame.  The section "(elisp) Child Frames" in the ELisp manual
1723 describes the intrinsics of that relationship.
1726 **** 'delete-before' triggers deletion of one frame before that of
1727 another.
1730 **** 'mouse-wheel-frame' specifies another frame whose windows shall be
1731 scrolled instead.
1734 **** 'no-other-frame' has 'next-frame' and 'previous-frame' skip this
1735 frame.
1738 **** 'skip-taskbar' removes a frame's icon from the taskbar and has
1739 'Alt-<TAB>' skip this frame.
1742 **** 'no-focus-on-map' avoids that a frame gets input focus when mapped.
1745 **** 'no-accept-focus' means that a frame does not want to get input
1746 focus via the mouse.
1749 **** 'undecorated' removes the window manager decorations from a frame.
1752 **** 'override-redirect' tells the window manager to disregard this
1753 frame.
1756 **** 'width' and 'height' allow to specify pixel values and ratios now.
1759 **** 'left' and 'top' allow to specify ratios now.
1762 **** 'keep-ratio' preserves size and position of child frames when their
1763 parent frame is resized.
1766 **** 'no-special-glyphs' suppresses display of truncation and
1767 continuation glyphs in a frame.
1770 **** 'auto-hide-function' and 'minibuffer-exit' handle auto hiding of
1771 frames and exiting from minibuffer individually.
1774 **** 'fit-frame-to-buffer-margins' and 'fit-frame-to-buffer-sizes'
1775 handle fitting a frame to its buffer individually.
1778 **** 'drag-internal-border', 'drag-with-header-line',
1779 'drag-with-mode-line', 'snap-width', 'top-visible' and 'bottom-visible'
1780 allow to drag and resize frames with the mouse.
1782 *** The new function 'frame-list-z-order' returns a list of all frames
1783 in Z (stacking) order.
1786 *** The function 'x-focus-frame' optionally tries to not activate its
1787 frame.
1790 *** The variable 'focus-follows-mouse' has a third meaningful value
1791 'auto-raise' to indicate that the window manager automatically raises a
1792 frame when the mouse pointer enters it.
1795 *** The new function 'frame-restack' puts a frame above or below
1796 another on the display.
1799 *** The new face 'internal-border' specifies the background of a frame's
1800 internal border.
1803 *** The NORECORD argument of 'select-window' now has a meaningful value
1804 'mark-for-redisplay' which is like any other non-nil value but marks
1805 WINDOW for redisplay.
1808 *** Support for side windows is now official.  The display action
1809 function 'display-buffer-in-side-window' will display its buffer in a
1810 side window.  Functions for toggling all side windows on a frame,
1811 changing and reversing the layout of side windows and returning the
1812 main (major non-side) window of a frame are provided.  For details
1813 consult the section "(elisp) Side Windows" in the ELisp manual.
1816 *** Support for atomic windows - rectangular compositions of windows
1817 treated by 'split-window', 'delete-window' and 'delete-other-windows'
1818 like a single live window - is now official.  For details consult the
1819 section "(elisp) Atomic Windows" in the ELisp manual.
1822 *** New 'display-buffer' alist entry 'window-parameters' allows to
1823 assign window parameters to the window used for displaying the buffer.
1826 *** New function 'display-buffer-reuse-mode-window' is an action function
1827 suitable for use in 'display-buffer-alist'.  For example, to avoid
1828 creating a new window when opening man pages when there's already one,
1831 (add-to-list 'display-buffer-alist
1832      '("\\`\\*Man .*\\*\\'" .
1833        (display-buffer-reuse-mode-window
1834         (inhibit-same-window . nil)
1835         (mode . Man-mode))))
1838 *** New window parameter 'no-delete-other-windows' prevents that
1839 its window gets deleted by 'delete-other-windows'.
1842 *** New window parameters 'mode-line-format' and 'header-line-format'
1843 allow to override the buffer-local formats for this window.
1846 *** New command 'window-swap-states' swaps the states of two live
1847 windows.
1850 *** New functions 'window-pixel-width-before-size-change' and
1851 'window-pixel-height-before-size-change' support detecting which
1852 window changed size when 'window-size-change-functions' are run.
1855 *** The new function 'window-lines-pixel-dimensions' returns the pixel
1856 dimensions of a window's text lines.
1859 *** The new function 'window-largest-empty-rectangle' returns the
1860 dimensions of the largest rectangular area not occupying any text in a
1861 window's body.
1864 *** The semantics of 'mouse-autoselect-window' has changed slightly.
1865 For details see the section "(elisp) Mouse Window Auto-selection" in
1866 the ELisp manual.
1869 *** 'select-frame-by-name' now may return a frame on another display
1870 if it does not find a suitable one on the current display.
1873 ** 'tcl-auto-fill-mode' is now declared obsolete.  Its functionality
1874 can be replicated simply by setting 'comment-auto-fill-only-comments'.
1876 ** New pcase pattern 'rx' to match against an rx-style regular expression.
1877 For details, see the doc string of 'rx--pcase-macroexpander'.
1880 ** New functions to set region from secondary selection and vice versa.
1881 The new functions 'secondary-selection-to-region' and
1882 'secondary-selection-from-region' let you set the beginning and the
1883 end of the region from those of the secondary selection and vice
1884 versa.
1886 ** New function 'lgstring-remove-glyph' can be used to modify a
1887 gstring returned by the underlying layout engine (e.g. m17n-flt,
1888 uniscribe).
1891 * Changes in Emacs 26.1 on Non-Free Operating Systems
1894 ** Intercepting hotkeys on Windows 7 and later now works better.
1895 The new keyboard hooking code properly grabs system hotkeys such as
1896 'Win-*' and 'Alt-TAB', in a way that Emacs can get at them before the
1897 system.  This makes the 'w32-register-hot-key' functionality work
1898 again on all versions of MS-Windows starting with Windows 7.  On
1899 Windows NT and later you can now register any hotkey combination.  (On
1900 Windows 9X, the previous limitations, spelled out in the Emacs manual,
1901 still apply.)
1904 ** 'convert-standard-filename' no longer mirrors slashes on MS-Windows.
1905 Previously, on MS-Windows this function converted slash characters in
1906 file names into backslashes.  It no longer does that.  If your Lisp
1907 program used 'convert-standard-filename' to prepare file names to be
1908 passed to subprocesses (which is not the recommended usage of that
1909 function), you will now have to mirror slashes in your application
1910 code.  One possible way is this:
1912          (let ((start 0))
1913            (while (string-match "/" file-name start)
1914              (aset file-name (match-beginning 0) ?\\)
1915              (setq start (match-end 0))))
1918 ** GUI sessions on MS-Windows now treat SIGINT like Posix platforms do.
1919 The effect of delivering a Ctrl-C (SIGINT) signal to a GUI Emacs on
1920 MS-Windows is now the same as on Posix platforms -- Emacs saves the
1921 session and exits.  In particular, this will happen if you start
1922 emacs.exe from the Windows shell, then type Ctrl-C into that shell's
1923 window.
1926 ** 'signal-process' supports SIGTRAP on Windows XP and later.
1927 The 'kill' emulation on Windows now maps SIGTRAP to a call to the
1928 'DebugBreakProcess' API.  This causes the receiving process to break
1929 execution and return control to the debugger.  If no debugger is
1930 attached to the receiving process, the call is typically ignored.
1931 This is in contrast to the default action on POSIX Systems, where it
1932 causes the receiving process to terminate with a core dump if no
1933 debugger has been attached to it.
1936 ** 'set-mouse-position' and 'set-mouse-absolute-pixel-position' work
1937 on macOS.
1940 ** Emacs can now be run as a GUI application from the command line on
1941 macOS.
1944 ** 'ns-appearance' and 'ns-transparent-titlebar' change the appearance
1945 of frame decorations on macOS 10.9+.
1948 ** 'ns-use-thin-smoothing' enables thin font smoothing on macOS 10.8+.
1951 ** 'process-attributes' on Darwin systems now returns more information.
1954 ** Mousewheel and trackpad scrolling on macOS 10.7+ now behaves more
1955 like the macOS default.  The new variables 'ns-mwheel-line-height',
1956 'ns-use-mwheel-acceleration' and 'ns-use-mwheel-momentum' can be used
1957 to customize the behavior.
1960 ----------------------------------------------------------------------
1961 This file is part of GNU Emacs.
1963 GNU Emacs is free software: you can redistribute it and/or modify
1964 it under the terms of the GNU General Public License as published by
1965 the Free Software Foundation, either version 3 of the License, or
1966 (at your option) any later version.
1968 GNU Emacs is distributed in the hope that it will be useful,
1969 but WITHOUT ANY WARRANTY; without even the implied warranty of
1970 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
1971 GNU General Public License for more details.
1973 You should have received a copy of the GNU General Public License
1974 along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.
1977 Local variables:
1978 coding: utf-8
1979 mode: outline
1980 paragraph-separate: "[  \f]*$"
1981 end: