* etc/NEWS: Apply "user option" when possible. Fix other oddities.

1 files changed, 141 insertions, 140 deletions

diff --git a/etc/NEWS b/etc/NEWS
index d6a7231474e..e1eb74f86e8 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -139,13 +139,13 @@ builds respectively.
 
 +++
 ** Emacs now uses the XDG convention for init files.
-For example, it looks for init.el in ~/.config/emacs/init.el, and
+For example, it looks for init.el in "~/.config/emacs/init.el", and
 similarly for other init files.
 
-The XDG_CONFIG_HOME environment variable (which defaults to ~/.config)
+The XDG_CONFIG_HOME environment variable (which defaults to "~/.config")
 specifies the parent directory of these and other configuration files,
 and will override their traditional locations (the home directory,
-~/.emacs.d, etc.).
+"~/.emacs.d", etc.).
 
 Emacs will still look for init files in their traditional locations if
 XDG_CONFIG_HOME does not exist, so invoking Emacs with
@@ -234,16 +234,16 @@ More specifically, lexical-binding is now used for 'M-:', '--eval', as
 well as in the "*scratch*" and "*ielm*" buffers.
 
 ---
-** The new option 'tooltip-resize-echo-area' avoids truncating tooltip text
-on GUI frames when tooltips are displayed in the echo area.  Instead,
-it resizes the echo area as needed to accommodate the full tool-tip
-text.
+** The new user option 'tooltip-resize-echo-area' avoids truncating
+tooltip text on GUI frames when tooltips are displayed in the echo
+area.  Instead, it resizes the echo area as needed to accommodate the
+full tool-tip text.
 
 ---
 ** Show mode line tooltips only if the corresponding action applies.
-Customize the option 'mode-line-default-help-echo' to restore the old
-behavior where the tooltip text is also shown when the corresponding
-action does not apply.
+Customize the user option 'mode-line-default-help-echo' to restore the
+old behavior where the tooltip text is also shown when the
+corresponding action does not apply.
 
 +++
 ** New hook 'server-after-make-frame-hook'.
@@ -287,7 +287,7 @@ that match.
 +++
 ** The Network Security Manager now allows more fine-grained control
 of what checks to run via the 'network-security-protocol-checks'
-variable.
+user option.
 
 +++
 ** TLS connections have their security tightened by default.
@@ -298,7 +298,7 @@ flag connections using these weak algorithms and ask users whether to
 allow them.  To get the old behavior back (where certificates are
 checked for validity, but no warnings about weak cryptography are
 issued), you can either set 'network-security-protocol-checks' to nil,
-or adjust the elements in that variable to only happen on the 'high'
+or adjust the elements in that user option to only happen on the 'high'
 security level (assuming you use the 'medium' level).
 
 ---
@@ -352,7 +352,7 @@ japanese-iso-8bit.
 +++
 ** New function 'exec-path'.
 This function by default returns the value of the corresponding
-variable, but can optionally return the equivalent of 'exec-path'
+user option, but can optionally return the equivalent of 'exec-path'
 from a remote host.
 
 +++
@@ -361,7 +361,7 @@ This triggers to search the program on the remote host as indicated by
 'default-directory'.
 
 +++
-** New variable 'auto-save-no-message'.
+** New user option 'auto-save-no-message'.
 When set to t, no message will be shown when auto-saving (default
 value: nil).
 
@@ -406,15 +406,15 @@ and directory-local variables.
 'with-connection-local-profiles'.  No argument PROFILES needed any longer.
 
 ---
-** New variable 'next-error-verbose' controls when 'next-error' outputs
-a message about the error locus.
+** New user option 'next-error-verbose' controls when 'next-error'
+outputs a message about the error locus.
 
 ---
-** New variable 'grep-search-path' defines the directories searched for
+** New user option 'grep-search-path' defines the directories searched for
 grep hits (this used to be controlled by 'compilation-search-path').
 
 ---
-** New variable 'emacs-lisp-compilation-search-path' defines the
+** New user option 'emacs-lisp-compilation-search-path' defines the
 directories searched for byte-compiler error messages (this used to
 be controlled by 'compilation-search-path').
 
@@ -427,7 +427,7 @@ Emacs configured with Cairo drawing and linked with cairo >= 1.16.0.
 This is similar to what 'fill-column-indicator' package provides, but
 much faster and compatible with 'show-trailing-whitespace'.
 
