Merge branch 'master' into harfbuzz

4 files changed, 225 insertions, 128 deletions

diff --git a/etc/NEWS b/etc/NEWS
index 091f958112f..ebffd9b8794 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -43,11 +43,15 @@ functions 'json-serialize', 'json-insert', 'json-parse-string', and
 'json-parse-buffer' are typically much faster than their Lisp
 counterparts from json.el.
 
+** Emacs no longer defaults to using ImageMagick to display images,
+due to security and stability concerns.  To override the default, use
+'configure --with-imagemagick'.
+
 ** Several configure options now accept an option-argument 'ifavailable'.
 For example, './configure --with-xpm=ifavailable' now configures Emacs
-to attempt to use libxpm but to continue building even if libxpm is absent.
-The other affected options are --with-gif, --with-gnutls, --with-jpeg,
---with-png, and --with-tiff.
+to attempt to use libxpm but to continue building even if libxpm is
+absent.  The other affected options are '--with-gif', '--with-gnutls',
+'--with-jpeg', '--with-png', and '--with-tiff'.
 
 ** The etags program now uses the C library's regular expression matcher
 when possible, and a compatible regex substitute otherwise.  This will
@@ -103,6 +107,10 @@ option was useful with modern debugging tools such as AddressSanitizer.
 (See etc/DEBUG for the details of using the modern replacements of the
 removed configure options.)
 
++++
+** The distribution tarball now has test cases; 'make check' runs them.
+This is intended mostly to help developers.
+
 ---
 ** Emacs now requires GTK 2.24 and GTK 3.10 for the GTK 2 and GTK 3
 builds respectively.
@@ -134,13 +142,14 @@ file, which was previously done when Emacs was started.  As a result
 of this change, it is no longer necessary to call 'package-initialize'
 in your init file.
 
-However, if your init file changes the values of 'package-load-list' or
-'package-user-dir', or sets 'package-enable-at-startup' to nil then it won't
-work right without some adjustment:
-- you can move that code to the early init file (see above), so those settings
-  apply before Emacs tries to activate the packages.
-- you can use the new 'package-quickstart' so activation of packages does not
-  need to pay attention to 'package-load-list' or 'package-user-dir' any more.
+However, if your init file changes the values of 'package-load-list'
+or 'package-user-dir', or sets 'package-enable-at-startup' to nil then
+it won't work right without some adjustment:
+- You can move that code to the early init file (see above), so those
+  settings apply before Emacs tries to activate the packages.
+- You can use the new 'package-quickstart' so activation of packages
+  does not need to pay attention to 'package-load-list' or
+  'package-user-dir' any more.
 
 ---
 ** Emacs now notifies systemd when startup finishes or shutdown begins.
@@ -150,6 +159,12 @@ after Emacs has finished initialization and is ready for use.
 emacs.service file to eg "~/.config/systemd/user/", you will need to copy
 the new version of the file again.)
 
++++
+** New option 'help-enable-completion-auto-load'.
+This allows disabling the new feature introduced in Emacs 26.1 which
+loads files during completion of 'C-h f' and 'C-h v' according to
+'definition-prefixes'.
+
 
 * Changes in Emacs 27.1
 
@@ -159,16 +174,16 @@ the new version of the file again.)
 *** emacsclient now supports the 'EMACS_SOCKET_NAME' environment variable.
 The behavior is identical to 'EMACS_SERVER_FILE', in that the
 command-line value specified via '--socket-name' will override the
-environment, and the natural default to TMPDIR, then "/tmp", continues
+environment, and the natural default to 'TMPDIR', then "/tmp", continues
 to apply.
 
 +++
-*** Emacs and emacsclient now default to $XDG_RUNTIME_DIR/emacs
+*** Emacs and emacsclient now default to "$XDG_RUNTIME_DIR/emacs"
 as the directory for client/server sockets, if Emacs is running
-under an X Window System desktop that sets the XDG_RUNTIME_DIR
+under an X Window System desktop that sets the 'XDG_RUNTIME_DIR'
 environment variable to indicate where session sockets should go.
 To get the old, less-secure behavior, you can set the
-EMACS_SOCKET_NAME environment variable to an appropriate value.
+'EMACS_SOCKET_NAME' environment variable to an appropriate value.
 
 ---
 *** When run by root, emacsclient no longer connects to non-root sockets.
@@ -182,11 +197,11 @@ be controlled via the new variable 'face-near-same-color-threshold'.
 The default value is 30000, as the previously hard-coded threshold.
 
 +++
