Emacs NEWS.29

This command deletes old subdirectories of the eln cache (but not the ones for the current Emacs version). Note that subdirectories of the system directory where the "*.eln" files are installed (usually, the last entry in native-comp-eln-load-path) are not deleted.

This function can be called in your init files to change the user-specific directory where Emacs stores the "*.eln" files produced by native compilation of Lisp packages Emacs loads. The default eln cache directory is unchanged: it is the "eln-cache" subdirectory of user-emacs-directory.

If there are several files marked, file names containing space and quote characters will be quoted "like this".

In previous Emacs versions, commands like 【C-u 10 d】 would put the "D" mark on the next ten files, no matter whether they were dot files (i.e., "." and "..") or not, while marking the next ten lines with the mouse (in transient-mark-mode) and then hitting d would skip dot files. These now work equivalently.

For consistency with remote connections, Eshell now uses exec-path to determine the execution path on the local or remote system, instead of using the PATH environment variable directly.

This is for compatibility with the shell versions of these commands, which don't handle options like '–help' in any special way.

Previously, some argument predicates/modifiers allowed arbitrary characters as string delimiters. To provide more unified behavior across all predicates/modifiers, the list of allowed delimiters has been restricted to "…", '…', …, |…|, (…), […], <…>, and {…}. See the "(eshell) Argument Predication and Modification" node in the Eshell manual for more details.

To pipe both stdout and stderr, use the '|&' operator instead of '|'.

Change the menu-bar-buffers-menu-command-entries variable to alter the entries that follow the buffer list.

If non-nil, dragging on the buffer name part of the mode-line will drag the buffer's associated file to other programs. This option is currently only available on X, Haiku and Nextstep (GNUstep or macOS).

If non-nil, this option allows dragging text in the region from Emacs to another program.

If non-nil, this option allows scrolling a window while dragging text around without a scroll wheel.

This prevents mouse drag gestures from putting empty strings onto the kill ring.

These options allow adjusting point and scrolling a window when dragging items from another program.

This means dropping an image or file link from programs such as Firefox will no longer create a temporary file in a random directory, instead asking you where to save the file first.

This is in addition to previously-supported ways of discovering 24-bit color support: either via the "RGB" or "setf24" capabilities, or if the COLORTERM environment variable is set to the value "truecolor".

On terminals with xterm "setSelection" support, the active region may be saved to the X primary selection, following the select-active-regions variable. This support is enabled when tty-select-active-regions is non-nil.

The new command standard-display-by-replacement-char produces Lisp code that sets up the standard-display-table to use a replacement character for display of characters that the text-mode terminal doesn't support. This code is intended to be used in your init files. This feature is most useful with the Linux console and similar terminals, where Emacs has a reliable way of determining which characters have glyphs in the font loaded into the terminal's memory.

The new functions 'tty–set-output-buffer-size' and 'tty–output-buffer-size' allow setting and retrieving the output buffer size of a terminal device. The default buffer size is and has always been BUFSIZ, which is defined in your system's stdio.h. When you set a buffer size with 'tty–set-output-buffer-size', this also prevents Emacs from explicitly flushing the tty output stream, except at the end of display update.

These variables will override print-length and print-level when printing Lisp values in ERT batch test results.

Executing ert-deftest with the same name as an existing test causes the previous definition to be discarded, which was probably not intended when this occurs in batch mode. To remedy the error, rename tests so that they all have unique names.

When environment variable 'EMACS_{TESTJUNITREPORT}' is set, ERT generates a JUnit test report under this file name. This is useful for Emacs integration into CI/CD test environments.

This affects the ert-select-tests function and its callers.

The Emoji commands are under the new 【C-x 8 e】 prefix.

This command guides you through various Emoji categories and combinations in a graphical menu system.

This command lets you search for and insert an Emoji based on names.

This command lists all Emoji (categorized by themes) in a special buffer and lets you choose one of them to insert.

This command lets you choose among the Emoji you have recently inserted and insert it.

This command will tell you the name of the Emoji at point. (It also works for non-Emoji characters.)

These are bound to 【C-x 8 e +】 and 【C-x 8 e -】, respectively. They can be used on any character, but are mainly useful for Emoji.

This is bound to 【C-x 8 e 0】, and undoes any size changes performed by emoji-zoom-increase and emoji-zoom-decrease.

This allows you to enter Emoji using short strings, eg ':face_palm:' or ':scream:'.

If non-nil, link buttons in "Help" buffers will have any surrounding quotes removed.

Such an apropos buffer is more easily viewed with outlining after enabling outline-minor-mode in apropos-mode.

When displaying docstrings in "Help" buffers, strings that are "`like-this'" are made into links (if they point to a bound function/variable). This can lead to false positives when talking about values that are symbols that happen to have the same names as functions/variables. To inhibit this buttonification, use the new "\\+`like-this'" syntax.

If non-nil, commands to show the info manual and the source will reuse the same window in which the "Help" buffer is shown.

For instance, previously a command might be described as having the following bindings:

It is bound to <open>, C-x C-f, <menu-bar> <file> <new-file>.

This has been changed to:

It is bound to <open> and C-x C-f. It can also be invoked from the menu: File → Visit New File…

'C-u C-h .' would previously inhibit displaying a warning message if there was no local help at point. This has been changed to call button-describe/widget-describe and display button/widget help instead.

If enabled, e on a value in "Help" will pop you to a new buffer where you can edit the value. This is not enabled by default, because it is easy to make an edit that yields an invalid result.

Set describe-bindings-outline to nil to get back the old behavior.

Jumping to source from a "Help" buffer moves point when the source buffer is already open. Now, the old point is pushed onto mark ring.

These will take you (respectively) to the next and previous "page".

This will take you to the Emacs Lisp manual entry for the item displayed, if any.

It now only includes local minor modes at the start, and the global minor modes are listed after the major mode.

The apropos commands will now select the apropos window if help-window-select is non-nil.

If the symbol at point is a keymap, describe-keymap suggests it as the default candidate.

The command pops up a buffer at the bottom of the screen with a few helpful commands for various tasks. You can toggle the display using 'C-h C-q'.

Customize the user option outline-default-state to define what headings will be visible initially, after Outline mode is turned on. When the value is a number, the user option outline-default-rules determines the visibility of the subtree starting at the corresponding level. Values are provided to control showing a heading subtree depending on whether the heading matches a regexp, or on whether its subtree has long lines or is itself too long.

If non-nil, Outline Minor Mode will use buttons to hide/show outlines in addition to the ellipsis. The default is nil, but in help-mode it has the value insert that inserts the buttons directly into the buffer, and you can use RET to cycle outline visibility. When the value is in-margins, Outline Minor Mode uses the window margins for buttons that hide/show outlines.

outline-button-icon-map, outline-overlay-button-map, and outline-inserted-button-map are now available as defined keymaps instead of being anonymous keymaps.

These commands split the root window in two, and are bound to 【C-x w 2】 and 【C-x w 3】, respectively. A number of other useful window-related commands are now available with key sequences that start with the 【C-x w】 prefix.

