diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi index cf57350743f..88638190d7f 100644 --- a/doc/emacs/dired.texi +++ b/doc/emacs/dired.texi @@ -816,9 +816,9 @@ Like the other commands in this section, this command operates on the @findex dired-do-open @kindex E @r{(Dired)} @item E -``Open'' the specified files using an external program. The program is -selected according to the system conventions, as determined by the -variable @code{shell-command-guess-open}. +``Open'' the specified files using an external program (@code{dired-do-open}). +The program is selected according to the system conventions, as +determined by the variable @code{shell-command-guess-open}. @findex dired-do-rename @kindex R @r{(Dired)} diff --git a/doc/emacs/mini.texi b/doc/emacs/mini.texi index 79744967455..862cf9bdd79 100644 --- a/doc/emacs/mini.texi +++ b/doc/emacs/mini.texi @@ -699,8 +699,9 @@ completions list buffer, and the second one will switch to it. @vindex completion-auto-wrap When the window showing the completions is selected, either because you customized @code{completion-auto-select} or because you switched to -it by typing @kbd{C-x o}, the @kbd{@key{UP}} and @kbd{@key{DOWN}} arrow -keys move by lines between completion candidates; with a prefix numeric +it by typing @kbd{C-x o}, the @kbd{@key{UP}} (@code{previous-line-completion}) +and @kbd{@key{DOWN}} (@code{next-line-completion}) arrow keys +move by lines between completion candidates; with a prefix numeric argument, they move that many lines. If @code{completion-auto-wrap} is non-@code{nil}, these commands will wrap at bottom and top of the candidate list. diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi index 3b863eefd72..42b57143bf1 100644 --- a/doc/emacs/programs.texi +++ b/doc/emacs/programs.texi @@ -1430,7 +1430,7 @@ line shows how many manual pages are available. @vindex Man-prefer-synchronous-call By default, @kbd{M-x man} calls the @code{man} program asynchronously. You can force the invocation to be synchronous by -customizing @code{Man-prefer-synchronous-calls} to a non-@code{nil} +customizing @code{Man-prefer-synchronous-call} to a non-@code{nil} value. @vindex Man-support-remote-systems diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi index 73ff170401e..f0b7fef30c7 100644 --- a/doc/lispref/minibuf.texi +++ b/doc/lispref/minibuf.texi @@ -1910,8 +1910,8 @@ pairs. The following properties are supported: @item :category The value should be a symbol describing what kind of text the completion function is trying to complete. If the symbol matches one -of the keys in @code{completion-category-overrides}, the usual -completion behavior is overridden. @xref{Completion Variables}. +of the keys in @code{completion-category-overrides} described above, +the usual completion behavior is overridden. @item :annotation-function The value should be a function to add annotations in the completions diff --git a/doc/lispref/positions.texi b/doc/lispref/positions.texi index 37cfe264157..93fba8b8ac0 100644 --- a/doc/lispref/positions.texi +++ b/doc/lispref/positions.texi @@ -894,11 +894,13 @@ Sentences,,, emacs, The extensible self-documenting text editor}). @findex treesit-forward-sexp @findex forward-sexp@r{, and tree-sitter} @findex backward-sexp@r{, and tree-sitter} +@vindex forward-sexp-function If Emacs is compiled with tree-sitter, it can use the tree-sitter parser information to move across syntax constructs. Since what exactly is considered a sexp varies between languages, a major mode should set @code{treesit-thing-settings} to determine that. Then -the mode can get navigation-by-sexp functionality for free, by using +@code{forward-sexp-function} will be set to @code{treesit-forward-sexp}, +and the mode can get navigation-by-sexp functionality for free, by using @code{forward-sexp} and @code{backward-sexp}(@pxref{Expressions, ,, emacs, The extensible self-documenting text editor}). diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi index 9b422915d7e..8c3b81a5fe5 100644 --- a/doc/misc/efaq.texi +++ b/doc/misc/efaq.texi @@ -954,7 +954,7 @@ used. @item New major modes based on the @uref{https://tree-sitter.github.io/tree-sitter/, tree-sitter library} -library for editing Elixir, HTML, Lua, HEEx, and PHP. +library for editing Elixir, HEEx, HTML, Lua, and PHP. @item Support for the EditorConfig standard has been added, an editor-neutral diff --git a/etc/NEWS b/etc/NEWS index 6c9eb0d33c6..f2c999a3955 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -379,11 +379,6 @@ the name of the killed buffer that was displayed in that window. It can be used to add, remove and reorder functions that change the appearance of every tab on the tab bar. ---- -*** New user option 'tab-line-tabs-buffer-group-function'. -It provides two choices to group tab buffers by major mode and by -project name. - --- *** New hook 'tab-bar-tab-post-select-functions'. @@ -401,7 +396,7 @@ you want to use these keys for the commands 'previous-buffer' and 'next-buffer'. --- -*** Default list of tabs is changed to support a fixed order. +*** Default list of tab-line tabs is changed to support a fixed order. This means that 'tab-line-tabs-fixed-window-buffers', the new default tabs function, is like the previous 'tab-line-tabs-window-buffers' where both of them show only buffers that were previously displayed in the @@ -411,7 +406,12 @@ these buffers. You can drag the tabs and release at a new position to manually reorder the buffers on the tab line. --- -*** Buffers on group tabs are now sorted alphabetically. +*** New user option 'tab-line-tabs-buffer-group-function'. +It provides two choices to group tab buffers by major mode and by +project name. + +--- +*** Buffers on tab-line group tabs are now sorted alphabetically. This will keep the fixed order of tabs, even after switching between them. @@ -945,7 +945,7 @@ Customizing it to 'relativize' makes commands like 'project-find-file' and 'project-find-dir' display previous history entries relative to the current project. --- +--- *** New user option 'project-key-prompt-style'. The look of the key prompt in the project switcher has been changed slightly. To get the previous one, set this option to 'brackets'. @@ -1993,12 +1993,7 @@ providers for "things" that are defined by text properties. Now, calling '(thing-at-point 'url)' when point is on a bug reference will return the URL for that bug. -** Miscellaneous - -+++ -*** New user option 'rcirc-log-time-format'. -This allows for rcirc logs to use a custom timestamp format, which the -chat buffers use by default. +** Buffer-menu --- *** New user option 'Buffer-menu-group-by'. @@ -2013,6 +2008,13 @@ that is, buffers not visiting a file and whose names start with a space. Previously, such buffers were never shown. This command is bound to 'I' in Buffer Menu mode. +** Miscellaneous + ++++ +*** New user option 'rcirc-log-time-format'. +This allows for rcirc logs to use a custom timestamp format, which the +chat buffers use by default. + --- *** 'ffap-lax-url' now defaults to nil. Previously, it was set to t, but this broke remote file name detection. @@ -2506,7 +2508,7 @@ sorts by the return value of 'age', then by 'size', then by 'cost'. The old signature, '(sort SEQ PREDICATE)', can still be used and sorts its input in-place as before. -** New API for 'derived-mode-p' and control of the graph of major modes. +** New API for 'derived-mode-p' and control of the graph of major modes +++ *** 'derived-mode-p' now takes the list of modes as a single argument.