-** The function 'read-passwd' uses '*' as default character to hide passwords.
+** The function 'read-passwd' uses "*" as default character to hide passwords.
 
-** Lexical binding is now used when evaluating interactive Elisp forms
-More specifically, lexical-binding is now used for M-:, --eval, as well
-as in the *scratch* and *ielm* buffers.
+** Lexical binding is now used when evaluating interactive Elisp forms.
+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
@@ -221,7 +236,7 @@ indirectly, e.g., by checking that functions like
 'libxml-parse-html-region' return nil.
 
 +++
-** 'libxml-parse-xml-region' and 'libxml-parse-html' region take
+** 'libxml-parse-xml-region' and 'libxml-parse-html-region' take
 a parameter that's called DISCARD-COMMENTS, but it really only
 discards the top-level comment.  Therefore this parameter is now
 obsolete, and the new utility function 'xml-remove-comments' can be
@@ -247,7 +262,7 @@ security level (assuming you use the 'medium' level).
 +++
 ** Native GnuTLS connections can now use client certificates.
 Previously, this support was only available when using the external
-gnutls-cli command.  Call 'open-network-stream' with
+'gnutls-cli' command.  Call 'open-network-stream' with
 ':client-certificate t' to trigger looking up of per-server
 certificates via 'auth-source'.
 
@@ -327,25 +342,40 @@ and directory-local variables.
 
 +++
 *** The macro 'with-connection-local-variables' has been renamed from
-'with-connection-local-profiles'.  No argument 'profiles' needed any
-longer.
+'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 variable 'next-error-verbose' controls when 'next-error' outputs
+a message about the error locus.
 
 ---
-** New variable grep-search-path defines the directories searched for
-   grep hits (this used to be controlled by compilation-search-path).
+** New variable '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
-   directories searched for byte-compiler error messages (this used to
-   be controlled by compilation-search-path).
+** New variable 'emacs-lisp-compilation-search-path' defines the
+directories searched for byte-compiler error messages (this used to
+be controlled by 'compilation-search-path').
 
 ** Multicolor fonts such as "Noto Color Emoji" can be displayed on
 Emacs configured with Cairo drawing and linked with cairo >= 1.16.0.
 
++++
+** Emacs now optionally displays a fill column indicator.
+
+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'
+and 'display-fill-column-indicator-character' to activate the
+indicator.
+
+The indicator is not displayed at all in minibuffer windows and
+in tooltips, as it is not useful there.
+
+There are 2 new buffer local variables and 1 face to customize this
+mode they are described in the manual "(emacs) Display".
+
 
 * Editing Changes in Emacs 27.1
 
@@ -405,39 +435,41 @@ syntax that you can see in the example of a ".dir-locals.el" file in
 the node "(emacs) Directory Variables" of the user manual.
 
 +++
-** Network connections using 'local can now use IPv6.
+** Network connections using 'local' can now use IPv6.
 'make-network-process' now uses the correct loopback address when
-asked to use :host 'local and :family 'ipv6.
+asked to use ':host 'local' and ':family 'ipv6'.
 
 +++
-** The new function `replace-region-contents' replaces the current
+** The new function 'replace-region-contents' replaces the current
 region using a given replacement-function in a non-destructive manner
-(in terms of `replace-buffer-contents').
+(in terms of 'replace-buffer-contents').
 
 +++
