procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

; Small doc fixes

Browse source 
* 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.
This commit is contained in:
Juri Linkov 2024-09-01 19:53:52 +03:00
parent da980ad838
commit 4ff4b78f92
7 changed files with 30 additions and 25 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
doc/emacs/dired.texi
View 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)}

5
doc/emacs/mini.texi
View 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.

2
doc/emacs/programs.texi
View 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

4
doc/lispref/minibuf.texi
View 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

4
doc/lispref/positions.texi
View 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}).

2
doc/misc/efaq.texi
View 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

32
etc/NEWS
View file

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