-Customize the buffer-local variables 'display-fill-column-indicator'
+Customize the buffer-local user options 'display-fill-column-indicator'
 and 'display-fill-column-indicator-character' to activate the
 indicator.
 
@@ -441,10 +441,10 @@ mode they are described in the manual "(emacs) Display".
 ** 'progress-reporter-update' accepts a suffix string to display.
 
 ---
-** New variable 'xref-file-name-display' controls the display of file
-names in xref buffers.
+** New user option 'xref-file-name-display' controls the display of
+file names in xref buffers.
 
-** New customizable variable 'byte-count-to-string-function'.
+** New user option 'byte-count-to-string-function'.
 It is used for displaying file sizes and disk space in some cases.
 
 +++
@@ -567,7 +567,7 @@ current and the previous or the next line, as before.
 
 ---
 ** The 'C' command in 'tar-mode' will now preserve the timestamp of
-the extracted file if the new variable 'tar-copy-preserve-time' is
+the extracted file if the new user option 'tar-copy-preserve-time' is
 non-nil.
 
 ---
@@ -593,16 +593,16 @@ now prompts the user for the directory containing the desktop file.
 ** display-line-numbers-mode
 
 *** New faces 'line-number-major-tick' and 'line-number-minor-tick',
-and customizable variables 'display-line-numbers-major-tick' and
+and user options 'display-line-numbers-major-tick' and
 'display-line-numbers-minor-tick' can be used to highlight the line
 numbers of lines multiple of certain numbers.
 
-*** New variable `display-line-numbers-offset', when non-zero, adds
+*** New variable 'display-line-numbers-offset', when non-zero, adds
 an offset to absolute line numbers.
 
 +++
 ** winner
-*** A new variable, 'winner-boring-buffers-regexp', has been added.
+*** A new user option, 'winner-boring-buffers-regexp', has been added.
 
 ** table
 ** 'table-generate-source' and friends now support outputting wiki and
@@ -620,7 +620,7 @@ should be ignored have been added via the
 +++
 ** tex-mode
 *** 'latex-noindent-commands' controls indentation of certain commands.
-You can use this new variable to control indentation of arguments of
+You can use this new user option to control indentation of arguments of
 \emph, \footnote, and similar commands.
 
 ** byte compiler
@@ -644,9 +644,9 @@ nil, but instead of scrolling the current line to the top of the
 screen when there is no left fringe, it inserts a visible arrow before
 column zero.
 ---
-*** The new 'compilation-transform-file-match-alist' variable can be used
-to transform file name matches compilation output, and remove known
-false positives being recognised as warnings/errors.
+*** The new 'compilation-transform-file-match-alist' user option can
+be used to transform file name matches compilation output, and remove
+known false positives being recognised as warnings/errors.
 
 ** cl-lib.el
 +++
@@ -654,7 +654,7 @@ false positives being recognised as warnings/errors.
 its functions.
 
 +++
-*** 'cl-defstruct' slots accept a ':documentation' property
+*** 'cl-defstruct' slots accept a ':documentation' property.
 
 ---
 *** 'cl-values-list' will now signal an error if its argument isn't a list.
@@ -663,8 +663,8 @@ its functions.
 *** New commands 'doc-view-presentation' and 'doc-view-fit-window-to-page'.
 *** Added support for password-protected PDF files
 
-*** A new variable 'doc-view-pdftotext-program-args' has been added to
-allow controlling how the conversion to text is done.
+*** A new user option 'doc-view-pdftotext-program-args' has been added
+to allow controlling how the conversion to text is done.
 
 ** Ido
 *** New user option 'ido-big-directories' to mark directories whose
@@ -674,7 +674,7 @@ list the contents of such directories when completing file names.
 ** Minibuffer
 
 +++
-*** A new variable, 'minibuffer-beginning-of-buffer-movement', has
+*** A new user option, 'minibuffer-beginning-of-buffer-movement', has
 been introduced to allow controlling how the 'M-<' command works in
 the minibuffer.  If non-nil, point will move to the end of the prompt
 (if point is after the end of the prompt).
@@ -748,7 +748,7 @@ The mode is automatically enabled in files that start with the
 
 *** New commands 'project-search' and 'project-query-replace-regexp'.
 
-*** New customizable variable 'project-read-file-name-function'.
+*** New user option 'project-read-file-name-function'.
 
 ** Etags
 
@@ -795,10 +795,10 @@ pipes, block devices and character devices.
 
 ** Find-Dired
 
-*** New customizable variable 'find-dired-refine-function'.
+*** New user option 'find-dired-refine-function'.
 The default value is 'find-dired-sort-by-filename'.
 
-*** New sorting options for the variable 'find-ls-option'.
+*** New sorting options for the user option 'find-ls-option'.
 
 ---
 *** Zstandard compression is now supported for 'dired-do-compress' and
@@ -807,27 +807,26 @@ The default value is 'find-dired-sort-by-filename'.
 ** Change Logs and VC
 
 +++
-*** New command 'log-edit-generate-changelog-from-diff', bound to C-c C-w.
+*** New command 'log-edit-generate-changelog-from-diff', bound to 'C-c C-w'.
 This generates ChangeLog entries from the VC fileset diff.
 
 *** Recording ChangeLog entries doesn't require an actual file.
-If a ChangeLog file doesn't exist, and if the new variable
+If a ChangeLog file doesn't exist, and if the new user option
 'add-log-dont-create-changelog-file' is non-nil (which is the
 default), commands such as 'C-x 4 a' will add log entries to a
 suitable named temporary buffer.  (An existing ChangeLog file will
-still be used if it exists.)  Set the variable to nil to get the
+still be used if it exists.)  Set the user option to nil to get the
 previous behavior of always creating a buffer that visits a ChangeLog
 file.
 
-*** New customizable variable 'vc-find-revision-no-save'.
+*** New user option 'vc-find-revision-no-save'.
 With non-nil, 'vc-find-revision' doesn't write the created buffer to file.
 
 ---
-*** 'vc-dir-ignore' now takes a prefix argument to ignore all marked
-files.
+*** 'vc-dir-ignore' now takes a prefix argument to ignore all marked files.
 
-*** New customizable variable 'vc-git-grep-template'.
-This new variable allows customizing the default arguments passed to
+*** New user option 'vc-git-grep-template'.
+This new user option allows customizing the default arguments passed to
 'git-grep' when 'vc-git-grep' is used.
 
 *** Command 'vc-git-stash' now respects marks in the "*vc-dir*" buffer.
@@ -887,8 +886,8 @@ effect.
 +++
 *** Better syntax highlighting of Diff hunks.
 Fragments of source in Diff hunks are now by default highlighted
-according to the appropriate major mode.  Customize the new option
-'diff-font-lock-syntax' to nil to disable this.
+according to the appropriate major mode.  Customize the new user
+option 'diff-font-lock-syntax' to nil to disable this.
 
 *** File headers can be shortened, mimicking Magit's diff format.
 To enable it, set the new user option 'diff-font-lock-prettify' to t.
@@ -920,7 +919,8 @@ links to most ordinary special-mode buffers that display text that
 have URLs embedded.  'browse-url-button-regexp' controls what's
 considered a button.
 
-*** A new variable, 'browse-url-secondary-browser-function', has been added.
+*** A new user option, 'browse-url-secondary-browser-function', has been added.
+
 ** Comint
 
 +++
@@ -937,7 +937,7 @@ compatibility with these shells.
 +++
 *** 'comint-insert-previous-argument' can now count arguments from the end.
 By default, invoking 'C-c .' with a numeric argument N would copy the
-Nth argument, counting from the first one.  But if the new option
+Nth argument, counting from the first one.  But if the new user option
 'comint-insert-previous-argument-from-end' is non-nil, it will copy
 the Nth argument counting from the last one.  Thus 'C-c .' can now
 better emulate 'M-.' in both Bash and zsh, since the former counts
@@ -1003,7 +1003,7 @@ emulator in line mode.
 You should instead set properties on known diagnostic symbols, like
 ':error' and ':warning', as demonstrated in the Flymake manual.
 
-*** New customizable variable 'flymake-start-on-save-buffer'.
+*** New user option 'flymake-start-on-save-buffer'.
 Control whether Flymake starts checking the buffer on save.
 
 *** Flymake and backend functions may exchange hints about buffer changes.
@@ -1077,9 +1077,9 @@ where you can select a node to go back (like in browsers).
 ---
 *** Info can now follow 'file://' protocol URLs.
 The 'file://' URLs in Info documents can now be followed by passing
-them to the 'browse-url' function, like the other protocols: ftp,
-http, and https.  This allows to have references to local HTML files,
-for example.
+them to the 'browse-url' function, like the other protocols: 'ftp',
+'http', and 'https'.  This allows to have references to local HTML
+files, for example.
 
 ** Xref
 
@@ -1100,7 +1100,7 @@ where it was invoked.
 ---
 *** New xref faces 'xref-file-header', 'xref-line-number', 'xref-match'.
 
-*** New variable 'xref-show-definitions-function'.
+*** New user option 'xref-show-definitions-function'.
 It encapsulates the logic pertinent to showing the result of
 'xref-find-definitions'.  The user can change it to customize its
 behavior and the display of results.
@@ -1120,17 +1120,17 @@ A new command 'xref-revert-buffer' is bound to 'g'.
 ** Ecomplete
 
 *** The ecomplete sorting has changed to a decay-based algorithm.
-This can be controlled by the new 'ecomplete-sort-predicate' variable.
+This can be controlled by the new 'ecomplete-sort-predicate' user option.
 
-*** The 'ecompleterc' file is now placed in '~/.emacs.d/ecompleterc' by default.
-Of course it will still find it if you have it in '~/.ecompleterc'.
+*** The 'ecompleterc' file is now placed in "~/.emacs.d/ecompleterc" by default.
+Of course it will still find it if you have it in "~/.ecompleterc".
 
 ** Gnus
 
 +++
 *** Two new Gnus summary mode navigation commands have been added,
-bound to the '[' and ']' keys: `gnus-summary-prev-unseen-article' and
-`gnus-summary-next-unseen-article'.  These take you (respectively) to
+bound to the '[' and ']' keys: 'gnus-summary-prev-unseen-article' and
+'gnus-summary-next-unseen-article'.  These take you (respectively) to
 the previous unseen or next unseen article.  (These are the ones that
 are marked with "." in the summary mode lines.)
 
@@ -1145,7 +1145,7 @@ deleted by any IMAP client (rather than just those that have been
 deleted by Gnus).
 
 +++
-*** New option 'gnus-use-atomic-windows' makes Gnus window layouts
+*** New user option 'gnus-use-atomic-windows' makes Gnus window layouts
 atomic.  See the "Atomic Windows" section of the Elisp manual for
 details.
 
@@ -1200,7 +1200,7 @@ buffer with the article(s) attached.
 offers them to the user to open with 'browse-url'.
 
 ---
-*** New option 'nnir-notmuch-filter-group-names-function'.
+*** New user option 'nnir-notmuch-filter-group-names-function'.
 This option controls whether and how to use Gnus search groups as
 'path:' search terms to 'notmuch'.
 
@@ -1220,7 +1220,7 @@ and its value has been changed to Duck Duck Go.
 
 ---
 *** 'erc-send-pre-hook' and 'erc-send-this' have been obsoleted.
-The variable to use instead to alter text to be sent is now
+The user option to use instead to alter text to be sent is now
 'erc-pre-send-functions'.
 
 ** EUDC
@@ -1230,9 +1230,9 @@ The variable to use instead to alter text to be sent is now
 ** eww/shr
 
 +++
-*** The new variable 'shr-cookie-policy' can be used to control when
-to use cookies when fetching embedded images.  The default is to use
-them when the images are from the same domain as the main HTML
+*** The new user option 'shr-cookie-policy' can be used to control
+when to use cookies when fetching embedded images.  The default is to
+use them when the images are from the same domain as the main HTML
 document.
 
 +++
@@ -1255,7 +1255,7 @@ current page instead of signaling an error.
 has been executed.
 
 +++
-*** New option 'shr-discard-aria-hidden'.
+*** New user option 'shr-discard-aria-hidden'.
 If set, shr will not render tags with attribute 'aria-hidden="true"'.
 This attribute is meant to tell screen readers to ignore a tag.
 
@@ -1291,18 +1291,18 @@ defining new 'cl-defmethod' of 'smtpmail-try-auth-method'.
 
 *** To always force smtpmail to send credentials over on the first
 attempt when communicating with the SMTP server(s), the
-'smtpmail-servers-requiring-authorization' variable can be used.
+'smtpmail-servers-requiring-authorization' user option can be used.
 
 +++
 *** smtpmail will now try resending mail when getting a transient 4xx
 error message from the SMTP server.  The new 'smtpmail-retries'
-variable says how many times to retry.
+user option says how many times to retry.
 
 ** Footnote mode
 
 *** Support Hebrew-style footnotes
 *** Footnote text lines are now aligned.
-Can be controlled via the new variable 'footnote-align-to-fn-text'.
+Can be controlled via the new user option 'footnote-align-to-fn-text'.
 
 ** CSS mode
 
@@ -1355,7 +1355,7 @@ can now be searched via 'C-s'.
 ** Ibuffer
 
 ---
-*** New filter 'ibuffer-filter-by-process'; bound to '/E'.
+*** New filter 'ibuffer-filter-by-process'; bound to '/ E'.
 
 ---
 *** All mode filters can now accept a list of symbols.
@@ -1380,7 +1380,7 @@ counting from the beginning/end of the buffer.  This complements
 with a numeric argument.
 
 *** 'isearch-lazy-count' shows the current match number and total number
-of matches in the Isearch prompt.  Customizable variables
+of matches in the Isearch prompt.  User options
 'lazy-count-prefix-format' and 'lazy-count-suffix-format' define the
 format of the current and the total number of matches in the prompt's
 prefix and suffix respectively.
@@ -1412,7 +1412,7 @@ to the existing binding 'M-s h r' ('highlight-regexp') that highlights
 JUST the search string.
 
 +++
-*** New variable 'isearch-yank-on-move' provides options 't' and 'shift'
+*** New user option 'isearch-yank-on-move' provides options 't' and 'shift'
 to extend the search string by yanking text that ends at the new
 position after moving point in the current buffer.  'shift' extends
 the search string by motion commands while holding down the shift key.
@@ -1481,7 +1481,7 @@ been instrumented by Edebug.
 
 ** Enhanced xterm support
 
-*** New variable 'xterm-set-window-title' controls whether Emacs sets
+*** New user option 'xterm-set-window-title' controls whether Emacs sets
 the XTerm window title.  This feature is experimental and is disabled
 by default.
 
@@ -1491,7 +1491,7 @@ by default.
 *** 'rgrep', 'lgrep' and 'zrgrep' now hide part of the command line
 that contains a list of ignored directories and files.
 Clicking on the button with ellipsis unhides it.
-The abbreviation can be disabled by the new option
+The abbreviation can be disabled by the new user option
 'grep-find-abbreviate'.  The new command
 'grep-find-toggle-abbreviation' toggles it interactively.
 
@@ -1524,7 +1524,7 @@ This is useful for games where lower scores are better, like time-based games.
 
 ---
 *** Completing filenames in the minibuffer via 'C-TAB' now uses the
-styles as configured by the variable 'completion-styles'.
+styles as configured by the user option 'completion-styles'.
 
 ** New macros 'thunk-let' and 'thunk-let*'.
 These macros are analogue to 'let' and 'let*', but create bindings that
@@ -1533,7 +1533,7 @@ are evaluated lazily.
 ** next-error
 
 +++
-*** New customizable variable 'next-error-find-buffer-function'.
+*** New user option 'next-error-find-buffer-function'.
 The value should be a function that determines how to find the
 next buffer to be used by 'next-error' and 'previous-error'.  The
 default is to use the last buffer that navigated to the current
@@ -1592,7 +1592,7 @@ followed when Emacs writes the relevant history variables to the disk.
 *** Program name completion inside remote shells works now as expected.
 
 +++
-*** The variable 'shell-file-name' can be set now as connection-local
+*** The user option 'shell-file-name' can be set now as connection-local
 variable for remote shells.  It still defaults to "/bin/sh".
 
 ** Single shell commands
@@ -1603,14 +1603,14 @@ available for output of asynchronous shell commands.
 
 +++
 *** Prompt for shell commands can now show the current directory.
-Customize 'shell-command-prompt-show-cwd' to enable it.
+Customize the new user option 'shell-command-prompt-show-cwd' to enable it.
 
 ** Pcomplete
 
-*** The 'pcomplete' command is now obsolete
-The Pcomplete functionality can be obtained via completion-at-point
-instead, by adding pcomplete-completions-at-point to
-completion-at-point-functions.
+*** The 'pcomplete' command is now obsolete.
+The Pcomplete functionality can be obtained via 'completion-at-point'
+instead, by adding 'pcomplete-completions-at-point' to
+'completion-at-point-functions'.
 
 *** The function 'pcomplete-uniquify-list' has been renamed from
 'pcomplete-uniqify-list'.
@@ -1625,11 +1625,11 @@ To recover the previous behavior, set new user option
 ---
 *** The Secret Service backend supports the ':create' key now.
 
-*** .authinfo and .netrc files now use a new mode: 'authinfo-mode'.
+*** ".authinfo" and ".netrc" files now use a new mode: 'authinfo-mode'.
 This is just like 'fundamental-mode', except that it hides passwords
 under a "****" display property.  When the cursor moves to this text,
-the real password is revealed (via 'reveal-mode').  The
-'authinfo-hidden' variable can be used to control what to hide.
+the real password is revealed (via 'reveal-mode').  The new
+'authinfo-hidden' user option can be used to control what to hide.
 
 ** Tramp
 
@@ -1707,9 +1707,9 @@ GnuTLS manual) is recommended instead.
 
 ** Message
 
-*** 'message-mode' now supports highlighting citations of different
-depths.  This can be customized via 'message-cite-level-function' and
-the new 'message-cited-text-*' faces.
+*** 'message-mode' now supports highlighting citations of different depths.
+This can be customized via the new user option
+'message-cite-level-function' and the new 'message-cited-text-*' faces.
 
 +++
 *** Messages can now be systematically encrypted
@@ -1809,7 +1809,7 @@ A symbol 'uuid' can be passed to 'thing-at-point' and it returns the
 UUID at point.
 
 ---
-*** 'number-at-point' will now recognize hex number like 0xAb09 and #xAb09
+*** 'number-at-point' will now recognize hex numbers like 0xAb09 and #xAb09
 and return them as numbers.
 
 ---
@@ -1875,7 +1875,7 @@ symbols (e.g., '[return]', '[tab]', '[backspace]') as keys respectively.
 +++
 *** New user options for tabulated list sort indicators.
 You can now customize which sorting indicator character to display
-near the current column in Tabulated Lists (see variables
+near the current column in Tabulated Lists (see user options
 'tabulated-list-gui-sort-indicator-asc',
 'tabulated-list-gui-sort-indicator-desc',
 'tabulated-list-tty-sort-indicator-asc', and
@@ -1981,7 +1981,7 @@ name, too.
 
 ** Autorevert
 
-*** New variable 'auto-revert-avoid-polling' for saving power.
+*** New user option 'auto-revert-avoid-polling' for saving power.
 When set to a non-nil value, buffers in Auto Revert mode are no longer
 polled for changes periodically.  This reduces the power consumption
 of an idle Emacs, but may fail on some network file systems; set
@@ -2003,12 +2003,12 @@ buffers to auto-revert.
 ** auth-source-pass
 
 +++
-*** New customizable variable 'auth-source-pass-filename'.
+*** New user option 'auth-source-pass-filename'.
 Allows setting the path to the password-store, defaults to
 "~/.password-store".
 
 +++
-*** New customizable variable 'auth-source-pass-port-separator'.
+*** New user option 'auth-source-pass-port-separator'.
 Specifies separator between host and port, defaults to colon ":".
 
 ---
@@ -2102,13 +2102,13 @@ Unqualified host name: (was none), now %q
 Login name: was %u, now %l
 User's full name: was %U, now %L
 
-Merely having (add-hook 'before-save-hook 'time-stamp) in your
+Merely having '(add-hook 'before-save-hook 'time-stamp)' in your
 Emacs init file does not expose you to this change.  However,
 if you set 'time-stamp-format' or 'time-stamp-pattern' with a
 file-local variable, you may need to update the value.
 
 ** mode-local
-*** define-overload is declared obsolete
+*** 'define-overload' is declared obsolete.
 
 
 * New Modes and Packages in Emacs 27.1
@@ -2128,13 +2128,13 @@ edit file in another tab; and 'C-TAB' and 'S-C-TAB' switch to the next
 or previous tab.  You can also switch between tabs and create/delete
 tabs with a mouse.
 
-Tab-related commands are available even when the tab-bar-mode is
-disabled: by default, they enable tab-bar-mode in that case.
+Tab-related commands are available even when 'tab-bar-mode' is
+disabled: by default, they enable 'tab-bar-mode' in that case.
 
 The X resource "tabBar", class "TabBar" enables the tab bar
 when its value is "on", "yes" or "1".
 
-The variable 'tab-bar-position' specifies where to show the tab bar.
+The user option 'tab-bar-position' specifies where to show the tab bar.
 
 Read the new Info node "(emacs) Tab Bars" for full description
 of all related features.
@@ -2143,8 +2143,8 @@ of all related features.
 The new command 'global-tab-line-mode' enables the tab line above each
 window, which you can use to switch buffers in the window.  Selecting
 the previous window-local tab is the same as typing 'C-x <LEFT>'
-(previous-buffer), selecting the next tab is the same as 'C-x <RIGHT>'
-(next-buffer).  Both commands support a numeric prefix argument as
+('previous-buffer'), selecting the next tab is the same as 'C-x <RIGHT>'
+('next-buffer').  Both commands support a numeric prefix argument as
 a repeat count.  Clicking on the plus icon adds a new buffer to the
 window-local tab line of buffers.  Using the mouse wheel on the tab
 line scrolls tabs that display the window buffers.
@@ -2186,9 +2186,9 @@ immediately.  Type 'M-x so-long-commentary' for full documentation.
 * Incompatible Lisp Changes in Emacs 27.1
 
 ---
-** Two-column mode provides its C-x 6 prefix map only after loading
-two-column.el.  Its prefix key F2 is still available globally
-along with C-x 6 used by the tab commands globally.
+** Two-column mode provides its 'C-x 6' prefix map only after loading
+two-column.el.  Its prefix key 'F2' is still available globally
+along with 'C-x 6' used by the tab commands globally.
 
 ---
 ** Incomplete destructive splicing support has been removed.
@@ -2260,12 +2260,12 @@ other serious errors prevent them from determining the result.
 Formerly, these functions often (though not always) returned nil.
 For example, if there is an access error, I/O error or low-level
 integer overflow when getting the attributes of a file F,
-(file-attributes F) now signals an error instead of returning nil.
+'(file-attributes F)' now signals an error instead of returning nil.
 These functions still behave as before if the only problem is that the
 file does not exist.  The affected primitives are
-directory-files-and-attributes, file-acl, file-attributes, file-modes,
-file-newer-than-file-p, file-selinux-context, file-system-info, and
-set-visited-file-modtime.
+'directory-files-and-attributes', 'file-acl', 'file-attributes',
+'file-modes', 'file-newer-than-file-p', 'file-selinux-context',
+'file-system-info', and 'set-visited-file-modtime'.
 
 ---
 ** The function 'eldoc-message' now accepts a single argument.
@@ -2387,14 +2387,14 @@ Previously, the control key modifier was used to scroll up or down by
 an amount which was close to near a full screen.  This is now instead
 available by scrolling with the meta modifier key.
 
-To get the old behaviour back, customize the variable
+To get the old behaviour back, customize the user option
 'mouse-wheel-scroll-amount', or add the following to your init file:
 
 (customize-set-variable 'mouse-wheel-scroll-amount
                         '(5 ((shift) . 1) ((control) . nil)))
 
 By default, the font size will be changed in the window that the mouse
-pointer is over.  To change this behaviour, you can customize the
+pointer is over.  To change this behaviour, you can customize the user
 option 'mouse-wheel-follow-mouse'.  Note that this will also affect
 scrolling.
 
@@ -2420,18 +2420,18 @@ overlays.  This is only done on 'display' properties that have the
 'reveal-toggle-invisible' property set.
 
 +++
-** 'process-contact' now takes an optional NO-BLOCK parameter to allow
+** 'process-contact' now takes an optional NO-BLOCK argument to allow
 not waiting for a process to be set up.
 
 +++
-** The new 'quit-window-hook' is now run first when executing the
-'quit-window' command.
+** The new user option 'quit-window-hook' is now run first when
+executing the 'quit-window' command.
 
-** The variables 'help-enable-completion-auto-load',
+** The user options 'help-enable-completion-auto-load',
 'help-enable-auto-load' and 'vhdl-project-auto-load', as well as the
-'vhdl-auto-load-project' have been renamed to have "autoload" without
-the hyphen in their names.  Obsolete aliases from the old names have
-been added.
+function 'vhdl-auto-load-project' have been renamed to have "autoload"
+without the hyphen in their names.  Obsolete aliases from the old
+names have been added.
 
 +++
 ** Buttons (created with 'make-button' and related functions) can
@@ -2514,10 +2514,10 @@ functions like 'process-id' that compute process IDs, and functions like
 ** Time values
 
 +++
-*** New function time 'time-convert' converts Lisp time values
-to Lisp timestamps of various forms, including a new timestamp form
-(TICKS . HZ) where TICKS is an integer and HZ a positive integer
-denoting a clock frequency.
+*** New function 'time-convert' converts Lisp time values to Lisp
+timestamps of various forms, including a new timestamp form '(TICKS
+. HZ)' where TICKS is an integer and HZ a positive integer denoting a
+clock frequency.
 
 +++
 *** Although the default timestamp format is still '(HI LO US PS)',
@@ -2530,19 +2530,20 @@ by hand.
 
 +++
 *** Decoded (calendrical) timestamps now have subsecond resolution.
-This affects decode-time, which generates these timestamps, as well as
-functions like encode-time that accept them.  The subsecond info is
-present as a (TICKS . HZ) value in the seconds element of a decoded
-timestamp, and decode-time has a new optional FORM argument specifying
-the form of the seconds member.  For example, if X is the timestamp
-(1566009571321878186 . 1000000000), which represents 2019-08-17
-02:39:31.321878186 UTC, (decode-time X t t) returns ((31321878186
-. 1000000000) 39 2 17 8 2019 6 nil 0) instead of the traditional (31
-39 2 17 8 2019 6 nil 0) returned by plain (decode-time X t).  Although
-the default FORM is currently 'integer', which truncates the seconds
-to an integer and is the traditional behavior, this default may change
-in future Emacs versions, so callers requiring an integer should
-specify FORM explicitly.
+This affects 'decode-time', which generates these timestamps, as well
+as functions like 'encode-time' that accept them.  The subsecond info
+is present as a '(TICKS . HZ)' value in the seconds element of a
+decoded timestamp, and 'decode-time' has a new optional FORM argument
+specifying the form of the seconds member.  For example, if X is the
+timestamp '(1566009571321878186 . 1000000000)', which represents
+"2019-08-17 02:39:31.321878186 UTC", '(decode-time X t t)' returns
+'((31321878186 . 1000000000) 39 2 17 8 2019 6 nil 0)' instead of the
+traditional '(31 39 2 17 8 2019 6 nil 0)' returned by plain
+'(decode-time X t)'.  Although the default FORM is currently
+'integer', which truncates the seconds to an integer and is the
+traditional behavior, this default may change in future Emacs
+versions, so callers requiring an integer should specify FORM
+explicitly.
 
 +++
 *** 'encode-time' supports a new API '(encode-time TIME)'.
@@ -2582,7 +2583,7 @@ accessors can be used.
 
 *** The new functions 'date-days-in-month' (which will say how many
 days there are in a month in a specific year), 'date-ordinal-to-time'
-(that computes the date of an ordinal day), 'decoded-time-add' for
+(that computes the date of an ordinal day), 'decoded-time-add' (for
 doing computations on a decoded time structure), 'make-decoded-time'
 (for making a decoded time structure with only the given keywords
 filled out), and 'encoded-time-set-defaults' (which fills in nil
@@ -2669,7 +2670,7 @@ have a new optional argument that makes the settings they produce
 reliably survive subsequent invocations of 'set-window-buffer'.
 
 +++
-** New option 'resize-mini-frames'.
+** New user option 'resize-mini-frames'.
 This option allows to automatically resize minibuffer-only frames
 similarly to how minibuffer windows are resized on "normal" frames.
 
@@ -2759,7 +2760,7 @@ remote systems, which support this check.
 +++
 ** When interpreting 'gc-cons-percentage', Emacs now estimates the
 heap size more often and (we hope) more accurately.  E.g., formerly
-(progn (let ((gc-cons-percentage 0.8)) BODY1) BODY2) continued to use
+'(progn (let ((gc-cons-percentage 0.8)) BODY1) BODY2)' continued to use
 the 0.8 value during BODY2 until the next garbage collection, but that
 is no longer true.  Applications may need to re-tune their GC tricks.
 
@@ -2859,10 +2860,10 @@ functions.
 
 *** New library image-converter.
 If you need to view exotic image formats for which Emacs doesn't have
-native support, customize the new variable 'convert-images-externally'
-to t.  If your system has GraphicsMagick, ImageMagick or 'ffmpeg'
-installed, they will then be used to convert images automatically
-before displaying them.
+native support, customize the new user option
+'image-use-external-converter' to t.  If your system has
+GraphicsMagick, ImageMagick or 'ffmpeg' installed, they will then be
+used to convert images automatically before displaying them.
 
 *** 'image-mode' now uses this library to automatically rotate images
 according to the orientation in the Exif data, if any.