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

; Update NEWS and corresponding manuals

Browse source 
* etc/NEWS: Improve wording and mark entries as approriate.

* doc/emacs/buffers.texi (Kill Buffer): Document new commands.
* doc/emacs/mini.texi (Completion Options, Completion Commands):
Document new completion options and behaviors.
This commit is contained in:
Eli Zaretskii 2024-06-30 15:06:06 +03:00
parent 4e22ef870c
commit f50167ab95
3 changed files with 72 additions and 25 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
doc/emacs/buffers.texi
View file

@ -313,6 +313,8 @@ Kill buffer @var{buffer} (@code{kill-buffer}).
Offer to kill each buffer, one by one.
@item M-x kill-matching-buffers
Offer to kill all buffers matching a regular expression.
@item M-x kill-matching-buffers-no-ask
Like @code{kill-matching-buffers}, but don't ask for confirmation.
@end table
@findex kill-buffer
@ -334,13 +336,16 @@ by one. An answer of @kbd{yes} means to kill the buffer, just like
with a space, which are used internally by Emacs.
@findex kill-matching-buffers
@findex kill-matching-buffers-no-ask
The command @kbd{M-x kill-matching-buffers} prompts for a regular
expression and kills all buffers whose names match that expression.
@xref{Regexps}. Like @code{kill-some-buffers}, it asks for
confirmation before each kill. This command normally ignores buffers
whose names begin with a space, which are used internally by Emacs.
To kill internal buffers as well, call @code{kill-matching-buffers}
with a prefix argument.
@xref{Regexps}. Like @code{kill-some-buffers}, it asks for confirmation
before each kill. This command normally ignores buffers whose names
begin with a space, which are used internally by Emacs. To kill
internal buffers as well, call @code{kill-matching-buffers} with a
prefix argument. The command @w{@kbd{M-x kill-matching-buffers-no-ask}}
works like @code{kill-matching-buffers}, but doesn't ask for
confirmation before killing each matching buffer.
The Buffer Menu feature is also convenient for killing various
buffers. @xref{Several Buffers}.

20
doc/emacs/mini.texi
View file

@ -452,6 +452,15 @@ While in the completion list buffer, kill it and delete the window
showing it (@code{kill-current-buffer}).
@end table
@vindex minibuffer-visible-completions
If the variable @code{minibuffer-visible-completions} is customized to
a non-@code{nil} value, it changes the commands bound to the arrow keys:
instead of moving in the minibuffer, they move between completion
candidates, like meta-arrow keys do by default. Similarly,
@kbd{@key{RET}} selects the current candidate, like @kbd{M-@key{RET}}
does normally. @code{C-g} hides the completion window, but leaves the
minibuffer active, so you can continue typing at the prompt.
@node Completion Exit
@subsection Completion Exit
@ -685,6 +694,17 @@ then move to a candidate by cursor motion commands and select it with
@code{second-tab}, then the first @kbd{@key{TAB}} will pop up the
completions list buffer, and the second one will switch to it.
@findex previous-line-completion
@findex next-line-completion
@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
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.
@vindex completion-cycle-threshold
If @code{completion-cycle-threshold} is non-@code{nil}, completion
commands can cycle through completion alternatives. Normally, if

62
etc/NEWS
View file

@ -58,6 +58,7 @@ ALSA on these operating systems instead.
* Startup Changes in Emacs 30.1
---
** On GNU/Linux, Emacs is now the default application for 'org-protocol'.
Org mode provides a way to quickly capture bookmarks, notes, and links
using 'emacsclient':
@ -71,7 +72,7 @@ arranges for Emacs to be the default application for the 'org-protocol'
URI scheme. See the Org mode manual, Info node "(org) Protocols" for
more details.
---
+++
** New variable lets Lisp code read emacsclient arguments.
When '--eval' is passed to emacsclient and Emacs is evaluating each
argument, the new variable 'server-eval-args-left' is set to those
@ -84,6 +85,7 @@ escaping (to protect them from the shell).
* Incompatible Changes in Emacs 30.1
---
** Tree-Sitter modes are now declared as submodes of the non-TS modes.
In order to help the use of those Tree-Sitter modes, they are now
declared to have the corresponding non-Tree-Sitter mode as an
@ -94,6 +96,7 @@ collections of snippets automatically apply to the new Tree-Sitter modes.
Note that those modes still do not inherit from the non-TS mode, so
configuration settings installed via mode hooks are not affected.
---
** Mouse wheel events should now always be 'wheel-up/down/left/right'.
At those places where the old 'mouse-4/5/6/7' events could still occur
(i.e., X11 input in the absence of XInput2, and 'xterm-mouse-mode'),
@ -124,6 +127,7 @@ to your init file:
(advice-add 'completion-at-point :after #'minibuffer-hide-completions)
---
** The default process filter was rewritten in native code.
The round-trip through the Lisp function
'internal-default-process-filter' is skipped when the process filter is
@ -158,6 +162,7 @@ see the variable 'url-request-extra-headers'.
* Changes in Emacs 30.1
---
** Emacs now supports Unicode Standard version 15.1.
+++
@ -184,20 +189,23 @@ TTY frames.
---
** Support for underline colors on TTY frames.
Colors specified in face underlines will now also be displayed in TTY
frames with the previously mentioned capabilities.
Colors specified in the underline face will now also be displayed on TTY
frames on terminals that support the 'Su' or 'Smulx' capabilities.
+++
** Modeline elements can now be right-aligned.
Anything following the symbol 'mode-line-format-right-align' in
'mode-line-format' will be right-aligned. Exactly where it is
right-aligned to is controlled by the new user option
'mode-line-right-align-edge'.
---
** X selection requests are now handled much faster and asynchronously.
This means it should be less necessary to disable the likes of
'select-active-regions' when Emacs is running over a slow network
connection.
---
** Emacs now updates invisible frames that are made visible by a compositor.
If an invisible or an iconified frame is shown to the user by the
compositing manager, Emacs will now redisplay such a frame even though
@ -209,8 +217,8 @@ example, as part of preview for iconified frames.
The only exception is w32notify.
+++
** Image ':map' property is now recomputed when image is transformed.
Now images with clickable maps work as expected after you run commands
** The ':map' property of images is now recomputed when image is transformed.
Images with clickable maps now work as expected after you run commands
such as 'image-increase-size', 'image-decrease-size', 'image-rotate',
'image-flip-horizontally', and 'image-flip-vertically'.
Set the new user option 'image-recompute-map-p' to nil to prevent Emacs
@ -218,11 +226,13 @@ from recomputing image maps.
** Minibuffer and Completions
+++
*** New commands 'previous-line-completion' and 'next-line-completion'.
Bound to '<up>' and '<down>' arrow keys, respectively, they navigate
the "*Completions*" buffer vertically by lines, wrapping at the
top/bottom when 'completion-auto-wrap' is non-nil.
+++
*** New user option 'minibuffer-visible-completions'.
When customized to non-nil, you can use arrow keys in the minibuffer
to navigate the completions displayed in the "*Completions*" window.
@ -231,6 +241,7 @@ completions window. When the completions window is not visible,
then all these keys have their usual meaning in the minibuffer.
This option is supported for in-buffer completion as well.
---
*** Selected completion candidates are deselected on typing.
When you type at the minibuffer prompt, the current completion
candidate will be un-highlighted, and point in the "*Completions*" window
@ -242,6 +253,7 @@ the minibuffer contents instead. This deselection behavior can be
controlled with the new user option 'completion-auto-deselect', which
is t by default.
+++
*** New value 'historical' for user option 'completions-sort'.
When 'completions-sort' is set to 'historical', completion candidates
will be first sorted alphabetically, and then re-sorted by their order
@ -304,6 +316,7 @@ It specifies how 'set-window-configuration' and 'window-state-put'
should proceed with windows whose buffer was killed after the
corresponding configuration or state was recorded.
---
*** New variable 'window-point-context-set-function'.
It can be used to set a context for window point in all windows by
'window-point-context-set' before calling 'current-window-configuration'
@ -336,8 +349,9 @@ window systems other than macOS and GNUstep (Nextstep).
+++
*** New global minor mode 'modifier-bar-mode'.
When this minor mode is enabled, buttons representing modifier keys
are displayed along the tool bar.
When this minor mode is enabled, the tool bar displays buttons
representing modifier keys. Clicking on these buttons applies the
corresponding modifiers to the next input event.
+++
*** New user option 'tool-bar-always-show-default'.
@ -413,10 +427,12 @@ Switch to a buffer visiting the source of what is being described in
This user option controls outline visibility in the output buffer of
'describe-bindings' when 'describe-bindings-outline' is non-nil.
---
*** 'describe-function' shows function inferred type when available.
For native compiled Lisp functions 'describe-function' prints (after
the signature) the automatically inferred function type as well.
---
*** 'describe-function' now shows the type of the function object.
The text used to say things like "car is is a built-in function" whereas
it now says "car is a primitive-function" where "primitive-function" is
@ -427,6 +443,7 @@ get information about that type.
*** 'C-h m' ('describe-mode') uses outlining by default.
Set 'describe-mode-outline' to nil to get back the old behavior.
---
*** 'C-h k' ('describe-key') shows Unicode name.
For keybindings which produce single characters via translation or input
methods, 'C-h k' now shows the Unicode name of the produced character in
@ -436,6 +453,7 @@ addition to the character itself, e.g.
€ 'EURO SIGN' (translated from C-x 8 E)
---
*** 'C-h b' ('describe-bindings') shows Unicode names.
For keybindings which produce single characters via translation (such as
those using the 'C-x 8' or 'A-' prefix, or 'dead-acute', 'dead-grave',
@ -465,8 +483,10 @@ This command can toggle boolean options for the duration of a session.
*** New prefix argument for modifying directory-local variables.
The commands 'add-dir-local-variable', 'delete-dir-local-variable' and
'copy-file-locals-to-dir-locals' now take an optional prefix argument,
to enter the file name you want to modify.
to enter the file name where you want to modify directory-local
variables.
+++
*** New user option 'safe-local-variable-directories'.
This user option names directories in which Emacs will treat all
directory-local variables as safe.
@ -474,6 +494,10 @@ directory-local variables as safe.
+++
** CL Print
+++
*** There is a new chapter in the CL manual documenting cl-print.el.
See the Info node "(cl) Printing".
+++
*** You can expand the "..." truncation everywhere.
The code that allowed "..." to be expanded in the "*Backtrace*" buffer
@ -494,13 +518,9 @@ This setting causes byte-compiled functions to be printed in full by
'prin1'. A button on this output can be activated to disassemble the
function.
+++
*** There is a new chapter in the CL manual documenting cl-print.el.
See the Info node "(cl) Printing".
** Miscellaneous
---
+++
*** New command 'kill-matching-buffers-no-ask'.
This works like 'kill-matching-buffers', but without asking for
confirmation.
@ -512,9 +532,9 @@ between the auto save file and the current file.
+++
*** 'read-passwd' can toggle the visibility of passwords.
Use 'TAB' in the minibuffer to show or hide the password. Likewise,
there is an icon on the mode-line, which toggles the visibility of the
password when clicking with 'mouse-1'.
Use 'TAB' in the minibuffer to show or hide the password.
Alternatively, click the new show-password icon on the mode-line with
'mouse-1' to toggle the visibility of the password.
*** 'advice-remove' is now an interactive command.
When called interactively, 'advice-remove' now prompts for an advised
@ -541,8 +561,8 @@ remote buffers. The default is nil.
+++
*** New user option 'remote-file-name-access-timeout'.
When a positive number, this option limits the call of 'access-file'
for remote files to this number of seconds. Default is nil.
If a positive number, this option limits the call of 'access-file'
for remote files to that number of seconds. Default is nil.
+++
*** New user option 'yes-or-no-prompt'.
@ -554,7 +574,8 @@ This allows the user to customize the prompt that is appended by
*** New user option 'menu-bar-close-window'.
When non-nil, selecting "Close" from the "File" menu or clicking
"Close" in the tool bar will result in the current window being
closed, if possible.
deleted, if possible. The default is nil, and these gestures kill the
buffer shown in the current window, but don't delete the window.
---
*** New face 'display-time-date-and-time'.
@ -585,8 +606,9 @@ Homebrew.
+++
*** 'write-region-inhibit-fsync' now defaults to t in interactive mode,
as it has in batch mode since Emacs 24.
as it did in batch mode since Emacs 24.
---
*** The default value of 'read-process-output-max' was increased to 65536.
+++