emacs-30 4ff4b78f922: ; Small doc fixes

[Juri Linkov]

branch: emacs-30
commit 4ff4b78f922353236cb2970270dd175c8011ba8f
Author: Juri Linkov <juri@linkov.net>
Commit: Juri Linkov <juri@linkov.net>

    ; Small doc fixes
    
    * doc/emacs/dired.texi (Operating on Files): Add indexed function
    'dired-do-open' to the text.
    
    * doc/emacs/mini.texi (Completion Options): Add indexed functions
    'previous-line-completion' and 'next-line-completion' to the text.
    
    * doc/lispref/minibuf.texi (Completion Variables): Remove self-reference.
    
    * doc/lispref/positions.texi (List Motion): Add indexed function
    'treesit-forward-sexp' to the text.  Add @vindex for
    'forward-sexp-function'.
    
    * etc/NEWS: Group tab-bar and tab-line items separately.
    Move two Buffer-menu items to separate outline.
---
 doc/emacs/dired.texi       |  6 +++---
 doc/emacs/mini.texi        |  5 +++--
 doc/emacs/programs.texi    |  2 +-
 doc/lispref/minibuf.texi   |  4 ++--
 doc/lispref/positions.texi |  4 +++-
 doc/misc/efaq.texi         |  2 +-
 etc/NEWS                   | 32 +++++++++++++++++---------------
 7 files changed, 30 insertions(+), 25 deletions(-)

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.