Raise version of macOS we define instancetype for (bug#27059)
[emacs.git] / etc / NEWS
1 GNU Emacs NEWS -- history of user-visible changes.
3 Copyright (C) 2014-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.23, NEWS.22, NEWS.21, NEWS.20,
13 NEWS.19, NEWS.18, and NEWS.1-17 for changes 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 are complete.
20     (This means all relevant manuals in doc/ AND lisp doc-strings.)
21 --- means 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 'movemail' to retrieve email.  By default, the Emacs
35 build procedure continues to build and install a limited and insecure
36 'movemail' substitute.  Although --with-mailutils is recommended, it
37 is not yet the default due to backward-compatibility concerns.
39 ** The new option 'configure --enable-gcc-warnings=warn-only' causes
40 GCC to issue warnings without stopping the build.  This behavior is
41 now the default in developer builds.  As before, use
42 '--disable-gcc-warnings' to suppress GCC's warnings, and
43 '--enable-gcc-warnings' to stop the build if GCC issues warnings.
45 ** When GCC warnings are enabled, '--enable-check-lisp-object-type' is
46 now enabled by default when configuring.
48 +++
49 ** The Emacs server now has socket-launching support.  This allows
50 socket based activation, where an external process like systemd can
51 invoke the Emacs server process upon a socket connection event and
52 hand the socket over to Emacs.  Emacs uses this socket to service
53 emacsclient commands.  This new functionality can be disabled with the
54 configure option '--disable-libsystemd'.
56 +++
57 ** A systemd user unit file is provided.  Use it in the standard way:
58 systemctl --user enable emacs
59 (If your Emacs is installed in a non-standard location, you may
60 need to copy the emacs.service file to eg ~/.config/systemd/user/)
62 ** New configure option '--disable-build-details' attempts to build an
63 Emacs that is more likely to be reproducible; that is, if you build
64 and install Emacs twice, the second Emacs is a copy of the first.
65 Deterministic builds omit the build date from the output of the
66 emacs-version and erc-cmd-SV functions, and the leave the following
67 variables nil: emacs-build-system, emacs-build-time,
68 erc-emacs-build-time.
70 ** The configure option '--with-gameuser' now defaults to 'no',
71 as this appears to be the most common configuration in practice.
72 When it is 'no', the shared game directory and the auxiliary program
73 update-game-score are no longer needed and are not installed.
75 ** Emacs no longer works on IRIX.  We expect that Emacs users are not
76 affected by this, as SGI stopped supporting IRIX in December 2013.
79 * Startup Changes in Emacs 26.1
81 ** New option '--new-daemon'.  This is the same as '--daemon', except
82 it runs in the foreground and does not fork.  This is intended for
83 modern init systems such as systemd, which manage many of the traditional
84 aspects of daemon behavior themselves.  '--old-daemon' is now an alias
85 for '--daemon'.
87 +++
88 ** Emacs now supports 24-bit colors on capable text terminals
89 Terminal is automatically initialized to use 24-bit colors if the
90 required capabilities are found in terminfo.  See the FAQ node
91 "Colors on a TTY" for more information.
94 * Changes in Emacs 26.1
96 ** The variable 'emacs-version' no longer includes the build number.
97 This is now stored separately in a new variable, 'emacs-build-number'.
99 +++
100 ** The new function 'mapbacktrace' applies a function to all frames of
101 the current stack trace.
104 ** Emacs now provides a limited form of concurrency with Lisp threads.
105 Concurrency in Emacs Lisp is "mostly cooperative", meaning that
106 Emacs will only switch execution between threads at well-defined
107 times: when Emacs waits for input, during blocking operations related
108 to threads (such as mutex locking), or when the current thread
109 explicitly yields.  Global variables are shared among all threads, but
110 a 'let' binding is thread-local.  Each thread also has its own current
111 buffer and its own match data.
113 See the chapter "Threads" in the ELisp manual for full documentation
114 of these facilities.
117 ** The new function 'file-name-case-insensitive-p' tests whether a
118 given file is on a case-insensitive filesystem.
121 ** The new user variable 'electric-quote-chars' provides a list
122 of curved quotes for 'electric-quote-mode', allowing user to choose
123 the types of quotes to be used.
126 ** The new user variable 'dired-omit-case-fold' allows the user to
127 customize the case-sensitivity of dired-omit-mode.  It defaults to
128 the same sensitivity as that of the filesystem for the corresponding
129 dired buffer.
132 ** Emacs now uses double buffering to reduce flicker when editing and
133 resizing graphical Emacs frames on the X Window System.  This support
134 requires the DOUBLE-BUFFER extension, which major X servers have
135 supported for many years.  If your system has this extension, but an
136 Emacs built with double buffering misbehaves on some displays you use,
137 you can disable the feature by adding
139   '(inhibit-double-buffering . t)
141 to default-frame-alist.  Or inject this parameter into the selected
142 frame by evaluating this form:
144   (modify-frame-parameters nil '((inhibit-double-buffering . t)))
147 The group 'wp', whose label was "text", is now deprecated.
148 Use the new group 'text', which inherits from 'wp', instead.
151 ** The new function 'call-shell-region' executes a command in an
152 inferior shell with the buffer region as input.
155 ** The new user option 'shell-command-dont-erase-buffer' controls
156 if the output buffer is erased between shell commands; if non-nil,
157 the output buffer is not erased; this variable also controls where
158 to set the point in the output buffer: beginning of the output,
159 end of the buffer or save the point.
160 When 'shell-command-dont-erase-buffer' is nil, the default value,
161 the behavior of 'shell-command', 'shell-command-on-region' and
162 'async-shell-command' is as usual.
165 ** The new user option 'mouse-select-region-move-to-beginning'
166 controls the position of point when double-clicking mouse-1 on the end
167 of a parenthetical grouping or string-delimiter: the default value nil
168 keeps point at the end of the region, setting it to non-nil moves
169 point to the beginning of the region.
172 ** The new user option 'confirm-kill-processes' allows the user to
173 skip a confirmation prompt for killing subprocesses when exiting
174 Emacs.  When set to t (the default), Emacs will prompt for
175 confirmation before killing subprocesses on exit, which is the same
176 behavior as before.
179 ** 'find-library-name' will now fall back on looking at 'load-history'
180 to try to locate libraries that have been loaded with an explicit path
181 outside 'load-path'.
184 ** Faces in 'minibuffer-prompt-properties' no longer overwrite properties
185 in the text in functions like 'read-from-minibuffer', but instead are
186 added to the end of the face list.  This allows users to say things
187 like '(read-from-minibuffer (propertize "Enter something: " 'face 'bold))'.
190 ** The new variable 'extended-command-suggest-shorter' has been added
191 to control whether to suggest shorter 'M-x' commands or not.
194 ** icomplete now respects 'completion-ignored-extensions'.
197 ** Non-breaking hyphens are now displayed with the 'nobreak-hyphen'
198 face instead of the 'escape-glyph' face.
201 ** Approximations to quotes are now displayed with the new 'homoglyph'
202 face instead of the 'escape-glyph' face.
205 ** 'C-x h' ('mark-whole-buffer') will now avoid marking the prompt
206 part of minibuffers.
209 ** 'find-library' now takes a prefix argument to pop to a different
210 window.
213 ** 'process-attributes' on Darwin systems now returns more information.
216 ** Several accessors for the value returned by 'file-attributes'
217 have been added.  They are: 'file-attribute-type',
218 'file-attribute-link-number', 'file-attribute-user-id',
219 'file-attribute-group-id', 'file-attribute-access-time',
220 'file-attribute-modification-time',
221 'file-attribute-status-change-time', 'file-attribute-size',
222 'file-attribute-modes', 'file-attribute-inode-number',
223 'file-attribute-device-number' and 'file-attribute-collect'.
226 ** The new function 'buffer-hash' computes a fast, non-consing hash of
227 a buffer's contents.
230 ** 'fill-paragraph' no longer marks the buffer as changed unless it
231 actually changed something.
234 ** The locale language name 'ca' is now mapped to the language
235 environment 'Catalan', which has been added.
238 ** 'align-regexp' has a separate history for its interactive argument.
239 'align-regexp' no longer shares its history with all other
240 history-less functions that use 'read-string'.
243 ** The networking code has been reworked so that it's more
244 asynchronous than it was (when specifying :nowait t in
245 'make-network-process').  How asynchronous it is varies based on the
246 capabilities of the system, but on a typical GNU/Linux system the DNS
247 resolution, the connection, and (for TLS streams) the TLS negotiation
248 are all done without blocking the main Emacs thread.  To get
249 asynchronous TLS, the TLS boot parameters have to be passed in (see
250 the manual for details).
252 Certain process oriented functions (like 'process-datagram-address')
253 will block until socket setup has been performed.  The recommended way
254 to deal with asynchronous sockets is to avoid interacting with them
255 until they have changed status to "run".  This is most easily done
256 from a process sentinel.
258 ** 'make-network-process' and 'open-network-stream' sometimes allowed
259 :service to be an integer string (e.g., :service "993") and sometimes
260 required an integer (e.g., :service 993).  This difference has been
261 eliminated, and integer strings work everywhere.
263 ** It is possible to disable attempted recovery on fatal signals.
265 Two new variables support disabling attempts to recover from stack
266 overflow and to avoid automatic auto-save when Emacs is delivered a
267 fatal signal.  'attempt-stack-overflow-recovery', if set to 'nil',
268 will disable attempts to recover from C stack overflows; Emacs will
269 then crash as with any other fatal signal.
270 'attempt-orderly-shutdown-on-fatal-signal', if set to 'nil', will
271 disable attempts to auto-save the session and shut down in an orderly
272 fashion when Emacs receives a fatal signal; instead, Emacs will
273 terminate immediately.  Both variables are non-'nil' by default.
274 These variables are for users who would like to avoid the small
275 probability of data corruption due to techniques Emacs uses to recover
276 in these situations.
279 ** File local and directory local variables are now initialized each
280 time the major mode is set, not just when the file is first visited.
281 These local variables will thus not vanish on setting a major mode.
284 ** A second dir-local file (.dir-locals-2.el) is now accepted.
285 See the variable 'dir-locals-file-2' for more information.
288 ** Connection-local variables can be used to specify local variables
289 with a value depending on the connected remote server.  For details,
290 see the node "Connection Local Variables" in the ELisp manual.
293 ** International domain names (IDNA) are now encoded via the new
294 puny.el library, so that one can visit web sites with non-ASCII URLs.
297 ** The new 'timer-list' command lists all active timers in a buffer,
298 where you can cancel them with the 'c' command.
301 ** The new function 'read-multiple-choice' prompts for multiple-choice
302 questions, with a handy way to display help texts.
305 ** 'switch-to-buffer-preserve-window-point' now defaults to t.
308 ** The new variable 'debugger-stack-frame-as-list' allows displaying
309 all call stack frames in a Lisp backtrace buffer as lists.  Both
310 debug.el and edebug.el have been updated to heed to this variable.
313 ** The new variable 'x-ctrl-keysym' has been added to the existing
314 roster of X keysyms.  It can be used in combination with another
315 variable of this kind to swap modifiers in Emacs.
318 ** New input methods: 'cyrillic-tuvan', 'polish-prefix'.
321 ** File name quoting by adding the prefix "/:" is now possible for the
322 local part of a remote file name.  Thus, if you have a directory named
323 "/~" on the remote host "foo", you can prevent it from being
324 substituted by a home directory by writing it as "/foo:/:/~/file".
327 ** The new variable 'maximum-scroll-margin' allows having effective
328 settings of 'scroll-margin' up to half the window size, instead of
329 always restricting the margin to a quarter of the window.
332 ** Emacs can scroll horizontally using mouse, touchpad, and trackbar.
333 You can enable this by customizing 'mwheel-tilt-scroll-p'.  If you
334 want to reverse the direction of the scroll, customize
335 'mwheel-flip-direction'.
338 ** Emacsclient has a new option -u/--suppress-output.  The option
339 suppresses display of return values from the server process.
342 ** New user option 'dig-program-options' and extended functionality
343 for DNS-querying functions 'nslookup-host', 'dns-lookup-host',
344 and 'run-dig'.  Each function now accepts an optional name server
345 argument interactively (with a prefix argument) and non-interactively.
348 ** Emacsclient has a new option -T/--tramp.
349 This helps with using a local Emacs session as the server for a remote
350 emacsclient.  With appropriate setup, one can now set the EDITOR
351 environment variable on a remote machine to emacsclient, and
352 use the local Emacs to edit remote files via Tramp.  See the node
353 "emacsclient Options" in the user manual for the details.
356 ** The new variable 'eval-expression-print-maximum-character' prevents
357 large integers from being displayed as characters.
359 ** Two new commands for finding the source code of Emacs Lisp
360 libraries: 'find-library-other-window' and 'find-library-other-frame'.
363 * Editing Changes in Emacs 26.1
366 ** New variable 'column-number-indicator-zero-based'.
367 Traditionally, in Column Number mode, the displayed column number
368 counts from zero starting at the left margin of the window.  This
369 behavior is now controlled by 'column-number-indicator-zero-based'.
370 If you would prefer for the displayed column number to count from one,
371 you may set this variable to nil.  (Behind the scenes, there is now a
372 new mode line construct, '%C', which operates exactly as '%c' does
373 except that it counts from one.)
375 ** New single-line horizontal scrolling mode.
376 The 'auto-hscroll-mode' variable can now have a new special value,
377 'current-line', which causes only the line where the cursor is
378 displayed to be horizontally scrolled when lines are truncated on
379 display and point moves outside the left or right window margin.
382 ** New mode line constructs '%o' and '%q', and user option
383 'mode-line-percent-position'.  '%o' displays the "degree of travel" of
384 the window through the buffer.  Unlike the default '%p', this
385 percentage approaches 100% as the window approaches the end of the
386 buffer.  '%q' displays the percentage offsets of both the start and
387 the end of the window, e.g. "5-17%".  The new option
388 'mode-line-percent-position' makes it easier to switch between '%p',
389 '%P', and these new constructs.
392 ** Two new user options 'list-matching-lines-jump-to-current-line' and
393 'list-matching-lines-current-line-face' to show highlighted the current
394 line in *Occur* buffer.
397 ** The 'occur' command can now operate on the region.
400 ** New bindings for 'query-replace-map'.
401 'undo', undo the last replacement; bound to 'u'.
402 'undo-all', undo all replacements; bound to 'U'.
404 ** 'delete-trailing-whitespace' deletes whitespace after form feed.
405 In modes where form feed was treated as a whitespace character,
406 'delete-trailing-whitespace' would keep lines containing it unchanged.
407 It now deletes whitespace after the last form feed thus behaving the
408 same as in modes where the character is not whitespace.
410 ** No more prompt about changed file when the file's content is unchanged.
411 Instead of only checking the modification time, Emacs now also checks
412 the file's actual content before prompting the user.
414 ** Various casing improvements.
416 *** 'upcase', 'upcase-region' et al. convert title case characters
417 (such as Dz) into their upper case form (such as DZ).
419 *** 'capitalize', 'upcase-initials' et al. make use of title-case forms
420 of initial characters (correctly producing for example Džungla instead
421 of incorrect DŽungla).
423 *** Characters which turn into multiple ones when cased are correctly handled.
424 For example, fi ligature is converted to FI when upper cased.
426 *** Greek small sigma is correctly handled when at the end of the word.
427 Strings such as ΌΣΟΣ are now correctly converted to Όσος when
428 capitalized instead of incorrect Όσοσ (compare lowercase sigma at the
429 end of the word).
431 ** Emacs can now auto-save buffers to visited files in a more robust
432 manner via the new mode 'auto-save-visited-mode'.  Unlike
433 'auto-save-visited-file-name', this mode uses the normal saving
434 procedure and therefore obeys saving hooks.
435 'auto-save-visited-file-name' is now obsolete.
438 ** New behavior of 'mark-defun' implemented
439 Prefix argument selects that many (or that many more) defuns.
440 Negative prefix arg flips the direction of selection.  Also,
441 'mark-defun' between defuns correctly selects N following defuns (or
442 -N previous for negative arguments).  Finally, comments preceding the
443 defun are selected unless they are separated from the defun by a blank
444 line.
447 * Changes in Specialized Modes and Packages in Emacs 26.1
449 *** smerge-refine-regions can refine regions in separate buffers
451 *** Info menu and index completion uses substring completion by default.
452 This can be customized via the info-menu category in
453 completion-category-override.
456 *** The ancestor buffer is shown by default in 3way merges.
457 A new option ediff-show-ancestor and a new toggle
458 ediff-toggle-show-ancestor.
460 ** TeX: Add luatex and xetex as alternatives to pdftex
462 ** Electric-Buffer-menu
465 *** Key 'U' is bound to 'Buffer-menu-unmark-all' and key 'M-DEL' is
466 bound to 'Buffer-menu-unmark-all-buffers'.
468 ** bs
471 *** Two new commands 'bs-unmark-all', bound to 'U', and
472 'bs-unmark-previous', bound to <backspace>.
474 ** Buffer-menu
477 *** Two new commands 'Buffer-menu-unmark-all', bound to 'U' and
478 'Buffer-menu-unmark-all-buffers', bound to 'M-DEL'.
480 ** Gnus
483 *** The .newsrc file will now only be saved if the native select
484 method is an NNTP select method.
487 *** A new command for sorting articles by readedness marks has been
488 added: 'C-c C-s C-m C-m'.
490 ** Ibuffer
493 *** New command 'ibuffer-jump'.
496 *** New filter commands 'ibuffer-filter-by-basename',
497 'ibuffer-filter-by-file-extension', 'ibuffer-filter-by-directory',
498 'ibuffer-filter-by-starred-name', 'ibuffer-filter-by-modified'
499 and 'ibuffer-filter-by-visiting-file'; bound respectively
500 to '/b', '/.', '//', '/*', '/i' and '/v'.
503 *** Two new commands 'ibuffer-filter-chosen-by-completion'
504 and 'ibuffer-and-filter', the second bound to '/&'.
507 *** The commands 'ibuffer-pop-filter', 'ibuffer-pop-filter-group',
508 'ibuffer-or-filter' and 'ibuffer-filter-disable' have the alternative
509 bindings '/<up>', '/S-<up>', '/|' and '/DEL', respectively.
512 *** The data format specifying filters has been extended to allow
513 explicit logical 'and', and a more flexible form for logical 'not'.
514 See 'ibuffer-filtering-qualifiers' doc string for full details.
517 *** A new command 'ibuffer-copy-buffername-as-kill'; bound
518 to 'B'.
521 *** New command 'ibuffer-change-marks'; bound to '* c'.
524 *** A new command 'ibuffer-mark-by-locked' to mark
525 all locked buffers;  bound to '% L'.
528 *** A new option 'ibuffer-locked-char' to indicate
529 locked buffers; Ibuffer shows a new column displaying
530 'ibuffer-locked-char' for locked buffers.
533 *** A new command 'ibuffer-unmark-all-marks' to unmark
534 all buffers without asking confirmation;  bound to
535 'U'; 'ibuffer-do-replace-regexp' bound to 'r'.
538 *** A new command 'ibuffer-mark-by-content-regexp' to mark buffers
539 whose content matches a regexp; bound to '% g'.
542 *** Two new options 'ibuffer-never-search-content-name' and
543 'ibuffer-never-search-content-mode' used by
544 'ibuffer-mark-by-content-regexp'.
546 ** Browse-URL
548 *** Support for opening links to man pages in Man or WoMan mode.
550 ** Comint
553 *** New user option 'comint-move-point-for-matching-input' to control
554 where to place point after C-c M-r and C-c M-s.
556 ** Compilation mode
559 *** Messages from CMake are now recognized.
562 *** A new option 'dired-always-read-filesystem' default to nil.
563 If non-nil, buffers visiting files are reverted before search them;
564 for instance, in 'dired-mark-files-containing-regexp' a non-nil value
565 of this option means the file is revisited in a temporary buffer;
566 this temporary buffer is the actual buffer searched: the original buffer
567 visiting the file is not modified.
570 *** In wdired, when editing files to contain slash characters,
571 the resulting directories are automatically created.  Whether to do
572 this is controlled by the 'wdired-create-parent-directories' variable.
575 *** 'W' is now bound to 'browse-url-of-dired-file', and is useful for
576 viewing HTML files and the like.
578 ** Edebug
580 *** Edebug can be prevented from pausing 1 second after reaching a
581 breakpoint (e.g. with "f" and "o") by customizing the new option
582 'edebug-sit-on-break'.
585 *** New customizable option 'edebug-max-depth'
586 This allows to enlarge the maximum recursion depth when instrumenting
587 code.
589 ** Eshell
591 *** 'eshell-input-filter's value is now a named function
592 'eshell-input-filter-default', and has a new custom option
593 'eshell-input-filter-initial-space' to ignore adding commands prefixed
594 with blank space to eshell history.
596 ** eww
599 *** New 'M-RET' command for opening a link at point in a new eww buffer.
602 *** A new 's' command for switching to another eww buffer via the minibuffer.
605 *** The 'o' command ('shr-save-contents') has moved to 'O' to avoid collision
606 with the 'o' command from 'image-map'.
609 *** A new command 'C' ('eww-toggle-colors') can be used to toggle
610 whether to use the HTML-specified colors or not.  The user can also
611 customize the 'shr-use-colors' variable.
614 *** Images that are being loaded are now marked with gray
615 "placeholder" images of the size specified by the HTML.  They are then
616 replaced by the real images asynchronously, which will also now
617 respect width/height HTML specs (unless they specify widths/heights
618 bigger than the current window).
620 ** Ido
622 *** The commands 'find-alternate-file-other-window',
623 'dired-other-window', 'dired-other-frame', and
624 'display-buffer-other-window' are now remapped to Ido equivalents if
625 Ido mode is active.
627 ** Images
630 *** Images are automatically scaled before displaying based on the
631 'image-scaling-factor' variable (if Emacs supports scaling the images
632 in question).
635 *** Images inserted with 'insert-image' and related functions get a
636 keymap put into the text properties (or overlays) that span the
637 image.  This keymap binds keystrokes for manipulating size and
638 rotation, as well as saving the image to a file.  These commands are
639 also available in 'image-mode'.
642 *** A new library for creating and manipulating SVG images has been
643 added.  See the "SVG Images" section in the Lisp reference manual for
644 details.
647 *** New setf-able function to access and set image parameters is
648 provided: 'image-property'.
651 *** New commands 'image-scroll-left' and 'image-scroll-right'
652 for 'image-mode' that complement 'image-scroll-up' and
653 'image-scroll-down': they have the same prefix arg behavior and stop
654 at image boundaries.
656 ** Image-Dired
658 *** Now provides a minor mode 'image-dired-minor-mode' which replaces
659 the function 'image-dired-setup-dired-keybindings'.
661 *** Thumbnail generation is now asynchronous
662 The number of concurrent processes is limited by the variable
663 'image-dired-thumb-job-limit'.
665 *** 'image-dired-thumbnail-storage' has a new option 'standard-large'
666 for generating 256x256 thumbnails according to the Thumbnail Managing
667 Standard.
669 *** Inherits movement keys from 'image-mode' for viewing full images.
670 This includes the usual char, line, and page movement commands.
672 *** All the -options types have been changed to argument lists
673 instead of shell command strings.  This change affects
674 'image-dired-cmd-create-thumbnail-options',
675 'image-dired-cmd-create-temp-image-options',
676 'image-dired-cmd-rotate-thumbnail-options',
677 'image-dired-cmd-rotate-original-options',
678 'image-dired-cmd-write-exif-data-options',
679 'image-dired-cmd-read-exif-data-options', and introduces
680 'image-dired-cmd-pngnq-options', 'image-dired-cmd-pngcrush-options',
681 'image-dired-cmd-create-standard-thumbnail-options'
683 *** Recognizes more tools by default, including pngnq-s9 and OptiPNG
685 *** 'find-file' and related commands now work on thumbnails and
686 displayed images, providing a default argument of the original file name
687 via an addition to 'file-name-at-point-functions'.
690 ** The default 'Info-default-directory-list' no longer checks some obsolete
691 directory suffixes (gnu, gnu/lib, gnu/lib/emacs, emacs, lib, lib/emacs)
692 when searching for info directories.
695 ** The commands that add ChangeLog entries now prefer a VCS root directory
696 for the ChangeLog file, if none already exists.  Customize
697 'change-log-directory-files' to nil for the old behavior.
700 ** Support for non-string values of 'time-stamp-format' has been removed.
702 ** Message
705 *** 'message-use-idna' now defaults to t (because Emacs comes with
706 built-in IDNA support now).
709 *** When sending HTML messages with embedded images, and you have
710 exiftool installed, and you rotate images with EXIF data (i.e.,
711 JPEGs), the rotational information will be inserted into the outgoing
712 image in the message.  (The original image will not have its
713 orientation affected.)
716 *** The 'message-valid-fqdn-regexp' variable has been removed, since
717 there are now top-level domains added all the time.  Message will no
718 longer warn about sending emails to top-level domains it hasn't heard
719 about.
721 *** 'message-beginning-of-line' (bound to C-a) understands folded headers.
722 In 'visual-line-mode' it will look for the true beginning of a header
723 while in non-'visual-line-mode' it will move the point to the indented
724 header's value.
726 ** Package
729 *** The new variable 'package-gnupghome-dir' has been added to control
730 where the GnuPG home directory (used for signature verification) is
731 located and whether GnuPG's option "--homedir" is used or not.
733 ** Tramp
736 *** The method part of remote file names is mandatory now.  A valid
737 remote file name starts with "/method:host:" or "/method:user@host:".
740 *** The new pseudo method "-" is a marker for the default method.
741 "/-::" is the shortest remote file name then.
744 *** The command 'tramp-change-syntax' allows to choose an alternative
745 remote file name syntax.
748 *** New connection method "sg", which supports editing files under a
749 different group ID.
752 *** New connection method "doas" for OpenBSD hosts.
755 *** New connection method "gdrive", which allows to access Google
756 Drive onsite repositories.
759 *** Gateway methods in Tramp have been removed.  Instead, the Tramp
760 manual documents how to configure ssh and PuTTY accordingly.
763 *** Setting the "ENV" environment variable in
764 'tramp-remote-process-environment' enables reading of shell
765 initialization files.
768 *** Variable 'tramp-completion-mode' is obsoleted.
771 ** 'auto-revert-use-notify' is set back to t in 'global-auto-revert-mode'.
774 ** JS mode now sets 'comment-multi-line' to t.
776 ** CSS mode
779 *** Support for completing attribute values, at-rules, bang-rules,
780 HTML tags, classes and IDs using the 'completion-at-point' command.
781 Completion candidates for HTML classes and IDs are retrieved from open
782 HTML mode buffers.
785 *** CSS mode now binds 'C-h S' to a function that will show
786 information about a CSS construct (an at-rule, property, pseudo-class,
787 pseudo-element, with the default being guessed from context).  By
788 default the information is looked up on the Mozilla Developer Network,
789 but this can be customized using 'css-lookup-url-format'.
792 *** CSS colors are fontified using the color they represent as the
793 background.  For instance, #ff0000 would be fontified with a red
794 background.
797 ** Emacs now supports character name escape sequences in character and
798 string literals.  The syntax variants \N{character name} and
799 \N{U+code} are supported.
802 ** Prog mode has some support for multi-mode indentation.
803 This allows better indentation support in modes that support multiple
804 programming languages in the same buffer, like literate programming
805 environments or ANTLR programs with embedded Python code.
807 A major mode can provide indentation context for a sub-mode through
808 the 'prog-indentation-context' variable.  To support this, modes that
809 provide indentation should use 'prog-widen' instead of 'widen' and
810 'prog-first-column' instead of a literal zero.  See the node
811 "Mode-Specific Indent" in the ELisp manual for more details.
813 ** ERC
815 *** New variable 'erc-default-port-tls' used to connect to TLS IRC
816 servers.
818 ** URL
821 *** The new function 'url-cookie-delete-cookie' can be used to
822 programmatically delete all cookies, or cookies from a specific
823 domain.
826 *** 'url-retrieve-synchronously' now takes an optional timeout parameter.
829 *** The URL package now support HTTPS over proxies supporting CONNECT.
832 *** 'url-user-agent' now defaults to 'default', and the User-Agent
833 string is computed dynamically based on 'url-privacy-level'.
835 ** VC and related modes
838 *** The VC state indicator in the mode line now defaults to more
839 colorful faces to make it more obvious to the user what the state is.
840 See the 'vc-faces' customization group.
843 *** 'vc-dir-mode' now binds 'vc-log-outgoing' to 'O'; and has various
844 branch-related commands on a keymap bound to 'B'.
846 ** CC mode
848 *** Opening a .h file will turn C or C++ mode depending on language used.
849 This is done with the help of 'c-or-c++-mode' function which analyses
850 contents of the buffer to determine whether it's a C or C++ source
851 file.
854 ** New DNS mode command 'dns-mode-ipv6-to-nibbles' to convert IPv6 addresses
855 to a format suitable for reverse lookup zone files.
857 ** Flymake
860 *** Emacs does no longer prompt the user before killing Flymake
861 processes on exit.
864 * New Modes and Packages in Emacs 26.1
866 ** New Elisp data-structure library 'radix-tree'.
868 ** New library 'xdg' with utilities for some XDG standards and specs.
870 ** HTML
873 *** A new submode of 'html-mode', 'mhtml-mode', is now the default
874 mode for *.html files.  This mode handles indentation,
875 fontification, and commenting for embedded JavaScript and CSS.
877 ** New minor mode 'pixel-scroll-mode' provides smooth pixel-level scrolling.
880 * Incompatible Lisp Changes in Emacs 26.1
883 *** Command 'dired-mark-extension' now automatically prepends a '.' to the
884 extension when not present.  The new command 'dired-mark-suffix' behaves
885 similarly but it doesn't prepend a '.'.
888 ** Certain cond/pcase/cl-case forms are now compiled using a faster jump
889 table implementation. This uses a new bytecode op 'switch', which isn't
890 compatible with previous Emacs versions. This functionality can be disabled
891 by setting 'byte-compile-cond-use-jump-table' to nil.
893 ** 'C-up', 'C-down', 'C-left' and 'C-right' are now defined in term
894 mode to send the same escape sequences that xterm does.  This makes
895 things like forward-word in readline work.
898 ** hideshow mode got four key bindings that are analogous to outline
899 mode bindings: 'C-c @ C-a', 'C-c @ C-t', 'C-c @ C-d', and 'C-c @ C-e.'
901 ** The grep/rgrep/lgrep functions will now ask about saving files
902 before running.  This is controlled by the 'grep-save-buffers'
903 variable.
906 ** Customizable variable 'query-replace-from-to-separator'
907 now doesn't propertize the string value of the separator.
908 Instead, text properties are added by query-replace-read-from.
909 Additionally, the new nil value restores pre-24.5 behavior
910 of not providing replacement pairs via the history.
912 ** Some obsolete functions, variables, and faces have been removed:
913 *** make-variable-frame-local.  Variables cannot be frame-local any more.
914 *** From subr.el: window-dot, set-window-dot, read-input, show-buffer,
915 eval-current-buffer, string-to-int
916 *** All the default-FOO variables that hold the default value of the
917 FOO variable.  Use 'default-value' and 'setq-default' to access and
918 change FOO, respectively.  The exhaustive list of removed variables is:
919 'default-mode-line-format', 'default-header-line-format',
920 'default-line-spacing', 'default-abbrev-mode', 'default-ctl-arrow',
921 'default-truncate-lines', 'default-left-margin', 'default-tab-width',
922 'default-case-fold-search', 'default-left-margin-width',
923 'default-right-margin-width', 'default-left-fringe-width',
924 'default-right-fringe-width', 'default-fringes-outside-margins',
925 'default-scroll-bar-width', 'default-vertical-scroll-bar',
926 'default-indicate-empty-lines', 'default-indicate-buffer-boundaries',
927 'default-fringe-indicator-alist', 'default-fringe-cursor-alist',
928 'default-scroll-up-aggressively', 'default-scroll-down-aggressively',
929 'default-fill-column', 'default-cursor-type',
930 'default-cursor-in-non-selected-windows',
931 'default-buffer-file-coding-system', 'default-major-mode', and
932 'default-enable-multibyte-characters'.
933 *** Many variables obsoleted in 22.1 referring to face symbols
936 ** The variable 'text-quoting-style' no longer affects the treatment
937 of curved quotes in format arguments to functions like 'message' and
938 'format-message'.  In particular, when this variable's value is
939 'grave', all quotes in formats are output as-is.
941 ** Functions like 'check-declare-file' and 'check-declare-directory'
942 now generate less chatter and more-compact diagnostics.  The auxiliary
943 function 'check-declare-errmsg' has been removed.
946 ** The regular expression character class [:blank:] now matches
947 Unicode horizontal whitespace as defined in the Unicode Technical
948 Standard #18.  If you only want to match space and tab, use [ \t]
949 instead.
952 ** 'min' and 'max' no longer round their results.  Formerly, they
953 returned a floating-point value if any argument was floating-point,
954 which was sometimes numerically incorrect.  For example, on a 64-bit
955 host (max 1e16 10000000000000001) now returns its second argument
956 instead of its first.
959 ** The variable 'old-style-backquotes' has been made internal and
960 renamed to 'lread--old-style-backquotes'.  No user code should use
961 this variable.
964 ** Module functions are now implemented slightly differently; in
965 particular, the function 'internal--module-call' has been removed.
966 Code that depends on undocumented internals of the module system might
967 break.
970 * Lisp Changes in Emacs 26.1
972 ** New function 'seq-set-equal-p' to check if SEQUENCE1 and SEQUENCE2
973 contain the same elements, regardless of the order.
976 ** Emacs now supports records for user-defined types, via the new
977 functions 'make-record', 'record', and 'recordp'.  Records are now
978 used internally to represent cl-defstruct and defclass instances, for
979 example.
982 ** 'save-some-buffers' now uses 'save-some-buffers-default-predicate'
983 to decide which buffers to ask about, if the PRED argument is nil.
984 The default value of 'save-some-buffers-default-predicate' is nil,
985 which means ask about all file-visiting buffers.
987 ** string-(to|as|make)-(uni|multi)byte are now declared obsolete.
988 ** New variable 'while-no-input-ignore-events' which allow
989 setting which special events 'while-no-input' should ignore.
990 It is a list of symbols.
992 ** New function 'undo-amalgamate-change-group' to get rid of
993 undo-boundaries between two states.
995 ** New var 'definition-prefixes' is a hash table mapping prefixes to
996 the files where corresponding definitions can be found.  This can be
997 used to fetch definitions that are not yet loaded, for example for
998 'C-h f'.
1000 ** New var 'syntax-ppss-table' to control the syntax-table used in
1001 'syntax-ppss'.
1004 ** 'define-derived-mode' can now specify an :after-hook form, which
1005 gets evaluated after the new mode's hook has run.  This can be used to
1006 incorporate configuration changes made in the mode hook into the
1007 mode's setup.
1009 ** Autoload files can be generated without timestamps,
1010 by setting 'autoload-timestamps' to nil.
1011 FIXME As an experiment, nil is the current default.
1012 If no insurmountable problems before next release, it can stay that way.
1015 ** 'gnutls-boot' now takes a parameter ':complete-negotiation' that
1016 says that negotiation should complete even on non-blocking sockets.
1019 ** There is now a new variable 'flyspell-sort-corrections-function'
1020 that allows changing the way corrections are sorted.
1023 ** The new command 'fortune-message' has been added, which displays
1024 fortunes in the echo area.
1027 ** New function 'func-arity' returns information about the argument list
1028 of an arbitrary function.  This generalizes 'subr-arity' for functions
1029 that are not built-in primitives.  We recommend using this new
1030 function instead of 'subr-arity'.
1032 ** New function 'region-bounds' can be used in the interactive spec
1033 to provide region boundaries (for rectangular regions more than one)
1034 to an interactively callable function as a single argument instead of
1035 two separate arguments region-beginning and region-end.
1038 ** 'parse-partial-sexp' state has a new element.  Element 10 is
1039 non-nil when the last character scanned might be the first character
1040 of a two character construct, i.e., a comment delimiter or escaped
1041 character.  Its value is the syntax of that last character.
1044 ** 'parse-partial-sexp's state, element 9, has now been confirmed as
1045 permanent and documented, and may be used by Lisp programs.  Its value
1046 is a list of currently open parenthesis positions, starting with the
1047 outermost parenthesis.
1050 ** 'read-color' will now display the color names using the color itself
1051 as the background color.
1053 ** The function 'redirect-debugging-output' now works on platforms
1054 other than GNU/Linux.
1057 ** The new function 'string-version-lessp' compares strings by
1058 interpreting consecutive runs of numerical characters as numbers, and
1059 compares their numerical values.  According to this predicate,
1060 "foo2.png" is smaller than "foo12.png".
1063 ** Numeric comparisons and 'logb' no longer return incorrect answers
1064 due to internal rounding errors.  For example, (< most-positive-fixnum
1065 (+ 1.0 most-positive-fixnum)) now correctly returns t on 64-bit hosts.
1068 ** The functions 'ffloor', 'fceiling', 'ftruncate' and 'fround' now
1069 accept only floating-point arguments, as per their documentation.
1070 Formerly, they quietly accepted integer arguments and sometimes
1071 returned nonsensical answers, e.g., (< N (ffloor N)) could return t.
1074 ** On hosts like GNU/Linux x86-64 where a 'long double' fraction
1075 contains at least EMACS_INT_WIDTH - 3 bits, 'format' no longer returns
1076 incorrect answers due to internal rounding errors when formatting
1077 Emacs integers with %e, %f, or %g conversions.  For example, on these
1078 hosts (eql N (string-to-number (format "%.0f" N))) now returns t for
1079 all Emacs integers N.
1082 ** Calls that accept floating-point integers (for use on hosts with
1083 limited integer range) now signal an error if arguments are not
1084 integral.  For example (decode-char 'ascii 0.5) now signals an error.
1087 ** The new function 'char-from-name' converts a Unicode name string
1088 to the corresponding character code.
1091 ** New functions 'sxhash-eq' and 'sxhash-eql' return hash codes of a
1092 Lisp object suitable for use with 'eq' and 'eql' correspondingly.  If
1093 two objects are 'eq' ('eql'), then the result of 'sxhash-eq'
1094 ('sxhash-eql') on them will be the same.
1097 ** Function 'sxhash' has been renamed to 'sxhash-equal' for
1098 consistency with the new functions.  For compatibility, 'sxhash'
1099 remains as an alias to 'sxhash-equal'.
1102 ** 'make-hash-table' now defaults to a rehash threshold of 0.8125
1103 instead of 0.8, to avoid rounding glitches.
1106 ** New function 'add-variable-watcher' can be used to call a function
1107 when a symbol's value is changed.  This is used to implement the new
1108 debugger command 'debug-on-variable-change'.
1111 ** Time conversion functions that accept a time zone rule argument now
1112 allow it to be OFFSET or a list (OFFSET ABBR), where the integer
1113 OFFSET is a count of seconds east of Universal Time, and the string
1114 ABBR is a time zone abbreviation.  The affected functions are
1115 'current-time-string', 'current-time-zone', 'decode-time',
1116 'format-time-string', and 'set-time-zone-rule'.
1119 ** 'format-time-string' now formats "%q" to the calendar quarter.
1121 ** New built-in function 'mapcan' which avoids unnecessary consing (and garbage
1122 collection).
1125 ** 'car' and 'cdr' compositions 'cXXXr' and 'cXXXXr' are now part of Elisp.
1128 ** 'if-let*', 'when-let*', and 'and-let*' are new in subr-x.el.
1129 The incumbent 'if-let' and 'when-let' are now aliases.
1131 ** Low-level list functions like 'length' and 'member' now do a better
1132 job of signaling list cycles instead of looping indefinitely.
1135 ** The new functions 'make-nearby-temp-file' and 'temporary-file-directory'
1136 can be used for creation of temporary files of remote or mounted directories.
1139 ** The new function 'file-local-name' can be used to specify arguments
1140 of remote processes.
1143 ** The new functions 'file-name-quote', 'file-name-unquote' and
1144 'file-name-quoted-p' can be used to quote / unquote file names with
1145 the prefix "/:".
1148 ** The new error 'file-missing', a subcategory of 'file-error', is now
1149 signaled instead of 'file-error' if a file operation acts on a file
1150 that does not exist.
1153 ** The function 'delete-directory' no longer signals an error when
1154 operating recursively and when some other process deletes the directory
1155 or its files before 'delete-directory' gets to them.
1158 *** New error type 'user-search-failed' like 'search-failed' but
1159 avoids debugger like 'user-error'.
1161 ** Changes in Frame- and Window- Handling
1164 *** Resizing a frame no longer runs 'window-configuration-change-hook'.
1165 'window-size-change-functions' should be used instead.
1168 *** The new function 'frame-size-changed-p' can tell whether a frame has
1169 been resized since the last time 'window-size-change-functions' has been
1170 run.
1173 *** The function 'frame-geometry' now also returns the width of a
1174 frame's outer border.
1177 *** New frame parameters
1180 **** 'z-group' positions a frame above or below all others.
1183 **** 'min-width' and 'min-height' specify the absolute minimum size of a
1184 frame.
1187 **** 'parent-frame' makes a frame the child frame of another Emacs
1188 frame.  The section "Child Frames" in the Elisp manual describes the
1189 intrinsics of that relationship.
1192 **** 'delete-before' triggers deletion of one frame before that of
1193 another.
1196 **** 'mouse-wheel-frame' specifies another frame whose windows shall be
1197 scrolled instead.
1200 **** 'no-other-frame' has 'next-frame' and 'previous-frame' skip this
1201 frame.
1204 **** 'skip-taskbar' removes a frame's icon from the taskbar and has
1205 Alt-<TAB> skip this frame.
1208 **** 'no-focus-on-map' avoids that a frame gets input focus when mapped.
1211 **** 'no-accept-focus' means that a frame does not want to get input
1212 focus via the mouse.
1215 **** 'undecorated' removes the window manager decorations from a frame.
1218 **** 'override-redirect' tells the window manager to disregard this
1219 frame.
1222 *** The 'width' and 'height' frame parameters allow to specify pixel
1223 values now.
1226 *** The new function 'frame-list-z-order' returns a list of all frames
1227 in Z (stacking) order.
1230 *** The function 'x-focus-frame' optionally tries to not activate its
1231 frame.
1234 *** The variable 'focus-follows-mouse' has a third meaningful value
1235 'auto-raise' to indicate that the window manager automatically raises a
1236 frame when the mouse pointer enters it.
1239 *** The new function 'frame-restack' puts a frame above or below
1240 another on the display.
1243 *** The new face 'internal-border' specifies the background of a frame's
1244 internal border.
1247 *** The NORECORD argument of 'select-window' now has a meaningful value
1248 'mark-for-redisplay' which is like any other non-nil value but marks
1249 WINDOW for redisplay.
1252 *** Support for side windows is now official.  The display action
1253 function 'display-buffer-in-side-window' will display its buffer in a
1254 side window.  Functions for toggling all side windows on a frame,
1255 changing and reversing the layout of side windows and returning the main
1256 (major non-side) window of a frame are provided.  For details consult
1257 the section "Side Windows" in the Elisp manual.
1260 *** Support for atomic windows - rectangular compositions of windows
1261 treated by 'split-window', 'delete-window' and 'delete-other-windows'
1262 like a single live window - is now official.  For details consult the
1263 section "Atomic Windows" in the Elisp manual.
1266 *** New 'display-buffer' alist entry 'window-parameters' allows to
1267 assign window parameters to the window used for displaying the buffer.
1270 *** New function 'display-buffer-reuse-mode-window' is an action function
1271 suitable for use in 'display-buffer-alist'. For example, to avoid creating
1272 a new window when opening man pages when there's already one, use
1273 (add-to-list 'display-buffer-alist
1274      '("\\`\\*Man .*\\*\\'" .
1275        (display-buffer-reuse-mode-window
1276         (inhibit-same-window . nil)
1277         (mode . Man-mode))))
1280 *** New window parameter 'no-delete-other-window' prevents that
1281 its window gets deleted by 'delete-other-windows'.
1284 *** New command 'window-swap-states' swaps the states of two live
1285 windows.
1288 *** New functions 'window-pixel-width-before-size-change' and
1289 'window-pixel-height-before-size-change' support detecting which
1290 window changed size when 'window-size-change-functions' are run.
1293 *** The semantics of 'mouse-autoselect-window' has changed slightly.
1294 For details see the section "Mouse Window Auto-selection" in the Elisp
1295 manual.
1297 * Changes in Emacs 26.1 on Non-Free Operating Systems
1299 ** Intercepting hotkeys on Windows 7 and later now works better.
1300 The new keyboard hooking code properly grabs system hotkeys such as
1301 Win-* and Alt-TAB, in a way that Emacs can get at them before the
1302 system.  This makes the 'w32-register-hot-key' functionality work
1303 again on all versions of MS-Windows starting with Windows 7.  On
1304 Windows NT and later you can now register any hotkey combination.  (On
1305 Windows 9X, the previous limitations, spelled out in the Emacs manual,
1306 still apply.)
1308 ** 'convert-standard-filename' no longer mirrors slashes on MS-Windows.
1309 Previously, on MS-Windows this function converted slash characters in
1310 file names into backslashes.  It no longer does that.  If your Lisp
1311 program used 'convert-standard-filename' to prepare file names to be
1312 passed to subprocesses (which is not the recommended usage of that
1313 function), you will now have to mirror slashes in your application
1314 code.  One possible way is this:
1316          (let ((start 0))
1317            (while (string-match "/" file-name start)
1318              (aset file-name (match-beginning 0) ?\\)
1319              (setq start (match-end 0))))
1321 ** GUI sessions now treat SIGINT like Posix platforms do.
1322 The effect of delivering a Ctrl-C (SIGINT) signal to a GUI Emacs on
1323 MS-Windows is now the same as on Posix platforms -- Emacs saves the
1324 session and exits.  In particular, this will happen if you start
1325 emacs.exe from the Windows shell, then type Ctrl-C into that shell's
1326 window.
1329 ** 'signal-process' supports SIGTRAP on Windows XP and later.
1330 The 'kill' emulation on Windows now maps SIGTRAP to a call to the
1331 'DebugBreakProcess' API.  This causes the receiving process to break
1332 execution and return control to the debugger.  If no debugger is
1333 attached to the receiving process, the call is typically ignored.
1334 This is in contrast to the default action on POSIX Systems, where it
1335 causes the receiving process to terminate with a core dump if no
1336 debugger has been attached to it.
1338 ** `set-mouse-position' and `set-mouse-absolute-pixel-position' work
1339 on macOS.
1342 ----------------------------------------------------------------------
1343 This file is part of GNU Emacs.
1345 GNU Emacs is free software: you can redistribute it and/or modify
1346 it under the terms of the GNU General Public License as published by
1347 the Free Software Foundation, either version 3 of the License, or
1348 (at your option) any later version.
1350 GNU Emacs is distributed in the hope that it will be useful,
1351 but WITHOUT ANY WARRANTY; without even the implied warranty of
1353 GNU General Public License for more details.
1355 You should have received a copy of the GNU General Public License
1356 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
1359 Local variables:
1360 coding: utf-8
1361 mode: outline
1362 paragraph-separate: "[  \f]*$"
1363 end: