From: Glenn Morris Date: Thu, 29 Aug 2019 18:11:21 +0000 (-0700) Subject: Merge from origin/emacs-26 X-Git-Tag: emacs-27.0.90~1328^2~43 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=5a3e501edd61e20454fff775d779d906185f3247;p=emacs.git Merge from origin/emacs-26 290fe4d * ; ChangeLog.3 update e8f176b * etc/NEWS: Delete temporary markup. # Conflicts: # ChangeLog.3 # etc/NEWS --- 5a3e501edd61e20454fff775d779d906185f3247 diff --cc ChangeLog.3 index c04940257fa,117b57d73c1..48d1c66306e --- a/ChangeLog.3 +++ b/ChangeLog.3 @@@ -1,4 -1,547 +1,548 @@@ -2019-08-21 Nicolas Petton ++2019-08-29 Nicolas Petton + + * etc/NEWS: Delete temporary markup. + -2019-08-20 Noam Postavsky ++2019-08-29 Noam Postavsky + + Fix process filter documentation (Bug#13400) + + * doc/lispref/processes.texi (Asynchronous Processes): Note that input + may read when sending data as well. + (Output from Processes): Note that functions which send data may also + trigger reading from processes. + (Input to Processes, Filter Functions): Note that filter functions may + be called recursively. + -2019-08-19 Tino Calancha ++2019-08-29 Tino Calancha + + Fix query-replace-regexp undo feature + + Ensure that non-regexp strings used with `looking-at' are quoted. + * lisp/replace.el (perform-replace): Quote regexp (Bug#37073). + * test/lisp/replace-tests.el (replace-tests-perform-replace-regexp-flag): + New variable. + (replace-tests-with-undo): Use it. + (query-replace-undo-bug37073): Add tests. + -2019-08-18 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + Support the new Japanese era name + + * admin/unidata/NormalizationTest.txt: + * admin/unidata/UnicodeData.txt: Add U+32FF SQUARE ERA NAME REIWA. + Do not merge to master. + + * test/lisp/international/ucs-normalize-tests.el + (ucs-normalize-tests--failing-lines-part1) + (ucs-normalize-tests--failing-lines-part2): Update. Do not + merge to master. + + * etc/NEWS: Mention the change. + -2019-08-18 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + Fix a typo in char-width-table + + * lisp/international/characters.el (char-width-table): Fix a + typo in zero-width characters. + -2019-08-17 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + Minor update in admin/notes/unicode + + * admin/notes/unicode: Mention changes to be done in + setup-default-fontset in fontset.el. (Bug#14461) + -2019-08-17 Noam Postavsky ++2019-08-29 Noam Postavsky + + Fix lisp indent infloop on unfinished strings (Bug#37045) + + * lisp/emacs-lisp/lisp-mode.el (lisp-indent-calc-next): Stop trying to + skip over strings if we've hit the end of buffer. + * test/lisp/emacs-lisp/lisp-mode-tests.el + (lisp-indent-unfinished-string): New test. + -2019-08-17 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + Improve commentary in composite.el + + * lisp/composite.el (compose-gstring-for-graphic) + (compose-gstring-for-terminal): Add comments that explain + Unicode General Category mnemonics in human-readable terms. + (Bug#14461) + -2019-08-16 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + Fix markup in dired-x.texi + + * doc/misc/dired-x.texi (Omitting Variables) + (Local Variables, Shell Command Guessing) + (Advanced Cleaning Variables, Special Marking Function): Fix + markup and indexing. (Bug#14212) + -2019-08-10 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + * src/callproc.c (Fcall_process): Doc fix. + -2019-08-10 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + Improve documentation of features that use the fringes + + * doc/emacs/display.texi (Fringes): Add cross-reference to + where indicate-empty-lines is described. + (Useless Whitespace): Add an @anchor for a more accurate + cross-reference in "Fringes". + -2019-08-10 Mauro Aranda ++2019-08-29 Mauro Aranda + + Fix docstrings in pong + + * lisp/play/pong.el (pong-move-left pong-move-right): Refer to the + right bats and directions of movement. (Bug#36959) + -2019-08-09 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + Improve doc strings of 'append-to-buffer' and friends + + * lisp/simple.el (append-to-buffer, prepend-to-buffer) + (copy-to-buffer): Doc fixes. + -2019-08-08 Mauro Aranda ++2019-08-29 Mauro Aranda + + Fix octave-mode ElDoc support + + * lisp/progmodes/octave.el (octave-eldoc-function-signatures): Fix the + regexp used, so no match happens when there is no defined function FN. + Also, tweak the regexp to support GNU Octave 4.2.x and newer. (Bug#36459) + -2019-08-08 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + Avoid Groff hanging on MS-Windows when invoked by "M-x man" + + * lisp/man.el (Man-build-man-command): On MS-Windows, redirect + stdin of 'man' to the null device, to make sure Groff exits + immediately after formatting the man page. + -2019-08-07 Philipp Stephani ++2019-08-29 Philipp Stephani + + Ignore pending_signals when checking for quits. + + pending_signals is often set if no quit is pending. This results in + bugs in module code if the module returns but no quit is actually + pending. + + * src/emacs-module.c (module_should_quit): Use QUITP macro to check + whether the caller should quit. + + * src/eval.c: Remove obsolete comment. + -2019-08-03 Basil L. Contovounesios ++2019-08-29 Basil L. Contovounesios + + Fix nnmail-expiry-wait docs and custom :types + + * doc/misc/gnus.texi (Group Parameters, Expiring Mail): + * lisp/gnus/gnus-cus.el (gnus-group-parameters): Clarify + descriptions of nnmail-expiry, nnmail-expiry-wait, and + nnmail-expiry-wait-function. + * lisp/gnus/nnmail.el (nnmail-expiry-wait) + (nnmail-expiry-wait-function): Clarify docstrings and fix custom + :types (bug#36850). + -2019-08-03 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + * lisp/simple.el (kill-do-not-save-duplicates): Doc fix. (Bug#36827) + -2019-08-03 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + Improve documentation of debugging Lisp syntax error + + * doc/lispref/debugging.texi (Syntax Errors, Excess Open) + (Excess Close): Name the commands invoked by the key + sequences. Add cross-references to appropriate sections of + the Emacs manual. (Bug#21385) + + (cherry picked from commit faafd467a374c9398ee4668cdc173611d35693ed) + -2019-07-30 Noam Postavsky ++2019-08-29 Noam Postavsky + + Add index for "\( in strings" (Bug#25195) + + * doc/emacs/programs.texi (Left Margin Paren): Add index for "\( in + strings". + * doc/lispref/positions.texi (List Motion): Add index, and cross + reference. + -2019-07-30 Martin Rudalics ++2019-08-29 Martin Rudalics + + Fix doc-string of 'fit-window-to-buffer' (Bug#36848) + + * lisp/window.el (fit-window-to-buffer): Fix doc-string. + + Suggested by Drew Adams + -2019-07-26 Tino Calancha ++2019-08-29 Tino Calancha + + Update view-mode docstring + + Not all the kill commands save the text in the kill ring + by default (e.g. `kill-rectangle'). + It is more precise to just say that the kill commands save + the text and do not change the buffer (Bug#36741). + * lisp/view.el (view-mode): Update docstring. + -2019-07-26 Noam Postavsky ++2019-08-29 Noam Postavsky + + Fix subproc listening when setting filter to non-t (Bug#36591) + + * src/process.c (Fset_process_filter): Call add_process_read_fd + according to the state of process filter before it's updated. This + restores the correct functioning as it was before 2016-02-16 "Allow + setting the filter masks later". Inline the set_process_filter_masks + call instead of fixing it that function, because it is also called + from connect_network_socket, and we don't want to change the behavior + of that function so close to release. + * test/src/process-tests.el (set-process-filter-t): New test. + -2019-07-26 Noam Postavsky ++2019-08-29 Noam Postavsky + + * etc/NEWS.25: Belatedly announce rcirc-reconnect-delay. + -2019-07-26 Noam Postavsky ++2019-08-29 Noam Postavsky + + Mention term.el's \032 dir tracking in commentary (Bug#19524) + + * lisp/term.el: Mention both forms of directory tracking in + commentary. Remove obsolete ChangeLog comments. Move more relevant + summary comments to the top. + -2019-07-26 Stefan Kangas ++2019-08-29 Stefan Kangas + + Remove upload functionality of package-x from the elisp manual + + Suggested by Stefan Monnier. + Ref: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=19537#8 + + * doc/lispref/package.texi (Package Archives): Don't document + package-x upload functions in the elisp manual, since they are not + very commonly used. (Bug#19537) + * lisp/emacs-lisp/package-x.el (package-archive-upload-base) + (package-upload-buffer, package-upload-file): Add to the doc strings + any details removed from the elisp manual that would otherwise be + missing. + -2019-07-25 Nicolas Petton ++2019-08-29 Nicolas Petton + + * etc/AUTHORS: Update. + -2019-07-23 Basil L. Contovounesios ++2019-08-29 Basil L. Contovounesios + + Clarify Gravatar docs + + For discussion, see the following thread: + https://lists.gnu.org/archive/html/emacs-devel/2019-07/msg00528.html + * doc/misc/gnus.texi (X-Face): Fix cross-reference. + (Gravatars): + * lisp/gnus/gnus-gravatar.el (gnus-gravatar-too-ugly): + * lisp/image/gravatar.el (gravatar-cache-ttl, gravatar-rating) + (gravatar-size): Clarify user option descriptions. + (gravatar-retrieve, gravatar-retrieve-synchronously): Document + return value. + -2019-07-22 Alan Mackenzie ++2019-08-29 Alan Mackenzie + + * doc/lispref/display.texi (Defining Faces): Say a face can't be undefined. + -2019-07-21 Noam Postavsky ++2019-08-29 Noam Postavsky + + Handle completely undecoded input in term (Bug#29918) + + * lisp/term.el (term-emulate-terminal): Avoid errors if the whole + decoded string is eight-bit characters. Don't attempt to save the + string for next iteration in that case. + * test/lisp/term-tests.el (term-decode-partial) + (term-undecodable-input): New tests. + -2019-07-20 N. Jackson (tiny change) ++2019-08-29 N. Jackson (tiny change) + + * doc/misc/forms.texi (Control File Format): Fix a doc error. + + (Bug#36693) + -2019-07-17 Basil L. Contovounesios ++2019-08-29 Basil L. Contovounesios + + Fix typo in package-alist docstring + + Pointed out by Michael Heerdegen . + * lisp/emacs-lisp/package.el (package-alist): Fix docstring + grammar (bug#17403). + -2019-07-14 Markus Triska ++2019-08-29 Markus Triska + + * doc/lispref/text.texi (Mode-Specific Indent): Fix a typo (bug#36646). + -2019-07-13 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + Improve doc string of 'bidi-display-reordering' + + * src/buffer.c (syms_of_buffer) : + Further doc fix. + -2019-07-13 Stefan Kangas ++2019-08-29 Stefan Kangas + + Add warning to bidi-display-reordering doc string + + This explanation was given by Eli Zaretskii on emacs-devel. + For discussion, see: + https://lists.gnu.org/archive/html/emacs-devel/2019-07/msg00294.html + + * src/buffer.c (syms_of_buffer): Add warning to doc string of + bidi-display-reordering to explain that it should only be used for + debugging. + -2019-07-12 YAMAMOTO Mitsuharu ++2019-08-29 YAMAMOTO Mitsuharu + + Raise required librsvg version so as to match the current use + + * configure.ac: Set RSVG_REQUIRED to 2.14.0 as rsvg_handle_get_dimensions + needs it. + -2019-07-10 Michael Albinus ++2019-08-29 Michael Albinus + + * lisp/net/tramp-sh.el (tramp-inline-compress-start-size): Set nil on w32. + -2019-07-09 Stefan Monnier ++2019-08-29 Stefan Monnier + + * lisp/progmodes/verilog-mode.el: One more ELPA Version: + -2019-07-06 Stefan Monnier ++2019-08-29 Stefan Monnier + + * lisp/svg.el, lisp/progmodes/ada-mode.el: Fix bug#36360. + + Tell package.el their version number, for better behavior w.r.t the + versions available in GNU ELPA + -2019-07-06 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + Minor copyedit of "Font Lock" in user manual + + * doc/emacs/display.texi (Font Lock): Make the wording about + "enabling Font Lock" crystal clear. (Bug#36529) + -2019-07-06 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + Improve description of image descriptors + + * doc/lispref/display.texi (Image Descriptors): More accurate + description of where image files are looked up. (Bug#36523) + -2019-07-06 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + Improve documentation of secondary selections + + * doc/emacs/killing.texi (Secondary Selection): Improve + wording. Mention that 'M-mouse-1' can be used to cancel + secondary selections. (Bug#36365) + -2019-07-06 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + * src/fns.c (Fmapconcat): Doc fix. (Bug#36418) + -2019-07-06 YAMAMOTO Mitsuharu ++2019-08-29 YAMAMOTO Mitsuharu + + Avoid crash inside CFCharacterSetIsLongCharacterMember (Bug#36507) + + * src/macfont.m (macfont_supports_charset_and_languages_p) + (macfont_has_char): Don't pass integers outside the Unicode codespace to + CFCharacterSetIsLongCharacterMember. Do not merge to master. + -2019-07-06 Noam Postavsky ++2019-08-29 Noam Postavsky + + Fix python.el docstring (Bug#36458) + + * lisp/progmodes/python.el (python-shell--prompt-calculated-output-regexp): + python-shell-set-prompt-regexp doesn't exist, presumably + python-shell-prompt-set-calculated-regexps was meant. + -2019-07-03 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + * lisp/hi-lock.el (hi-lock-line-face-buffer): Doc fix. (Bug36448) + -2019-06-29 Stefan Kangas ++2019-08-29 Stefan Kangas + + Fix typo in doc string of file-exists-p (bug#36408) + + * src/fileio.c (Ffile_exists_p): Fix typo in doc string. + -2019-06-28 Juanma Barranquero ++2019-08-29 Juanma Barranquero + + * test/lisp/url/url-file-tests.el (url-file): Fix for POSIX filenames. + -2019-06-28 Stefan Kangas ++2019-08-29 Stefan Kangas + + Fix typo in windows.texi + + * doc/lispref/windows.texi (Window History): Fix typo. (Bug#36412) + -2019-06-26 Basil L. Contovounesios ++2019-08-29 Basil L. Contovounesios + + Clarify & update (elisp) Writing Emacs Primitives + + * doc/lispref/internals.texi (Writing Emacs Primitives): Update some + of the sample code listings, fixing argument lists and parentheses. + Replace ... with @dots{}. Describe UNEVALLED special forms as + taking a single argument. (bug#36392) + -2019-06-26 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + Clarify a subtle issue in the Internals chapter of lispref + + * doc/lispref/internals.texi (Writing Emacs Primitives): + Clarify the issue with relocation of buffer or string text as + side effect of Lisp evaluation. (Bug#36392) + -2019-06-26 Noam Postavsky ++2019-08-29 Noam Postavsky + + Fix sgml-mode handling of quotes within parens (Bug#36347) + + * lisp/textmodes/sgml-mode.el (sgml-syntax-propertize): Use + syntax-ppss-table if set. This is only needed on the release branch, + on master the caller (syntax-propertize) already does this. + (sgml-mode): Set syntax-ppss-table to sgml-tag-syntax-table. This + correctly classifies parens as punctuation, so they won't confuse the + parser. + * test/lisp/textmodes/sgml-mode-tests.el (sgml-tests--quotes-syntax): + New test copied from master, with two cases added for this bug. + -2019-06-21 Juanma Barranquero ++2019-08-29 Juanma Barranquero + + Rename 'make-symbolic-link' argument NEWNAME to LINKNAME + + * src/fileio.c (Fmake_symbolic_link): Fix docstring. + * doc/lispref/files.texi (Changing Files): Doc fix. + -2019-06-20 Robert Pluim ++2019-08-29 Robert Pluim + + Check that length of data returned by sysctl is non-zero + + The length of the data returned by sysctl can be zero, which was not + checked for. This could cause crashes, e.g. when querying + non-existent processes. (Bug#36279) + + * src/sysdep.c (list_system_processes) [DARWIN_OS || __FreeBSD__]: + (system_process_attributes) [__FreeBSD__]: + (system_process_attributes) [DARWIN_OS]: + * src/filelock.c (get_boot_time) [CTL_KERN && KERN_BOOTTIME]: Check + for zero length data returned by sysctl. + -2019-06-17 Juanma Barranquero ++2019-08-29 Juanma Barranquero + + * test/lisp/progmodes/python-tests.el (python-virt-bin): Doc fix. + -2019-06-17 Juanma Barranquero ++2019-08-29 Juanma Barranquero + + Fix Python tests depending on system-type + + * test/lisp/progmodes/python-tests.el (python-virt-bin): New function. + (python-shell-calculate-exec-path-2) + (python-shell-calculate-exec-path-3) + (python-shell-calculate-exec-path-4) + (python-shell-with-environment-1, python-shell-with-environment-2): + Use it. + -2019-06-16 Juanma Barranquero ++2019-08-29 Juanma Barranquero + + Fix problem with wdired test when symlinks cannot be created. + + * test/lisp/wdired-tests.el (wdired-test-symlink-name): + Skip test if 'make-symbolic-link' fails for whatever reason; + that's not what's being tested. + -2019-06-16 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + Improve wording of documentation of click events + + * doc/lispref/commands.texi (Click Events, Accessing Mouse): + Improve and clarify wording. (Bug#36232) + -2019-06-16 Mattias Engdegård ++2019-08-29 Mattias Engdegård + + Backport: Fix typo in regexp-opt example code + + * doc/lispref/searching.texi (Regexp Functions): + Fix typo in example code (Bug#34596). + -2019-06-15 Stefan Kangas ++2019-08-29 Stefan Kangas + + Remove outdated comment in winner.el (Bug#36185) + + * lisp/winner.el: Remove outdated comment. + -2019-06-15 Michael Albinus ++2019-08-29 Michael Albinus + + Fix accidential change in tramp-tests; do not merge with master + + * lisp/net/trampver.el: Change version to "2.3.5.26.3". + (customize-package-emacs-version-alist): Add Tramp version + integrated in Emacs 26.3. + + * test/lisp/net/tramp-tests.el (tramp-test42-auto-load): + Add skip for w32. + -2019-06-15 Juanma Barranquero ++2019-08-29 Juanma Barranquero + + tramp-test42-auto-load: Add expected-result. + + * test/lisp/net/tramp-tests.el (tramp-test42-auto-load): + Expect a failed result if remote file access is not enabled, + as it happens while doing the test on Windows. + -2019-06-15 Juanma Barranquero ++2019-08-29 Juanma Barranquero + + * test/lisp/url/url-file-tests.el (url-file): Use file:///, not file://. + -2019-06-15 Juanma Barranquero ++2019-08-29 Juanma Barranquero + + Fix doc of srecompile-compile-split-code (Bug#36200) + + * lisp/cedet/srecode/compile.el (srecode-compile-split-code): + Remove leftover text from docstring. + -2019-06-14 Eric Abrahamsen ++2019-08-29 Eric Abrahamsen + + Make sure Gnus imap group names are decoded before searching + + do not merge (fix unnecessary in Emacs 27) + + * lisp/gnus/nnir.el (nnir-run-imap): Ensure that non-ascii group names + have been fully decoded before passing them to imap search. + -2019-06-14 Eli Zaretskii ++2019-08-29 Eli Zaretskii + + Remove failing test erroneously added in backport + + * test/src/thread-tests.el (threads-test-bug33073): Remove + test which cannot work on the emacs-26 branch. Do not merge + to master. Reported by Juanma Barranquero . + -2019-06-14 Juanma Barranquero ++2019-08-29 Juanma Barranquero + + * lisp/net/sieve-manage.el (sieve-manage-parse-capability): Doc fix. + -2019-06-12 Nicolas Petton ++2019-08-29 Nicolas Petton + + Bump Emacs version to 26.2.90 + + * README: + * configure.ac: + * msdos/sed2v2.inp: + * nt/README.W32: Bump Emacs version. + -2019-06-12 Nicolas Petton ++2019-08-29 Nicolas Petton + + * etc/AUTHORS: Update. + -2019-06-12 Martin Rudalics ++2019-08-29 Martin Rudalics +2019-06-15 Martin Rudalics Fix description of 'display-buffer-in-previous-window' again (Bug#36161) diff --cc etc/NEWS.26 index 9beb79c150a,00000000000..11c526c56ed mode 100644,000000..100644 --- a/etc/NEWS.26 +++ b/etc/NEWS.26 @@@ -1,1953 -1,0 +1,1932 @@@ +GNU Emacs NEWS -- history of user-visible changes. + +Copyright (C) 2016-2019 Free Software Foundation, Inc. +See the end of the file for license conditions. + +Please send Emacs bug reports to 'bug-gnu-emacs@gnu.org'. +If possible, use 'M-x report-emacs-bug'. + +This file is about changes in Emacs version 26. + +See file HISTORY for a list of GNU Emacs versions and release dates. +See files NEWS.25, NEWS.24, ..., NEWS.18, and NEWS.1-17 for changes +in older Emacs versions. + +You can narrow news to a specific version by calling 'view-emacs-news' +with a prefix argument or by typing 'C-u C-h C-n'. + - - * Installation Changes in Emacs 26.3 - - - * Startup Changes in Emacs 26.3 - + +* Changes in Emacs 26.3 - - +++ ++ +** New option 'help-enable-completion-auto-load'. +This allows disabling the new feature introduced in Emacs 26.1 which +loads files during completion of 'C-h f' and 'C-h v' according to +'definition-prefixes'. + - - * Editing Changes in Emacs 26.3 - - - * Changes in Specialized Modes and Packages in Emacs 26.3 - - - * New Modes and Packages in Emacs 26.3 - - - * Incompatible Lisp Changes in Emacs 26.3 - - - * Lisp Changes in Emacs 26.3 - - - * Changes in Emacs 26.3 on Non-Free Operating Systems ++** Emacs now supports the new Japanese Era name. ++The newly assigned codepoint U+32FF was added to the Unicode Character ++Database compiled into Emacs. + + +* Installation Changes in Emacs 26.2 + +** Building Emacs with the '--with-xwidgets' option now requires WebKit2. +To build Emacs with xwidgets support, you will need to install the +webkit2gtk-4.0 package; version 2.12 or later is required. +(This change was actually made in Emacs 26.1, but was not called out +in its NEWS.) + +** Installing Emacs now installs the emacs-module.h file. +The emacs-module.h file is now installed in the system-wide include +directory as part of the Emacs installation. This allows to build +Emacs modules outside of the Emacs source tree. + + +* Changes in Emacs 26.2 + +** Emacs is now compliant with the latest version 11.0 of the Unicode Standard. + +** New variable 'xft-ignore-color-fonts'. +Default t means don't try to load color fonts when using Xft, as they +often cause crashes. Set it to nil if you really need those fonts. + + +* Changes in Specialized Modes and Packages in Emacs 26.2 + +** Dired + +*** The 'Z' command on a directory name compresses all of its files. +It produces a compressed '.tar.gz' archive with all the files in the +directory and all of its subdirectories. For symmetry, 'Z' on a +'.tar.gz' or a '.tgz' archive extracts all the archived files into the +current directory; thus, typing 'Z' on a '.tar.gz' archive created by +a previous 'Z' command will extract the archived files into a +directory whose name is the archive name sans the '.tar.gz' extension. +(This change was actually made in Emacs 25.1 but was only +partially called out in its NEWS; 'tgz' handling was added in 26.1.) + +** Ibuffer + +*** New toggle 'ibuffer-do-toggle-lock', bound to 'L'. + +** Imenu + +*** The value for 'imenu-auto-rescan-maxout' has been increased to 600000. + +** Gnus + +*** Mailutils movemail will now be used if found at runtime. +The default value of 'mail-source-movemail-program' is now "movemail". +This ensures that the movemail program from GNU Mailutils will be used +if found in 'exec-path', even if it was not found at build time. To +use a different program, customize 'mail-source-movemail-program' to the +absolute file name of the desired executable. + +** Shadowfile + +*** shadowfile.el has been rewritten to support Tramp file names. + +** Shell mode + +*** Shell mode buffers now have 'scroll-conservatively' set to 101. +This is so as to better emulate the scrolling behavior of a text +terminal when new output is added to the screen buffer. To get back +the previous behavior, reset 'scroll-conservatively' to zero (or any +other value you like) in a function and add it to 'shell-mode-hook'. +(This change was actually made in Emacs 26.1, but was not called out +in its NEWS.) + +** VC + +*** VC support for Mercurial was improved. +Emacs now avoids invoking 'hg' as much as possible, for faster operation. +(This and the following changes were actually made in Emacs 26.1, but +were not called out in its NEWS.) + +**** New vc-hg options. +The new option 'vc-hg-parse-hg-data-structures' controls whether vc-hg +will try parsing the Mercurial data structures directly instead of +running 'hg'; it defaults to t (set to nil if you want the pre-26.1 +behavior). +The new option 'vc-hg-symbolic-revision-styles' controls how versions +in a Mercurial repository are presented symbolically on the mode line. +The new option 'vc-hg-use-file-version-for-mode-line-version' controls +whether the version shown on the mode line is that of the visited file +or of the repository working copy. + +**** Display of Mercurial revisions in the mode line has changed. +Previously, the mode line displayed the local number (1, 2, 3, ...) of +the revision. Starting with Emacs 26.1, the default has changed, and +it now shows the global revision number, in the form of its changeset +hash value. To get back the previous behavior, customize the new +option 'vc-hg-symbolic-revision-styles' to the value '("{rev}")'. + + +* Incompatible Lisp Changes in Emacs 26.2 + +** shadowfile config files have changed their syntax. +Existing files "~/.emacs.d/shadows" and "~/.emacs.d/shadow_todo" must +be removed prior using the changed 'shadow-*' commands. + +** 'thread-alive-p' has been renamed to 'thread-live-p'. +The old name is an alias of the new name. Future Emacs version will +obsolete it. + +** 'while-no-input' does not return due to input from subprocesses. +Input that arrived from subprocesses while some code executed inside +the 'while-no-input' form injected an internal buffer-switch event +that counted as input and would cause 'while-no-input' to return, +perhaps prematurely. These buffer-switch events are now by default +ignored by 'while-no-input'; if you need to get the old behavior, +remove 'buffer-switch' from the list of events in +'while-no-input-ignore-events'. + + +* Lisp Changes in Emacs 26.2 + +** The new function 'read-answer' accepts either long or short answers +depending on the new customizable variable 'read-answer-short'. + +** New function 'assoc-delete-all'. +Like 'assq-delete-all', but uses 'equal' for comparison. + +** The function 'thing-at-point' behaves as before Emacs 26.1. +The behavior of 'thing-at-point' when called with argument 'list' has +changed in Emacs 26.1, in that it didn't consider text inside comments +and strings as a potential list. This change is now reverted, and +'thing-at-point' behaves like it did before Emacs 26.1. + +** To cater to use cases where comments and strings are to be ignored +when looking for a list, the function 'list-at-point' now takes an +optional argument to do so. + + +* Changes in Emacs 26.2 on Non-Free Operating Systems + +** macOS features can now be detected at run-time as well as at +build-time. See nextstep/INSTALL for details. +(This change was actually made in Emacs 26.1, but was undocumented and +not called out in its NEWS.) + + +* Installation Changes in Emacs 26.1 + +** By default libgnutls is now required when building Emacs. +Use 'configure --with-gnutls=no' to build even when GnuTLS is missing. + +** GnuTLS version 2.12.2 or later is now required, instead of merely +version 2.6.6 or later. + +** The new option 'configure --with-mailutils' causes Emacs to rely on +GNU Mailutils to retrieve email. It is recommended, and is the +default if GNU Mailutils is installed. When '--with-mailutils' is not +in effect, the Emacs build procedure by default continues to build and +install a limited 'movemail' substitute that retrieves POP3 email only +via insecure channels. To avoid this problem, use either +'--with-mailutils' or '--without-pop' when configuring; '--without-pop' +is the default on platforms other than native MS-Windows. + +** The new option 'configure --enable-gcc-warnings=warn-only' causes +GCC to issue warnings without stopping the build. This behavior is +now the default in developer builds. As before, use +'--disable-gcc-warnings' to suppress GCC's warnings, and +'--enable-gcc-warnings' to stop the build if GCC issues warnings. + +** When GCC warnings are enabled, '--enable-check-lisp-object-type' is +now enabled by default when configuring. + +** The Emacs server now has socket-launching support. +This allows socket based activation, where an external process like +systemd can invoke the Emacs server process upon a socket connection +event and hand the socket over to Emacs. Emacs uses this socket to +service emacsclient commands. This new functionality can be disabled +with the configure option '--disable-libsystemd'. + +** A systemd user unit file is provided. +Use it in the standard way: 'systemctl --user enable emacs'. (If your +Emacs is installed in a non-standard location, you may need to copy +the emacs.service file to eg ~/.config/systemd/user/) + +** New configure option '--disable-build-details' attempts to build an +Emacs that is more likely to be reproducible; that is, if you build +and install Emacs twice, the second Emacs is a copy of the first. +Deterministic builds omit the build date from the output of the +'emacs-version' and 'erc-cmd-SV' functions, and the leave the +following variables nil: 'emacs-build-system', 'emacs-build-time', +'erc-emacs-build-time'. + +** Emacs can now be built with support for Little CMS. +If the lcms2 library is installed, Emacs will enable features built on +top of that library. The new configure option '--without-lcms2' can +be used to build without lcms2 support even if it is installed. Emacs +linked to Little CMS exposes color management functions in Lisp: the +color metrics 'lcms-cie-de2000' and 'lcms-cam02-ucs', as well as +functions for conversion to and from CIE CAM02 and CAM02-UCS. + +** The configure option '--with-gameuser' now defaults to 'no', +as this appears to be the most common configuration in practice. +When it is 'no', the shared game directory and the auxiliary program +update-game-score are no longer needed and are not installed. + +** Emacs no longer works on IRIX. We expect that Emacs users are not +affected by this, as SGI stopped supporting IRIX in December 2013. + + +* Startup Changes in Emacs 26.1 + +** New option '--fg-daemon'. This is the same as '--daemon', except +it runs in the foreground and does not fork. This is intended for +modern init systems such as systemd, which manage many of the traditional +aspects of daemon behavior themselves. '--bg-daemon' is now an alias +for '--daemon'. + +** New option '--module-assertions'. +When given this option, Emacs will perform expensive correctness +checks when dealing with dynamic modules. This is intended for module +authors that wish to verify that their module conforms to the module +requirements. The option makes Emacs abort if a module-related +assertion triggers. + +** Emacs now supports 24-bit colors on capable text terminals. +Terminal is automatically initialized to use 24-bit colors if the +required capabilities are found in terminfo. See the FAQ node +"(efaq) Colors on a TTY" for more information. + +** Emacs now obeys the X resource "scrollBar" at startup. +The effect is similar to that of "toolBar" resource on the tool bar. + + +* Changes in Emacs 26.1 + +** Option 'buffer-offer-save' can be set to new value, 'always'. +When set to 'always', the command 'save-some-buffers' will always +offer this buffer for saving. + +** Security vulnerability related to Enriched Text mode is removed. + +*** Enriched Text mode does not evaluate Lisp in 'display' properties. +This feature allows saving 'display' properties as part of text. +Emacs 'display' properties support evaluation of arbitrary Lisp forms +as part of processing the property for display, so displaying Enriched +Text could be vulnerable to executing arbitrary malicious Lisp code +included in the text (e.g., sent as part of an email message). +Therefore, execution of arbitrary Lisp forms in 'display' properties +decoded by Enriched Text mode is now disabled by default. Customize +the new option 'enriched-allow-eval-in-display-props' to a non-nil +value to allow Lisp evaluation in decoded 'display' properties. + +This vulnerability was introduced in Emacs 21.1. To work around that +in Emacs versions before 25.3, append the following to your ~/.emacs +init file: + + (eval-after-load "enriched" + '(defun enriched-decode-display-prop (start end &optional param) + (list start end))) + +** Functions in 'write-contents-functions' can fully short-circuit the +'save-buffer' process. Previously, saving a buffer that was not +visiting a file would always prompt for a file name. Now it only does +so if 'write-contents-functions' is nil (or all its functions return +nil). + +** New variable 'executable-prefix-env' for inserting magic signatures. +This variable affects the format of the interpreter magic number +inserted by 'executable-set-magic'. If non-nil, the magic number now +takes the form "#!/usr/bin/env interpreter", otherwise the value +determined by 'executable-prefix', which is by default +"#!/path/to/interpreter". By default, 'executable-prefix-env' is nil, +so the default behavior is not changed. + +** The variable 'emacs-version' no longer includes the build number. +This is now stored separately in a new variable, 'emacs-build-number'. + +** Emacs now provides a limited form of concurrency with Lisp threads. +Concurrency in Emacs Lisp is "mostly cooperative", meaning that +Emacs will only switch execution between threads at well-defined +times: when Emacs waits for input, during blocking operations related +to threads (such as mutex locking), or when the current thread +explicitly yields. Global variables are shared among all threads, but +a 'let' binding is thread-local. Each thread also has its own current +buffer and its own match data. + +See the chapter "(elisp) Threads" in the ELisp manual for full +documentation of these facilities. + +** The new user variable 'electric-quote-chars' provides a list +of curved quotes for 'electric-quote-mode', allowing user to choose +the types of quotes to be used. + +** The new user option 'electric-quote-context-sensitive' makes +'electric-quote-mode' context sensitive. If it is non-nil, you can +type an ASCII apostrophe to insert an opening or closing quote, +depending on context. Emacs will replace the apostrophe by an opening +quote character at the beginning of the buffer, the beginning of a +line, after a whitespace character, and after an opening parenthesis; +and it will replace the apostrophe by a closing quote character in all +other cases. + +** The new variable 'electric-quote-inhibit-functions' controls when +to disable electric quoting based on context. Major modes can add +functions to this list; Emacs will temporarily disable +'electric-quote-mode' whenever any of the functions returns non-nil. +This can be used by major modes that derive from 'text-mode' but allow +inline code segments, such as 'markdown-mode'. + +** The new user variable 'dired-omit-case-fold' allows the user to +customize the case-sensitivity of dired-omit-mode. It defaults to +the same sensitivity as that of the filesystem for the corresponding +dired buffer. + +** Emacs now uses double buffering to reduce flicker when editing and +resizing graphical Emacs frames on the X Window System. This support +requires the DOUBLE-BUFFER extension, which major X servers have +supported for many years. If your system has this extension, but an +Emacs built with double buffering misbehaves on some displays you use, +you can disable the feature by adding + + '(inhibit-double-buffering . t) + +to default-frame-alist. Or inject this parameter into the selected +frame by evaluating this form: + + (modify-frame-parameters nil '((inhibit-double-buffering . t))) + +** The customization group 'wp', whose label was "text", is now +deprecated. Use the new group 'text', which inherits from 'wp', +instead. + +** The new function 'call-shell-region' executes a command in an +inferior shell with the buffer region as input. + +** The new user option 'shell-command-dont-erase-buffer' controls +if the output buffer is erased between shell commands; if non-nil, +the output buffer is not erased; this variable also controls where +to set the point in the output buffer: beginning of the output, +end of the buffer or save the point. +When 'shell-command-dont-erase-buffer' is nil, the default value, +the behavior of 'shell-command', 'shell-command-on-region' and +'async-shell-command' is as usual. + +** The new user option 'async-shell-command-display-buffer' controls +whether the output buffer of an asynchronous command is shown +immediately, or only when there is output. + +** New user option 'mouse-select-region-move-to-beginning'. +This option controls the position of point when double-clicking +mouse-1 on the end of a parenthetical grouping or string-delimiter: +the default value nil keeps point at the end of the region, setting it +to non-nil moves point to the beginning of the region. + +** New user option 'mouse-drag-and-drop-region'. +This option allows you to drag the entire region of text to another +place or another buffer. Its behavior is customizable via the new +options 'mouse-drag-and-drop-region-cut-when-buffers-differ', +'mouse-drag-and-drop-region-show-tooltip', and +'mouse-drag-and-drop-region-show-cursor'. + +** The new user option 'confirm-kill-processes' allows the user to +skip a confirmation prompt for killing subprocesses when exiting +Emacs. When set to t (the default), Emacs will prompt for +confirmation before killing subprocesses on exit, which is the same +behavior as before. + +** 'find-library-name' will now fall back on looking at 'load-history' +to try to locate libraries that have been loaded with an explicit path +outside 'load-path'. + +** Faces in 'minibuffer-prompt-properties' no longer overwrite properties +in the text in functions like 'read-from-minibuffer', but instead are +added to the end of the face list. This allows users to say things +like '(read-from-minibuffer (propertize "Enter something: " 'face 'bold))'. + +** The new variable 'extended-command-suggest-shorter' has been added +to control whether to suggest shorter 'M-x' commands or not. + +** icomplete now respects 'completion-ignored-extensions'. + +** Non-breaking hyphens are now displayed with the 'nobreak-hyphen' +face instead of the 'escape-glyph' face. + +** Approximations to quotes are now displayed with the new 'homoglyph' +face instead of the 'escape-glyph' face. + +** New face 'header-line-highlight'. +This face is the header-line analogue of 'mode-line-highlight'; it +should be the preferred mouse-face for mouse-sensitive elements in the +header line. + +** 'C-x h' ('mark-whole-buffer') will now avoid marking the prompt +part of minibuffers. + +** 'fill-paragraph' no longer marks the buffer as changed unless it +actually changed something. + +** The locale language name 'ca' is now mapped to the language +environment 'Catalan', which has been added. + +** 'align-regexp' has a separate history for its interactive argument. +'align-regexp' no longer shares its history with all other +history-less functions that use 'read-string'. + +** The networking code has been reworked so that it's more +asynchronous than it was (when specifying :nowait t in +'make-network-process'). How asynchronous it is varies based on the +capabilities of the system, but on a typical GNU/Linux system the DNS +resolution, the connection, and (for TLS streams) the TLS negotiation +are all done without blocking the main Emacs thread. To get +asynchronous TLS, the TLS boot parameters have to be passed in (see +the manual for details). + +Certain process oriented functions (like 'process-datagram-address') +will block until socket setup has been performed. The recommended way +to deal with asynchronous sockets is to avoid interacting with them +until they have changed status to "run". This is most easily done +from a process sentinel. + +** 'make-network-process' and 'open-network-stream' sometimes allowed +:service to be an integer string (e.g., :service "993") and sometimes +required an integer (e.g., :service 993). This difference has been +eliminated, and integer strings work everywhere. + +** It is possible to disable attempted recovery on fatal signals. +Two new variables support disabling attempts to recover from stack +overflow and to avoid automatic auto-save when Emacs is delivered a +fatal signal. 'attempt-stack-overflow-recovery', if set to nil, +will disable attempts to recover from C stack overflows; Emacs will +then crash as with any other fatal signal. +'attempt-orderly-shutdown-on-fatal-signal', if set to nil, will +disable attempts to auto-save the session and shut down in an orderly +fashion when Emacs receives a fatal signal; instead, Emacs will +terminate immediately. Both variables are non-nil by default. +These variables are for users who would like to avoid the small +probability of data corruption due to techniques Emacs uses to recover +in these situations. + +** File local and directory local variables are now initialized each +time the major mode is set, not just when the file is first visited. +These local variables will thus not vanish on setting a major mode. + +** A second dir-local file (.dir-locals-2.el) is now accepted. +See the doc string of 'dir-locals-file' for more information. + +** Connection-local variables can be used to specify local variables +with a value depending on the connected remote server. For details, +see the node "(elisp) Connection Local Variables" in the ELisp manual. + +** International domain names (IDNA) are now encoded via the new +puny.el library, so that one can visit Web sites with non-ASCII URLs. + +** The new 'list-timers' command lists all active timers in a buffer, +where you can cancel them with the 'c' command. + +** 'switch-to-buffer-preserve-window-point' now defaults to t. +Applications that call 'switch-to-buffer' and want to show the buffer at +the position of its point should use 'pop-to-buffer-same-window' in lieu +of 'switch-to-buffer'. + +** The new variable 'debugger-stack-frame-as-list' allows displaying +all call stack frames in a Lisp backtrace buffer as lists. Both +debug.el and edebug.el have been updated to heed to this variable. + +** Values in call stack frames are now displayed using 'cl-prin1'. +The old behavior of using 'prin1' can be restored by customizing the +new option 'debugger-print-function'. + +** NUL bytes in text copied to the system clipboard are now replaced with "\0". + +** The new variable 'x-ctrl-keysym' has been added to the existing +roster of X keysyms. It can be used in combination with another +variable of this kind to swap modifiers in Emacs. + +** New input methods: 'cyrillic-tuvan', 'polish-prefix', 'uzbek-cyrillic'. + +** The 'dutch' input method no longer attempts to support Turkish too. +Also, it no longer converts 'IJ' and 'ij' to the compatibility +characters U+0132 LATIN CAPITAL LIGATURE IJ and U+0133 LATIN SMALL +LIGATURE IJ. + +** File name quoting by adding the prefix "/:" is now possible for the +local part of a remote file name. Thus, if you have a directory named +"/~" on the remote host "foo", you can prevent it from being +substituted by a home directory by writing it as "/foo:/:/~/file". + +** The new variable 'maximum-scroll-margin' allows having effective +settings of 'scroll-margin' up to half the window size, instead of +always restricting the margin to a quarter of the window. + +** Emacs can scroll horizontally using mouse, touchpad, and trackbar. +You can enable this by customizing 'mouse-wheel-tilt-scroll'. If you +want to reverse the direction of the scroll, customize +'mouse-wheel-flip-direction'. + +** The default GnuTLS priority string now includes %DUMBFW. +This is to avoid bad behavior in some firewalls, which causes the +connection to be closed by the remote host. + +** Emacsclient changes + +*** Emacsclient has a new option '-u' / '--suppress-output'. +This option suppresses display of return values from the server +process. + +*** Emacsclient has a new option '-T' / '--tramp'. +This helps with using a local Emacs session as the server for a remote +emacsclient. With appropriate setup, one can now set the EDITOR +environment variable on a remote machine to emacsclient, and +use the local Emacs to edit remote files via Tramp. See the node +"(emacs) emacsclient Options" in the user manual for the details. + +*** Emacsclient now accepts command-line options in ALTERNATE_EDITOR +and '--alternate-editor'. For example, ALTERNATE_EDITOR="emacs -Q -nw". +Arguments may be quoted "like this", so that for example an absolute +path containing a space may be specified; quote escaping is not +supported. + +** New user option 'dig-program-options' and extended functionality +for DNS-querying functions 'nslookup-host', 'dns-lookup-host', +and 'run-dig'. Each function now accepts an optional name server +argument interactively (with a prefix argument) and non-interactively. + +** 'describe-key-briefly' now ignores mouse movement events. + +** The new variable 'eval-expression-print-maximum-character' prevents +large integers from being displayed as characters by 'M-:' and similar +commands. + +** Two new commands for finding the source code of Emacs Lisp +libraries: 'find-library-other-window' and 'find-library-other-frame'. + +** The new variable 'display-raw-bytes-as-hex' allows you to change +the display of raw bytes from octal to hex. + +** You can now provide explicit field numbers in format specifiers. +For example, '(format "%2$s %1$s %2$s" "X" "Y")' produces "Y X Y". + +** Emacs now supports optional display of line numbers in the buffer. +This is similar to what 'linum-mode' provides, but much faster and +doesn't usurp the display margin for the line numbers. Customize the +buffer-local variable 'display-line-numbers' to activate this optional +display. Alternatively, you can use the 'display-line-numbers-mode' +minor mode or the global 'global-display-line-numbers-mode'. When +using these modes, customize 'display-line-numbers-type' with the same +value as you would use with 'display-line-numbers'. + +Line numbers are not displayed at all in minibuffer windows and in +tooltips, as they are not useful there. + +Lisp programs can disable line-number display for a particular screen +line by putting the 'display-line-numbers-disable' text property or +overlay property on the first character of that screen line. This is +intended for add-on packages that need a finer control of the display. + +Lisp programs that need to know how much screen estate is used up for +line-number display in a window can use the new function +'line-number-display-width'. + +'linum-mode' and all similar packages are henceforth becoming obsolete. +Users and developers are encouraged to switch to this new feature +instead. + +** The new user option 'arabic-shaper-ZWNJ-handling' controls how to +handle ZWNJ in Arabic text rendering. + + +* Editing Changes in Emacs 26.1 + +** New variable 'column-number-indicator-zero-based'. +Traditionally, in Column Number mode, the displayed column number +counts from zero starting at the left margin of the window. This +behavior is now controlled by 'column-number-indicator-zero-based'. +If you would prefer for the displayed column number to count from one, +you may set this variable to nil. (Behind the scenes, there is now a +new mode line construct, '%C', which operates exactly as '%c' does +except that it counts from one.) + +** New single-line horizontal scrolling mode. +The 'auto-hscroll-mode' variable can now have a new special value, +'current-line', which causes only the line where the cursor is +displayed to be horizontally scrolled when lines are truncated on +display and point moves outside the left or right window margin. + +** New mode line constructs '%o' and '%q', and user option +'mode-line-percent-position'. '%o' displays the "degree of travel" of +the window through the buffer. Unlike the default '%p', this +percentage approaches 100% as the window approaches the end of the +buffer. '%q' displays the percentage offsets of both the start and +the end of the window, e.g. "5-17%". The new option +'mode-line-percent-position' makes it easier to switch between '%p', +'%P', and these new constructs. + +** Two new user options 'list-matching-lines-jump-to-current-line' and +'list-matching-lines-current-line-face' to show the current line +highlighted in *Occur* buffer. + +** The 'occur' command can now operate on the region. + +** New bindings for 'query-replace-map'. +'undo', undo the last replacement; bound to 'u'. +'undo-all', undo all replacements; bound to 'U'. + +** 'delete-trailing-whitespace' deletes whitespace after form feed. +In modes where form feed was treated as a whitespace character, +'delete-trailing-whitespace' would keep lines containing it unchanged. +It now deletes whitespace after the last form feed thus behaving the +same as in modes where the character is not whitespace. + +** Emacs no longer prompts about editing a changed file when the file's +content is unchanged. Instead of only checking the modification time, +Emacs now also checks the file's actual content before prompting the user. + +** Various casing improvements. + +*** 'upcase', 'upcase-region' et al. convert title case characters +(such as Dz) into their upper case form (such as DZ). + +*** 'capitalize', 'upcase-initials' et al. make use of title-case forms +of initial characters (correctly producing for example Džungla instead +of incorrect DŽungla). + +*** Characters which turn into multiple ones when cased are correctly handled. +For example, fi ligature is converted to FI when upper cased. + +*** Greek small sigma is correctly handled when at the end of the word. +Strings such as ΌΣΟΣ are now correctly converted to Όσος when +capitalized instead of incorrect Όσοσ (compare lowercase sigma at the +end of the word). + +** Emacs can now auto-save buffers to visited files in a more robust +manner via the new mode 'auto-save-visited-mode'. Unlike +'auto-save-visited-file-name', this mode uses the normal saving +procedure and therefore obeys saving hooks. +'auto-save-visited-file-name' is now obsolete. + +** New behavior of 'mark-defun'. +Prefix argument selects that many (or that many more) defuns. +Negative prefix arg flips the direction of selection. Also, +'mark-defun' between defuns correctly selects N following defuns (or +-N previous for negative arguments). Finally, comments preceding the +defun are selected unless they are separated from the defun by a blank +line. + +** New command 'replace-buffer-contents'. +This command replaces the contents of the accessible portion of the +current buffer with the contents of the accessible portion of a +different buffer while keeping point, mark, markers, and text +properties as intact as possible. + +** New commands 'apropos-local-variable' and 'apropos-local-value'. +These are buffer-local versions of 'apropos-variable' and +'apropos-value', respectively. They show buffer-local variables whose +names and values, respectively, match a given pattern. + +** More user control of reordering bidirectional text for display. +The two new variables, 'bidi-paragraph-start-re' and +'bidi-paragraph-separate-re', allow customization of what exactly are +paragraphs, for the purposes of bidirectional display. + +** New variable 'x-wait-for-event-timeout'. +This controls how long Emacs will wait for updates to the graphical +state to take effect (making a frame visible, for example). + + +* Changes in Specialized Modes and Packages in Emacs 26.1 + +** Emacs 26.1 comes with Org v9.1.6. +See the file ORG-NEWS for user-visible changes in Org. + +** New function 'cl-generic-p'. + +** Dired + +*** You can answer 'all' in 'dired-do-delete' to delete recursively all +remaining directories without more prompts. + +*** Dired supports wildcards in the directory part of the file names. + +*** You can now use '`?`' in 'dired-do-shell-command'. +It gets replaced by the current file name, like ' ? '. + +*** A new option 'dired-always-read-filesystem' defaulting to nil. +If non-nil, buffers visiting files are reverted before they are +searched; for instance, in 'dired-mark-files-containing-regexp' a +non-nil value of this option means the file is revisited in a +temporary buffer; this temporary buffer is the actual buffer searched: +the original buffer visiting the file is not modified. + +*** Users can now customize mouse clicks in Dired in a more flexible way. +The new command 'dired-mouse-find-file' can be bound to a mouse click +and used to visit files/directories in Dired in the selected window. +The new command 'dired-mouse-find-file-other-frame' similarly visits +files/directories in another frame. You can write your own commands +that invoke 'dired-mouse-find-file' with non-default optional +arguments, to tailor the effects of mouse clicks on file names in +Dired buffers. + +*** In wdired, when editing files to contain slash characters, +the resulting directories are automatically created. Whether to do +this is controlled by the 'wdired-create-parent-directories' variable. + +*** 'W' is now bound to 'browse-url-of-dired-file', and is useful for +viewing HTML files and the like. + +*** New variable 'dired-clean-confirm-killing-deleted-buffers' +controls whether Dired asks to kill buffers visiting deleted files and +directories. The default is t, so Dired asks for confirmation, to +keep previous behavior. + +** html2text is now marked obsolete. + +** smerge-refine-regions can refine regions in separate buffers. + +** Info menu and index completion uses substring completion by default. +This can be customized via the 'info-menu' category in +'completion-category-overrides'. + +** The ancestor buffer is shown by default in 3-way merges. +A new option 'ediff-show-ancestor' and a new toggle +'ediff-toggle-show-ancestor'. + +** TeX: Add luatex and xetex as alternatives to pdftex. + +** Electric-Buffer-menu + +*** Key 'U' is bound to 'Buffer-menu-unmark-all' and key 'M-DEL' is +bound to 'Buffer-menu-unmark-all-buffers'. + +** hideshow mode got four key bindings that are analogous to outline +mode bindings: 'C-c @ C-a', 'C-c @ C-t', 'C-c @ C-d', and 'C-c @ C-e'. + +** bs + +*** Two new commands 'bs-unmark-all', bound to 'U', and +'bs-unmark-previous', bound to . + +** Buffer-menu + +*** Two new commands 'Buffer-menu-unmark-all', bound to 'U' and +'Buffer-menu-unmark-all-buffers', bound to 'M-DEL'. + +** Checkdoc + +*** 'checkdoc-arguments-in-order-flag' now defaults to nil. + +** Gnus + +*** The ~/.newsrc file will now only be saved if the native select +method is an NNTP select method. + +*** A new command for sorting articles by readedness marks has been +added: 'C-c C-s C-m C-m'. + +*** In 'message-citation-line-format' the '%Z' format is now the time +zone name instead of the numeric form. The '%z' format continues to +be the numeric form. The new behavior is compatible with +'format-time-string'. + +*** New user option 'gnus-rcvstore-options' provides a way to +specify additional options when saving messages to an MH folder. + +** Ibuffer + +*** New command 'ibuffer-jump'. + +*** New filter commands 'ibuffer-filter-by-basename', +'ibuffer-filter-by-file-extension', 'ibuffer-filter-by-directory', +'ibuffer-filter-by-starred-name', 'ibuffer-filter-by-modified' +and 'ibuffer-filter-by-visiting-file'; bound respectively +to '/b', '/.', '//', '/*', '/i' and '/v'. + +*** Two new commands 'ibuffer-filter-chosen-by-completion' +and 'ibuffer-and-filter', the second bound to '/&'. + +*** The commands 'ibuffer-pop-filter', 'ibuffer-pop-filter-group', +'ibuffer-or-filter' and 'ibuffer-filter-disable' have the alternative +bindings '/', '/S-', '/|' and '/DEL', respectively. + +*** The data format specifying filters has been extended to allow +explicit logical 'and', and a more flexible form for logical 'not'. +See 'ibuffer-filtering-qualifiers' doc string for full details. + +*** A new command 'ibuffer-copy-buffername-as-kill'; bound +to 'B'. + +*** New command 'ibuffer-change-marks'; bound to '* c'. + +*** A new command 'ibuffer-mark-by-locked' to mark +all locked buffers; bound to '% L'. + +*** A new option 'ibuffer-locked-char' to indicate +locked buffers; Ibuffer shows a new column displaying +'ibuffer-locked-char' for locked buffers. + +*** A new command 'ibuffer-unmark-all-marks' to unmark +all buffers without asking confirmation; bound to +'U'; 'ibuffer-do-replace-regexp' bound to 'r'. + +*** A new command 'ibuffer-mark-by-content-regexp' to mark buffers +whose content matches a regexp; bound to '% g'. + +*** Two new options 'ibuffer-never-search-content-name' and +'ibuffer-never-search-content-mode' used by +'ibuffer-mark-by-content-regexp'. + +** Browse-URL + +*** Support for opening links to man pages in Man or WoMan mode. + +** Comint + +*** New user option 'comint-move-point-for-matching-input' to control +where to place point after 'C-c M-r' and 'C-c M-s'. + +*** New user option 'comint-terminfo-terminal'. +This option allows control of the value of the TERM environment +variable Emacs puts into the environment of the Comint mode and its +derivatives, such as Shell mode and Compilation Shell minor-mode. The +default is "dumb", for compatibility with previous behavior. + +** Compilation mode + +*** Messages from CMake are now recognized. + +*** The number of errors, warnings, and informational messages is now +displayed in the mode line. These are updated as compilation +proceeds. + +** Grep + +*** Grep commands will now use GNU grep's '--null' option if +available, which allows distinguishing the filename from contents if +they contain colons. This can be controlled by the new custom option +'grep-use-null-filename-separator'. + +*** The grep/rgrep/lgrep functions will now ask about saving files +before running. This is controlled by the 'grep-save-buffers' +variable. + +** Edebug + +*** Edebug can be prevented from pausing 1 second after reaching a +breakpoint (e.g. with "f" and "o") by customizing the new option +'edebug-sit-on-break'. + +*** New customizable option 'edebug-max-depth'. +This allows you to enlarge the maximum recursion depth when +instrumenting code. + +*** 'edebug-prin1-to-string' now aliases 'cl-prin1-to-string'. +This means edebug output is affected by variables 'cl-print-readably' +and 'cl-print-compiled'. To completely restore the previous printing +behavior, use + + (fset 'edebug-prin1-to-string #'prin1-to-string) + +** Eshell + +*** 'eshell-input-filter's value is now a named function +'eshell-input-filter-default', and has a new custom option +'eshell-input-filter-initial-space' to ignore adding commands prefixed +with blank space to eshell history. + +** EUDC + +*** Backward compatibility support for BBDB versions less than 3 +(i.e., BBDB 2.x) is deprecated and will likely be removed in the next +major release of Emacs. Users of BBDB 2.x should plan to upgrade to +BBDB 3.x. + +** eww + +*** New 'M-RET' command for opening a link at point in a new eww buffer. + +*** A new 's' command for switching to another eww buffer via the minibuffer. + +*** The 'o' command ('shr-save-contents') has moved to 'O' to avoid collision +with the 'o' command from 'image-map'. + +*** A new command 'C' ('eww-toggle-colors') can be used to toggle +whether to use the HTML-specified colors or not. The user can also +customize the 'shr-use-colors' variable. + +*** Images that are being loaded are now marked with gray +"placeholder" images of the size specified by the HTML. They are then +replaced by the real images asynchronously, which will also now +respect width/height HTML specs (unless they specify widths/heights +bigger than the current window). + +*** The 'w' command on links is now 'shr-maybe-probe-and-copy-url'. +'shr-copy-url' now only copies the url at point; users who wish to +avoid accidentally accessing remote links may rebind 'w' and 'u' in +'eww-link-keymap' to it. + +** Ido + +*** The commands 'find-alternate-file-other-window', +'dired-other-window', 'dired-other-frame', and +'display-buffer-other-window' are now remapped to Ido equivalents if +Ido mode is active. + +** Images + +*** Images are automatically scaled before displaying based on the +'image-scaling-factor' variable (if Emacs supports scaling the images +in question). + +*** It's now possible to specify aspect-ratio preserving combinations +of :width/:max-height and :height/:max-width keywords. In either +case, the "max" keywords win. (Previously some combinations would, +depending on the aspect ratio of the image, just be ignored and in +other instances this would lead to the aspect ratio not being +preserved.) + +*** Images inserted with 'insert-image' and related functions get a +keymap put into the text properties (or overlays) that span the +image. This keymap binds keystrokes for manipulating size and +rotation, as well as saving the image to a file. These commands are +also available in 'image-mode'. + +*** A new library for creating and manipulating SVG images has been +added. See the "(elisp) SVG Images" section in the ELisp reference +manual for details. + +*** New setf-able function to access and set image parameters is +provided: 'image-property'. + +*** New commands 'image-scroll-left' and 'image-scroll-right' +for 'image-mode' that complement 'image-scroll-up' and +'image-scroll-down': they have the same prefix arg behavior and stop +at image boundaries. + +** Image-Dired + +*** Now provides a minor mode 'image-dired-minor-mode' which replaces +the function 'image-dired-setup-dired-keybindings'. + +*** Thumbnail generation is now asynchronous. +The number of concurrent processes is limited by the variable +'image-dired-queue-active-limit'. + +*** 'image-dired-thumbnail-storage' has a new option 'standard-large' +for generating 256x256 thumbnails according to the Thumbnail Managing +Standard. + +*** Inherits movement keys from 'image-mode' for viewing full images. +This includes the usual char, line, and page movement commands. + +*** All the -options types have been changed to argument lists +instead of shell command strings. This change affects +'image-dired-cmd-create-thumbnail-options', +'image-dired-cmd-create-temp-image-options', +'image-dired-cmd-rotate-thumbnail-options', +'image-dired-cmd-rotate-original-options', +'image-dired-cmd-write-exif-data-options', +'image-dired-cmd-read-exif-data-options', and introduces +'image-dired-cmd-pngnq-options', 'image-dired-cmd-pngcrush-options', +'image-dired-cmd-create-standard-thumbnail-options'. + +*** Recognizes more tools by default, including pngnq-s9 and OptiPNG. + +*** 'find-file' and related commands now work on thumbnails and +displayed images, providing a default argument of the original file name +via an addition to 'file-name-at-point-functions'. + +** The default 'Info-default-directory-list' no longer checks some obsolete +directory suffixes (gnu, gnu/lib, gnu/lib/emacs, emacs, lib, lib/emacs) +when searching for info directories. + +** The commands that add ChangeLog entries now prefer a VCS root directory +for the ChangeLog file, if none already exists. Customize +'change-log-directory-files' to nil for the old behavior. + +** Support for non-string values of 'time-stamp-format' has been removed. + +** Message + +*** 'message-use-idna' now defaults to t (because Emacs comes with +built-in IDNA support now). + +*** When sending HTML messages with embedded images, and you have +exiftool installed, and you rotate images with EXIF data (i.e., +JPEGs), the rotational information will be inserted into the outgoing +image in the message. (The original image will not have its +orientation affected.) + +*** The 'message-valid-fqdn-regexp' variable has been removed, since +there are now top-level domains added all the time. Message will no +longer warn about sending emails to top-level domains it hasn't heard +about. + +*** 'message-beginning-of-line' (bound to 'C-a') understands folded headers. +In 'visual-line-mode' it will look for the true beginning of a header +while in non-'visual-line-mode' it will move the point to the indented +header's value. + +** Package + +*** The new variable 'package-gnupghome-dir' has been added to control +where the GnuPG home directory (used for signature verification) is +located and whether GnuPG's option '--homedir' is used or not. + +*** Deleting a package no longer respects 'delete-by-moving-to-trash'. + +** Python + +*** The new variable 'python-indent-def-block-scale' has been added. +It controls the depth of indentation of arguments inside multi-line +function signatures. + +** Tramp + +*** The method part of remote file names is mandatory now. +A valid remote file name starts with "/method:host:" or +"/method:user@host:". + +*** The new pseudo method "-" is a marker for the default method. +"/-::" is the shortest remote file name then. + +*** The command 'tramp-change-syntax' allows you to choose an +alternative remote file name syntax. + +*** New connection method "sg", which supports editing files under a +different group ID. + +*** New connection method "doas" for OpenBSD hosts. + +*** New connection method "gdrive", which allows access to Google +Drive onsite repositories. + +*** Gateway methods in Tramp have been removed. +Instead, the Tramp manual documents how to configure ssh and PuTTY +accordingly. + +*** Setting the "ENV" environment variable in +'tramp-remote-process-environment' enables reading of shell +initialization files. + +*** Tramp is able now to send SIGINT to remote asynchronous processes. + +*** Variable 'tramp-completion-mode' is obsoleted. + +** 'auto-revert-use-notify' is set back to t in 'global-auto-revert-mode'. + +** JS mode + +*** JS mode now sets 'comment-multi-line' to t. + +*** New variable 'js-indent-align-list-continuation', when set to nil, +will not align continuations of bracketed lists, but will indent them +by the fixed width 'js-indent-level'. + +** CSS mode + +*** Support for completing attribute values, at-rules, bang-rules, +HTML tags, classes and IDs using the 'completion-at-point' command. +Completion candidates for HTML classes and IDs are retrieved from open +HTML mode buffers. + +*** CSS mode now binds 'C-h S' to a function that will show +information about a CSS construct (an at-rule, property, pseudo-class, +pseudo-element, with the default being guessed from context). By +default the information is looked up on the Mozilla Developer Network, +but this can be customized using 'css-lookup-url-format'. + +*** CSS colors are fontified using the color they represent as the +background. For instance, #ff0000 would be fontified with a red +background. + +** Emacs now supports character name escape sequences in character and +string literals. The syntax variants '\N{character name}' and +'\N{U+code}' are supported. + +** Prog mode has some support for multi-mode indentation. +This allows better indentation support in modes that support multiple +programming languages in the same buffer, like literate programming +environments or ANTLR programs with embedded Python code. + +A major mode can provide indentation context for a sub-mode. To +support this, modes should use 'prog-first-column' instead of a +literal zero and avoid calling 'widen' in their indentation functions. +See the node "(elisp) Mode-Specific Indent" in the ELisp manual for +more details. + +** ERC + +*** New variable 'erc-default-port-tls' used to connect to TLS IRC +servers. + +** URL + +*** The new function 'url-cookie-delete-cookie' can be used to +programmatically delete all cookies, or cookies from a specific +domain. + +*** 'url-retrieve-synchronously' now takes an optional timeout parameter. + +*** The URL package now supports HTTPS over proxies supporting CONNECT. + +*** 'url-user-agent' now defaults to 'default', and the User-Agent +string is computed dynamically based on 'url-privacy-level'. + +** VC and related modes + +*** 'vc-dir-mode' now binds 'vc-log-outgoing' to 'O'; and has various +branch-related commands on a keymap bound to 'B'. + +*** 'vc-region-history' is now bound to 'C-x v h', replacing the older +'vc-insert-headers' binding. + +*** New user option 'vc-git-print-log-follow' to follow renames in Git logs +for a single file. + +** CC mode + +*** Opening a .h file will turn C or C++ mode depending on language used. +This is done with the help of the 'c-or-c++-mode' function, which +analyzes buffer contents to infer whether it's a C or C++ source file. + +** New option 'cpp-message-min-time-interval' to allow user control +of progress messages in cpp.el. + +** New DNS mode command 'dns-mode-ipv6-to-nibbles' to convert IPv6 addresses +to a format suitable for reverse lookup zone files. + +** Ispell + +*** Enchant is now supported as a spell-checker. +Enchant is a meta-spell-checker that uses providers such as Hunspell +to do the actual checking. With it, users can use spell-checkers not +directly supported by Emacs, such as Voikko, Hspell and AppleSpell, +more easily share personal word-lists with other programs, and +configure different spelling-checkers for different languages. +(Version 2.1.0 or later of Enchant is required.) + +** Flymake + +*** Flymake has been completely redesigned. +Flymake now annotates arbitrary buffer regions, not just lines. It +supports arbitrary diagnostic types, not just errors and warnings (see +variable 'flymake-diagnostic-types-alist'). + +It also supports multiple simultaneous backends, meaning that you can +check your buffer from different perspectives (see variable +'flymake-diagnostic-functions'). Backends for Emacs Lisp mode are +provided. + +The old Flymake behavior is preserved in the so-called "legacy +backend", which has been updated to benefit from the new UI features. + +** Term + +*** 'term-char-mode' now makes its buffer read-only. +The buffer is made read-only to prevent changes from being made by +anything other than the process filter; and movements of point away +from the process mark are counter-acted so that the cursor is in the +correct position after each command. This is needed to avoid states +which are inconsistent with the state of the terminal understood by +the inferior process. + +New user options 'term-char-mode-buffer-read-only' and +'term-char-mode-point-at-process-mark' control these behaviors, and +are non-nil by default. Customize these options to nil if you want +the previous behavior. + +** Xref + +*** When an *xref* buffer is needed, 'TAB' quits and jumps to an xref. +A new command 'xref-quit-and-goto-xref', bound to 'TAB' in *xref* +buffers, quits the window before jumping to the destination. In many +situations, the intended window configuration is restored, just as if +the *xref* buffer hadn't been necessary in the first place. + + +* New Modes and Packages in Emacs 26.1 + +** New Elisp data-structure library 'radix-tree'. + +** New library 'xdg' with utilities for some XDG standards and specs. + +** HTML + +*** A new submode of 'html-mode', 'mhtml-mode', is now the default +mode for *.html files. This mode handles indentation, +fontification, and commenting for embedded JavaScript and CSS. + +** New mode 'conf-toml-mode' is a sub-mode of 'conf-mode', specialized +for editing TOML files. + +** New mode 'conf-desktop-mode' is a sub-mode of 'conf-unix-mode', +specialized for editing freedesktop.org desktop entries. + +** New minor mode 'pixel-scroll-mode' provides smooth pixel-level scrolling. + +** New major mode 'less-css-mode' (a minor variant of 'css-mode') for +editing Less files. + +** New package 'auth-source-pass' integrates 'auth-source' with the +password manager password-store (http://passwordstore.org). + + +* Incompatible Lisp Changes in Emacs 26.1 + +** 'password-data' is now a hash-table so that 'password-read' can use +any object for the 'key' argument. + +** Command 'dired-mark-extension' now automatically prepends a '.' to the +extension when not present. The new command 'dired-mark-suffix' behaves +similarly but it doesn't prepend a '.'. + +** Certain cond/pcase/cl-case forms are now compiled using a faster jump +table implementation. This uses a new bytecode op 'switch', which +isn't compatible with previous Emacs versions. This functionality can +be disabled by setting 'byte-compile-cond-use-jump-table' to nil. + +** If 'comment-auto-fill-only-comments' is non-nil, 'auto-fill-function' +is now called only if either no comment syntax is defined for the +current buffer or the self-insertion takes place within a comment. + +** The alist 'ucs-names' is now a hash table. + +** 'if-let' and 'when-let' now support binding lists as defined by the +SRFI-2 (Scheme Request for Implementation 2). + +** 'C-up', 'C-down', 'C-left' and 'C-right' are now defined in term +mode to send the same escape sequences that xterm does. This makes +things like 'forward-word' in readline work. + +** Customizable variable 'query-replace-from-to-separator' +now doesn't propertize the string value of the separator. +Instead, text properties are added by 'query-replace-read-from'. +Additionally, the new nil value restores pre-24.5 behavior +of not providing replacement pairs via the history. + +** Some obsolete functions, variables, and faces have been removed: + +*** 'make-variable-frame-local'. Variables cannot be frame-local any more. + +*** From subr.el: 'window-dot', 'set-window-dot', 'read-input', +'show-buffer', 'eval-current-buffer', 'string-to-int'. + +*** 'icomplete-prospects-length'. + +*** All the default-FOO variables that hold the default value of the +FOO variable. Use 'default-value' and 'setq-default' to access and +change FOO, respectively. The exhaustive list of removed variables is: +'default-mode-line-format', 'default-header-line-format', +'default-line-spacing', 'default-abbrev-mode', 'default-ctl-arrow', +'default-truncate-lines', 'default-left-margin', 'default-tab-width', +'default-case-fold-search', 'default-left-margin-width', +'default-right-margin-width', 'default-left-fringe-width', +'default-right-fringe-width', 'default-fringes-outside-margins', +'default-scroll-bar-width', 'default-vertical-scroll-bar', +'default-indicate-empty-lines', 'default-indicate-buffer-boundaries', +'default-fringe-indicator-alist', 'default-fringe-cursor-alist', +'default-scroll-up-aggressively', 'default-scroll-down-aggressively', +'default-fill-column', 'default-cursor-type', +'default-cursor-in-non-selected-windows', +'default-buffer-file-coding-system', 'default-major-mode', and +'default-enable-multibyte-characters'. + +*** Many variables obsoleted in 22.1 referring to face symbols. + +** The variable 'text-quoting-style' is now a customizable option. +It controls whether to and how to translate ASCII quotes in messages +and help output. Its possible values and their semantics remain +unchanged from Emacs 25. In particular, when this variable's value is +'grave', all quotes in formats are output as-is. + +** Functions like 'check-declare-file' and 'check-declare-directory' +now generate less chatter and more-compact diagnostics. The auxiliary +function 'check-declare-errmsg' has been removed. + +** The regular expression character class '[:blank:]' now matches +Unicode horizontal whitespace as defined in the Unicode Technical +Standard #18. If you only want to match space and tab, use '[ \t]' +instead. + +** 'min' and 'max' no longer round their results. +Formerly, they returned a floating-point value if any argument was +floating-point, which was sometimes numerically incorrect. For +example, on a 64-bit host (max 1e16 10000000000000001) now returns its +second argument instead of its first. + +** The variable 'old-style-backquotes' has been made internal and +renamed to 'lread--old-style-backquotes'. No user code should use +this variable. + +** 'default-file-name-coding-system' now defaults to a coding system +that does not process CRLF. For example, it defaults to 'utf-8-unix' +instead of to 'utf-8'. Before this change, Emacs would sometimes +mishandle file names containing these control characters. + +** 'file-attributes', 'file-symlink-p' and 'make-symbolic-link' no +longer quietly mutate the target of a local symbolic link, so that +Emacs can access and copy them reliably regardless of their contents. +The following changes are involved. + +*** 'file-attributes' and 'file-symlink-p' no longer prepend "/:" to +symbolic links whose targets begin with "/" and contain ":". For +example, if a symbolic link "x" has a target "/y:z:", '(file-symlink-p +"x")' now returns "/y:z:" rather than "/:/y:z:". + +*** 'make-symbolic-link' no longer looks for file name handlers of +target when creating a symbolic link. For example, +'(make-symbolic-link "/y:z:" "x")' now creates a symbolic link to +"/y:z:" instead of failing. + +*** 'make-symbolic-link' removes the remote part of a link target if +target and newname have the same remote part. For example, +'(make-symbolic-link "/x:y:a" "/x:y:b")' creates a link with the +literal string "a"; and '(make-symbolic-link "/x:y:a" "/x:z:b")' +creates a link with the literal string "/x:y:a" instead of failing. + +*** 'make-symbolic-link' now expands a link target with leading "~" +only when the optional third arg is an integer, as when invoked +interactively. For example, '(make-symbolic-link "~y" "x")' now +creates a link with target the literal string "~y"; to get the old +behavior, use '(make-symbolic-link (expand-file-name "~y") "x")'. To +avoid this expansion in interactive use, you can now prefix the link +target with "/:". For example, '(make-symbolic-link "/:~y" "x" 1)' +now creates a link to literal "~y". + +** 'file-truename' returns a quoted file name if the target of a +symbolic link has remote file name syntax. + +** Module functions are now implemented slightly differently; in +particular, the function 'internal--module-call' has been removed. +Code that depends on undocumented internals of the module system might +break. + +** The argument LOCKNAME of 'write-region' is propagated to file name +handlers now. + +** When built against recent versions of GTK+, Emacs always uses +gtk_window_move for moving frames and ignores the value of the +variable 'x-gtk-use-window-move'. The variable is now obsolete. + +** Several functions that create or rename files now treat their +destination argument specially only when it is a directory name, i.e., +when it ends in '/' on GNU and other POSIX-like systems. When the +destination argument D of one of these functions is an existing +directory and the intent is to act on an entry in that directory, D +should now be a directory name. For example, (rename-file "e" "f/") +renames to 'f/e'. Although this formerly happened sometimes even when +D was not a directory name, as in (rename-file "e" "f") where 'f' +happened to be a directory, the old behavior often contradicted the +documentation and had inherent races that led to security holes. A +call like (rename-file C D) that used the old, undocumented behavior +can be written as (rename-file C (file-name-as-directory D)), a +formulation portable to both older and newer versions of Emacs. +Affected functions include 'add-name-to-file', 'copy-directory', +'copy-file', 'format-write-file', 'gnus-copy-file', +'make-symbolic-link', 'rename-file', 'thumbs-rename-images', and +'write-file'. + +** The list returned by 'overlays-at' is now in decreasing priority order. +The documentation of this function always said the order should be +that of decreasing priority, if the 2nd argument of the function is +non-nil, but the code returned the list in the increasing order of +priority instead. Now the code does what the documentation says it +should do. + +** 'format' now avoids allocating a new string in more cases. +'format' was previously documented to return a newly-allocated string, +but this documentation was not correct, as (eq x (format x)) returned +t when x was the empty string. 'format' is no longer documented to +return a newly-allocated string, and the implementation now takes +advantage of the doc change to avoid making copies of strings in +common cases like (format "foo") and (format "%s" "foo"). + +** The function 'eldoc-message' now accepts a single argument. +Programs that called it with multiple arguments before should pass +them through 'format' first. Even that is discouraged: for ElDoc +support, you should set 'eldoc-documentation-function' instead of +calling 'eldoc-message' directly. + +** Using '&rest' or '&optional' incorrectly is now an error. +For example giving '&optional' without a following variable, or +passing '&optional' multiple times: + + (defun foo (&optional &rest x)) + (defun bar (&optional &optional x)) + +Previously, Emacs would just ignore the extra keyword, or give +incorrect results in certain cases. + +** The pinentry.el library has been removed. +That package (and the corresponding change in GnuPG and pinentry) +was intended to provide a way to input passphrase through Emacs with +GnuPG 2.0. However, the change to support that was only implemented +in GnuPG >= 2.1 and didn't get backported to GnuPG 2.0. And with +GnuPG 2.1 and later, pinentry.el is not needed at all. So the +library was useless, and we removed it. GnuPG 2.0 is no longer +supported by the upstream project. + +To adapt to the change, you may need to set 'epa-pinentry-mode' to the +symbol 'loopback'. Alternatively, leave 'epa-pinentry-mode' at its +default value of nil, and remove the 'allow-emacs-pinentry' setting +from your 'gpg-agent.conf' configuration file, usually found in the +'~/.gnupg' directory. + +Note that previously, it was said that passphrase input through +minibuffer would be much less secure than other graphical pinentry +programs. However, these days the difference is insignificant: the +'read-password' function sufficiently protects input from leakage to +message logs. Emacs still doesn't use secure memory to protect +passphrases, but it was also removed from other pinentry programs as +the attack is unrealistic on modern computer systems which don't +utilize swap memory usually. + +** The function 'display-buffer-in-major-side-window' no longer exists. +It has been renamed as internal function 'window--make-major-side-window', +however applications should instead call 'display-buffer-in-side-window' +(passing the SIDE and SLOT parameters as elements of ALIST). This approach +is backwards-compatible with versions of Emacs in which the old function +exists. See the node "Displaying Buffers in Side Windows" in the ELisp +manual for more details. + +* Lisp Changes in Emacs 26.1 + +** The function 'assoc' now takes an optional third argument TESTFN. +This argument, when non-nil, is used for comparison instead of +'equal'. + +** New optional argument TESTFN in 'alist-get', 'map-elt' and 'map-put'. +If non-nil, the argument specifies a function to use for comparison, +instead of, respectively, 'assq' and 'eql'. + +** New function 'seq-set-equal-p' to check if SEQUENCE1 and SEQUENCE2 +contain the same elements, regardless of the order. + +** The new function 'mapbacktrace' applies a function to all frames of +the current stack trace. + +** The new function 'file-name-case-insensitive-p' tests whether a +given file is on a case-insensitive filesystem. + +** Several accessors for the value returned by 'file-attributes' +have been added. They are: 'file-attribute-type', +'file-attribute-link-number', 'file-attribute-user-id', +'file-attribute-group-id', 'file-attribute-access-time', +'file-attribute-modification-time', +'file-attribute-status-change-time', 'file-attribute-size', +'file-attribute-modes', 'file-attribute-inode-number', +'file-attribute-device-number' and 'file-attribute-collect'. + +** The new function 'buffer-hash' computes a fast, non-consing hash of +a buffer's contents. + +** 'interrupt-process' now consults the list 'interrupt-process-functions', +to determine which function has to be called in order to deliver the +SIGINT signal. This allows Tramp to send the SIGINT signal to remote +asynchronous processes. The hitherto existing implementation has been +moved to 'internal-default-interrupt-process'. + +** The new function 'read-multiple-choice' prompts for multiple-choice +questions, with a handy way to display help texts. + +** 'comment-indent-function' values may now return a cons to specify a +range of indentation. + +** New optional argument TEXT in 'make-temp-file'. + +** New function 'define-symbol-prop'. + +** New function 'secure-hash-algorithms' to list the algorithms that +'secure-hash' supports. +See the node "(elisp) Checksum/Hash" in the ELisp manual for details. + +** Emacs now exposes the GnuTLS cryptographic API with the functions +'gnutls-macs' and 'gnutls-hash-mac'; 'gnutls-digests' and +'gnutls-hash-digest'; 'gnutls-ciphers' and 'gnutls-symmetric-encrypt' +and 'gnutls-symmetric-decrypt'. +See the node "(elisp) GnuTLS Cryptography" in the ELisp manual for details. + +** The function 'gnutls-available-p' now returns a list of capabilities +supported by the GnuTLS library used by Emacs. + +** Emacs now supports records for user-defined types, via the new +functions 'make-record', 'record', and 'recordp'. Records are now +used internally to represent cl-defstruct and defclass instances, for +example. + +If your program defines new record types, you should use +package-naming conventions for naming those types. This is so any +potential conflicts with other types are avoided. + +** 'save-some-buffers' now uses 'save-some-buffers-default-predicate' +to decide which buffers to ask about, if the PRED argument is nil. +The default value of 'save-some-buffers-default-predicate' is nil, +which means ask about all file-visiting buffers. + +** string-(to|as|make)-(uni|multi)byte are now declared obsolete. + +** New variable 'while-no-input-ignore-events' which allow +setting which special events 'while-no-input' should ignore. +It is a list of symbols. + +** New function 'undo-amalgamate-change-group' to get rid of +undo-boundaries between two states. + +** New var 'definition-prefixes' is a hash table mapping prefixes to +the files where corresponding definitions can be found. This can be +used to fetch definitions that are not yet loaded, for example for +'C-h f'. + +** New var 'syntax-ppss-table' to control the syntax-table used in +'syntax-ppss'. + +** 'define-derived-mode' can now specify an :after-hook form, which +gets evaluated after the new mode's hook has run. This can be used to +incorporate configuration changes made in the mode hook into the +mode's setup. + +** Autoload files are now generated without timestamps. +Set 'autoload-timestamps' to a non-nil value to get timestamps in +autoload files. + +** 'gnutls-boot' now takes a parameter ':complete-negotiation' that +says that negotiation should complete even on non-blocking sockets. + +** There is now a new variable 'flyspell-sort-corrections-function' +that allows changing the way corrections are sorted. + +** The new command 'fortune-message' has been added, which displays +fortunes in the echo area. + +** New function 'func-arity' returns information about the argument list +of an arbitrary function. This generalizes 'subr-arity' for functions +that are not built-in primitives. We recommend using this new +function instead of 'subr-arity'. + +** New function 'region-bounds' can be used in the interactive spec +to provide region boundaries (for rectangular regions more than one) +to an interactively callable function as a single argument instead of +two separate arguments 'region-beginning' and 'region-end'. + +** 'parse-partial-sexp' state has a new element. +Element 10 is non-nil when the last character scanned might be the +first character of a two character construct, i.e., a comment +delimiter or escaped character. Its value is the syntax of that last +character. + +** 'parse-partial-sexp's state, element 9, has now been confirmed as +permanent and documented, and may be used by Lisp programs. Its value +is a list of currently open parenthesis positions, starting with the +outermost parenthesis. + +** 'read-color' will now display the color names using the color itself +as the background color. + +** The function 'redirect-debugging-output' now works on platforms +other than GNU/Linux. + +** The new function 'string-version-lessp' compares strings by +interpreting consecutive runs of numerical characters as numbers, and +compares their numerical values. According to this predicate, +"foo2.png" is smaller than "foo12.png". + +** Numeric comparisons and 'logb' no longer return incorrect answers +due to internal rounding errors. For example, '(< most-positive-fixnum +(+ 1.0 most-positive-fixnum))' now correctly returns t on 64-bit hosts. + +** The functions 'ffloor', 'fceiling', 'ftruncate' and 'fround' now +accept only floating-point arguments, as per their documentation. +Formerly, they quietly accepted integer arguments and sometimes +returned nonsensical answers, e.g., '(< N (ffloor N))' could return t. + +** On hosts like GNU/Linux x86-64 where a 'long double' fraction +contains at least EMACS_INT_WIDTH - 3 bits, 'format' no longer returns +incorrect answers due to internal rounding errors when formatting +Emacs integers with '%e', '%f', or '%g' conversions. For example, on +these hosts '(eql N (string-to-number (format "%.0f" N)))' now returns +t for all Emacs integers N. + +** Calls that accept floating-point integers (for use on hosts with +limited integer range) now signal an error if arguments are not +integral. For example '(decode-char 'ascii 0.5)' now signals an +error. + +** Functions 'string-trim-left', 'string-trim-right' and 'string-trim' +now accept optional arguments which specify the regexp of a substring +to trim. + +** The new function 'char-from-name' converts a Unicode name string +to the corresponding character code. + +** New functions 'sxhash-eq' and 'sxhash-eql' return hash codes of a +Lisp object suitable for use with 'eq' and 'eql' correspondingly. If +two objects are 'eq' ('eql'), then the result of 'sxhash-eq' +('sxhash-eql') on them will be the same. + +** Function 'sxhash' has been renamed to 'sxhash-equal' for +consistency with the new functions. For compatibility, 'sxhash' +remains as an alias to 'sxhash-equal'. + +** 'make-hash-table' now defaults to a rehash threshold of 0.8125 +instead of 0.8, to avoid rounding glitches. + +** New function 'add-variable-watcher' can be used to call a function +when a symbol's value is changed. This is used to implement the new +debugger command 'debug-on-variable-change'. + +** New variable 'print-escape-control-characters' causes 'prin1' and +'print' to output control characters as backslash sequences. + +** Time conversion functions that accept a time zone rule argument now +allow it to be OFFSET or a list (OFFSET ABBR), where the integer +OFFSET is a count of seconds east of Universal Time, and the string +ABBR is a time zone abbreviation. The affected functions are +'current-time-string', 'current-time-zone', 'decode-time', +'format-time-string', and 'set-time-zone-rule'. + +** 'format-time-string' now formats '%q' to the calendar quarter. + +** New built-in function 'mapcan'. +It avoids unnecessary consing (and garbage collection). + +** 'car' and 'cdr' compositions 'cXXXr' and 'cXXXXr' are now part of Elisp. + +** 'gensym' is now part of Elisp. + +** Low-level list functions like 'length' and 'member' now do a better +job of signaling list cycles instead of looping indefinitely. + +** The new functions 'make-nearby-temp-file' and 'temporary-file-directory' +can be used for creation of temporary files on remote or mounted directories. + +** On GNU platforms when operating on a local file, 'file-attributes' +no longer suffers from a race when called while another process is +altering the filesystem. On non-GNU platforms 'file-attributes' +attempts to detect the race, and returns nil if it does so. + +** The new function 'file-local-name' can be used to specify arguments +of remote processes. + +** The new functions 'file-name-quote', 'file-name-unquote' and +'file-name-quoted-p' can be used to quote / unquote file names with +the prefix "/:". + +** The new error 'file-missing', a subcategory of 'file-error', is now +signaled instead of 'file-error' if a file operation acts on a file +that does not exist. + +** The function 'delete-directory' no longer signals an error when +operating recursively and when some other process deletes the directory +or its files before 'delete-directory' gets to them. + +** New error type 'user-search-failed' like 'search-failed' but +avoids debugger like 'user-error'. + +** The function 'line-number-at-pos' now takes a second optional +argument 'absolute'. If this parameter is nil, the default, this +function keeps on returning the line number taking potential narrowing +into account. If this parameter is non-nil, the function ignores +narrowing and returns the absolute line number. + +** The function 'color-distance' now takes a second optional argument +'metric'. When non-nil, it should be a function of two arguments that +accepts two colors and returns a number. + +** Changes in Frame and Window Handling + +*** Resizing a frame no longer runs 'window-configuration-change-hook'. +'window-size-change-functions' should be used instead. + +*** The new function 'frame-size-changed-p' can tell whether a frame has +been resized since the last time 'window-size-change-functions' has been +run. + +*** The function 'frame-geometry' now also returns the width of a +frame's outer border. + +*** New frame parameters and changed semantics for older ones: + +**** 'z-group' positions a frame above or below all others. + +**** 'min-width' and 'min-height' specify the absolute minimum size of a +frame. + +**** 'parent-frame' makes a frame the child frame of another Emacs +frame. The section "(elisp) Child Frames" in the ELisp manual +describes the intrinsics of that relationship. + +**** 'delete-before' triggers deletion of one frame before that of +another. + +**** 'mouse-wheel-frame' specifies another frame whose windows shall be +scrolled instead. + +**** 'no-other-frame' has 'next-frame' and 'previous-frame' skip this +frame. + +**** 'skip-taskbar' removes a frame's icon from the taskbar and has +'Alt-' skip this frame. + +**** 'no-focus-on-map' avoids that a frame gets input focus when mapped. + +**** 'no-accept-focus' means that a frame does not want to get input +focus via the mouse. + +**** 'undecorated' removes the window manager decorations from a frame. + +**** 'override-redirect' tells the window manager to disregard this +frame. + +**** 'width' and 'height' now allow the specification of pixel values +and ratios. + +**** 'left' and 'top' now allow the specification of ratios. + +**** 'keep-ratio' preserves size and position of child frames when their +parent frame is resized. + +**** 'no-special-glyphs' suppresses display of truncation and +continuation glyphs in a frame. + +**** 'auto-hide-function' and 'minibuffer-exit' handle auto hiding of +frames and exiting from minibuffer individually. + +**** 'fit-frame-to-buffer-margins' and 'fit-frame-to-buffer-sizes' +handle fitting a frame to its buffer individually. + +**** 'drag-internal-border', 'drag-with-header-line', +'drag-with-mode-line', 'snap-width', 'top-visible' and 'bottom-visible' +allow dragging and resizing frames with the mouse. + +**** 'minibuffer' is now set to the default minibuffer window when +initially specified as nil and is not reset to nil when initially +specifying a minibuffer window. + +*** The new function 'frame-list-z-order' returns a list of all frames +in Z (stacking) order. + +*** The function 'x-focus-frame' optionally tries to not activate its +frame. + +*** The variable 'focus-follows-mouse' has a third meaningful value +'auto-raise' to indicate that the window manager automatically raises a +frame when the mouse pointer enters it. + +*** The new function 'frame-restack' puts a frame above or below +another on the display. + +*** The new face 'internal-border' specifies the background of a frame's +internal border. + +*** The NORECORD argument of 'select-window' now has a meaningful value +'mark-for-redisplay' which is like any other non-nil value but marks +WINDOW for redisplay. + +*** Support for side windows is now official. The display action +function 'display-buffer-in-side-window' will display its buffer in a +side window. Functions for toggling all side windows on a frame, +changing and reversing the layout of side windows and returning the +main (major non-side) window of a frame are provided. For details +consult the section "(elisp) Side Windows" in the ELisp manual. + +*** Support for atomic windows - rectangular compositions of windows +treated by 'split-window', 'delete-window' and 'delete-other-windows' +like a single live window - is now official. For details consult the +section "(elisp) Atomic Windows" in the ELisp manual. + +*** New 'display-buffer' alist entry 'window-parameters' allows the +assignment of window parameters to the window used for displaying the +buffer. + +*** New function 'display-buffer-reuse-mode-window' is an action function +suitable for use in 'display-buffer-alist'. For example, to avoid +creating a new window when opening man pages when there's already one, +use + +(add-to-list 'display-buffer-alist + '("\\`\\*Man .*\\*\\'" . + (display-buffer-reuse-mode-window + (inhibit-same-window . nil) + (mode . Man-mode)))) + +*** New window parameter 'no-delete-other-windows' prevents that +its window gets deleted by 'delete-other-windows'. + +*** New window parameters 'mode-line-format' and 'header-line-format' +allow the buffer-local formats for this window to be overridden. + +*** New command 'window-swap-states' swaps the states of two live +windows. + +*** New functions 'window-pixel-width-before-size-change' and +'window-pixel-height-before-size-change' support detecting which +window changed size when 'window-size-change-functions' are run. + +*** The new function 'window-lines-pixel-dimensions' returns the pixel +dimensions of a window's text lines. + +*** The new function 'window-largest-empty-rectangle' returns the +dimensions of the largest rectangular area not occupying any text in a +window's body. + +*** The semantics of 'mouse-autoselect-window' has changed slightly. +For details see the section "(elisp) Mouse Window Auto-selection" in +the ELisp manual. + +*** 'select-frame-by-name' now may return a frame on another display +if it does not find a suitable one on the current display. + +** 'tcl-auto-fill-mode' is now declared obsolete. +Its functionality can be replicated simply by setting +'comment-auto-fill-only-comments'. + +** New pcase pattern 'rx' to match against an rx-style regular expression. +For details, see the doc string of 'rx--pcase-macroexpander'. + +** New functions to set region from secondary selection and vice versa. +The new functions 'secondary-selection-to-region' and +'secondary-selection-from-region' let you set the beginning and the +end of the region from those of the secondary selection and vice +versa. + +** New function 'lgstring-remove-glyph' can be used to modify a +gstring returned by the underlying layout engine (e.g. m17n-flt, +uniscribe). + + +* Changes in Emacs 26.1 on Non-Free Operating Systems + +** Intercepting hotkeys on Windows 7 and later now works better. +The new keyboard hooking code properly grabs system hotkeys such as +'Win-*' and 'Alt-TAB', in a way that Emacs can get at them before the +system. This makes the 'w32-register-hot-key' functionality work +again on all versions of MS-Windows starting with Windows 7. On +Windows NT and later you can now register any hotkey combination. (On +Windows 9X, the previous limitations, spelled out in the Emacs manual, +still apply.) + +** 'convert-standard-filename' no longer mirrors slashes on MS-Windows. +Previously, on MS-Windows this function converted slash characters in +file names into backslashes. It no longer does that. If your Lisp +program used 'convert-standard-filename' to prepare file names to be +passed to subprocesses (which is not the recommended usage of that +function), you will now have to mirror slashes in your application +code. One possible way is this: + + (let ((start 0)) + (while (string-match "/" file-name start) + (aset file-name (match-beginning 0) ?\\) + (setq start (match-end 0)))) + +** GUI sessions on MS-Windows now treat SIGINT like Posix platforms do. +The effect of delivering a Ctrl-C (SIGINT) signal to a GUI Emacs on +MS-Windows is now the same as on Posix platforms -- Emacs saves the +session and exits. In particular, this will happen if you start +emacs.exe from the Windows shell, then type Ctrl-C into that shell's +window. + +** 'signal-process' supports SIGTRAP on Windows XP and later. +The 'kill' emulation on Windows now maps SIGTRAP to a call to the +'DebugBreakProcess' API. This causes the receiving process to break +execution and return control to the debugger. If no debugger is +attached to the receiving process, the call is typically ignored. +This is in contrast to the default action on POSIX Systems, where it +causes the receiving process to terminate with a core dump if no +debugger has been attached to it. + +** 'set-mouse-position' and 'set-mouse-absolute-pixel-position' work +on macOS. + +** Emacs can now be run as a GUI application from the command line on +macOS. + +** 'ns-appearance' and 'ns-transparent-titlebar' change the appearance +of frame decorations on macOS 10.9+. + +** 'ns-use-thin-smoothing' enables thin font smoothing on macOS 10.8+. + +** 'process-attributes' on Darwin systems now returns more information. + +** Mousewheel and trackpad scrolling on macOS 10.7+ now behaves more +like the macOS default. The new variables 'ns-mwheel-line-height', +'ns-use-mwheel-acceleration' and 'ns-use-mwheel-momentum' can be used +to customize the behavior. + + +---------------------------------------------------------------------- +This file is part of GNU Emacs. + +GNU Emacs is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 3 of the License, or +(at your option) any later version. + +GNU Emacs is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with GNU Emacs. If not, see . + + +Local variables: +coding: utf-8 +mode: outline +paragraph-separate: "[ ]*$" +end: