; Small doc fixes
authorJuri Linkov <juri@linkov.net>
Sun, 1 Sep 2024 16:53:52 +0000 (19:53 +0300)
committerJuri Linkov <juri@linkov.net>
Sun, 1 Sep 2024 16:53:52 +0000 (19:53 +0300)
* 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
doc/emacs/mini.texi
doc/emacs/programs.texi
doc/lispref/minibuf.texi
doc/lispref/positions.texi
doc/misc/efaq.texi
etc/NEWS

index cf57350743f7421ba9850d868828b2b6e8ca557c..88638190d7f5338dcc775d390b9821c0c1e0770c 100644 (file)
@@ -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)}
index 797449674552ca076068a2ab540c609901ad0adf..862cf9bdd796a34f50693b8e59a3ff772ff04044 100644 (file)
@@ -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.
index 3b863eefd725cc3ce821636da6b7321011eee2a2..42b57143bf1baa4ae05f6adac85d3c8b20d1f699 100644 (file)
@@ -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
index 73ff170401e6c6679c3f5d6d9844892a6d68a4d4..f0b7fef30c7ed4d6bd564d4a22241094a3df7362 100644 (file)
@@ -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
index 37cfe264157489c87c0e89fcb1730a07e8698493..93fba8b8ac0711754c5698750e20d510fbc4ca0b 100644 (file)
@@ -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}).
 
index 9b422915d7e8246cfb3bf2075a83d6f2dbc3f4c0..8c3b81a5fe502e46d6484345ac5c08a9eebb023d 100644 (file)
@@ -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
index 6c9eb0d33c6e62aa34e0d4de9361c77b03cac98c..f2c999a39555bfa7be938bf13a7a41f5618f5ea6 100644 (file)
--- 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.