From: Juri Linkov <juri@linkov.net>
Date: Sun, 1 Sep 2024 16:53:52 +0000 (+0300)
Subject: ; Small doc fixes
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=388cc9e3fbd8de380d74e208a48a5cf00c457ac4;p=emacs.git

; 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.

(cherry picked from commit 4ff4b78f922353236cb2970270dd175c8011ba8f)
---

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/programs.texi b/doc/emacs/programs.texi
index e98f55267c8..719fa93e0ad 100644
--- a/doc/emacs/programs.texi
+++ b/doc/emacs/programs.texi
@@ -1398,7 +1398,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 082d7037eb1..3bc9fa4f4a4 100644
--- a/doc/lispref/minibuf.texi
+++ b/doc/lispref/minibuf.texi
@@ -1905,8 +1905,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 7ea469f2dce..7c340c2a9d6 100644
--- a/doc/lispref/positions.texi
+++ b/doc/lispref/positions.texi
@@ -880,11 +880,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 feb200bf1b6..3554ef80bd0 100644
--- a/doc/misc/efaq.texi
+++ b/doc/misc/efaq.texi
@@ -944,7 +944,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