Improve NEWS entries

* etc/NEWS: Fix typos, and add information about default values of new
  user options.
This commit is contained in:
Robert Pluim 2024-09-13 15:42:39 +02:00
parent ca3932121a
commit 8e1187e336

View file

@ -150,7 +150,7 @@ number has been bumped to 2048 bits.
+++ +++
** URL now never sends user email addresses in HTTP requests. ** URL now never sends user email addresses in HTTP requests.
Emacs never sent email addresses by default, but it used to be Emacs never sent email addresses by default, but it used to be
possible to customize 'url-privacy-level' so that the users email possible to customize 'url-privacy-level' so that the user's email
address was sent along in HTTP requests. This feature has now been address was sent along in HTTP requests. This feature has now been
removed, as it was considered more dangerous than useful. RFC 9110 removed, as it was considered more dangerous than useful. RFC 9110
(§ 10.1.2) also recommends against it. The user option (§ 10.1.2) also recommends against it. The user option
@ -670,15 +670,15 @@ that shows as diffs replacements in the marked files in Dired.
+++ +++
** New mode of prompting for register names and showing preview. ** New mode of prompting for register names and showing preview.
The new user option 'register-use-preview' can be customized to the The new user option 'register-use-preview' can be customized to the
value t or insist to request a different user interface of prompting for value t or 'insist' to request a different user interface of prompting for
register names and previewing the registers: Emacs will require register names and previewing the registers: Emacs will require
confirmation for overwriting the value of a register, and will show confirmation for overwriting the value of a register, and will show
the preview of registers without delay. You can also customize this the preview of registers without delay. You can also customize this
new option to disable the preview completely. new option to disable the preview completely.
The default value of 'register-use-preview' preserves the behavior of The default value of 'register-use-preview' ('traditional') preserves the
Emacs 29 and before. See the Info node "(emacs) Registers" for more behavior of Emacs 29 and before. See the Info node "(emacs) Registers"
details about the new UI and its variants. for more details about the new UI and its variants.
+++ +++
** New advanced macro counter commands. ** New advanced macro counter commands.
@ -1464,8 +1464,8 @@ bookmark URIs.
*** New command 'eww-copy-alternate-url'. *** New command 'eww-copy-alternate-url'.
It copies an alternate link on the page currently visited in EWW into It copies an alternate link on the page currently visited in EWW into
the kill ring. Alternate links are optional metadata that HTML pages the kill ring. Alternate links are optional metadata that HTML pages
use for linking to their alternative representations, such as use for linking to their alternative representations, such as translated
translated versions or associated RSS feeds. versions or associated RSS feeds. It is bound to 'A' by default.
+++ +++
*** 'eww-open-in-new-buffer' supports the prefix argument. *** 'eww-open-in-new-buffer' supports the prefix argument.
@ -1565,9 +1565,10 @@ following to your init file:
--- ---
*** New user option 'package-vc-register-as-project'. *** New user option 'package-vc-register-as-project'.
When non-nil, it will automatically register every package as a When non-nil, 'package-vc-install' and 'package-vc-checkout' will
project, that you can quickly select using 'project-switch-project' automatically register every package they install as a project, that you
('C-x p p'). can quickly select using 'project-switch-project' ('C-x p p'). Default
is t.
--- ---
*** New user option 'package-vc-allow-build-commands'. *** New user option 'package-vc-allow-build-commands'.
@ -1592,9 +1593,9 @@ in a clean environment.
+++ +++
*** New user option 'flymake-indicator-type'. *** New user option 'flymake-indicator-type'.
This user option controls which error indicator type Flymake should use This controls which error indicator type Flymake should use in the
in current buffer. Depending on your preference, this can either use current buffer. Depending on your preference, this can either use
fringes or margins for indicating errors. fringes or margins for indicating errors, the default is 'margins'.
+++ +++
*** New user option 'flymake-margin-indicators-string'. *** New user option 'flymake-margin-indicators-string'.
@ -1603,14 +1604,14 @@ the margin indicator.
+++ +++
*** New user option 'flymake-autoresize-margins'. *** New user option 'flymake-autoresize-margins'.
If non-nil, Flymake will resize the margins when 'flymake-mode' is If non-nil (the default), Flymake will resize the margins when
turned on or off. 'flymake-mode' is turned on or off.
Only relevant if 'flymake-indicator-type' is set to 'margins'. Only relevant if 'flymake-indicator-type' is set to 'margins'.
+++ +++
*** New user option 'flymake-margin-indicator-position'. *** New user option 'flymake-margin-indicator-position'.
It controls which margin (left or right) is used for margin It controls whether to use margins for margin indicators, and which
indicators. margin (left or right) to use. Default is to use the left margin.
+++ +++
*** New user option 'flymake-show-diagnostics-at-end-of-line'. *** New user option 'flymake-show-diagnostics-at-end-of-line'.
@ -1618,7 +1619,7 @@ When non-nil, Flymake shows summarized descriptions of diagnostics at
the end of the line. Depending on your preference, this can either be the end of the line. Depending on your preference, this can either be
distracting and easily confused with actual code, or a significant distracting and easily confused with actual code, or a significant
early aid that relieves you from moving the buffer or reaching for the early aid that relieves you from moving the buffer or reaching for the
mouse to consult an error message. mouse to consult an error message. Default is nil.
** Flyspell ** Flyspell
@ -1626,6 +1627,7 @@ mouse to consult an error message.
*** New user option 'flyspell-check-changes'. *** New user option 'flyspell-check-changes'.
When non-nil, Flyspell mode spell-checks only words that you edited; it When non-nil, Flyspell mode spell-checks only words that you edited; it
does not check unedited words just because you move point across them. does not check unedited words just because you move point across them.
Default is nil.
--- ---
** JS mode. ** JS mode.
@ -1647,7 +1649,7 @@ buffers contain Javascript code.
*** New user option 'python-indent-block-paren-deeper'. *** New user option 'python-indent-block-paren-deeper'.
If non-nil, increase the indentation of the lines inside parens in a If non-nil, increase the indentation of the lines inside parens in a
header of a block when they are indented to the same level as the body header of a block when they are indented to the same level as the body
of the block: of the block, producing:
if (some_expression if (some_expression
and another_expression): and another_expression):
@ -1659,6 +1661,8 @@ instead of:
and another_expression): and another_expression):
do_something() do_something()
Default is nil.
--- ---
*** New user option 'python-interpreter-args'. *** New user option 'python-interpreter-args'.
This allows the user to specify command line arguments to the non This allows the user to specify command line arguments to the non
@ -1699,8 +1703,8 @@ This keyword enables the user to install packages using package-vc.el.
+++ +++
*** New user option 'use-package-vc-prefer-newest'. *** New user option 'use-package-vc-prefer-newest'.
This allows the user to always install the newest commit of a package If non-nil, always install the newest commit of a package when using the
when using the ':vc' keyword. ':vc' keyword rather than its stable release. Default is nil.
** Gnus ** Gnus
@ -1749,6 +1753,7 @@ Controls how the 'dictionary-search' command prompts for and displays
dictionary definitions. Customize this user option to 'help' to have dictionary definitions. Customize this user option to 'help' to have
'dictionary-search' display definitions in a "*Help*" buffer and 'dictionary-search' display definitions in a "*Help*" buffer and
provide dictionary-based minibuffer completion for word selection. provide dictionary-based minibuffer completion for word selection.
Default is nil, which means to use a "*Dictionary*" buffer.
--- ---
*** New user option 'dictionary-read-word-prompt'. *** New user option 'dictionary-read-word-prompt'.
@ -1971,11 +1976,11 @@ If non-nil, moving point forward or backward between widgets by typing
*** New user option 'ruby-rubocop-use-bundler'. *** New user option 'ruby-rubocop-use-bundler'.
By default it retains the previous behavior: read the contents of By default it retains the previous behavior: read the contents of
Gemfile and act accordingly. But you can also set it to t or nil to Gemfile and act accordingly. But you can also set it to t or nil to
skip the check. skip checking the Gemfile.
*** New user option 'ruby-bracketed-args-indent'. *** New user option 'ruby-bracketed-args-indent'.
When it is set to nil, multiple consecutive open braces/brackets/parens When it is set to nil, multiple consecutive open braces/brackets/parens
result in only one additional indentation level. result in only one additional indentation level. Default is t.
** Thingatpt ** Thingatpt
@ -2003,7 +2008,8 @@ will return the URL for that bug.
*** New user option 'Buffer-menu-group-by'. *** New user option 'Buffer-menu-group-by'.
It controls how buffers are divided into groups that are displayed with It controls how buffers are divided into groups that are displayed with
headings using Outline minor mode. Using commands that mark buffers headings using Outline minor mode. Using commands that mark buffers
on the outline heading line will mark all buffers in the outline. on the outline heading line will mark all buffers in the outline. By
default, no grouping is performed.
+++ +++
*** New command 'Buffer-menu-toggle-internal'. *** New command 'Buffer-menu-toggle-internal'.
@ -2025,9 +2031,9 @@ Previously, it was set to t, but this broke remote file name detection.
--- ---
*** More control on automatic update of Proced buffers. *** More control on automatic update of Proced buffers.
The user option 'proced-auto-update-flag' can now be set to two The user option 'proced-auto-update-flag' can now be set to an
additional values, which control automatic updates of Proced buffers additional value 'visible', which controls automatic updates of Proced
that are not displayed in some window. buffers that are displayed in some window.
--- ---
*** nXML Mode now comes with schemas for Mono/.NET development. *** nXML Mode now comes with schemas for Mono/.NET development.
@ -2165,7 +2171,8 @@ This is a minor mode for editing regular expressions in the minibuffer,
for example in 'query-replace-regexp'. It correctly highlights parens for example in 'query-replace-regexp'. It correctly highlights parens
via 'show-paren-mode' and 'blink-matching-paren' in a user-friendly way, via 'show-paren-mode' and 'blink-matching-paren' in a user-friendly way,
avoids reporting alleged paren mismatches and makes sexp navigation more avoids reporting alleged paren mismatches and makes sexp navigation more
intuitive. intuitive. It is enabled by default, 'minibuffer-regexp-prompts' can be
used to tune when it takes effect.
--- ---
** The highly accessible Modus themes collection has eight items. ** The highly accessible Modus themes collection has eight items.
@ -2291,7 +2298,7 @@ unibyte string.
buffer-local value from the minibuffer. buffer-local value from the minibuffer.
+++ +++
** 'minibuffer-allow-text-properties' also affects completions. ** 'minibuffer-allow-text-properties' now also affects completions.
When it has a non-nil value, then completion functions like When it has a non-nil value, then completion functions like
'completing-read' don't discard text properties from the returned 'completing-read' don't discard text properties from the returned
completion candidate. completion candidate.
@ -2321,7 +2328,7 @@ values.
--- ---
** User option 'tramp-completion-reread-directory-timeout' has been removed. ** User option 'tramp-completion-reread-directory-timeout' has been removed.
This user option has been obsoleted in Emacs 27, use This user option was obsoleted in Emacs 27, use
'remote-file-name-inhibit-cache' instead. 'remote-file-name-inhibit-cache' instead.
+++ +++
@ -2497,7 +2504,7 @@ where arguments after the first are keyword/value pairs, all optional:
':key' specifies a function that produces the sorting key from an element, ':key' specifies a function that produces the sorting key from an element,
':lessp' specifies the ordering predicate, defaulting to 'value<', ':lessp' specifies the ordering predicate, defaulting to 'value<',
':reverse' is used to reverse the sorting order, ':reverse' is used to reverse the sorting order,
':in-place is used for in-place sorting, as the default is now to ':in-place' is used for in-place sorting, as the default is now to
sort a copy of the input. sort a copy of the input.
The new signature is less error-prone and reduces the need to write The new signature is less error-prone and reduces the need to write
@ -2574,7 +2581,8 @@ analogous to 'w32-notification-notify'.
** New Haiku specific variable 'haiku-pass-control-tab-to-system'. ** New Haiku specific variable 'haiku-pass-control-tab-to-system'.
This sets whether Emacs should pass 'C-TAB' on to the system instead of This sets whether Emacs should pass 'C-TAB' on to the system instead of
handling it, fixing a problem where window switching would not activate handling it, fixing a problem where window switching would not activate
if an Emacs frame had focus on the Haiku operating system. if an Emacs frame had focus on the Haiku operating system. Default
value is t.
+++ +++
** New value 'if-regular' for the REPLACE argument to 'insert-file-contents'. ** New value 'if-regular' for the REPLACE argument to 'insert-file-contents'.
@ -2956,9 +2964,9 @@ default to use 'LANGUAGE'.
--- ---
** New optional argument to 'modify-dir-local-variable'. ** New optional argument to 'modify-dir-local-variable'.
A 5th argument, optional, has been added to An optional 5th argument FILE has been added to
'modify-dir-local-variable'. It can be used to specify which 'modify-dir-local-variable'. It can be used to specify which file to
dir-locals file to modify. modify instead of the default ".dir-locals.el".
** Connection local variables ** Connection local variables
@ -3012,13 +3020,13 @@ They pertained to the internal storage size which is now irrelevant.
** 'treesit-install-language-grammar' can handle local directory instead of URL. ** 'treesit-install-language-grammar' can handle local directory instead of URL.
It is now possible to pass a directory of a local repository as URL It is now possible to pass a directory of a local repository as URL
inside 'treesit-language-source-alist', so that calling inside 'treesit-language-source-alist', so that calling
'treesit-install-language-grammar' would avoid cloning the repository. 'treesit-install-language-grammar' will avoid cloning the repository.
It may be useful, for example, for the purposes of bisecting a It may be useful, for example, for the purposes of bisecting a
treesitter grammar. treesitter grammar.
+++
** New buffer-local variable 'tabulated-list-groups'. ** New buffer-local variable 'tabulated-list-groups'.
It controls display and separate sorting of groups of entries. It controls display and separate sorting of groups of entries. By
default no grouping or sorting is done.
+++ +++
** New variable 'revert-buffer-restore-functions'. ** New variable 'revert-buffer-restore-functions'.