This action removes other windows from the frame when displaying a buffer on that frame.

For example, a display-buffer-alist entry of

(window-width . (body-columns . 40))

will make the body of the chosen window 40 columns wide. For the height use window-height and body-lines, respectively.

The display buffer action functions display-buffer-use-some-window and display-buffer-use-least-recent-window now honor the action alist entry window-min-height as well as the entries listed below to make the display of several buffers in a row more amenable.

This allows specifying which frames display-buffer should consider when using a window that shows another buffer. It is interpreted as per the ALL-FRAMES argument of get-lru-window.

display-buffer will ignore windows with a use time higher than this when using a window that shows another buffer.

This has display-buffer bump the use time of any window it returns, making it a less likely candidate for displaying another buffer.

This allows specifying a preferred minimum width of the window used to display a buffer.

This is controlled by the new other-window-scroll-default variable, which should be set to a function that returns a window. When this variable is nil, next-window is used.

The 16 most recently deleted frames can be undeleted with 【C-x 5 u】 when undelete-frame-mode is enabled. Without a prefix argument, undelete the most recently deleted frame. With a numerical prefix argument between 1 and 16, where 1 is the most recently deleted frame, undelete the corresponding deleted frame.

That value means to use frame-title-format for iconified frames. This is useful with some window managers and desktop environments which treat changes in frame's title as requests to raise the frame and/or give it input focus, or if you want the frame's title to be the same no matter if the frame is iconified or not.

This option is non-nil by default, which resizes tab-bar tabs so that their width is evenly distributed across the tab bar. A companion option tab-bar-auto-width-max controls the maximum width of a tab before its name on display is truncated.

It prompts for the name of a tab and switches to it, creating a new tab if no tab exists by that name.

By default, it contains 'C-c <left>' and 'C-c <right>' to browse the history of tab window configurations back and forward.

With this command-line option, Emacs reuses an existing graphical client frame if one exists; otherwise it creates a new frame.

With this command-line option, emacsclient will exit if Emacs does not respond within N seconds. The default is to wait forever.

The Emacs server will be automatically stopped when certain conditions are met. The conditions are determined by the argument to server-stop-automatically, which can be empty, delete-frame or kill-terminal.

This shows the reception time of the message at point (if available).

Rcirc now uses the default completion-at-point mechanism. The conventional IRC behavior of completing by cycling through the available options can be restored by enabling this option.

If you are in a channel where a bot is responsible for bridging between networks, you can use this variable to make these messages appear more native. For example, you might set the option to:

(setopt rcirc-bridge-bot-alist '(("bridge" . "{\\(.+?\\)}[[:space:]]+")))

for messages like

09:47 <bridge> {john} I am not on IRC

to be reformatted into

09:47 <john> I am not on IRC

Most IRC clients (including rcirc) support basic formatting using control codes. Under the 'C-c C-f' prefix a few commands have been added to insert these automatically. For example, if a region is active and 'C-c C-f C-b' is invoked, markup is inserted for the region to be highlighted in bold.

Use it if you want Imenu to forget the buffer's index alist and recreate it anew next time imenu is invoked.

When non-nil, if the point is in a closing delimiter and the opening delimiter is offscreen, shows some context around the opening delimiter in the echo area. The default is nil.

This option can also be set to the symbols overlay or child-frame, in which case the context is shown in an overlay or child-frame at the top-left of the current window. The latter option requires a graphical frame. On non-graphical frames, the context is shown in the echo area.

The user option comint-terminfo-terminal and the variable system-uses-terminfo can now be set as connection-local variables to change the terminal used on a remote host.

When nil, this prevents comint from deleting the current input when inserting previous input using '<mouse-2>'. The default is t, to preserve previous behavior.

This minor mode is enabled by default in "shell" and "ielm" buffers. It fontifies input text according to shell-mode or emacs-lisp-mode font-lock rules. Customize the user options shell-fontify-input-enable and ielm-fontify-input-enable to nil if you don't want to enable input fontification by default.

The user options mouse-wheel-down-alternate-event and mouse-wheel-up-alternate-event as well as the variables mouse-wheel-left-alternate-event and mouse-wheel-right-alternate-event have been added to better support systems where two kinds of wheel events can be received.

For the details, see the item about the delete-forward-char command above.

Setting it to a non-nil value temporarily disables automatic composition of character sequences at point, and thus makes it easier to edit such sequences by allowing point to "enter" the composed sequence.

Emacs now supports, and has language-environments and input methods, for several dozens of old scripts that were used in the past for various languages. For each such script Emacs now has font-selection and character composition rules, a language environment, and an input method. The newly-added scripts and the corresponding language environments are:

Tai Tham script and the Northern Thai language environment

Brahmi script and language environment

Kaithi script and language environment

Tirhuta script and language environment

Sharada script and language environment

Siddham script and language environment

Syloti Nagri script and language environment

Modi script and language environment

Baybayin script and Tagalog language environment

Hanunoo script and language environment

Buhid script and language environment

Tagbanwa script and language environment

Limbu script and language environment

Balinese script and language environment

Javanese script and language environment

Sundanese script and language environment

Batak script and language environment

Rejang script and language environment

Makasar script and language environment

Lontara script and language environment

Hanifi Rohingya script and language environment

Grantha script and language environment

Kharoshthi script and language environment

Lepcha script and language environment

Meetei Mayek script and language environment

Adlam script and language environment

Mende Kikakui script and language environment

Wancho script and language environment

Toto script and language environment

Gothic script and language environment

Coptic script and language environment

Mongolian-traditional script and language environment

Mongolian-cyrillic language environment

This is to follow the change in the official name of the script. The oriya input method was also renamed to odia. However, the old name of the language environment and the input method are still supported.

Type 'C-u C-h t' to select it in case your language setup does not do so automatically.

The default input method for the Tamil language environment is now "tamil-phonetic" which is a customizable phonetic input method. To change the input method's translation rules, customize the user option tamil-translation-rules.

This supports the keyboard layout specifically designed for the Tamil language.

This is a variant of the slovak input method, which corresponds to the QWERTY Slovak keyboards.

This input method is based on the russian-computer input method, and is intended for typing in the Chuvash language written in the Cyrillic script.

This input method is for typing in the Mongolian language using the Cyrillic script. It is the default input method for the new Mongolian-cyrillic language environment, see above.

These allow you to (respectively) edit and bulk-remove entries from the ecomplete database.

If non-nil and there's only one matching option, auto-select that.

If non-nil, this user option describes what entries not to add to the database stored on disk.

Whether to recognize additional keyword params, like ':max' and ':require', as well as accept lists of query terms paired with applicable keywords. This disables most known behavioral quirks unique to auth-source-pass, such as wildcard subdomain matching.

This means that dired-do-shell-command will now provide smarter defaults without first having to require dired-x. See the node "(emacs) Shell Command Guessing" in the Emacs manual for more details.

This means that Dired now offers to kill buffers visiting files and dirs when they are deleted in Dired. Before, you had to require dired-x to enable this behavior. To disable this behavior, customize the user option dired-clean-up-buffers-too to nil. The related user option dired-clean-confirm-killing-deleted-buffers (which see) has also been moved to dired.

The corresponding key Y is now bound by default in Dired.

The corresponding key sequence '% Y' is now bound by default in Dired.

Before, that binding was only available if the dired-x package was loaded.

The dired-info and dired-man commands have been moved from the dired-x package to dired. They have also been renamed to dired-do-info and dired-do-man; the old command names are obsolete aliases.

The keys I (dired-do-info) and N (dired-do-man) are now bound in Dired mode by default. The user options dired-bind-man and dired-bind-info no longer have any effect and are obsolete.

To get the old behavior back and unbind these keys in Dired mode, add the following to your Init file:

(with-eval-after-load 'dired (keymap-set dired-mode-map "N" nil) (keymap-set dired-mode-map "I" nil))

This command visits the file on the current line with EWW.

When invoked with a prefix arg, this will now call browse-url-secondary-browser-function instead of the default browser. browse-url-of-dired-file is bound to W by default in dired mode.

This is used by dired-omit-mode, and now allows you to hide based on other things than just the file names.

If non-nil, dragging file names with the mouse in a Dired buffer will initiate a drag-and-drop session allowing them to be opened in other programs.

Dired will now, by default, include the free space in the first line instead of having it on a separate line. To get the previous behavior back, say:

(setopt dired-free-space 'separate)

If non-nil (which is the default), hitting RET or mouse-1 on the directory components at the directory displayed at the start of the buffer will take you to that directory.

For example, the regexp ".*" will match only characters that are part of the file name. Also "^.*$" can be used to match at the beginning of the file name and at the end of the file name. This is used only when searching on file names. In Wdired this can be used when the new user option wdired-search-replace-filenames is non-nil (which is the default).

This command evals the forms in the active region or in the whole buffer.

These commands (bound to 'C-c C-f' and 'C-c C-b', respectively) byte-compile the visited file and the current buffer, respectively.

This controls how randomness is implemented (whether to use pure randomness as before, or to use a bag).

This can be used to trigger actions based on the battery status.

If Emacs is built with SVG support, doc-view can generate SVG files when using MuPDF as the converter for PDF files, which generally leads to sharper images (especially when zooming), and allows customization of background and foreground color of the page via the new user options doc-view-svg-background and doc-view-svg-foreground. To activate this behavior, set doc-view-mupdf-use-svg to non-nil if your Emacs has SVG support. Note that, with some versions of MuPDF, SVG generation is known to sometimes produce SVG files that are buggy or can take a long time to render.

This allows you to see the markup in enriched-mode buffers (e.g., the "HELLO" file). Bound to 【M-o m】 by default.

This controls how statements like the following are indented:

foo && bar

It is enabled by default, but requires that the external "shellcheck" command is installed.

The default value of objc-font-lock-extra-types has been changed to nil, since too many identifiers were getting misfontified as types. This may cause some actual types not to get fontified. To get the old behavior back, customize the user option to the value suggested in its doc string.

This option determines the indentation style to be used. It can also be used as a file-local variable.

If given a prefix, it will prompt for an argument to use for the run/continue command.

As of Perl 5.10, 'perl -E 0' behaves like 'perl -e 0' but also activates all optional features of the Perl version in use. perldb now uses this invocation as its default.

This is bound to H and toggles whether to hide or show the widget contents.

Sets the value of the buffer-local variable whitespace-style in diff-mode buffers. By default, this variable is '(face trailing)', which preserves behavior of previous Emacs versions.

If non-nil insert file names in ChangeLog skeletons relative to the VC root directory.

These commands push onto the mark ring the location of the last misspelled word where corrections were offered, so that you can then skip back to that location with 【C-x C-x】.

Buffers with major modes in this list will be ignored. By default, this includes "binary" buffers like archive-mode and image-mode.

This command allows you to upgrade packages without using list-packages. A package that comes with the Emacs distribution can only be upgraded after you install, once, a newer version from ELPA via the package-menu displayed by list-packages.

This command allows upgrading all packages without any queries. A package that comes with the Emacs distribution will only be upgraded by this command after you install, once, a newer version of that package from ELPA via the package-menu displayed by list-packages.

These commands can be useful if the ".elc" files are out of date (invalid byte code and macros).

If no packages are marked, x will install the package under point if it isn't already, and remove it if it is installed. Customize the new option package-menu-use-current-if-no-marks to the nil value to get back the old behavior of signaling an error in that case.

Packages can now be installed directly from source by cloning from their repository.

An existing checkout can now be loaded via package.el, by creating a symbolic link from the usual package directory to the checkout.

Used to fetch the source of a package by cloning a repository without activating the package.

This command allows you to send patches to package maintainers, for packages checked out using package-vc-install.

This command helps you compose an email for sending bug reports to package maintainers, and is bound to b in the "Packages" buffer.

By customizing this user option you can specify specific packages to install.

When enabled, package-install will include in the list of upgradeable packages those built-in packages (like Eglot and use-package, for example) for which a newer version is available in package archives, and will allow installing those newer versions. By default, this is disabled; however, if package-install is invoked with a prefix argument, it will act as if this new option were enabled.

In addition, when this option is non-nil, built-in packages for which a new version is available in archives can be upgraded via the package menu produced by list-packages. If you do set this option non-nil, we recommend not to use the U command, but instead to use '/ u' to show the packages which can be upgraded, and then decide which ones of them you actually want to update from the archives.

If you customize this option, we recommend you place its non-default setting in your early-init file.

The option desktop-load-locked-desktop can now be set to the value check-pid, which means to allow loading a locked ".emacs.desktop" file if the Emacs process which locked it is no longer running on the local machine. This allows avoiding questions about locked desktop files when the Emacs session which locked it crashes, or was otherwise interrupted and didn't exit gracefully. See the "(emacs) Saving Emacs Sessions" node in the Emacs manual for more details.

This command switches to the "scratch" buffer. If "scratch" doesn't exist, the command creates it first. You can use this command if you inadvertently delete the "scratch" buffer.

Instead it just buries the buffer and switches the mode from debugger-mode to backtrace-mode, since commands like e are no longer available after exiting the recursive edit.

This user option controls whether the e (in a "Backtrace" buffer or while edebugging) and 【C-x C-e】 (while edebugging) commands lead to a (further) backtrace. By default, this variable is nil, which is a change in behavior from previous Emacs versions.

When invoked with a prefix argument, as in 【C-u e】, this command will pop up a new buffer and show the full pretty-printed value there.

When invoked with a non-zero prefix argument, as in 'C-u C-x C-e', this command will pop up a new buffer and show the full pretty-printed value there.

To do this, set the new variable backtrace-on-redisplay-error to a non-nil value. The backtrace will be written to a special buffer named "Redisplay-trace". This buffer will not be automatically displayed in a window.

This regular expression can be used to make specific parts of compilation output invisible.

It can now have the additional values if-location-known (which will only jump if the location of the first error is known), and first-known (which will jump to the first known error location).

Lines longer than the value of this option will have their ends hidden, with a button to reveal the hidden text. This speeds up operations like grepping on files that have few newlines. The default value is 400; set to nil to disable hiding.

When the minibuffer is the current buffer, typing 'M-<up>' or 'M-<down>' selects a previous/next completion candidate from the "Completions" buffer and inserts it to the minibuffer. When the user option minibuffer-completion-auto-choose is nil, 'M-<up>' and 'M-<down>' do the same, but without inserting a completion candidate to the minibuffer, then M-RET can be used to choose the currently active candidate from the "Completions" buffer and exit the minibuffer. With a prefix argument, 'C-u M-RET' inserts the currently active candidate to the minibuffer, but doesn't exit the minibuffer. These keys are also available for in-buffer completion, but they don't insert candidates automatically, you need to type M-RET to insert the selected candidate to the buffer.

This means that typing 【C-u RET】 on a completion candidate in the "Completions" buffer inserts the completion into the minibuffer, but doesn't exit the minibuffer.

To enable this behavior, customize the user option completion-auto-select to t, then pressing TAB will switch to the "Completions" buffer when it pops up that buffer. If the value is second-tab, then the first TAB will display "Completions", and the second one will switch to the "Completions" buffer.

When non-nil, the commands next-completion and previous-completion automatically wrap around on reaching the beginning or the end of the "Completions" buffer.

There are two new values to control the way the "Completions" buffer behaves after pressing a TAB if completion is not unique. The value always updates or shows the "Completions" buffer after any attempt to complete. The value visual is like always, but only updates the completions if they are already visible. The default value t always hides the completion buffer after some completion is made.

minibuffer-complete-history (【C-x <up>】) is like minibuffer-complete but completes on the history items instead of the default completion table. minibuffer-complete-defaults (【C-x <down>】) completes on the list of default items.

Customize the user option minibuffer-default-prompt-format instead.

This option controls the sorting of the completion candidates in the "Completions" buffer. Available styles are no sorting, alphabetical (the default), or a custom sort function.

This option limits the height of the "Completions" buffer.

This is a string to control the header line to show in the "Completions" buffer before the list of completions. If it contains "%s", that is replaced with the number of completions. If nil, the header line is not shown.

When this user option names a face, the current candidate in the "Completions" buffer is highlighted with that face. The nil value disables this highlighting. The default is to highlight using the completions-highlight face.

minibuffer-mode-abbrev-table and minibuffer-inactive-mode-abbrev-table are now defined.

If a user does C-s and then uses '<mouse-2>' (mouse-yank-primary) outside the echo area, Emacs will, by default, end the Isearch and yank the text at mouse cursor. But if mouse-yank-at-point is non-nil, the text will now be added to the Isearch instead.

Now with these values the search will wrap around not only on repeating with 'C-s C-s', but also after typing a character.

Non-nil means that the default definitions of equivalent characters are overridden.

It displays character equivalences used by char-fold-to-regexp.

It is bound to 【C-x 8 e RET】 during an incremental search. The command accepts the Unicode name of an Emoji (for example, "smiling face" or "heart with arrow"), like 【C-x 8 e e】, with minibuffer completion, and adds the Emoji into the search string.

On capable platforms, GDB 10.1 and later can download missing source and debug info files from special-purpose servers, called "debuginfod servers". Use this new option to control whether 【M-x gdb】 instructs GDB to download missing files from debuginfod servers when you debug the corresponding programs. The default is to ask you at the beginning of each debugging session whether to download the files for that session.

This allows an easy way to toggle seeing all glyphless characters in the current buffer.

The extra slot of the glyphless-char-display char-table can now have values that are cons cells, specifying separate values for text-mode and GUI terminals.

The acronym method of displaying glyphless characters on text-mode frames treats single-character acronyms specially: they are displayed without the surrounding '[..]' "box", thus in effect treating such "acronyms" as replacement characters.

For instance, to enable jumping to the "Messages" buffer with 【C-x r j m】:

(set-register ?m '(buffer . "Messages"))

This fills the region to be no wider than a specified pixel width.

This will take you to the "gnu.org" web server's version of the current info node. This command only works for the Emacs and Emacs Lisp manuals.

It copies the name of the function near point into the kill ring.

This is in addition to the old keybindings 'C-c C-n' and 'C-c C-p'.

This commands first does a "pull" command, and if that is successful, does a "push" command afterwards. Currently supported in Git and Bzr.

vc-print-branch-log is bound to 【C-x v b l】, and new commands are vc-create-branch (【C-x v b c】) and vc-switch-branch (【C-x v b s】). The VC Directory buffer now uses the prefix b for these branch-related commands.

This command marks files based on a regexp. If given a prefix argument, unmark instead.

This prefix command requests editing of the next VC shell command before execution. For example, in a Git repository, you can produce a log of more than one branch by typing 【C-x v ! C-x v b l】 and then appending additional branch names to the 'git log' command.

The intention is that this command can be used to access a wide variety of version control system-specific functionality from VC without complexifying either the VC command set or the backend API.

This command is intended to allow you to commit only some of the changes you have in your working tree. Begin by creating a buffer with the changes against the last commit, example: with 【C-x v D】 (vc-root-diff). Then edit the diffs to remove the hunks you don't want to commit. Finally, type 【C-x v v】 in that diff buffer to commit only part of your changes, those whose hunks were left in the buffer.

Previously, if you had an SVN-covered "~/" directory, and a Git-covered directory in "~/foo/bar", using 【C-x v v】 on a new, unregistered file "~/foo/bar/zot" would register it in the SVN repository in "~/" instead of in the Git repository in "~/foo/bar". This makes this command consistent with vc-responsible-backend.

Writing shorter summary lines avoids truncation in contexts in which Git commands display summary lines. See the two new user options vc-git-log-edit-summary-target-len and vc-git-log-edit-summary-max-len.

It is used to style the line that separates the log-edit headers from the log-edit summary.

If non-nil, multiple revisions can be queried. This is done using completing-read-multiple.

This function invokes vc-read-revision with a non-nil value for MULTIPLE.

Patches for any version control system can be prepared using VC. The command will query what commits to send and will compose messages for your mail user agent. The behavior of vc-prepare-patch can be modified by the user options vc-prepare-patches-separately and vc-default-patch-addressee.

If non-nil, 'C-c C-a' will put attached files at the end of the message.

This controls automatic insertion of the "X-Message-SMTP-Method" header before sending a message.

It narrows to the current node.

After Emacs 29.1, some aspects of EUDC will be deprecated. The goal of these deprecations is to simplify EUDC server configuration by making eudc-server-hotlist the only place to add servers. There will not be a need to set the server using the eudc-set-server command. Instead, the eudc-server-hotlist user option should be customized to have an entry for the server. The plan is to obsolete the eudc-hotlist package since Customize is sufficient for changing eudc-server-hotlist. How the eudc-server user option works in this context is to-be-determined; it can't be removed, because that would break compatibility, but it may become synchronized with eudc-server-hotlist so that eudc-server is always equal to '(car eudc-server-hotlist)'. The first entry in eudc-server-hotlist is the first server tried by eudc-expand-try-all. The hotlist simplification will allow eudc-query-form to show a drop down of possible servers, instead of requiring a call to eudc-set-server like it does in this release. The default value of eudc-ignore-options-file will be changed from nil to t.

The eudc-ignore-options-file user option can be configured to ignore the eudc-options-file (typically "~/.emacs.d/eudc-options"). Most users should configure this to t and put EUDC configuration in the main Emacs initialization file ("~/.emacs" or "~/.emacs.d/init.el").

The user option eudc-expansion-overwrites-query is renamed to eudc-expansion-save-query-as-kill to reflect the actual behavior of the user option. The former is kept as alias.

This command can be used in place of eudc-expand-inline. It takes a prefix argument that causes eudc-expand-try-all to return matches from all servers instead of just the matches from the first server to return any. This is useful for example, if one wants to search LDAP for a name that happens to match a contact in one's BBDB.

EUDC inline expansion result formatting defaulted to

("%s %s <%s>" firstname name email)

Since email address specifications need to comply with RFC 5322 in order to be useful in messages, there was a risk of producing syntax which was standard with RFC 822, but is marked as obsolete syntax by its successor RFC 5322. Also, the first and last name part was never enclosed in double quotes, potentially producing invalid address specifications, which may be rejected by a receiving MTA. Thus, this variable can now additionally be set to nil (the new default), or a function. In both cases, the formatted result will be in compliance with RFC 5322. When set to nil, a default format very similar to the old default will be produced. When set to a function, that function is called, and the returned values are used to populate the phrase and comment parts (see RFC 5322 for definitions). In both cases, the phrase part will be automatically quoted if necessary.

EUDC can now contribute email addresses to completion-at-point by adding the new function eudc-capf-complete to completion-at-point-functions in message-mode.

The EUDC back-end for the macOS Contacts app now provides a wider set of attributes to use for queries, and delivers more attributes in query results.

A new back-end for ecomplete allows information from that database to be queried by EUDC, too. The attributes present in the EUDC query are used to select the entry type in the ecomplete database.

A new back-end for mailabbrev allows information from that database to be queried by EUDC, too. Only the attributes email, name, and firstname are supported.

The eww-auto-rename-buffer user option can be configured to rename rendered web pages by using their title, URL, or a user-defined function which returns a string. For the first two cases, the length of the resulting name is controlled by the user option eww-buffer-name-length. By default, no automatic renaming is performed.

This complements shr-blocked-images, but allows specifying just the allowed images.

If non-nil (and Emacs has been built with support for xwidgets), display <video> elements with an xwidget. Note that this is experimental; it is known to crash Emacs on some systems, and just doesn't work on other systems. Also see etc/PROBLEMS.

These are used to alter an URL before using it. By default it removes the common "utm_" trackers from URLs.

This enables users to run find-dired with an arbitrary command, enabling running commands previously unsupported and also enabling new commands to be built on top.

There were previously two styles of tool bars available in Gnus and Message, referred to as gnus-summary-tool-bar-retro, gnus-group-tool-bar-retro and message-tool-bar-retro, and gnus-summary-tool-bar-gnome, gnus-group-tool-bar-gnome and message-tool-bar-gnome. The "retro" tool bars have been removed (as well as the icons used), and the "gnome" tool bars are now the only pre-defined toolbars.

The gnus-summary-down-thread binding to M-C-d was shadowed by gnus-summary-read-document, and these commands are also available on 'T u' and 'T d' respectively.

To get the monospace font back, you can put something like the following in your ".gnus" file:

(set-face-attribute 'gnus-header nil :inherit 'unspecified)

All other 'gnus-header-*' faces inherit from this face now.

If non-nil, symbols that have an Emoji representation will be displayed as emojis. The default is nil.

This is bound to 'W D e' and will display symbols that have Emoji representation as Emoji.

Configuration is very similar to the notmuch and namazu backends. It supports the unified search syntax.

Formerly it was a pair of numbers '(A B)' that represented 65536*A + B, to cater to older Emacs implementations that lacked bignums. The older form still works but is undocumented.

You can now narrow the set of messages selected by Rmail summary's criteria (recipients, topic, senders, etc.) by making a summary of the already summarized messages. For example, invoking rmail-summary-by-senders, followed by rmail-summary-by-topic will produce a summary where both the senders and the topic are according to your selection. The new user option rmail-summary-progressively-narrow controls whether the stacking of the filters is in effect; customize it to a non-nil value to enable this feature.

The new command rmail-summary-by-thread produces a summary of messages that belong to a single thread of discussion.

Previously, 【M-x align】 didn't do anything, and you had to say 'C-u M-x align' for it to work. This has now been changed. The default regexp for 'C-u M-x align-regexp' has also been changed to be easier for inexperienced users to use.

This mode is used by the 【C-h N】 command, and adds buttons to manual entries and symbol references.

When this option is non-nil (which is the default), key bindings displayed in the "Help" buffer will be linked to the documentation for the command they are bound to. This does not affect listings of key bindings and functions (such as 【C-h b】).

The new ':doc-spec-function' element can be used to compute the ':doc-spec' element when the user asks for info on that particular mode (instead of at load time).

256-color and 24-bit color codes are now handled by ANSI color filters and displayed with the specified color.

If non-nil, term-mode will pass the function keys on to the underlying shell instead of using the normal Emacs bindings.

term-mode can now display 256-color and 24-bit color codes. It can also handle ANSI codes for faint, italic and blinking text, displaying it with new 'term-{faint,italic,slow-blink,fast-blink}' faces.

The commands project-find-file and project-or-external-find-file now accept a prefix argument, which is interpreted to mean "include all files".

This command displays a list of buffers from the current project.

Customize the user option project-kill-buffers-display-buffer-list to enable the display of the buffer list.

Use it to add detection of nested projects (inside a VCS repository), or projects outside of VCS repositories.

As a consequence, the 'VC project backend' is formally renamed to 'VC-aware project backend'.

If non-nil, files untracked by a VCS are considered to be part of the project by a VC project based on that VCS.

It is bound to 'C-M-,' and jumps to the location where you previously invoked xref-go-back ('M-,', also known as xref-pop-marker-stack).

The implementation of the Xref marker stack was changed in a way that allows as many places to be saved on the stack as needed, limited only by the available memory. Therefore, the variables find-tag-marker-ring-length and xref-marker-ring-length are now obsolete and unused; setting them has no effect.

This command no longer prompts for FROM when called without prefix argument. This makes the most common case faster: replacing entire matches.

You can enable outlining by adding outline-minor-mode to xref-after-update-hook.

To improve security, if an sql product has ':password-in-comint' set to t, a password supplied via the minibuffer will be sent in-process, as opposed to via the command-line.

This command fits the image to the current window by scaling down or up as necessary. Unlike image-transform-fit-both, this can scale the image up as well as down. It is bound to 's w' in Image Mode by default.

This command sets the desktop background to the current image. It is bound to W in Image Mode by default.

Use the new command image-transform-fit-to-window instead. The keybinding for image-transform-fit-to-width is now 's i'.

This works like image-transform-fit-to-window.

The new fit-window option will never scale an image more than this much (in percent). It is nil by default, which means no limit.

This controls whether or not to show a message, when opening certain image formats, explaining how to edit it as text. The default is to show this message for SVG and XPM.

It allows resizing the image to a percentage of its original size, and is bound to 's p' in Image mode.

The old name was confusing, and is now an obsolete function alias.

The old name was confusing, and is now an obsolete function alias.

These commands allow interactively cropping/cutting the image at point. The commands are bound to keys 'i c' and 'i x' (respectively) in the local keymap over images. They rely on external programs, by default "convert" from ImageMagick, to do the actual cropping/eliding of the image file.

These commands horizontally and vertically flip the image under point, and are bound to 'i h' and 'i v', respectively.

This is done via image-converter-add-handler.

This avoids converting images in the background, and makes Image-Dired noticeably faster. New keybindings from image-mode are now available in the "image-dired-display-image" buffer; press '?' or h in that buffer to see the full list.

The following new bindings have been added:

• n, SPC => image-dired-display-next
• p, DEL => image-dired-display-previous
• m => image-dired-mark-thumb-original-file
• d => image-dired-flag-thumb-original-file
• u => image-dired-unmark-thumb-original-file

It removes all marks from all files in the thumbnail and the associated Dired buffer, and is bound to U in the thumbnail and display buffer.

It deletes all flagged files, and is bound to x in the thumbnail buffer. It replaces the command image-dired-delete-marked, which is now an obsolete alias.

It copies the name of the marked or current image to the kill ring, and is bound to w in the thumbnail buffer.

This command sets the desktop background to the image at point in the thumbnail buffer. It is bound to W by default.

It is bound in both the thumbnail and display buffer, and no longer prompts for a timeout; use a numerical prefix (e.g. 【C-u 8 S】) to set the timeout.

If this option is non-nil (the default), marking, unmarking or flagging an image in either the thumbnail or display buffer shows the next image.

If image-dired-thumb-mark is non-nil (the default), this face is used for images that are flagged for deletion in the Dired buffer associated with Image-Dired.

This replaces the message that most navigation commands in the thumbnail buffer used to show at the bottom of the screen.

This is used to format the new header line. The new specifiers are: "%d" for the name of the directory that the file is in, "%n" for file's number in the thumbnail buffer, and "%s" for the file size.

The default format has been updated to use this. If you prefer the old format, add this to your Init file:

(setopt image-dired-display-properties-format "%b: %f (%t): %c")

These faces correspond to different parts of the header line, as specified in image-dired-display-properties-format:

• image-dired-thumb-header-directory-name
• image-dired-thumb-header-file-name
• image-dired-thumb-header-file-size
• image-dired-thumb-header-image-count

Image-Dired now displays thumbnails for PDF files. Type RET on a PDF file in the thumbnail buffer to visit the corresponding PDF.

Support for the GraphicsMagick command line tool ("gm") has been added, and is used when it is available instead of ImageMagick.

This standard allows sharing generated thumbnails across different programs. Version 0.9.0 adds two larger thumbnail sizes: 512x512 and 1024x1024 pixels. See the user option image-dired-thumbnail-storage to use it; it is not enabled by default.

The image-dired-copy-with-exif-file-name command no longer requires an external "exiftool" program to be available. The user options image-dired-cmd-read-exif-data-program and image-dired-cmd-read-exif-data-options are now obsolete.

The command bookmark-set (bound to 【C-x r m】) is now supported in the thumbnail view, and will create a bookmark that opens the current directory in Image-Dired.

It no longer inconveniently prompts for a number of images and a delay: it runs indefinitely, but stops automatically on any command. You can set the delay with a prefix argument, or a negative prefix argument to prompt for a delay. Customize the user option image-dired-slideshow-delay to change the default from 5 seconds.

This user option controls asking for confirmation when starting Image-Dired in a directory with many files. Since Image-Dired creates thumbnails in the background in recent versions, this is not as important as it used to be. You can now also customize this option to nil to disable this confirmation completely.

The corresponding keymap is now named image-dired-image-mode-map.

• image-dired-display-thumbnail-original-image has been renamed to image-dired-display-this.
• image-dired-display-next-thumbnail-original has been renamed to image-dired-display-next.
• image-dired-display-previous-thumbnail-original has been renamed to image-dired-display-previous.

The old names are now obsolete aliases.

Customize image-dired-thumb-size instead, which will set both the height and width.

The image-dired-gallery-generate command and these user options are now obsolete: image-dired-gallery-thumb-image-root-url, image-dired-gallery-hidden-tags, image-dired-gallery-dir, image-dired-gallery-image-root-url.

Instead, use commands image-dired-refresh-thumb to generate a new thumbnail, or image-rotate to rotate the thumbnail without updating the thumbnail file.

Since image-dired-display-image-mode is now based on image-mode, some commands and user options are no longer needed and are now obsolete: image-dired-cmd-create-temp-image-options, image-dired-cmd-create-temp-image-program, image-dired-display-current-image-full, image-dired-display-current-image-sized, image-dired-display-window-height-correction, image-dired-display-window-width-correction, image-dired-temp-image-file.

This is a convenience function to extract the field data from exif-parse-file and exif-parse-buffer.

Types are registered via a bookmark-handler-type symbol property on the jumping function.

This will display bookmark list from most recently set to least recently set.

It is bound to the new command bookmark-edit-annotation-cancel.

This option controls the bitmap used to indicate bookmarks in the fringe (or nil to disable showing this marker).

This option controls how xwidget-webkit buffers are named.

This option controls whether the xwidget-webkit buffers save cookies set by web pages, and if so, in which file to save them.

When this mode is enabled, self-inserting characters and other common web browser shortcut keys are redefined to send themselves to the WebKit widget.

This mode acts similarly to incremental search, and allows searching the contents of a WebKit widget. In xwidget-webkit mode, it is bound to C-s and C-r.

This command displays a buffer containing the page load history of the current WebKit widget, and allows you to navigate it.

To access the inspector, right click on the widget and select "Inspect Element".

The newly created buffer will be displayed via display-buffer, which can be customized through the usual mechanism of display-buffer-alist and friends.

They allow accessing containers provided by Docker and similar programs.

When calling abbreviate-file-name on a Tramp file name, the result will abbreviate the user's home directory, for example by abbreviating "/ssh:user@host:/home/user" to "/ssh:user@host:~".

When set to non-nil, Tramp does not copy files between two remote hosts via a local copy in its temporary directory, but lets the scp command do this job.

The password prompts for these methods reflect now the credentials of the user requesting such a connection, and not of the user who is the target. This has always been needed, just the password prompt and the related auth-sources entry were wrong.

During user and host name completion in the minibuffer, results from Tramp's connection cache are taken into account. This can be disabled by setting the user option tramp-completion-use-cache to nil.

This user option decides which URL scheme that browse-url and related functions will use by default. For example, you could customize this to "https" to always prefer HTTPS URLs.

This option specifies a function for opening "//" links. It defaults to the new function browse-url-irc.

This multipurpose autoloaded function can be used for opening "//" and "ircs://" URLS by any caller that passes a URL string as an initial arg.

This support has been obsolete since Emacs 25.1. The final version of the Netscape web browser was released in February, 2008.

This support has been obsolete since Emacs 25.1. The final version of the Galeon web browser was released in September, 2008.

Note that this historical web browser is different from Mozilla Firefox; it is its predecessor.

When called with a prefix argument, run-python now offers the choice of creating a shell dedicated to the current project. This shell runs in the project root directory and is shared among all project buffers.

Without a prefix argument, the kind of shell (buffer-dedicated, project-dedicated or global) is specified by the new python-shell-dedicated user option.

ruby-method-params-indent, ruby-block-indent, ruby-after-operator-indent, ruby-method-call-indent, ruby-parenless-call-arguments-indent. See the docstrings for explanations and examples.

Prefixing '|', '<' or '>' with an asterisk, i.e. '*|', '*<' or '*>', will cause the whole command to be passed to the operating system shell. This is particularly useful to bypass Eshell's own pipelining support for pipelines which will move a lot of data. See section "Running Shell Pipelines Natively" in the Eshell manual, node "(eshell) Pipelines".

After enabling the new eshell-elecslash module, typing a forward slash as the first character of a command line argument will automatically insert the Tramp prefix. The automatic insertion applies only when default-directory is remote and the command is a Lisp function. This frees you from having to keep track of whether commands are Lisp function or external when supplying absolute file name arguments. See the "(eshell) Electric forward slash" node in the Eshell manual for details.

Eshell now supports a wider variety of redirection operators. For example, you can now redirect both stdout and stderr via '&>' or duplicate one output handle to another via 'NEW-FD>&OLD-FD'. For more information, see the "(eshell) Redirection" node in the Eshell manual.

The privilege-escalation program doas has been added to the existing su and sudo commands from the eshell-tramp module. The external command may still be accessed by using '*doas'.

If an Eshell expansion like '$FOO' is surrounded by double quotes, the result will always be a single string, no matter the type that would otherwise be returned.

When concatenating an Eshell expansion that returns a list, "adjacent" elements of each operand are now concatenated together, e.g. '$(list "a" "b")c' returns '("a" "bc")'. See the "(eshell) Expansion" node in the Eshell manual for more details.

If every line of the output of an Eshell subcommand like '${COMMAND}' is numeric, the result will be a list of numbers (or a single number if only one line of output). Previously, this only converted numbers when there was a single line of output.

Built-in commands in Eshell now accept command-line options with values passed as a single token, such as -oVALUE or '–option=VALUE'. New commands can take advantage of this with the eshell-eval-using-options macro. See "Defining new built-in commands" in the "(eshell) Built-ins" node of the Eshell manual.

Additionally, globs ending with "**/" or "***/" no longer raise an error, and now expand to all directories recursively (following symlinks in the latter case).

When executing a command that looks like '(lisp form)' and returns nil, Eshell will set the exit status (available in the '$?' variable) to 2. This allows commands like that to be used in conditionals. To change this behavior, customize the new eshell-lisp-form-nil-is-failure user option.

Enabling this will automatically kill a "shell" buffer as soon as the shell session terminates.

Customize shell-highlight-undef-enable to t if you want to enable this minor mode in "shell" buffers. It will highlight undefined commands with a warning face as you type.

Set it to nil to exclude line numbering from kills and copies.

hierarchy-add-tree and hierarchy-add-trees have an optional argument which allows tree-widget display to be activated and computed only when the user expands the node.

When default-directory is remote, and proced is invoked with a negative argument like 'C-u - proced', the system processes of that remote host are shown. Alternatively, the user option proced-show-remote-processes can be set to non-nil. proced-signal-function has been marked obsolete.

New user option proced-enable-color-flag enables coloring of Proced buffers. This option is disabled by default; customize it to a non-nil value to enable colors.

When non-nil, WebJump will use an internal browser to open web pages, instead of the default external browser.

This option provides a mechanism to selectively disable font-lock keyword-driven fontifications.

This user option is a predicate function which is called by auto-save-visited-mode to decide whether or not to save a buffer. You can use it to automatically save only specific buffers, for example buffers using a particular mode or in some directory.

If this user option is non-nil, auto-save-visited-mode will not auto-save remote buffers. The default is nil.

This package allows formatting data using variable-pitch fonts. The resulting tables can display text in variable pitch fonts, text using fonts of different sizes, and images. See the "(vtable) Top" manual for more details.

Enabling this minor mode turns on hiding header material, like elide-head does; disabling it shows the header. The commands elide-head and elide-head-show are now obsolete.

Support for OSC ("Operating System Command") escape sequences has been extracted from comint.el in order to provide interpretation of OSC sequences in compilation buffers.

Adding the new function ansi-osc-compilation-filter to compilation-filter-hook enables interpretation of OSC escape sequences in compilation buffers. By default, all sequences are filtered out.

The list of handlers (already covering OSC 7 and 8) has been extended with a handler for OSC 2, the command to set a window title.

This means that e.g. "/home/foo/bar" is now displayed as "~/bar". Customize the user option recentf-filename-handlers to nil to get back the old behavior.

This command prompts for a recently opened file in the minibuffer, and visits it.

It will now simply look at a hostname to determine if it is valid, instead of also trying to ping it. Customize the user option ffap-machine-p-known to ping to get the old behavior back.

To respect Emacs naming conventions, the variable unread-bib-file has been renamed to bib-unread-file. The following commands have also been renamed: addbib to bib-add return-key-bib to bib-return-key mark-bib to bib-mark unread-bib to bib-unread

The old name is still available as an obsolete function alias.

It copies the current line into the kill ring.

The new face abbrev-table-name is used to display the abbrev table name.

This key is now bound to Buffer-menu-view-other-window, which will view this line's buffer in View mode in another window.

Emacs now automatically enables the Scheme mode when opening R6RS Scheme Library Source (".sls") files and R7RS Scheme Library Definition (".sld") files.

Imenu now lists the members directly nested in R6RS Scheme libraries (library) and R7RS libraries (define-library).

Used by interactive-form when called on an OClosure. This allows specific OClosure types to compute their interactive specs on demand rather than precompute them when created.

A major mode based on the tree-sitter library for editing programs in the TypeScript language.

A major mode based on the tree-sitter library for editing programs in the TypeScript language, with support for TSX.

An optional major mode based on the tree-sitter library for editing programs in the C language.

An optional major mode based on the tree-sitter library for editing programs in the C++ language.

A command that automatically guesses the language of a header file, and enables either c-ts-mode or 'c++-ts-mode' accordingly.

An optional major mode based on the tree-sitter library for editing programs in the Java language.

An optional major mode based on the tree-sitter library for editing programs in the Python language.

An optional major mode based on the tree-sitter library for editing CSS (Cascading Style Sheets).

An optional major mode based on the tree-sitter library for editing programs in the JSON language.

An optional major mode based on the tree-sitter library for editing programs in the C# language.

Am optional major mode based on the tree-sitter library for editing Bash shell scripts.

A major mode based on the tree-sitter library for editing Dockerfiles.

A major mode based on the tree-sitter library for editing CMake files.

An optional major mode based on the tree-sitter library for editing files written in TOML, a format for writing configuration files.

A major mode based on the tree-sitter library for editing programs in the Go language.

A major mode based on the tree-sitter library for editing "go.mod" files.

A major mode based on the tree-sitter library for editing files written in YAML.

A major mode based on the tree-sitter library for editing programs in the Rust language.

An optional major mode based on the tree-sitter library for editing programs in the Ruby language.

This function does nothing, and in particular has no effect on the value returned by overlay-lists. The purpose of overlay-recenter was to allow more efficient lookup of overlays around a certain buffer position; however with the new implementation the lookup of overlays is efficient regardless of their position, and there's no longer any need to "optimize" the lookup, nor any notion of a "center" of the overlays.

This function used to return a cons of two lists, one with overlays before the "center" position, the other after that "center". It now returns a list whose car is the list of all the buffer overlays, and whose cdr is always nil.

Emacs previously didn't distinguish between the regular/normal weight and the medium weight, but it now also supports the (heavier) medium weight. However, this means that if you specify a weight of normal and the font doesn't have this weight, Emacs won't find the font spec. In these cases, replacing ":weight 'normal" with ":weight 'medium" should fix the issue.

The variables connection-local-profile-alist and connection-local-criteria-alist are now user options, in order to make it more convenient to inspect and modify them.

This function allows to modify the settings of an existing connection-local profile.

This macro works like with-connection-local-variables, but it allows using another application instead of tramp. This is useful when running code in a buffer where Tramp has already set some connection-local variables.

This allows dynamically setting variable values for a particular connection within the body of 'with-connection-local-{application-}variables'. See the "(elisp) Connection Local Variables" node in the Lisp Reference manual for more information.

This returns a list of sub-sequences of the specified sequence.

This function returns a copy of the specified sequence with the element at a given (zero-based) index removed.

This returns a list of the (zero-based) indices of elements matching a given predicate in the specified sequence.

This is like seq-map, but removes all nil results from the returned list.

These are run after enabling and disabling a theme, respectively.

Using make-obsolete on a theme is now supported. This will make load-theme issue a warning when loading the theme.

When writing code snippets that contains the "'" character (APOSTROPHE), that quote character has to be escaped to avoid Emacs displaying it as "’" (LEFT SINGLE QUOTATION MARK), which would make code examples like

(setq foo '(1 2 3))

invalid. Emacs will now warn during byte compilation if it sees something like that, and also warn about when using RIGHT/LEFT SINGLE QUOTATION MARK directly. In both these cases, if these characters should really be present in the docstring, they should be quoted with "\=".

It is very common to write defcustom types on the form:

:type '(choice (const :tag "foo" 'bar))

I.e., double-quoting the bar, which is almost never the correct value. The byte compiler will now issue a warning if it encounters these forms.

This library contains a number of checks for whether a string is "suspicious". This usually means that the string contains characters that have glyphs that can be confused with other, more commonly used glyphs, or contains bidirectional (or other) formatting characters that may be used to confuse a user.

If non-nil (which is the default), Emacs packages that are vulnerable to attackers trying to confuse the users will use the textsec library to mark suspicious text. For instance shr/eww will mark suspicious URLs and links, Gnus will mark suspicious From addresses, and Message mode will query the user if the user is sending mail to a suspicious address. If this variable is nil, these checks are disabled.

This is the main function Emacs applications should be using to check whether a string is suspicious. It heeds the textsec-check user option.

If a command maps to a key binding like '[some-event]', and some-event has a symbol plist containing a non-nil non-key-event property, then that binding is ignored by where-is-internal.

These all take the syntax defined by key-valid-p, which is basically the same syntax as the one accepted by the kbd macro. None of the older functions have been deprecated or altered, but they are now de-emphasized in the documentation, and we encourage Lisp programs to switch to these new functions.

If non-nil, remove the definition from the keymap. This is subtly different from setting a definition to nil: when the keymap has a parent such a definition will shadow the parent's definition.

If non-nil, show the help buffer immediately, before any user input.

The kbd function is quite permissive, and will try to return something usable even if the syntax of the argument isn't completely correct. The key-valid-p predicate does a stricter check of the syntax.

This is like kbd, but only returns vectors instead of a mix of vectors and strings.

The new key type can be used for options that should be a valid key according to key-valid-p. The type key-sequence is now obsolete.

pp formats general Lisp sexps. This function does much the same, but applies formatting rules appropriate for Emacs Lisp code. Note that this could currently be quite slow, and is thus appropriate only for relatively small code fragments.

If non-nil, pp and all 'pp-*' commands that format the results, will attempt to limit the line length when formatting long lists and vectors. This uses pp-emacs-lisp-code, and thus could be slow for large lists.

It returns the new 'XDG_STATEHOME' environment variable. It should point to a file name that "contains state data that should persist between (application) restarts, but that is not important or portable enough to the user that it should be stored in $XDG_DATAHOME". (This variable was introduced in the XDG Base Directory Specification version 0.8 released on May 8, 2021.)

It returns a list of strings, corresponding to the colon-separated list of names in the 'XDG_{CURRENTDESKTOP}' environment variable, which identify the current desktop environment. (This variable was introduced in XDG Desktop Entry Specification version 1.2.)

It returns the 'XDG_SESSIONTYPE' environment variable. (This is not part of any official standard; see the man page pam_systemd(8) for more information.)

This holds the value of the previous call to set-locale-environment.

This macro can be used to change the locale temporarily while executing code.

This allows switching between "table" and "tabular".

The tabulated-list-entries variable now supports using an image descriptor, which means to insert an image in that column instead of text. See the documentation string of that variable for details.

This argument is used as another widget for the newly created WebKit widget to share settings and subprocesses with. It must be another WebKit widget.

This function allows you to send events to xwidgets. Usually, some equivalent of the event will be sent, but there is no guarantee of what the widget will actually receive.

On GTK+, only key and function key events are implemented.

This function is used to load HTML text into WebKit xwidgets directly, in contrast to creating a temporary file to hold the markup, and passing the URI of the file as an argument to xwidget-webkit-goto-uri.

Some new functions, such as xwidget-webkit-search, have been added for performing searches on WebKit xwidgets.

This function returns the history of page-loads in a WebKit xwidget.

This function returns the estimated progress of page loading in a WebKit xwidget.

This function terminates all data transfer during page loads in a WebKit xwidget.

In particular, they can now have different arguments based on the state of the WebKit widget. load-finished is sent when a load has completed, load-started when a load first starts, load-redirected after a redirect, and load-committed when the WebKit widget first commits to the load.

These events are sent whenever an xwidget requests that Emacs displays another xwidget. The only arguments to this event are the xwidget that should be displayed, and the xwidget that asked to display it.

This function is used to control where and if an xwidget stores cookies set by web pages on disk.