-** The command `replace-buffer-contents' now has two optional
+** The command 'replace-buffer-contents' now has two optional
 arguments mitigating performance issues when operating on huge
 buffers.
 
++++
 ** The command 'delete-indentation' now operates on the active region.
 If the region is active, the command joins all the lines in the
 region.  When there's no active region, the command works on the
 current and the previous or the next line, as before.
 
-+++
 
 * Changes in Specialized Modes and Packages in Emacs 27.1
 
 ** compile.el
 ---
-*** In compilation-error-regexp-alist, 'line' (and 'end-line') can be functions
+*** In 'compilation-error-regexp-alist', 'line' (and 'end-line') can
+be functions.
 
-** cl-lib
+** cl-lib.el
 +++
-*** cl-defstruct has a new :noinline argument to prevent inlining its functions
+*** 'cl-defstruct' has a new ':noinline' argument to prevent inlining
+its functions.
 
-** doc-view-mode
-*** New commands doc-view-presentation and doc-view-fit-window-to-page
+** doc-view.el
+*** New commands 'doc-view-presentation' and 'doc-view-fit-window-to-page'.
 *** Added support for password-protected PDF files
 
 ** Ido
@@ -479,10 +511,10 @@ that display the next buffer in the window at the specified direction.
 This is like 'windmove-default-keybindings' that binds keys to commands
 that select the window in the specified direction, but additionally it
 displays the buffer from the next command in that window.  For example,
-'S-M-right C-h i' displays the *Info* buffer in the right window,
+'S-M-right C-h i' displays the "*Info*" buffer in the right window,
 creating the window if necessary.  A special key can be customized to
 display the buffer in the same window, for example, 'S-M-0 C-h e'
-displays the *Messages* buffer in the same window.
+displays the "*Messages*" buffer in the same window.
 
 *** Windmove also supports directional window deletion.
 The new command 'windmove-delete-default-keybindings' binds default
@@ -502,8 +534,11 @@ The mode is automatically enabled in files that start with the
 'function' keyword.
 
 ** project.el
+
 *** New commands 'project-search' and 'project-query-replace-regexp'.
 
+*** New customizable variable 'project-read-file-name-function'.
+
 ** Etags
 
 +++
@@ -547,7 +582,7 @@ With non-nil, 'vc-find-revision' doesn't write the created buffer to file.
 This new variable 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.
+*** Command 'vc-git-stash' now respects marks in the "*vc-dir*" buffer.
 When some files are marked, only those are stashed.
 When no files are marked, all modified files are stashed, as before.
 
@@ -565,7 +600,7 @@ values.
 and compares their entire trees.
 
 *** New user option 'vc-hg-revert-switches' specifies switches to pass
-to hg revert.
+to Hg revert.
 
 *** 'C-x v M D' ('vc-diff-mergebase') and 'C-x v M L' ('vc-log-mergebase')
 print diffs and logs between the merge base (common ancestor) of two
@@ -574,9 +609,10 @@ given revisions.
 ** Diff mode
 +++
 *** Hunks are now automatically refined by font-lock.
-To disable refinement, set the new defcustom 'diff-refine' to nil.
+To disable refinement, set the new user option 'diff-refine' to nil.
 To get back the old behavior where hunks are refined as you navigate
 through a diff, set 'diff-refine' to the symbol 'navigate'.
+
 +++
 *** 'diff-auto-refine-mode' is deprecated in favor of 'diff-refine'.
 It is no longer enabled by default and binding it no longer has any
@@ -589,7 +625,7 @@ according to the appropriate major mode.  Customize the new 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 defcustom 'diff-font-lock-prettify' to t.
+To enable it, set the new user option 'diff-font-lock-prettify' to t.
 
 +++
 *** Prefix arg of 'diff-goto-source' means jump to the old revision
@@ -599,11 +635,11 @@ or to the new revision of the file otherwise.
 ** Texinfo
 
 +++
-*** New function for inserting @pxref, @xref, or @ref commands.
+*** New function for inserting '@pxref', '@xref', or '@ref' commands.
 The function 'texinfo-insert-dwim-@ref', bound to 'C-c C-c r' by
 default, inserts one of three types of references based on the text
-surrounding point, namely @pxref near a parenthesis, @xref at the
-start of a sentence or at (point-min), else @ref.
+surrounding point, namely '@pxref' near a parenthesis, '@xref' at the
+start of a sentence or at '(point-min)', else '@ref'.
 
 ** Browse-url
 
@@ -637,7 +673,6 @@ end.
 ** SQL
 
 *** SQL Indent Minor Mode
-
 SQL Mode now supports the ELPA 'sql-indent' package for assisting
 sophisticated SQL indenting rules.  Note, however, that SQL is not
 like other programming languages like C, Java, or Python where code is
@@ -659,7 +694,6 @@ default values. If you have existing customizations to these variables,
 you should make sure that the new default entry is included.
 
 *** Connection Wallet
-
 Database passwords can now by stored in NETRC or JSON data files that
 may optionally be encrypted. When establishing an interactive session
 with the database via 'sql-connect' or a product specific function,
@@ -669,9 +703,9 @@ searched for the password. The 'sql-product', 'sql-server',
 appropriate authorization. This eliminates the discouraged practice of
 embedding database passwords in your Emacs initialization.
 
-See the `auth-source' module for complete documentation on the file
+See the 'auth-source' module for complete documentation on the file
 formats.  By default, the wallet file is expected to be in the
