GNU Emacs NEWS -- history of user-visible changes. Copyright (C) 2022-2024 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 31. See file HISTORY for a list of GNU Emacs versions and release dates. See files NEWS.30, NEWS.29, ..., 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'. Temporary note: +++ indicates that all relevant manuals in doc/ have been updated. --- means no change in the manuals is needed. When you add a new item, use the appropriate mark if you are sure it applies, and please also update docstrings as needed. * Installation Changes in Emacs 31.1 * Startup Changes in Emacs 31.1 * Changes in Emacs 31.1 ** Time & Date +++ *** 'seconds-to-string' includes new formatting options. Options are provided to produce human-readable delay strings in a variety of formats, for example "6 months 3 weeks" or "5m 52.5s". * Editing Changes in Emacs 31.1 * Changes in Specialized Modes and Packages in Emacs 31.1 ** Whitespace --- *** 'whitespace-cleanup' now adds missing newline at end of file. If 'whitespace-style' includes 'missing-newline-at-eof (which is the default), the 'whitespace-cleanup' function will now add the newline. ** Eshell --- *** New option 'eshell-command-async-buffer'. This option lets you tell 'eshell-command' how to respond if its output buffer is already in use by another invocation of 'eshell-command', much like 'async-shell-command-buffer' does for 'shell-command'. By default, this will prompt for confirmation before creating a new buffer when necessary. To restore the previous behavior, set this option to 'confirm-kill-process'. +++ *** Eshell's built-in "wait" command now accepts a timeout. By passing "-t" or "--timeout", you can specify a maximum time to wait for the processes to exit. Additionally, you can now wait for external processes by passing their PIDs. ** SHR +++ *** SHR now slices large images into rows. Sliced images allow for more intuitive scrolling up/down by letting you scroll past each slice, instead of jumping past the entire image. Previously, SHR sliced images when zoomed to their original size, no matter how large or small that was). Now, SHR slices any images taller than 'shr-sliced-image-height'. For more information, see the "(eww) Advanced" node in the EWW manual. --- *** You can now customize the image zoom levels to cycle through. By customizing 'shr-image-zoom-levels', you can change the list of zoom levels that SHR cycles through when calling 'shr-zoom-image'. ** Emacs Lisp mode --- *** Checkdoc no longer warns about missing footer lines in some cases. Emacs Lisp libraries have traditionally ended with a footer line (sometimes referred to as "terminating comment"). Their purpose was to easily detect files that had been truncated in transit on ancient and less reliable connections: ;; some-cool-package.el ends here 'checkdoc' will no longer warn if that line is missing for packages that explicitly only support Emacs 30.1 or later, as specified in the "Package-Requires" header. The reason for keeping the warning for packages that support earlier versions of Emacs is that package.el in those versions can't install packages where that line is missing. This change affects both 'M-x checkdoc' and the corresponding flymake backend. --- *** Checkdoc will now flag incorrect formatting in warnings. This affects calls to 'warn', 'lwarn', 'display-warning', and 'message-box'. --- *** The default of 'checkdoc-verb-check-experimental-flag' is now nil. In most cases, having it enabled leads to a large amount of false positives. * New Modes and Packages in Emacs 31.1 * Incompatible Lisp Changes in Emacs 31.1 * Lisp Changes in Emacs 31.1 +++ *** Support interactive D-Bus authorization. A new ':authorizable t' parameter has been added to 'dbus-call-method' and 'dbus-call-method-asynchronously' to allow the user to interactively authorize the invoked D-Bus method (e.g., via polkit). * Changes in Emacs 31.1 on Non-Free Operating Systems --- ** Process execution has been optimized on Android. The run-time performance of subprocesses on recent Android releases where a userspace executable loader is required has been optimized on systems featuring Linux 3.5.0 and above. ---------------------------------------------------------------------- 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 mode: emacs-news paragraph-separate: "[ ]" end: