1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2025-01-18 18:05:07 +00:00

Improve wording of recently changed documentation

* src/minibuf.c (syms_of_minibuf):
* lisp/minibuffer.el (minibuffer-restore-windows):
* lisp/progmodes/etags.el (etags-xref-prefer-current-file):
Improve wording of doc strings.

* etc/NEWS: Improve wording and format of recently added entries.
This commit is contained in:
Eli Zaretskii 2021-08-06 10:22:22 +03:00
parent 9f88a9c058
commit c327d61ec8
4 changed files with 17 additions and 12 deletions

View File

@ -181,7 +181,8 @@ nor t.
+++
** New user option 'read-minibuffer-restore-windows'.
When customized to nil, it uses 'minibuffer-restore-windows' in
'minibuffer-exit-hook' to remove only the *Completions* window.
'minibuffer-exit-hook' to remove only the window showing the
"*Completions*" buffer.
+++
** New system for displaying documentation for groups of functions.
@ -2074,11 +2075,12 @@ project's root directory, respectively.
This command lets you interactively remove an entry from the list of projects
in 'project-list-file'.
*** 'project-find-file' now accepts non-existent file names (to
facilitate creating a file inside some nested sub-directory easily).
*** 'project-find-file' now accepts non-existent file names.
This is to allow easy creation of files inside some nested
sub-directory.
*** 'project-find-file' doesn't use the string at point as default
input, now it's only suggested as part of "future history".
*** 'project-find-file' doesn't use the string at point as default input.
Now it's only suggested as part of the "future history".
** xref
@ -3695,8 +3697,10 @@ Emacs constructs the nondirectory part of the auto-save file name by
applying that 'secure-hash' to the buffer file name. This avoids any
risk of excessively long file names.
** New variable 'etags-xref-prefer-current-file' to change the order
of definitions returned by the etags Xref backend.
---
** New user option 'etags-xref-prefer-current-file'.
When non-nil, matches for identifiers in the file visited by the
current buffer will be shown first in the "*xref*" buffer.
* Changes in Emacs 28.1 on Non-Free Operating Systems

View File

@ -2332,7 +2332,7 @@ variables.")
"Restore some windows on exit from minibuffer.
When `read-minibuffer-restore-windows' is nil, then this function
added to `minibuffer-exit-hook' will remove at least the window
with the *Completions* buffer."
that displays the \"*Completions*\" buffer."
(unless read-minibuffer-restore-windows
(minibuffer-hide-completions)))

View File

@ -2060,7 +2060,7 @@ If you want `xref-find-definitions' to find the tagged files by their
file name, add `tag-partial-file-name-match-p' to the list value.")
(defcustom etags-xref-prefer-current-file nil
"Non-nil to show the matches in the current file first."
"Non-nil means show the matches in the current file first."
:type 'boolean
:version "28.1")

View File

@ -2537,9 +2537,10 @@ restore, on exit, the window configurations of the frame where the
minibuffer was entered from and, if it is different, the frame that owns
the associated minibuffer window.
If this is nil, no such restorations are done.
But still `minibuffer-restore-windows' in `minibuffer-exit-hook'
will remove the window with the *Completions* buffer. */);
If this is nil, window configurations are not restored upon exiting
the minibuffer. However, if `minibuffer-restore-windows' is present
in `minibuffer-exit-hook', exiting the minibuffer will remove the window
showing the *Completions* buffer, if any. */);
read_minibuffer_restore_windows = true;
defsubr (&Sactive_minibuffer_window);