-`user-emacs-directory', named 'sql-wallet' or '.sql-wallet', with
+'user-emacs-directory', named 'sql-wallet' or '.sql-wallet', with
 '.json' (JSON) or no (NETRC) suffix.  Both file formats can optionally
 be encrypted with GPG by adding an additional '.gpg' suffix.
 
@@ -694,6 +728,10 @@ Control whether Flymake starts checking the buffer on save.
 This enables more efficient backends.  See the docstring of
 'flymake-diagnostic-functions' or the Flymake manual for details.
 
++++
+*** 'flymake-start-syntax-check-on-newline' is now obsolete,
+use 'post-self-insert-hook' to check on newline.
+
 ** Ruby
 
 *** The Rubocop Flymake diagnostic function will only run Lint cops if
@@ -703,16 +741,23 @@ it can't find the config file.
 
 ** Package
 
+*** Change of 'package-check-signature' for packages with multiple sigs
+In previous Emacsen, 't' checked that all signatures are valid.
+Now 't' only checks that at least one signature is valid and the new 'all'
+value needs to be used if you want to enforce that all signatures
+are valid.  This only affects packages with multiple signatures.
+
 *** New function 'package-get-version' lets packages query their own version.
 Example use in auctex.el: '(defconst auctex-version (package-get-version))'
 
 *** New 'package-quickstart' feature.
-When 'package-quickstart' is non-nil, package.el precomputes a big autoloads
-file so that activation of packages can be done much faster, which can speed up
-your startup significantly.
-It also causes variables like 'package-user-dir' and 'package-load-list' to be
-consulted when 'package-quickstart-refresh' is run rather than at startup so
-you don't need to set them in your early init file.
+When 'package-quickstart' is non-nil, package.el precomputes a big
+autoloads file so that activation of packages can be done much faster,
+which can speed up your startup significantly.
+It also causes variables like 'package-user-dir' and
+'package-load-list' to be consulted when 'package-quickstart-refresh'
+is run rather than at startup so you don't need to set them in your
+early init file.
 
 *** New function 'package-activate-all'.
 
@@ -738,19 +783,19 @@ Previously, setting 'xref-marker-ring-length' would only take effect
 if set before 'xref.el' was loaded.
 
 ---
-*** xref-find-definitions now sets the mark at the buffer position
-where it was invoked
+*** 'xref-find-definitions' now sets the mark at the buffer position
+where it was invoked.
 
 ---
-*** New xref faces 'xref-file-header', 'xref-line-number', 'xref-match'
+*** New xref faces 'xref-file-header', 'xref-line-number', 'xref-match'.
 
 ** Ecomplete
 
 *** The ecomplete sorting has changed to a decay-based algorithm.
 This can be controlled by the new 'ecomplete-sort-predicate' variable.
 
-*** 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
 
@@ -797,7 +842,7 @@ This option controls whether and how to use Gnus search groups as
 ** erc
 
 ---
-*** 'erc-button-google-url' has been renamed 'erc-button-search-url'
+*** 'erc-button-google-url' has been renamed to 'erc-button-search-url'
 and its value has been changed to Duck Duck Go.
 
 ** EUDC
@@ -889,7 +934,7 @@ directories in the destination.
 ** Help
 
 ---
-*** Description of variables and functions give an estimated first release
+*** Description of variables and functions give an estimated first release.
 
 ---
 *** Output format of 'C-h l' ('view-lossage') has changed.
@@ -968,7 +1013,7 @@ and case-sensitivity together with search strings in the search ring.
 *** Isearch now has its own tool-bar and menu-bar menu.
 
 +++
-*** flush-lines prints and returns the number of deleted matching lines.
+*** 'flush-lines' prints and returns the number of deleted matching lines.
 
 ** Debugger
 
@@ -1011,7 +1056,7 @@ by default.
 ** Grep
 
 +++
-*** rgrep, lgrep and zrgrep now hide part of the command line
+*** '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
@@ -1070,10 +1115,10 @@ default, and not just the opening element.
 
 ** Eshell
 
-*** TAB completion uses the standard completion-at-point rather than pcomplete
-Its UI is slightly different but can be customized to behave similarly,
-e.g. Pcomplete's default cycling can be obtained with
-(setq completion-cycle-threshold 5).
+*** TAB completion uses the standard 'completion-at-point' rather than
+'pcomplete'.  Its UI is slightly different but can be customized to
+behave similarly, e.g. Pcomplete's default cycling can be obtained
+with '(setq completion-cycle-threshold 5)'.
 
 ---
 *** Expansion of history event designators is disabled by default.
@@ -1108,9 +1153,9 @@ variable for remote shells.  It still defaults to "/bin/sh".
 
 ** Single shell commands
 
----
-*** 'shell-command-width' defines the number of display columns
-available for output of asynchronous or remote shell commands.
++++
+*** 'async-shell-command-width' defines the number of display columns
+available for output of asynchronous shell commands.
 
 ** Pcomplete
 
@@ -1172,6 +1217,7 @@ Setting this option to an integer causes URLs displayed in Rcirc
 buffers to be truncated to that many characters.
 
 ** Register
+
 ---
 *** The return value of method 'register-val-describe' includes the
 names of buffers shown by the windows of a window configuration.
@@ -1253,11 +1299,18 @@ automatically updates.  In the buffer, you can use 's q' or 's e' to
 signal a thread with quit or error respectively, or get a snapshot
 backtrace with 'b'.
 
+
+** thingatpt.el
+
 ---
-** thingatpt.el supports a new "thing" called 'uuid'.
+*** 'thing-at-point' supports a new "thing" called 'uuid'.
 A symbol 'uuid' can be passed to 'thing-at-point' and it returns the
 UUID at point.
 
+---
+*** 'word-at-point' and 'sentence-at-point' accept NO-PROPERTIES.
+Just like 'thing-at-point' itself.
+
 ** Interactive automatic highlighting
 
 +++
@@ -1280,6 +1333,12 @@ when given in a string.  Previously, '(any "\x80-\xff")' would match
 characters U+0080...U+00FF.  Now the expression matches raw bytes in
 the 128...255 range, as expected.
 
+*** The rx 'or' and 'seq' forms no longer require any arguments.
+(or) produces a regexp that never matches anything, while (seq)
+matches the empty string, each being an identity for the operation.
+This also works for their aliases: '|' for 'or'; ':', 'and' and
+'sequence' for 'seq'.
+
 ** Frames
 
 +++
@@ -1294,7 +1353,7 @@ frame when making a frame.
 *** New predicates 'display-blink-cursor-p' and 'display-symbol-keys-p'.
 These predicates are to be preferred over 'display-graphic-p' when
 testing for blinking cursor capability and the capability to have
-symbols (e.g., [return], [tab], [backspace]) as keys respectively.
+symbols (e.g., '[return]', '[tab]', '[backspace]') as keys respectively.
 
 ** Tabulated List mode
 
@@ -1315,8 +1374,8 @@ near the current column in Tabulated Lists (see variables
 ** CUA mode
 
 ---
-*** New defcustom 'cua-rectangle-terminal-modifier-key'.
-This defcustom allows for the customization of the modifier key used
+*** New user option 'cua-rectangle-terminal-modifier-key'.
+This user option allows for the customization of the modifier key used
 in a terminal frame.
 
 ** JS mode
@@ -1329,11 +1388,11 @@ will be supported in 'js-mode' and derivative modes.  ('js-jsx-mode'
 no longer needs to be enabled.)
 
 ---
-*** New defcustom 'js-jsx-detect-syntax' disables automatic detection.
+*** New user option 'js-jsx-detect-syntax' disables automatic detection.
 This is turned on by default.
 
 ---
-*** New defcustom 'js-jsx-syntax' enables JSX syntax unconditionally.
+*** New user option 'js-jsx-syntax' enables JSX syntax unconditionally.
 This is off by default.
 
 ---
@@ -1353,7 +1412,7 @@ of the React developer community (see 'js-jsx-align->-with-<'),
 otherwise still adhering to SGML conventions.
 
 ---
-*** New defcustom 'js-jsx-align->-with-<' controls '>' indents.
+*** New user option 'js-jsx-align->-with-<' controls '>' indents.
 Commonly in JSX code, a '>' on its own line is indented at the same
 level as its opening '<'.  This is the new default for JSX.  This
 behavior is slightly different than that used by SGML in Emacs, where
@@ -1376,12 +1435,12 @@ The old behavior can be emulated by controlling JSX indentation
 independently of JS, by setting 'js-jsx-indent-level'.
 
 ---
-*** New defcustom 'js-jsx-indent-level' for different JSX indentation.
+*** New user option 'js-jsx-indent-level' for different JSX indentation.
 If you wish to indent JSX by a different number of spaces than JS, set
-this variable to the desired number.
+this user option to the desired number.
 
 ---
-*** New defcustom 'js-jsx-attribute-offset' for JSX attribute indents.
+*** New user option 'js-jsx-attribute-offset' for JSX attribute indents.
 
 ---
 *** New variable 'js-syntactic-mode-name' controls mode name display.
@@ -1395,6 +1454,22 @@ Packages deriving from 'js-mode' with 'define-derived-mode' should
 call this function to add enabled syntax extensions to their mode
 name, too.
 
+** Autorevert
+
+*** New variable '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
+'auto-revert-notify-exclude-dir-regexp' to match files where
+notification is not supported.  The default value is nil.
+
+*** New variable 'buffer-auto-revert-by-notification'
+A major mode can declare that notification on the buffer's default
+directory is sufficient to know when updates are required, by setting
+the new variable 'buffer-auto-revert-by-notification' to a non-nil
+value.  Auto Revert mode can use this information to avoid polling the
+buffer periodically when 'auto-revert-avoid-polling' is non-nil.
+
 
 * New Modes and Packages in Emacs 27.1
 
@@ -1425,8 +1500,8 @@ documentation of the new mode and its commands.
 
 * Incompatible Lisp Changes in Emacs 27.1
 
-** In compilation-error-regexp-alist the old undocumented feature where 'line'
-could be a function of 2 arguments has been dropped.
+** In 'compilation-error-regexp-alist' the old undocumented feature
+where 'line' could be a function of 2 arguments has been dropped.
 
 ** 'define-fringe-bitmap' is always defined, even when Emacs is built
 without any GUI support.
@@ -1449,11 +1524,11 @@ its default value changed in Emacs 27.1.
 
 ** The REPETITIONS argument of 'benchmark-run' can now also be a variable.
 
-** Interpretation of relative HOME directory has changed.
-If $HOME is set to a relative file name, 'expand-file-name' now
+** Interpretation of relative 'HOME' directory has changed.
+If "$HOME" is set to a relative file name, 'expand-file-name' now
 interprets it relative to the directory where Emacs was started, not
 relative to the 'default-directory' of the current buffer.  We recommend
-always setting $HOME to an absolute file name, so that its meaning is
+always setting "$HOME" to an absolute file name, so that its meaning is
 independent of where Emacs was started.
 
 ** The FILENAME argument to 'file-name-base' is now mandatory and no
@@ -1479,7 +1554,7 @@ old-style backquotes as new-style, bind the new variable
 integer, Emacs now signals an error if the number is too large for the
 implementation to format.
 
-** logb now returns infinity when given an infinite or zero argument,
+** 'logb' now returns infinity when given an infinite or zero argument,
 and returns a NaN when given a NaN.  Formerly, it returned an extreme
 fixnum for such arguments.
 
@@ -1530,11 +1605,11 @@ they are now allocated like any other pseudovector.  As a result, the
 removed.
 
 +++
-** Reversed character ranges are no longer permitted in rx.
+** Reversed character ranges are no longer permitted in 'rx'.
 Previously, ranges where the starting character is greater than the
 ending character were silently omitted.
 For example, '(rx (any "@z-a" (?9 . ?0)))' would match '@' only.
-Now, such rx expressions generate an error.
+Now, such 'rx' expressions generate an error.
 
 +++
 ** 'text-mode' no longer sets the value of 'indent-line-function'.
@@ -1543,16 +1618,21 @@ The global value of 'indent-line-function', which defaults to
 'text-mode'.
 
 To get back the old behavior, add a function to 'text-mode-hook' which
-performs (setq-local indent-line-function #'indent-relative).
+performs '(setq-local indent-line-function #'indent-relative)'.
 
 ** 'make-process' no longer accepts a non-nil ':stop' key.  This has
 never worked reliably, and now causes an error.
 
++++
+** 'eventp' no longer returns non-nil for lists whose car is nil.
+This is consistent with the fact that nil, though a symbol, is not a
+valid event type.
+
 
 * Lisp Changes in Emacs 27.1
 
 ** New 'help-fns-describe-variable-functions' hook.
-Makes it possible to add metadata information to describe-variable.
+Makes it possible to add metadata information to 'describe-variable'.
 
 ** i18n (internationalization)
 
@@ -1560,7 +1640,7 @@ Makes it possible to add metadata information to describe-variable.
 according to the given numeric value.
 
 +++
-** inhibit-null-byte-detection is renamed to inhibit-nul-byte-detection
+** 'inhibit-null-byte-detection' is renamed to 'inhibit-nul-byte-detection'.
 
 +++
 ** 'self-insert-command' takes the char to insert as (optional) argument.
@@ -1604,8 +1684,10 @@ like 'file-attributes' that compute file sizes and other attributes,
 functions like 'process-id' that compute process IDs, and functions like
 'user-uid' and 'group-gid' that compute user and group IDs.
 
+** Time values
+
 +++
-** Although the default timestamp format is still (HI LO US PS),
+*** Although the default timestamp format is still '(HI LO US PS)',
 it is planned to change in a future Emacs version, to exploit bignums.
 The documentation has been updated to mention that the timestamp
 format may change and that programs should use functions like
@@ -1614,22 +1696,22 @@ probing the innards of a timestamp directly, or creating a timestamp
 by hand.
 
 +++
-** 'encode-time' supports a new API '(encode-time TIME &optional FORM)'.
+*** 'encode-time' supports a new API '(encode-time TIME &optional FORM)'.
 This can convert decoded times and Lisp time values to Lisp timestamps
 of various forms, including a new timestamp form '(TICKS . HZ)', where
 TICKS is an integer and HZ is a positive integer denoting a clock
 frequency.  The old 'encode-time' API is still supported.
 
 +++
-** 'time-add', 'time-subtract', and 'time-less-p' now accept
+*** 'time-add', 'time-subtract', and 'time-less-p' now accept
 infinities and NaNs too, and propagate them or return nil like
 floating-point operators do.
 
 +++
-** New function 'time-equal-p' compares time values for equality.
+*** New function 'time-equal-p' compares time values for equality.
 
 +++
-** 'format-time-string' supports a new conversion specifier flag '+'
+*** 'format-time-string' supports a new conversion specifier flag '+'
 that acts like the '0' flag but also puts a '+' before nonnegative
 years containing more than four digits.  This is for compatibility
 with POSIX.1-2017.
@@ -1682,7 +1764,6 @@ of the Emacs Lisp Reference manual for more detail.
 
 +++
 ** Window change functions have been redesigned.
-
 Hooks reacting to window changes run now only when redisplay detects
 that a change has actually occurred.  Six hooks are now provided:
 'window-buffer-change-functions' (run after window buffers have
@@ -1710,11 +1791,16 @@ See the section "(elisp) Window Hooks" in the Elisp manual for a
 detailed explanation of the new behavior.
 
 +++
-*** New option 'resize-mini-frames'.
+** New option 'resize-mini-frames'.
 This option allows to automatically resize minibuffer-only frames
 similarly to how minibuffer windows are resized on "normal" frames.
 
 +++
+** New buffer display action function 'display-buffer-in-direction'.
+This function allows to specify the location of the window chosen by
+'display-buffer' in various ways.
+
++++
 ** New buffer display action alist entry 'dedicated'.
 Such an entry allows to specify the dedicated status of a window
 created by 'display-buffer'.
@@ -1726,6 +1812,16 @@ for displaying a buffer.  'display-buffer-below-selected' is the only
 action function to respect it at the moment.
 
 +++
+** New buffer display action alist entry 'direction'.
+This entry is used to specify the location of the window chosen by
+'display-buffer-in-direction'.
+
++++
+** Additional meaning of display action alist entry 'window'.
+A 'window' entry can now also specify a reference window for
+'display-buffer-in-direction'.
+
++++
 ** The function 'assoc-delete-all' now takes an optional predicate argument.
 
 +++
@@ -1741,7 +1837,7 @@ This avoids problems in calls like '(read (format "#x%x" -1))', and is
 more compatible with bignums.  To get the traditional machine-dependent
 behavior, set the experimental variable 'binary-as-unsigned' to t,
 and if the new behavior breaks your code please email
-32252@debbugs.gnu.org.  Because '%o' and '%x' can now format signed
+<32252@debbugs.gnu.org>.  Because '%o' and '%x' can now format signed
 integers, they now support the '+' and space flags.
 
 ** To avoid confusion caused by "smart quotes", the reader signals an
@@ -1870,16 +1966,31 @@ some years back.  It now respects 'imagemagick-types-inhibit' as a way
 to disable that.
 
 ---
-*** Some image-mode variables are now buffer-local.
+*** Some 'image-mode' variables are now buffer-local.
 The image parameters 'image-transform-rotation',
 'image-transform-scale' and 'image-transform-resize' are now declared
 buffer-local, so each buffer could have its own values for these
 parameters.
 
-** The function 'load' now behaves correctly when loading modules.
+** Modules
+
+*** The function 'load' now behaves correctly when loading modules.
 Specifically, it puts the module name into 'load-history', prints
 loading messages if requested, and protects against recursive loads.
 
+*** New module environment function 'process_input' to process user
+input while module code is running.
+
+*** New module environment functions 'make_time' and 'extract_time' to
+convert between timespec structures and Emacs Lisp time values.
+
+*** New module environment functions 'make_big_integer' and
+'extract_big_integer' to create and extract arbitrary-size integer
+values.
+
+*** emacs-module.h now defines a macro 'EMACS_MAJOR_VERSION' that expands
+to the major version of the latest Emacs supported by the header.
+
 +++
 ** The function 'read-variable' now uses its own history list.
 The history of variable names read by 'read-variable' is recorded in
@@ -1912,13 +2023,10 @@ The new function 'image-scaling-p' can be used to test whether any
 given frame supports resizing.
 
 +++
-** (locale-info 'paper) now returns the paper size on systems that support it.
+** '(locale-info 'paper)' now returns the paper size on systems that support it.
 This is currently supported on GNUish hosts and on modern versions of
 MS-Windows.
 
-** New module environment function 'process_input' to process user
-input while module code is running.
-
 +++
 ** The function 'regexp-opt' accepts an additional optional argument.
 By default, the regexp returned by 'regexp-opt' may match the strings
@@ -1932,12 +2040,9 @@ returns a regexp that never matches anything, which is an identity for
 this operation.  Previously, the empty string was returned in this
 case.
 
-** New module environment functions 'make_time' and 'extract_time' to
-convert between timespec structures and Emacs Lisp time values.
-
-** New module environment functions 'make_big_integer' and
-'extract_big_integer' to create and extract arbitrary-size integer
-values.
+** New constant 'regexp-unmatchable' contains a never-matching regexp.
+It is a convenient and readable way to specify a regexp that should
+not match anything, and is as fast as any such regexp can be.
 
 
 * Changes in Emacs 27.1 on Non-Free Operating Systems
diff --git a/etc/NEWS.24 b/etc/NEWS.24
index 9150e49fd92..049005306fd 100644
--- a/etc/NEWS.24
+++ b/etc/NEWS.24
@@ -1117,6 +1117,8 @@ a non-nil `interactive-only' property.
 The value, if non-nil, is a regexp that specifies what to trim from
 the start and end of each substring.
 
+** New function `delete-consecutive-dups'.
+
 ** Completion
 
 *** The separator used by `completing-read-multiple' is now a regexp.
diff --git a/etc/TODO b/etc/TODO
index ccb82cd296d..dc594a007ed 100644
--- a/etc/TODO
+++ b/etc/TODO
@@ -143,15 +143,6 @@ See the 'test' directory for examples.
 
 * Small but important fixes needed in existing features:
 
-** Flymake's customization mechanism needs to be both simpler (fewer
-levels of indirection) and better documented, so it is easier to
-understand.  I find it quite hard to figure out what compilation
-command it will use.
-
-I suggest totally rewriting that part of Flymake, using the simplest
-mechanism that suffices for the specific needs.  That will be easy
-for users to customize.
-
 ** Distribute a bar cursor of width > 1 evenly between the two glyphs
    on each side of the bar (what to do at the edges?).
 
diff --git a/etc/tutorials/TUTORIAL.translators b/etc/tutorials/TUTORIAL.translators
index 2747d39d355..b6b95787068 100644
--- a/etc/tutorials/TUTORIAL.translators
+++ b/etc/tutorials/TUTORIAL.translators
@@ -41,8 +41,8 @@ Maintainer: Alfredo Finelli <alfredofnl@tiscali.it>
             Italian GNU Translation Group <tp@lists.linux.it>
 
 * TUTORIAL.ja:
-Author:     Kenichi Handa <handa@m17n.org>
-Maintainer: Kenichi Handa <handa@m17n.org>
+Author:     Kenichi Handa <handa@gnu.org>
+Maintainer: Kenichi Handa <handa@gnu.org>
 
 * TUTORIAL.ko:
 Author:     Koaunghi Un <koaunghi@ling.cnu.ac.kr>
@@ -94,4 +94,3 @@ Maintainer: Chao-Hong Liu <chliu@gnu.org>
 ;;; Local Variables:
 ;;; coding: utf-8
 ;;; End:
-