summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--.gitignore1
-rw-r--r--README2
-rw-r--r--admin/gitmerge.el2
-rwxr-xr-xadmin/nt/dist-build/build-dep-zips.py2
-rw-r--r--configure.ac14
-rw-r--r--doc/lispref/internals.texi121
-rw-r--r--doc/lispref/loading.texi7
-rw-r--r--doc/lispref/minibuf.texi9
-rw-r--r--etc/NEWS3578
-rw-r--r--etc/NEWS.273615
-rw-r--r--etc/refcards/ru-refcard.tex2
-rw-r--r--lisp/calendar/diary-lib.el2
-rw-r--r--lisp/cedet/semantic/db-ebrowse.el2
-rw-r--r--lisp/cedet/srecode/document.el14
-rw-r--r--lisp/desktop.el2
-rw-r--r--lisp/elide-head.el4
-rw-r--r--lisp/emacs-lisp/byte-opt.el7
-rw-r--r--lisp/emacs-lisp/bytecomp.el2
-rw-r--r--lisp/emacs-lisp/edebug.el4
-rw-r--r--lisp/emacs-lisp/generator.el2
-rw-r--r--lisp/epa.el28
-rw-r--r--lisp/erc/erc-backend.el2
-rw-r--r--lisp/erc/erc-ezbounce.el2
-rw-r--r--lisp/files.el2
-rw-r--r--lisp/gnus/deuglify.el6
-rw-r--r--lisp/gnus/gnus-fun.el4
-rw-r--r--lisp/gnus/nnheader.el4
-rw-r--r--lisp/gnus/spam.el2
-rw-r--r--lisp/htmlfontify.el2
-rw-r--r--lisp/info-look.el2
-rw-r--r--lisp/international/rfc1843.el2
-rw-r--r--lisp/mail/feedmail.el2
-rw-r--r--lisp/mail/rmail-spam-filter.el14
-rw-r--r--lisp/man.el2
-rw-r--r--lisp/net/ange-ftp.el2
-rw-r--r--lisp/net/ldap.el2
-rw-r--r--lisp/net/newst-backend.el2
-rw-r--r--lisp/net/rcirc.el8
-rw-r--r--lisp/org/org-agenda.el4
-rw-r--r--lisp/org/org-protocol.el2
-rw-r--r--lisp/org/org-table.el2
-rw-r--r--lisp/org/ox-latex.el2
-rw-r--r--lisp/progmodes/bug-reference.el2
-rw-r--r--lisp/progmodes/hideif.el2
-rw-r--r--lisp/progmodes/idlw-help.el4
-rw-r--r--lisp/progmodes/idlwave.el2
-rw-r--r--lisp/progmodes/python.el16
-rw-r--r--lisp/progmodes/sql.el4
-rw-r--r--lisp/registry.el2
-rw-r--r--lisp/simple.el7
-rw-r--r--lisp/speedbar.el4
-rw-r--r--lisp/subr.el9
-rw-r--r--lisp/textmodes/flyspell.el4
-rw-r--r--lisp/textmodes/paragraphs.el2
-rw-r--r--lisp/textmodes/tildify.el4
-rw-r--r--lisp/vc/ediff-init.el2
-rw-r--r--lisp/vc/vc-git.el2
-rw-r--r--lisp/vc/vc-hg.el2
-rw-r--r--lisp/whitespace.el8
-rw-r--r--lisp/woman.el4
-rw-r--r--msdos/sed2v2.inp2
-rw-r--r--nt/README.W322
-rw-r--r--src/emacs-module.c154
-rw-r--r--src/emacs-module.h.in32
-rw-r--r--src/lread.c17
-rw-r--r--src/macfont.m3
-rw-r--r--src/minibuf.c7
-rw-r--r--src/module-env-25.h67
-rw-r--r--src/module-env-27.h2
-rw-r--r--src/module-env-28.h3
-rw-r--r--src/msdos.c2
-rw-r--r--src/nsfns.m10
-rw-r--r--src/nsimage.m7
-rw-r--r--src/nsterm.m12
-rw-r--r--test/lisp/time-stamp-tests.el110
-rw-r--r--test/src/emacs-module-tests.el18
76 files changed, 4153 insertions, 3865 deletions
diff --git a/.gitignore b/.gitignore
index 389fb450d86..102a79e1b5b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -135,6 +135,7 @@ src/gl-stamp
*.o
*.res
*.so
+*.dylib
core
core.*[0-9]
gmon.out
diff --git a/README b/README
index 5038995c5a1..f80fa0a892b 100644
--- a/README
+++ b/README
@@ -2,7 +2,7 @@ Copyright (C) 2001-2019 Free Software Foundation, Inc.
See the end of the file for license conditions.
-This directory tree holds version 27.0.60 of GNU Emacs, the extensible,
+This directory tree holds version 28.0.50 of GNU Emacs, the extensible,
customizable, self-documenting real-time display editor.
The file INSTALL in this directory says how to build and install GNU
diff --git a/admin/gitmerge.el b/admin/gitmerge.el
index edf43797304..31d96b0dab3 100644
--- a/admin/gitmerge.el
+++ b/admin/gitmerge.el
@@ -52,7 +52,7 @@
;; caused false positives. --Stef
(let ((skip "back[- ]?port\\|cherry picked from commit\\|\
\\(do\\( no\\|n['’]\\)t\\|no need to\\) merge\\|not to be merged\\|\
-bump \\(Emacs \\)?version\\|Auto-commit"))
+bump Emacs version\\|Auto-commit"))
(if noninteractive skip
;; "Regenerate" is quite prone to false positives.
;; We only want to skip merging things like AUTHORS and ldefs-boot.
diff --git a/admin/nt/dist-build/build-dep-zips.py b/admin/nt/dist-build/build-dep-zips.py
index b538d851513..769e21a62e4 100755
--- a/admin/nt/dist-build/build-dep-zips.py
+++ b/admin/nt/dist-build/build-dep-zips.py
@@ -26,7 +26,7 @@ import re
from subprocess import check_output
## Constants
-EMACS_MAJOR_VERSION="27"
+EMACS_MAJOR_VERSION="28"
# This list derives from the features we want Emacs to compile with.
PKG_REQ='''mingw-w64-x86_64-giflib
diff --git a/configure.ac b/configure.ac
index 1c3fe7853e5..f24597ae872 100644
--- a/configure.ac
+++ b/configure.ac
@@ -23,7 +23,7 @@ dnl along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>.
AC_PREREQ(2.65)
dnl Note this is parsed by (at least) make-dist and lisp/cedet/ede/emacs.el.
-AC_INIT(GNU Emacs, 27.0.60, bug-gnu-emacs@gnu.org, , https://www.gnu.org/software/emacs/)
+AC_INIT(GNU Emacs, 28.0.50, bug-gnu-emacs@gnu.org, , https://www.gnu.org/software/emacs/)
dnl Set emacs_config_options to the options of 'configure', quoted for the shell,
dnl and then quoted again for a C string. Separate options with spaces.
@@ -3676,8 +3676,13 @@ HAVE_MODULES=no
MODULES_OBJ=
case $opsys in
cygwin|mingw32) MODULES_SUFFIX=".dll" ;;
+ darwin) MODULES_SUFFIX=".dylib" ;;
*) MODULES_SUFFIX=".so" ;;
esac
+case "${opsys}" in
+ darwin) MODULES_SECONDARY_SUFFIX='.so' ;;
+ *) MODULES_SECONDARY_SUFFIX='' ;;
+esac
if test "${with_modules}" != "no"; then
case $opsys in
gnu|gnu-linux)
@@ -3708,19 +3713,26 @@ if test "${HAVE_MODULES}" = yes; then
AC_DEFINE(HAVE_MODULES, 1, [Define to 1 if dynamic modules are enabled])
AC_DEFINE_UNQUOTED(MODULES_SUFFIX, "$MODULES_SUFFIX",
[System extension for dynamic libraries])
+ if test -n "${MODULES_SECONDARY_SUFFIX}"; then
+ AC_DEFINE_UNQUOTED(MODULES_SECONDARY_SUFFIX, "$MODULES_SECONDARY_SUFFIX",
+ [Alternative system extension for dynamic libraries.])
+ fi
fi
AC_SUBST(MODULES_OBJ)
AC_SUBST(LIBMODULES)
AC_SUBST(HAVE_MODULES)
AC_SUBST(MODULES_SUFFIX)
+AC_SUBST(MODULES_SECONDARY_SUFFIX)
AC_CONFIG_FILES([src/emacs-module.h])
AC_SUBST_FILE([module_env_snippet_25])
AC_SUBST_FILE([module_env_snippet_26])
AC_SUBST_FILE([module_env_snippet_27])
+AC_SUBST_FILE([module_env_snippet_28])
module_env_snippet_25="$srcdir/src/module-env-25.h"
module_env_snippet_26="$srcdir/src/module-env-26.h"
module_env_snippet_27="$srcdir/src/module-env-27.h"
+module_env_snippet_28="$srcdir/src/module-env-28.h"
emacs_major_version="${PACKAGE_VERSION%%.*}"
AC_SUBST(emacs_major_version)
diff --git a/doc/lispref/internals.texi b/doc/lispref/internals.texi
index 36d32ffddab..2c47d67e3fb 100644
--- a/doc/lispref/internals.texi
+++ b/doc/lispref/internals.texi
@@ -1228,9 +1228,9 @@ the @var{runtime} structure with the value compiled into the module:
@example
int
-emacs_module_init (struct emacs_runtime *ert)
+emacs_module_init (struct emacs_runtime *runtime)
@{
- if (ert->size < sizeof (*ert))
+ if (runtime->size < sizeof (*runtime))
return 1;
@}
@end example
@@ -1247,7 +1247,7 @@ assumes it is part of the @code{emacs_module_init} function shown
above:
@example
- emacs_env *env = ert->get_environment (ert);
+ emacs_env *env = runtime->get_environment (runtime);
if (env->size < sizeof (*env))
return 2;
@end example
@@ -1264,7 +1264,7 @@ Emacs, by comparing the size of the environment passed by Emacs with
known sizes, like this:
@example
- emacs_env *env = ert->get_environment (ert);
+ emacs_env *env = runtime->get_environment (runtime);
if (env->size >= sizeof (struct emacs_env_26))
emacs_version = 26; /* Emacs 26 or later. */
else if (env->size >= sizeof (struct emacs_env_25))
@@ -1314,7 +1314,8 @@ subsection describes how to write such @dfn{module functions}.
A module function has the following general form and signature:
-@deftypefn Function emacs_value module_func (emacs_env *@var{env}, ptrdiff_t @var{nargs}, emacs_value *@var{args}, void *@var{data})
+@deftypefn Function emacs_value emacs_function (emacs_env *@var{env}, ptrdiff_t @var{nargs}, emacs_value *@var{args}, void *@var{data})
+@tindex emacs_function
The @var{env} argument provides a pointer to the @acronym{API}
environment, needed to access Emacs objects and functions. The
@var{nargs} argument is the required number of arguments, which can be
@@ -1323,7 +1324,7 @@ of the argument number), and @var{args} is a pointer to the array of
the function arguments. The argument @var{data} points to additional
data required by the function, which was arranged when
@code{make_function} (see below) was called to create an Emacs
-function from @code{module_func}.
+function from @code{emacs_function}.
Module functions use the type @code{emacs_value} to communicate Lisp
objects between Emacs and the module (@pxref{Module Values}). The
@@ -1338,6 +1339,10 @@ However, if the user typed @kbd{C-g}, or if the module function or its
callees signaled an error or exited nonlocally (@pxref{Module
Nonlocal}), Emacs will ignore the returned value and quit or throw as
it does when Lisp code encounters the same situations.
+
+The header @file{emacs-module.h} provides the type
+@code{emacs_function} as an alias type for a function pointer to a
+module function.
@end deftypefn
After writing your C code for a module function, you should make a
@@ -1348,11 +1353,11 @@ normally done in the module initialization function (@pxref{module
initialization function}), after verifying the @acronym{API}
compatibility.
-@deftypefn Function emacs_value make_function (emacs_env *@var{env}, ptrdiff_t @var{min_arity}, ptrdiff_t @var{max_arity}, subr @var{func}, const char *@var{docstring}, void *@var{data})
+@deftypefn Function emacs_value make_function (emacs_env *@var{env}, ptrdiff_t @var{min_arity}, ptrdiff_t @var{max_arity}, emacs_function @var{func}, const char *@var{docstring}, void *@var{data})
@vindex emacs_variadic_function
This returns an Emacs function created from the C function @var{func},
-whose signature is as described for @code{module_func} above (assumed
-here to be @code{typedef}'ed as @code{subr}). The arguments
+whose signature is as described for @code{emacs_function} above.
+The arguments
@var{min_arity} and @var{max_arity} specify the minimum and maximum
number of arguments that @var{func} can accept. The @var{max_arity}
argument can have the special value @code{emacs_variadic_function},
@@ -1388,7 +1393,7 @@ Combining the above steps, code that arranges for a C function
look like this, as part of the module initialization function:
@example
- emacs_env *env = ert->get_environment (ert);
+ emacs_env *env = runtime->get_environment (runtime);
emacs_value func = env->make_function (env, min_arity, max_arity,
module_func, docstring, data);
emacs_value symbol = env->intern (env, "module-func");
@@ -1541,12 +1546,11 @@ This function returns the value of a Lisp float specified by
@var{arg}, as a C @code{double} value.
@end deftypefn
-@deftypefn Function struct timespec extract_time (emacs_env *@var{env}, emacs_value @var{time})
-This function, which is available since Emacs 27, interprets
-@var{time} as an Emacs Lisp time value and returns the corresponding
-@code{struct timespec}. @xref{Time of Day}. @code{struct timespec}
-represents a timestamp with nanosecond precision. It has the
-following members:
+@deftypefn Function struct timespec extract_time (emacs_env *@var{env}, emacs_value @var{arg})
+This function, which is available since Emacs 27, interprets @var{arg}
+as an Emacs Lisp time value and returns the corresponding @code{struct
+timespec}. @xref{Time of Day}. @code{struct timespec} represents a
+timestamp with nanosecond precision. It has the following members:
@table @code
@item time_t tv_sec
@@ -1744,9 +1748,9 @@ next_prime (emacs_env *env, ptrdiff_t nargs, emacs_value *args,
@}
int
-emacs_module_init (struct emacs_runtime *ert)
+emacs_module_init (struct emacs_runtime *runtime)
@{
- emacs_env *env = ert->get_environment (ert);
+ emacs_env *env = runtime->get_environment (runtime);
emacs_value symbol = env->intern (env, "next-prime");
emacs_value func
= env->make_function (env, 1, 1, next_prime, NULL, NULL);
@@ -1773,16 +1777,15 @@ there's no requirement that @var{time} be normalized. This means that
@code{@var{time}.tv_nsec} can be negative or larger than 999,999,999.
@end deftypefn
-@deftypefn Function emacs_value make_string (emacs_env *@var{env}, const char *@var{str}, ptrdiff_t @var{strlen})
+@deftypefn Function emacs_value make_string (emacs_env *@var{env}, const char *@var{str}, ptrdiff_t @var{len})
This function creates an Emacs string from C text string pointed by
@var{str} whose length in bytes, not including the terminating null
-byte, is @var{strlen}. The original string in @var{str} can be either
-an @acronym{ASCII} string or a UTF-8 encoded non-@acronym{ASCII}
-string; it can include embedded null bytes, and doesn't have to end in
-a terminating null byte at @code{@var{str}[@var{strlen}]}. The
-function raises the @code{overflow-error} error condition if
-@var{strlen} is negative or exceeds the maximum length of an Emacs
-string.
+byte, is @var{len}. The original string in @var{str} can be either an
+@acronym{ASCII} string or a UTF-8 encoded non-@acronym{ASCII} string;
+it can include embedded null bytes, and doesn't have to end in a
+terminating null byte at @code{@var{str}[@var{len}]}. The function
+raises the @code{overflow-error} error condition if @var{len} is
+negative or exceeds the maximum length of an Emacs string.
@end deftypefn
The @acronym{API} does not provide functions to manipulate Lisp data
@@ -1839,27 +1842,35 @@ garbage-collected. Don't run any expensive code in a finalizer,
because GC must finish quickly to keep Emacs responsive.
@end deftypefn
-@deftypefn Function void *get_user_ptr (emacs_env *@var{env}, emacs_value val)
+@deftypefn Function void *get_user_ptr (emacs_env *@var{env}, emacs_value @var{arg})
This function extracts the C pointer from the Lisp object represented
-by @var{val}.
+by @var{arg}.
@end deftypefn
-@deftypefn Function void set_user_ptr (emacs_env *@var{env}, emacs_value @var{value}, void *@var{ptr})
+@deftypefn Function void set_user_ptr (emacs_env *@var{env}, emacs_value @var{arg}, void *@var{ptr})
This function sets the C pointer embedded in the @code{user-ptr}
-object represented by @var{value} to @var{ptr}.
+object represented by @var{arg} to @var{ptr}.
@end deftypefn
-@deftypefn Function emacs_finalizer get_user_finalizer (emacs_env *@var{env}, emacs_value val)
+@deftypefn Function emacs_finalizer get_user_finalizer (emacs_env *@var{env}, emacs_value @var{arg})
This function returns the finalizer of the @code{user-ptr} object
-represented by @var{val}, or @code{NULL} if it doesn't have a finalizer.
+represented by @var{arg}, or @code{NULL} if it doesn't have a
+finalizer.
@end deftypefn
-@deftypefn Function void set_user_finalizer (emacs_env *@var{env}, emacs_value @var{val}, emacs_finalizer @var{fin})
+@deftypefn Function void set_user_finalizer (emacs_env *@var{env}, emacs_value @var{arg}, emacs_finalizer @var{fin})
This function changes the finalizer of the @code{user-ptr} object
-represented by @var{val} to be @var{fin}. If @var{fin} is a
-@code{NULL} pointer, the @code{user-ptr} object will have no finalizer.
+represented by @var{arg} to be @var{fin}. If @var{fin} is a
+@code{NULL} pointer, the @code{user-ptr} object will have no
+finalizer.
@end deftypefn
+@deftypefun void emacs_finalizer (void *@var{ptr})
+The header @file{emacs-module.h} provides the type
+@code{emacs_finalizer} as a type alias for an Emacs finalizer
+function.
+@end deftypefun
+
@node Module Misc
@subsection Miscellaneous Convenience Functions for Modules
@@ -1870,20 +1881,20 @@ be called via the @code{emacs_env} pointer. Description of functions
that were introduced after Emacs 25 calls out the first version where
they became available.
-@deftypefn Function bool eq (emacs_env *@var{env}, emacs_value @var{val1}, emacs_value @var{val2})
+@deftypefn Function bool eq (emacs_env *@var{env}, emacs_value @var{a}, emacs_value @var{b})
This function returns @code{true} if the Lisp objects represented by
-@var{val1} and @var{val2} are identical, @code{false} otherwise. This
-is the same as the Lisp function @code{eq} (@pxref{Equality
-Predicates}), but avoids the need to intern the objects represented by
-the arguments.
+@var{a} and @var{b} are identical, @code{false} otherwise. This is
+the same as the Lisp function @code{eq} (@pxref{Equality Predicates}),
+but avoids the need to intern the objects represented by the
+arguments.
There are no @acronym{API} functions for other equality predicates, so
you will need to use @code{intern} and @code{funcall}, described
below, to perform more complex equality tests.
@end deftypefn
-@deftypefn Function bool is_not_nil (emacs_env *@var{env}, emacs_value @var{val})
-This function tests whether the Lisp object represented by @var{val}
+@deftypefn Function bool is_not_nil (emacs_env *@var{env}, emacs_value @var{arg})
+This function tests whether the Lisp object represented by @var{arg}
is non-@code{nil}; it returns @code{true} or @code{false} accordingly.
Note that you could implement an equivalent test by using
@@ -1892,12 +1903,12 @@ then use @code{eq}, described above, to test for equality. But using
this function is more convenient.
@end deftypefn
-@deftypefn Function emacs_value type_of (emacs_env *@var{env}, emacs_value @code{object})
-This function returns the type of @var{object} as a value that
-represents a symbol: @code{string} for a string, @code{integer} for an
-integer, @code{process} for a process, etc. @xref{Type Predicates}.
-You can use @code{intern} and @code{eq} to compare against known type
-symbols, if your code needs to depend on the object type.
+@deftypefn Function emacs_value type_of (emacs_env *@var{env}, emacs_value @code{arg})
+This function returns the type of @var{arg} as a value that represents
+a symbol: @code{string} for a string, @code{integer} for an integer,
+@code{process} for a process, etc. @xref{Type Predicates}. You can
+use @code{intern} and @code{eq} to compare against known type symbols,
+if your code needs to depend on the object type.
@end deftypefn
@anchor{intern}
@@ -1917,8 +1928,7 @@ calling the more powerful Emacs @code{intern} function
emacs_value fintern = env->intern (env, "intern");
emacs_value sym_name =
env->make_string (env, name_str, strlen (name_str));
-emacs_value intern_args[] = @{ sym_name, env->intern (env, "nil") @};
-emacs_value symbol = env->funcall (env, fintern, 2, intern_args);
+emacs_value symbol = env->funcall (env, fintern, 1, &sym_name);
@end example
@end deftypefn
@@ -2071,11 +2081,12 @@ One use of this function is when you want to re-throw a non-local exit
from one of the called @acronym{API} or Lisp functions.
@end deftypefn
-@deftypefn Function void non_local_exit_signal (emacs_env *@var{env}, emacs_value @var{error}, emacs_value @var{data})
-This function signals the error represented by @var{error} with the
-specified error data @var{data}. The module function should return
-soon after calling this function. This function could be useful,
-e.g., for signaling errors from module functions to Emacs.
+@deftypefn Function void non_local_exit_signal (emacs_env *@var{env}, emacs_value @var{symbol}, emacs_value @var{data})
+This function signals the error represented by the error symbol
+@var{symbol} with the specified error data @var{data}. The module
+function should return soon after calling this function. This
+function could be useful, e.g., for signaling errors from module
+functions to Emacs.
@end deftypefn
diff --git a/doc/lispref/loading.texi b/doc/lispref/loading.texi
index 3ba5fea4ca6..821e67e6df9 100644
--- a/doc/lispref/loading.texi
+++ b/doc/lispref/loading.texi
@@ -1170,10 +1170,13 @@ extension, a.k.a.@: ``suffix''. This suffix is platform-dependent.
@defvar module-file-suffix
This variable holds the system-dependent value of the file-name
-extension of the module files. Its value is @file{.so} on POSIX hosts
-and @file{.dll} on MS-Windows.
+extension of the module files. Its value is @file{.so} on POSIX
+hosts, @file{.dylib} on macOS, and @file{.dll} on MS-Windows.
@end defvar
+ On macOS, dynamic modules can also have the suffix @file{.so} in
+addition to @file{.dylib}.
+
@findex emacs_module_init
@vindex plugin_is_GPL_compatible
Every dynamic module should export a C-callable function named
diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi
index dde30ce67f7..2c2ef9747b4 100644
--- a/doc/lispref/minibuf.texi
+++ b/doc/lispref/minibuf.texi
@@ -645,6 +645,15 @@ A history list for variable-name arguments read by
@code{read-variable}.
@end defvar
+@defvar read-number-history
+A history list for numbers read by @code{read-number}.
+@end defvar
+
+@defvar goto-line-history
+A history list for arguments to @code{goto-line}. This variable is
+buffer local.
+@end defvar
+
@c Less common: coding-system-history, input-method-history,
@c command-history, grep-history, grep-find-history,
@c read-envvar-name-history, setenv-history, yes-or-no-p-history.
diff --git a/etc/NEWS b/etc/NEWS
index 0c055ca682b..5bd45d72da6 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -6,10 +6,10 @@ See the end of the file for license conditions.
Please send Emacs bug reports to 'bug-gnu-emacs@gnu.org'.
If possible, use 'M-x report-emacs-bug'.
-This file is about changes in Emacs version 27.
+This file is about changes in Emacs version 28.
See file HISTORY for a list of GNU Emacs versions and release dates.
-See files NEWS.26, NEWS.25, ..., NEWS.18, and NEWS.1-17 for changes
+See files NEWS.27, NEWS.26, ..., NEWS.18, and NEWS.1-17 for changes
in older Emacs versions.
You can narrow news to a specific version by calling 'view-emacs-news'
@@ -22,3573 +22,40 @@ When you add a new item, use the appropriate mark if you are sure it
applies, and please also update docstrings as needed.
-* Installation Changes in Emacs 27.1
-
----
-** Emacs now uses GMP, the GNU Multiple Precision library.
-By default, if 'configure' does not find a suitable libgmp, it
-arranges for the included mini-gmp library to be built and used.
-The new 'configure' option '--without-libgmp' uses mini-gmp even if a
-suitable libgmp is available.
-
----
-** Emacs can now use HarfBuzz as its shaping engine.
-The new configure option '--with-harfbuzz' adds support for the
-HarfBuzz text shaping engine. It is on by default; use './configure
---without-harfbuzz' to build without it. The HarfBuzz text shaping is
-available via new font backend drivers 'xfthb' and 'ftcrhb' for Xft
-and Cairo drawings, respectively, and via the 'harfbuzz' backend on
-MS-Windows. The Harfbuzz text shaping is preferred to the previously
-supported ones, so the font backends that use older shaping engines
-(FLT on GNU and Unix systems and Uniscribe on MS-Windows) are not
-enabled by default; they can be enabled via the 'font-backend' frame
-parameter or via X resources.
-
----
-** The new configure option '--with-json' adds native support for JSON.
-This uses the Jansson library. The option is on by default; use
-'./configure --with-json=no' to build without Jansson support. The
-new JSON functions 'json-serialize', 'json-insert',
-'json-parse-string', and 'json-parse-buffer' are typically much faster
-than their Lisp counterparts from json.el.
-
----
-** The configure option '--with-cairo' is no longer experimental.
-This builds Emacs with Cairo drawing, and supports built-in printing
-when Emacs is built with GTK+. Some severe bugs in this build were
-fixed, and we can therefore offer this to users without caveats.
-
-+++
-** Emacs now uses a "portable dumper" instead of unexec.
-This improves compatibility with memory allocation on modern systems,
-and in particular better supports the Address Space Layout
-Randomization (ASLR) feature, a security technique used by most modern
-operating systems.
-
-When built with the portable dumping support (which is the default),
-Emacs looks for the 'emacs.pdmp' file, generated during the build, in
-its data directory at startup, and loads the dumped state from there.
-The new command-line argument '--dump-file=FILE' allows to specify a
-non-default '.pdmp' file to load the state from; see the node "Initial
-Options" in the Emacs manual for more information.
-
-An Emacs started via a dump file can create a new dump file only if it
-was invoked with the '-batch' option. (This is a temporary
-limitation; we plan on lifting it in a future release.)
-
-Although the portable dumper has been tested, it may have a bug on
-unusual platforms. If you require traditional unexec dumping you can
-use the configure-time option '--with-dumping=unexec'; however, please
-file a bug report describing the situation, as unexec dumping is
-deprecated, and we plan on removing it in some future release.
-
----
-** The new configure option '--enable-checking=structs' attempts to
-check that the portable dumper code has been updated to match the last
-change to one of the data structures that it relies on.
-
----
-** The configure options '--enable-checking=conslist' and
-'--enable-checking=xmallocoverrun' have been withdrawn. The former
-made Emacs irredeemably slow, and the latter made it crash. Neither
-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.)
-
----
-** Emacs no longer defaults to using ImageMagick to display images.
-This is due to security and stability concerns with ImageMagick. 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'.
-
----
-** The 'etags' program now uses the C library's regular expression matcher.
-If it's possible, 'etags' will use the regexp matcher from the
-system's standard C library, otherwise it will be linked with a
-compatible regex substitute. This lets developers maintain Emacs's
-own regex code without having to also support other programs. The new
-configure option '--without-included-regex' forces 'etags' to use the C
-library's regex matcher even if the regex substitute ordinarily would
-be used to work around compatibility problems.
-
----
-** Emacs has been ported to the '-fcheck-pointer-bounds' option of GCC.
-This causes Emacs to check bounds of some arrays addressed by its
-internal pointers, which can be helpful when debugging the Emacs
-interpreter or modules that it uses. If your platform supports it you
-can enable it when configuring, e.g., './configure CFLAGS="-g3 -O2
--mmpx -fcheck-pointer-bounds"' on Intel MPX platforms.
-
----
-** Emacs now normally uses a C pointer type instead of a C integer
-type to implement Lisp_Object, which is the fundamental machine word
-type internal to the Emacs Lisp interpreter. This change aims to
-catch typos and supports '-fcheck-pointer-bounds'. The 'configure'
-option '--enable-check-lisp-object-type' is therefore no longer as
-useful and so is no longer enabled by default in developer builds,
-to reduce differences between developer and production builds.
-
----
-** 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.
-
----
-** New make target 'help' shows a summary of common make targets.
-
----
-** Emacs now builds with dynamic module support by default.
-Pass '--without-modules' to 'configure' to disable dynamic module
-support.
+* Installation Changes in Emacs 28.1
-* Startup Changes in Emacs 27.1
-
-+++
-** Emacs now uses the XDG convention for init files.
-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")
-specifies the parent directory of these and other configuration files,
-and will override their traditional locations (the home directory,
-"~/.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
-XDG_CONFIG_HOME='/nowhere' might be useful if your new-location init
-files are scrambled, or if you want to force Emacs to ignore files
-under XDG_CONFIG_HOME for some other reason.
-
-+++
-** Emacs can now be configured using an early init file.
-The file is called 'early-init.el', in 'user-emacs-directory'. It is
-loaded very early in the startup process: before graphical elements
-such as the tool bar are initialized, and before the package manager
-is initialized. The primary purpose is to allow customizing how the
-package system is initialized given that initialization now happens
-before loading the regular init file (see below).
-
-We recommend against putting any customizations in this file that
-don't need to be set up before initializing installed add-on packages,
-because the early init file is read too early into the startup
-process, and some important parts of the Emacs session, such as
-'window-system' and other GUI features, are not yet set up, which could
-make some customization fail to work.
-
-+++
-** Installed packages are now activated *before* loading the init file.
-As a result of this change, it is no longer necessary to call
-'package-initialize' in your init file.
-
-Previously, a call to 'package-initialize' was automatically inserted
-into the init file when Emacs was started. This call can now safely
-be removed. Alternatively, if you want to ensure that your init file
-is still compatible with earlier versions of Emacs, change it to:
-
-(when (< emacs-major-version 27)
- (package-initialize))
-
-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.
-Units that are ordered after 'emacs.service' will only be started
-after Emacs has finished initialization and is ready for use.
-(If your Emacs is installed in a non-standard location and you copied the
-emacs.service file to eg "~/.config/systemd/user/", you will need to copy
-the new version of the file again.)
+* Startup Changes in Emacs 28.1
-* Changes in Emacs 27.1
-
-+++
-** Emacs now supports resizing and rotating images without ImageMagick.
-All modern systems support this feature. (On GNU and Unix systems,
-Cairo drawing or the XRender extension to X11 is required for this to
-be available; the configure script will test for it and, if found,
-enable scaling.)
-
-The new function 'image-transforms-p' can be used to test whether any
-given frame supports these capabilities.
-
-+++
-** The Network Security Manager now allows more fine-grained control
-of what checks to run via the 'network-security-protocol-checks'
-user option.
-
-+++
-** TLS connections have their security tightened by default.
-Most of the checks for outdated, believed-to-be-weak TLS algorithms
-and ciphers are now switched on by default. (In addition, several new
-TLS weaknesses are now warned about.) By default, the NSM will
-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 user option to only happen on the 'high'
-security level (assuming you use the 'medium' level).
-
----
-** New user option 'nsm-trust-local-network'.
-Allows skipping Network Security Manager checks for hosts on your
-local subnet(s). It defaults to nil. Usually, there should be no
-need to set this non-nil, and doing that risks opening your local
-network connections to attacks. So be sure you know what you are
-doing before changing the value.
-
-+++
-** 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
-':client-certificate t' to trigger looking up of per-server
-certificates via 'auth-source'.
-
-+++
-** New user option 'network-stream-use-client-certificates'.
-When non-nil, 'open-network-stream' performs lookups of client
-certificates using 'auth-source' as if ':client-certificate t' were
-specified if there is no explicit ':client-certificate' parameter.
-Defaults to nil.
-
-+++
-** 'next/previous-multiframe-window' have been renamed.
-The new names are as follows:
-
- 'next-multiframe-window' -> 'next-window-any-frame'
- 'previous-multiframe-window' -> 'previous-window-any-frame'
-
-The old function names are maintained as aliases for backward
-compatibility.
-
-** emacsclient
-
-+++
-*** emacsclient now supports the 'EMACS_SOCKET_NAME' environment variable.
-The command-line argument '--socket-name' overrides it.
-(The same behavior as for the pre-existing 'EMACS_SERVER_FILE' variable.)
-
-+++
-*** Emacs and emacsclient now default to "$XDG_RUNTIME_DIR/emacs".
-This is used as the directory for client/server sockets, if Emacs is
-running on a platform or environment 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.
-
----
-*** When run by root, emacsclient no longer connects to non-root sockets.
-(Instead you can use Tramp methods to run root commands in a non-root Emacs.)
-
----
-** 'xft-ignore-color-fonts' now ignores even more color fonts.
-There are color fonts that managed to bypass the existing checks,
-causing XFT crashes, they are now filtered out. Setting
-'xft-ignore-color-fonts' to nil removes those checks, which might
-require setting 'face-ignored-fonts' to filter out problematic fonts.
-Known problematic fonts are "Noto Color Emoji" and "Emoji One".
-
-+++
-** New user option 'what-cursor-show-names'.
-When non-nil, 'what-cursor-position' will show the name of the character
-in addition to the decimal/hex/octal representation. Default nil.
-
-+++
-** New function 'network-lookup-address-info'.
-This does IPv4 and/or IPv6 address lookups on hostnames.
-
-+++
-** 'network-interface-list' can now return IPv4 and IPv6 addresses.
-IPv4 and IPv6 addresses are now returned by default if available,
-optionally including netmask/broadcast address information.
-
----
-** Control of the threshold for using the 'distant-foreground' color.
-The threshold for color distance below which the 'distant-foreground'
-color of the face will be used instead of the foreground color can now
-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-answer' now accepts not only single character
-answers, but also function keys like 'F1', character events such as
-'C-M-h', and control characters like 'C-h'.
-
-** 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 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 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'.
-This hook is a convenient place to perform initializations in daemon
-mode which require GUI features to be available. One example is
-restoration of the previous session using the desktop.el package: put
-the call to 'desktop-read' in this hook, if you want the GUI settings
-to be restored, or if desktop.el needs to interact with you during
-restoration of the session.
-
-+++
-** The functions 'set-frame-height' and 'set-frame-width' are now
-commands, and will set the currently selected frame to the height/
-width specified by the numeric prefix.
-
-+++
-** New function 'logcount' calculates an integer's Hamming weight.
-
-+++
-** New function 'libxml-available-p'.
-This function returns non-nil if libxml support is both compiled in
-and available at run time. Lisp programs should use this function to
-detect built-in libxml support, instead of testing for that
-indirectly, e.g., by checking that functions like
-'libxml-parse-html-region' return nil.
-
-+++
-** '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
-used to remove comments before calling the libxml functions to parse
-the data.
-
-+++
-** A new DOM (the XML/HTML document structure returned by functions
-such as 'libxml-parse-html-region') traversal function has been added:
-'dom-search', which takes a DOM and a predicate and returns all nodes
-that match.
-
-+++
-** New function 'fill-polish-nobreak-p', to be used in 'fill-nobreak-predicate'.
-It blocks line breaking after a one-letter word, also in the case when
-this word is preceded by a non-space, but non-alphanumeric character.
-
-+++
-** The limit on repetitions in regexps has been raised to 2^16-1.
-It was previously limited to 2^15-1. For example, the following
-regular expression was previously invalid, but is now accepted:
-
- x\{32768\}
-
----
-** The German prefix and postfix input methods now support Capital sharp S.
-
----
-** New input methods 'hawaiian-postfix' and 'hawaiian-prefix'.
-
----
-** New input methods 'georgian-qwerty' and 'georgian-nuskhuri'.
-
----
-** New input methods for several variants of the Sami language.
-The Sami input methods include: 'norwegian-sami-prefix',
-'bergsland-hasselbrink-sami-prefix', 'southern-sami-prefix',
-'ume-sami-prefix', 'northern-sami-prefix', 'inari-sami-prefix',
-'skolt-sami-prefix', and 'kildin-sami-prefix'.
-
-+++
-** Japanese environments use UTF-8 by default.
-In Japanese environments that do not specify encodings and are not
-based on MS-Windows, the default encoding is now utf-8 instead of
-japanese-iso-8bit.
-
-+++
-** New function 'exec-path'.
-This function by default returns the value of the corresponding
-user option, but can optionally return the equivalent of 'exec-path'
-from a remote host.
-
-+++
-** The function 'executable-find' supports an optional argument REMOTE.
-This triggers to search the program on the remote host as indicated by
-'default-directory'.
-
-+++
-** New user option 'auto-save-no-message'.
-When set to t, no message will be shown when auto-saving (default
-value: nil).
-
----
-** The value of 'make-cursor-line-fully-visible' can now be a function.
-In addition to nil or non-nil, the value can now be a predicate
-function. Follow mode uses this to control scrolling of its windows
-when the last screen line in a window is not fully visible.
-
-+++
-** New variable 'emacs-repository-branch'.
-It reports the git branch from which Emacs was built.
-
-+++
-** New user option 'switch-to-buffer-obey-display-actions'.
-When non-nil, 'switch-to-buffer' uses 'pop-to-buffer-same-window' that
-respects display actions specified by 'display-buffer-alist' and
-'display-buffer-overriding-action'.
-
-+++
-** The user option 'switch-to-visible-buffer' is now obsolete.
-Customize 'switch-to-prev-buffer-skip' instead.
-
-+++
-** New user option 'switch-to-prev-buffer-skip'.
-This user option allows to specify the set of buffers that may be
-shown by 'switch-to-prev-buffer' and 'switch-to-next-buffer' more
-stringently than the now obsolete 'switch-to-visible-buffer'.
-
-** New 'flex' completion style
-An implementation of popular "flex/fuzzy/scatter" completion which
-matches strings where the pattern appears as a subsequence. Put
-simply, makes "foo" complete to both "barfoo" and "frodo". Add 'flex'
-to 'completion-styles' or 'completion-category-overrides' to use it.
-
-** The 'completion-common-part' face is now visible by default.
-
-+++
-** New face attribute ':extend' to control face extension at EOL.
-The new face attribute ':extend' controls whether to use the face for
-displaying the empty space beyond end of line (EOL) till the edge of
-the window. By default, this attribute is non-nil only for a small
-number of faces, notably, 'region'; any other face that crosses end of
-line will not affect the display of the empty space at EOL. This is
-to make Emacs behave more like other GUI applications with respect to
-displaying faces that cross line boundaries.
-
-This attribute behaves specially when theme definitions are applied:
-if the theme doesn't specify an explicit value of this attribute for a
-face, the value from the original face definition is inherited.
-Consequently, a theme generally shouldn't specify this attribute
-unless it has a good reason to do so.
-
-** Connection-local variables
-
-+++
-*** Connection-local variables are applied by default like file-local
-and directory-local variables.
-
-+++
-*** The macro 'with-connection-local-variables' has been renamed from
-'with-connection-local-profiles'. No argument PROFILES needed any longer.
-
----
-** New user option 'next-error-verbose' controls when 'next-error'
-outputs a message about the error locus.
-
----
-** New user option 'grep-search-path' defines the directories searched for
-grep hits (this used to be controlled by 'compilation-search-path').
-
----
-** 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').
-
----
-** 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 user options '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".
-
-+++
-** 'progress-reporter-update' accepts a suffix string to display.
-
----
-** New user option 'xref-file-name-display' controls the display of
-file names in xref buffers.
-
-** New user option 'byte-count-to-string-function'.
-It is used for displaying file sizes and disk space in some cases.
-
-+++
-** Emacs now interprets RGB triplets like HTML, SVG, and CSS do.
-
-The X convention previously used differed slightly, particularly for
-RGB triplets with a single hexadecimal digit per component.
-
----
-** The toolbar now shows the equivalent key binding in its tooltips.
-
----
-** The File menu-bar menu was re-arranged: Print menu items moved to
-submenu, and also added the new entries for tabs.
-
----
-** 'scroll-lock-mode' is now bound to the 'Scroll_Lock' key globally.
-Note that this key binding will not work on MS-Windows systems if
-'w32-scroll-lock-modifier' is non-nil.
-
----
-** 'global-set-key', called interactively, now no longer downcases a
-key binding with an upper case letter - if you can type it, you can
-bind it.
-
-+++
-** 'read-from-minibuffer' now works with buffer-local history variables.
-The HIST argument of 'read-from-minibuffer' now works correctly with
-buffer-local variables. This means that different buffers can have
-their own separated input history list if desired.
-
-** 'backup-by-copying-when-privileged-mismatch' applies to file gid, too.
-In addition to checking the file owner uid, Emacs also checks that the
-group gid is not greater than 'backup-by-copying-when-privileged-mismatch';
-if so, 'backup-by-copying-when-mismatch' will be forced on.
+* Changes in Emacs 28.1
-* Editing Changes in Emacs 27.1
-
-+++
-** When asked to visit a large file, Emacs now offers visiting it literally.
-Previously, Emacs would only ask for confirmation before visiting
-large files. Now it also offers a third alternative: to visit the
-file literally, as in 'find-file-literally', which speeds up
-navigation and editing of large files.
-
-+++
-** 'zap-to-char' now uses history of characters you used to zap to.
-'zap-to-char' uses the new 'read-char-from-minibuffer' function to allow
-navigating through the history of characters that have been input.
-This is mostly useful for characters that have complex input methods
-where inputting the character again may involve many keystrokes.
-
-+++
-** 'save-some-buffers' now has a new action in the prompt: 'C-f' will
-exit the command and switch to the buffer currently being asked about.
-
----
-** More commands support noncontiguous rectangular regions, namely
-'upcase-dwim', 'downcase-dwim', 'capitalize-dwim', 'capitalize-region',
-'upcase-initials-region', 'replace-string', 'replace-regexp', and
-'delimit-columns-region'.
-
-+++
-** The new 'amalgamating-undo-limit' variable can be used to control
-how many changes should be amalgamated when using the 'undo' command.
-
----
-** The 'newline-and-indent' command (commonly bound to 'RET' in many
-modes) now takes an optional numeric argument to specify how many
-times is should insert newlines (and indent).
-
-+++
-** New command 'make-empty-file'.
-
----
-** New variable 'x-wait-for-event-timeout'.
-This controls how long Emacs will wait for updates to the graphical
-state to take effect (making a frame visible, for example).
-
-+++
-** New user option 'electric-quote-replace-double'.
-This option controls whether '"' is replaced in 'electric-quote-mode',
-in addition to other quote characters. If non-nil, ASCII double-quote
-characters that quote text "like this" are replaced by double
-typographic quotes, “like this”, in text modes, and in comments in
-non-text modes.
-
----
-** New user option 'flyspell-case-fold-duplications'.
-This option controls whether Flyspell mode considers consecutive words
-to be duplicates if they are not in the same case. If non-nil, the
-default, words are considered to be duplicates even if their letters'
-case does not match.
-
----
-** 'write-abbrev-file' now includes special properties.
-'write-abbrev-file' now writes special properties like ':case-fixed'
-for abbrevs that have them.
-
-+++
-** 'write-abbrev-file' skips empty tables.
-'write-abbrev-file' now skips inserting a 'define-abbrev-table' form for
-tables which do not have any non-system abbrevs to save.
-
-+++
-** The new functions and commands 'text-property-search-forward' and
-'text-property-search-backward' have been added. These provide an
-interface that's more like functions like 'search-forward'.
-
----
-** 'add-dir-local-variable' now uses dotted pair notation syntax to
-write alists of variables to ".dir-locals.el". This is the same
-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.
-'make-network-process' now uses the correct loopback address when
-asked to use ':host 'local' and ':family 'ipv6'.
-
-+++
-** 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').
-
-+++
-** The command 'replace-buffer-contents' now has two optional
-arguments mitigating performance issues when operating on huge
-buffers.
-
-+++
-** Dragging 'C-M-mouse-1' now marks rectangular regions.
-
-+++
-** 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.
-
-+++
-** You can now change the font size with the mouse wheel.
-Scroling the mouse wheel with the Ctrl key pressed will now act the
-same as the 'C-x C-+' and 'C-x C--' commands.
+* Editing Changes in Emacs 28.1
-* Changes in Specialized Modes and Packages in Emacs 27.1
-
----
-** New HTML mode skeleton 'html-id-anchor'.
-This new command (which inserts an <a id="foo">_</a> skeleton) is
-bound to 'C-c C-c #'.
-
-+++
-** New command 'font-lock-refontify'.
-This is an interactive convenience function to be used when developing
-font locking for a mode. It recomputes the font locking data and then
-re-fontifies the buffer.
-
----
-** Font Lock is smarter about fontifying unterminated strings and comments.
-When you type a quote that starts a string, or a comment delimiter
-that starts a comment, font-lock will not immediately refontify the
-following characters in 'font-lock-string-face' or
-'font-lock-comment-face'. Instead, it will delay the fontification
-beyond the current line to give you a chance to close the string or
-comment. This is controlled by the new user option
-'jit-lock-antiblink-grace', which specifies the delay in seconds. The
-default is 2 seconds; set to nil to get back the old behavior.
-
----
-** The 'C' command in 'tar-mode' will now preserve the timestamp of
-the extracted file if the new user option 'tar-copy-preserve-time' is
-non-nil.
-
----
-** 'autoconf-mode' is now used instead of 'm4-mode' for the
-acinclude.m4/aclocal.m4/acsite.m4 files.
-
----
-** On GNU/Linux, 'M-x battery' will now list all batteries, no matter
-what they're named, and the 'battery-linux-sysfs-regexp' variable has
-been removed.
-
-** The 'list-processes' command now includes port numbers in the
-network connection information (in addition to the host name).
-
-** The 'cl' package is now officially deprecated in favor of 'cl-lib'.
-
----
-** desktop
-*** When called interactively with a prefix arg 'C-u', 'desktop-read'
-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 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
-an offset to absolute line numbers.
-
-+++
-** winner
-*** A new user option, 'winner-boring-buffers-regexp', has been added.
-
-** table
-** 'table-generate-source' and friends now support outputting wiki and
-mediawiki format tables.
-
----
-** telnet-mode
-*** Reverting a buffer in 'telnet-mode' will restart a closed connection.
-
-** goto-addr
-*** A way to more conveniently specify what URI address schemes that
-should be ignored have been added via the
-'goto-address-uri-schemes-ignored' variable.
-
-+++
-** tex-mode
-*** 'latex-noindent-commands' controls indentation of certain commands.
-You can use this new user option to control indentation of arguments of
-\emph, \footnote, and similar commands.
-
-** byte compiler
-*** 'byte-compile-dynamic' is now obsolete.
-This is because on the one hand it suffers from misbehavior in corner
-cases that have plagued it for years, and on the other experiments indicated
-that it doesn't bring any measurable benefit.
-
----
-*** The 'g' keystroke in *Compile-Log* buffers has been bound to a new
-command that will recompile the file previously compiled with 'M-x
-byte-compile-file' and the like.
-
-** compile.el
----
-*** In 'compilation-error-regexp-alist', 'line' (and 'end-line') can
-be functions.
-+++
-*** 'compilation-context-lines' can now take the value t; this is like
-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' user option can
-be used to transform file name matches compilation output, and remove
-known false positives being recognized as warnings/errors.
-
-** cl-lib.el
-+++
-*** 'cl-defstruct' has a new ':noinline' argument to prevent inlining
-its functions.
-
-+++
-*** 'cl-defstruct' slots accept a ':documentation' property.
-
----
-*** 'cl-values-list' will now signal an error if its argument isn't a list.
-
-** doc-view.el
-*** New commands 'doc-view-presentation' and 'doc-view-fit-window-to-page'.
-*** Added support for password-protected PDF files
-
-*** 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
-names match certain regular expressions as big. Ido won't attempt to
-list the contents of such directories when completing file names.
-
-** Minibuffer
-
-+++
-*** 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).
-
-+++
-*** When the minibuffer is active, echo-area messages are displayed at
-the end of the minibuffer instead of hiding the minibuffer by the echo
-area display. The new user option 'minibuffer-message-clear-timeout'
-controls how messages displayed in this situation are removed from the
-minibuffer.
-
----
-*** Minibuffer now uses 'minibuffer-message' to display error messages
-at the end of the active minibuffer.
-
-+++
-*** 'y-or-n-p' now uses the minibuffer to read 'y' or 'n' answer.
-
----
-*** Some commands that previously used 'read-char-choice' now read
-a character using the minibuffer by 'read-char-from-minibuffer'.
-
-** map.el
-*** Now also understands plists.
-*** Now defined via generic functions that can be extended via 'cl-defmethod'.
-*** Deprecate the 'map-put' macro in favor of a new 'map-put!' function.
-*** 'map-contains-key' now returns a boolean rather than the key.
-*** Deprecate the 'testfn' args of 'map-elt' and 'map-contains-key'.
-*** New generic function 'map-insert'.
-
-+++
-*** The 'type' arg can be a list '(hash-table :key1 VAL1 :key2 VAL2 ...)'.
-
-** seq.el
-New convenience functions 'seq-first' and 'seq-rest' give easy access
-to respectively the first and all but the first elements of sequences.
-
-The new predicate function 'seq-contains-p' should be used instead of
-the now obsolete 'seq-contains'.
-
----
-** Follow mode
-In the current follow group of windows, "ghost" cursors are no longer
-displayed in the non-selected follow windows. To get the old behavior
-back, customize 'follow-hide-ghost-cursors' to nil.
-
-+++
-** New variable 'warning-fill-column' for 'display-warning'.
-
-** Windmove
-
----
-*** 'windmove-create-window' when non-nil makes a new window.
-This happens upon moving off the edge of the frame.
-
----
-*** Windmove supports directional window display and selection.
-The new command 'windmove-display-default-keybindings' binds default
-keys with provided modifiers (by default, Shift-Meta) to the commands
-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,
-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. 'S-M-t C-h C-n'
-displays NEWS in a new tab.
-
----
-*** Windmove also supports directional window deletion.
-The new command 'windmove-delete-default-keybindings' binds default
-keys with provided prefix (by default, 'C-x') and modifiers (by default,
-'Shift') to the commands that delete the window in the specified
-direction. For example, 'C-x S-down' deletes the window below.
-With a prefix arg 'C-u', also kills the buffer in that window.
-With 'M-0', deletes the selected window and selects the window
-that was in the specified direction.
-
----
-*** New command 'windmove-swap-states-in-direction' binds default keys
-to the commands that swap the states of the selected window with the
-window in the specified direction.
-
----
-*** Windmove code no longer used is now obsolete.
-That includes the user option 'windmove-window-distance-delta' and the
-functions 'windmove-coord-add', 'windmove-constrain-to-range',
-'windmove-constrain-around-range', 'windmove-frame-edges',
-'windmove-constrain-loc-for-movement', 'windmove-wrap-loc-for-movement',
-'windmove-reference-loc' and 'windmove-other-window-loc'.
-
-** Octave mode
-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 user option 'project-read-file-name-function'.
-
-** Etags
-
-+++
-*** 'next-file' is now an obsolete alias of 'tags-next-file'.
-
----
-*** 'tags-loop-revert-buffers' is an obsolete alias of
-'fileloop-revert-buffers'.
-
-+++
-*** The 'tags-loop-continue' function along with the
-'tags-loop-operate' and 'tags-loop-scan' variables are now obsolete;
-use the new 'fileloop-initialize' and 'fileloop-continue' functions
-instead.
-
-+++
-*** etags is now able to read Zstandard-compressed files.
-
-** bibtex
-
----
-*** New commands 'bibtex-next-entry' and 'bibtex-previous-entry'.
-In 'bibtex-mode-map', 'forward-paragraph' and 'backward-paragraph' are
-remapped to these, respectively.
-
-** Dired
-
----
-*** On systems that support suid/guid files, Dired now fontifies the
-permissions of such files with a special face 'dired-set-id'.
-
-+++
-*** New command 'dired-create-empty-file'.
-
-+++
-*** New command 'dired-number-of-marked-files'.
-It is by default bound to '* N'.
-
----
-*** The marking commands now report how many files were marked by the
-command itself, not how many files are marked in total.
-
----
-*** A new face, 'dired-special', is used to highlight sockets, named
-pipes, block devices and character devices.
-
-+++
-*** The new user option 'dired-create-destination-dirs' controls whether
-'dired-do-copy' and 'dired-rename-file' should create non-existent
-directories in the destination.
-
-+++
-*** 'dired-dwim-target' can be customized to prefer either the next window,
-or one of the most recently visited windows with a Dired buffer.
-
-+++
-*** When the new user option 'dired-vc-rename-file' is non-nil,
-Dired performs file renaming using underlying version control system.
-
----
-*** Zstandard compression is now supported for 'dired-do-compress' and
-'dired-do-compress-to'.
-
-** Find-Dired
-
----
-*** New user option 'find-dired-refine-function'.
-The default value is 'find-dired-sort-by-filename'.
-
----
-*** New sorting options for the user option 'find-ls-option'.
-
-** Change Logs and VC
-
----
-*** New user option 'vc-tor'.
-When non-nil, this user option causes the VC commands to communicate
-with the repository via Tor's proxy, using the 'torsocks' wrapper
-script. The default is nil.
-
-+++
-*** New command 'log-edit-generate-changelog-from-diff', bound to 'C-c C-w'.
-This generates ChangeLog entries from the VC fileset diff.
-
----
-*** 'vc-dir' now shows a button allowing you to hide the stash list.
-Controlled by user option 'vc-git-show-stash'. Default t means show
-the entire list as before. An integer value limits the list length
-(but still allows you to show the entire list via the button).
-
-+++
-*** Recording ChangeLog entries doesn't require an actual file.
-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 user option to nil to get the
-previous behavior of always creating a buffer that visits a ChangeLog
-file.
-
----
-*** 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.
-
----
-*** 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.
-When some files are marked, only those are stashed.
-When no files are marked, all modified files are stashed, as before.
-
----
-*** 'vc-git-stash' is now bound to 'C' in the stash headers.
-
---
-*** Some stash keybindings are now available in the stash button.
-'vc-git-stash' and 'vc-git-stash-snapshot' can now be run using 'C'
-and 'S' respectively, including when there are no stashes.
-
----
-*** The new hook 'vc-retrieve-tag-hook' runs after retrieving a tag.
-
----
-*** 'vc-hg' now invokes 'smerge-mode' when visiting files.
-Code that attempted to invoke 'smerge-mode' when visiting an Hg file
-with conflicts existed in earlier versions of Emacs, but incorrectly
-never detected a conflict due to invalid assumptions about cached
-values.
-
-+++
-*** The Hg (Mercurial) back-end now supports 'vc-region-history'.
-The 'C-x v h' command now works in buffers that visit files controlled
-by Hg.
-
-+++
-*** The Hg (Mercurial) back-end now prompts for revision to merge when
-you invoke 'C-x v m' ('vc-merge').
-
----
-*** The Hg (Mercurial) back-end now use tags, branches and bookmarks
-instead of revision numbers as completion candidates when it prompts
-for a revision.
-
-+++
-*** 'C-u C-x v D' ('vc-root-version-diff') prompts for two revisions
-and compares their entire trees.
-
-*** New user option 'vc-hg-revert-switches'.
-It specifies switches to pass to Hg's 'revert' command.
-
-*** '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
-given revisions.
-
-+++
-*** The new 'd' command ('vc-dir-clean-files') in 'vc-dir-mode'
-buffers will delete the marked files (or if no files are marked, the
-file under point). This command does not notify the VC backend, and
-is mostly useful for unregistered files.
-
-+++
-*** New command 'vc-log-search' asks for a pattern, searches it
-in the revision log, and displays matched log entries in the
-log buffer. For example, 'M-x vc-log-search RET bug#36644 RET'
-displays all entries whose log messages match the bug number.
-With a prefix argument asks for a command, so for example,
-'C-u M-x vc-log-search RET git log -1 f302475 RET' will display
-just one log entry found by its revision number.
-
-+++
-*** It is now possible to display a specific revision given by its ID.
-If you invoke 'C-x v L' ('vc-print-root-log') with a numeric argument
-of 1, as in 'C-1 C-x v L' or 'C-u 1 C-x v L', it asks for a revision
-ID, and shows its log entry together with the diffs introduced by the
-revision's commit. (For some less capable VCSes, only the log entry
-is shown.)
-
----
-*** 'C-x v =' can now mimic Magit's diff format.
-Set the new user option 'diff-font-lock-prettify' to t for that, see
-below under "Diff mode".
-
----
-*** The 'diff' function arguments OLD and NEW may each be a buffer
-rather than a file, in non-interactive calls. This change was made in
-Emacs 24.1, but wasn't documented until now.
-
-+++
-*** New command 'diff-buffers' interactively diffs two buffers.
-
-** Diff mode
-+++
-*** Hunks are now automatically refined by font-lock.
-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
-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 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.
-On GUI frames, this option also displays the insertion and deletion
-indicators on the left fringe.
-
-+++
-*** Prefix arg of 'diff-goto-source' means jump to the old revision
-of the file under version control if point is on an old changed line,
-or to the new revision of the file otherwise.
-
-** Texinfo
-
-+++
-*** 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'.
-
-** Browse-url
-
----
-*** The function 'browse-url-emacs' can now visit a URL in selected window.
-It now treats the optional 2nd argument to mean that the URL should be
-shown in the currently selected window.
-
----
-*** A new function, 'browse-url-add-buttons' can be used to add clickable
-links to most ordinary special-mode buffers that display text that
-have URLs embedded. 'browse-url-button-regexp' controls what's
-considered a button.
-
----
-*** New user option 'browse-url-secondary-browser-function'.
-It can be set to a function that invokes an alternative browser.
-
-** Comint
-
-+++
-*** 'send-invisible' is now an obsolete alias for 'comint-send-invisible'.
-Also, 'shell-strip-ctrl-m' is declared obsolete.
-
-+++
-*** 'C-c .' ('comint-insert-previous-argument') no longer interprets '&'.
-This feature caused problems when '&&' was present in the previous
-command. Since this command emulates 'M-.' in Bash and zsh, neither
-of which treats '&' specially, the feature was removed for
-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 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
-from the beginning of the arguments, while the latter counts from the
-end.
-
-+++
-*** 'comint-run' can now accept a list of switches to pass to the program.
-'C-u M-x comint-run' will prompt for the switches interactively.
-
-+++
-*** Abnormal hook 'comint-password-function' has been added.
-This hook permits a derived mode to supply a password for the
-underlying command interpreter without prompting the user. For
-example, in 'sql-mode', the password for connecting to the database may
-be stored in the connection wallet and may be passed on the command
-line to start the SQL interpreter. This is a potential security flaw
-that could expose user's database passwords on the command line
-through the use of a process list (Bug#8427). With this hook, it is
-possible to not pass the password on the command line and wait for the
-program to prompt for the password. When it does so, the password can
-be supplied to the SQL interpreter without involving the user just as
-if it had been supplied on the command line.
-
-** 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
-sparse and rules for formatting are fairly well established. Instead
-SQL is more like COBOL (from which it came) and code tends to be very
-dense and line ending decisions driven by syntax and line length
-considerations to make readable code. Experienced SQL developers may
-prefer to rely upon existing Emacs facilities for formatting code but
-the 'sql-indent' package provides facilities to aid more casual SQL
-developers layout queries and complex expressions.
-
----
-**** 'sql-use-indent-support' (default t) enables SQL indention support.
-The 'sql-indent' package from ELPA must be installed to get the
-indentation support in 'sql-mode' and 'sql-interactive-mode'.
-
----
-**** 'sql-mode-hook' and 'sql-interactive-mode-hook' changed.
-Both hook variables have had 'sql-indent-enable' added to their
-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,
-like 'sql-mysql' or 'my-postgres', the password wallet will be
-searched for the password. The 'sql-product', 'sql-server',
-'sql-database', and the 'sql-username' will be used to identify the
-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
-formats. By default, the wallet file is expected to be in the
-'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.
-
-** Term
-
----
-*** 'term-read-noecho' is now obsolete, use 'read-passwd' instead.
-
-+++
-*** 'serial-term' now takes an optional parameter to leave the
-emulator in line mode.
-
-** Flymake
-
-+++
-*** The variable 'flymake-diagnostic-types-alist' is obsolete.
-You should instead set properties on known diagnostic symbols, like
-':error' and ':warning', as demonstrated in the Flymake manual.
-
-+++
-*** 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.
-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
-it can't find the config file.
-
----
-*** Rubocop is called with 'bundle exec' if Gemfile mentions it.
-
----
-*** New command 'ruby-find-library-file' bound to 'C-c C-f'.
-
-** Package
-
----
-*** Warn if "footer line" is missing, but still install package.
-package.el used to refuse to install a package without the so-called
-"footer line", which appears at the very end of the file:
-
-;;; FILENAME ends here
-
-package.el will now install packages without this line, but it will
-issue a warning. To avoid this warning, packages should keep the
-"footer line".
-
-Note that versions of Emacs older than 27.1 will not only refuse to
-install packages without such a line -- they will be unable to parse
-package data. It is therefore recommended to keep this line.
-
-+++
-*** 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.
-
-+++
-*** The meaning of 'allow-unsigned' in 'package-check-signature' has
-changed slightly: If a usable OpenPGP configuration can't be found
-(for instance, if gpg isn't installed), it now has the same meaning as
-nil.
-
----
-*** 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 user options 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'.
-
-+++
-*** New functions for filtering packages list.
-A new function has been added which allows users to filter the
-packages list by name: 'package-menu-filter-by-name'. By default, it
-is bound to '/ n'. Additionally, the function
-'package-menu-filter-by-keyword' has been renamed from
-'package-menu-filter'. Its keybinding has also been changed to '/ k'
-(from 'f'). To clear any of the two filters, the user can now call
-the 'package-menu-clear-filter' function, bound to '/ /' by default.
-
----
-*** Imenu support has been added to 'package-menu-mode'.
-
----
-*** The package list can now be sorted by version or description.
-
-+++
-*** In Package Menu, 'g' now updates package data from archives.
-Previously, 'g' invoked 'tabulated-list-revert' which did not update
-the cached archive data. It is now bound to 'revert-buffer', which
-will update the data.
-
-'package-menu-refresh' is an obsolete alias for 'revert-buffer'.
-
-** Info
-
-+++
-*** Clicking on the left/right arrow icon in the Info tool-bar while
-holding down the Ctrl key pops up a menu of previously visited Info nodes
-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.
-
----
-** Display of man pages now limits the width for formatting pages.
-The new user option 'Man-width-max' (80 by default) limits the number
-of columns passed to the 'man' program for formatting man pages. This
-is to enhance readability when man pages are displayed in very wide
-windows (which are customary with today's large displays).
-
-** Xref
-
-+++
-*** New command 'xref-find-definitions-at-mouse'.
-This command finds definitions of the identifier at the place of a
-mouse click event, and is intended to be bound to a mouse event.
-
-+++
-*** Changing 'xref-marker-ring-length' works after 'xref.el' is loaded.
-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.
-
----
-*** New xref faces 'xref-file-header', 'xref-line-number', 'xref-match'.
-
----
-*** 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.
-
----
-*** Search results show the buffer even for one hit.
-The search-type Xref commands (e.g. 'xref-find-references' or
-'project-find-regexp') now show the results buffer even when there is
-only one hit. This can be altered by changing
-'xref-show-xrefs-function'.
-
-+++
-*** Xref buffers support refreshing the search results.
-A new command 'xref-revert-buffer' is bound to 'g'.
-
----
-*** Imenu support has been added to 'xref--xref-buffer-mode'.
-
-** Icomplete
-
-+++
-*** New minor mode Fido mode.
-This mode is based on Icomplete, and its name stands for "Fake Ido".
-The point of this mode is to be an 'ido-mode' workalike, but provide
-most of the functionality present in Icomplete that is not in
-'ido-mode', while being much more compatible with all of Emacs's
-completion facilities.
-
-** Ecomplete
-
----
-*** The ecomplete sorting has changed to a decay-based algorithm.
-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".
-
-** Gnus
-
----
-*** 'mm-uu-diff-groups-regexp' now defaults to matching all groups,
-which means that "git am" diffs are recognized everywhere.
-
-+++
-*** 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
-the previous unseen or next unseen article. (These are the ones that
-are marked with "." in the summary mode lines.)
-
-+++
-*** The Gnus user variable 'nnimap-expunge' supports three new values:
-'never' for never expunging messages, 'immediately' for immediately
-expunging deleted messages, and 'on-exit' to expunge deleted articles
-when exiting the group's summary buffer. Setting 'nnimap-expunge' to
-'nil' or 't' is still supported but not recommended, since it may
-result in Gnus expunging all messages that have been flagged as
-deleted by any IMAP client (rather than just those that have been
-deleted by Gnus).
-
-+++
-*** New user option 'gnus-use-atomic-windows' makes Gnus window layouts atomic.
-See the "Atomic Windows" section of the Elisp manual for details.
-
-+++
-*** There's a new value for 'gnus-article-date-headers',
-'combined-local-lapsed', which will show both the time (in the local
-timezone) and the lapsed time.
-
----
-*** Gnus now maps imaps to 993 only on old MS-Windows versions.
-The nnimap backend used to do this unconditionally to work around
-problems on old versions of MS-Windows. This is now done only for
-Windows XP and older.
-
-+++
-*** The nnimap backend now has support for IMAP namespaces.
-This feature can be enabled by setting the new 'nnimap-use-namespaces'
-server variable to non-nil.
-
-+++
-*** A prefix argument to 'gnus-summary-limit-to-score' will limit reverse.
-Limit to articles with score at below.
-
----
-*** The function 'gnus-score-find-favorite-words' has been renamed
-from 'gnus-score-find-favourite-words'.
-
----
-*** Gmane has been removed as an nnir backend, since Gmane no longer
-has a search engine.
-
-+++
-*** Splitting mail on common mailing list headers has been added.
-See the concept index in the Gnus manual for the 'match-list' entry.
-
-+++
-*** nil is no longer an allowed value for 'mm-text-html-renderer'.
-
-+++
-The default value of 'mm-inline-large-images' has changed from nil to
-'resize', which means that large images will be resized instead of
-displayed with an external program by default.
-
-+++
-*** A new Gnus summary mode command, 'S A'
-('gnus-summary-attach-article') can be used to attach the current
-article(s) to a pre-existing Message buffer, or create a new Message
-buffer with the article(s) attached.
-
-+++
-*** A new Gnus summary mode command, 'w'
-('gnus-summary-browse-url') scans the article buffer for URLs, and
-offers them to the user to open with 'browse-url'.
-
----
-*** 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'.
-
----
-*** The buttons in the Gnus article buffer were formerly widgets
-(i.e., buttons from widget.el). This has now changed, and they are
-now buttons (from button.el), and commands like 'TAB' now search for
-buttons instead of widgets. There should be no user-visible changes,
-but out-of-tree code that relied on widgets being present might now
-fail.
-
-** erc
-
----
-*** New hook 'erc-insert-done-hook'.
-This hook is called after strings have been inserted into the buffer,
-and is free to alter point and window configurations, as it's not
-called from inside a 'save-excursion', as opposed to
-'erc-insert-post-hook'.
-
----
-*** 'erc-button-google-url' has been renamed to 'erc-button-search-url'
-and its value has been changed to Duck Duck Go.
-
----
-*** 'erc-send-pre-hook' and 'erc-send-this' have been obsoleted.
-The user option to use instead to alter text to be sent is now
-'erc-pre-send-functions'.
-
-** EUDC
-
----
-*** XEmacs support has been removed.
-
-** eww/shr
-
-+++
-*** 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.
-
-+++
-*** The 'eww' command can now create a new EWW buffer.
-Invoking the command with a prefix argument will cause it to create a
-new EWW buffer for the URL instead of reusing the default one.
-
-+++
-*** Clicking with the Ctrl key or 'C-u RET' on a link opens a new tab
-when tab-bar-mode is enabled.
-
-+++
-*** The 'd' ('eww-download') command now falls back to current page's URL.
-If this command is invoked with no URL at point, it now downloads the
-current page instead of signaling an error.
-
-*** When opening external links in eww/shr (typically with the
-'C-u RET' keystroke on a link), the link will be flashed with the new
-'shr-selected-link' face to give the user feedback that the command
-has been executed.
-
-+++
-*** 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.
-
-+++
-*** 'shr-external-browser' has been made into an obsolete alias
-of 'browse-url-secondary-browser-function'.
-
----
-*** 'shr-tag-ol' now respects the ordered list 'start' attribute.
-
----
-*** The following tags are now handled: '<code>', '<abbr>', and '<acronym>'.
-
-** Htmlfontify
-
-+++
-*** The functions 'hfy-color', 'hfy-color-vals' and
-'hfy-fallback-color-values' and the variables 'hfy-fallback-color-map'
-and 'hfy-rgb-txt-color-map' have been renamed from names that used
-'colour' instead of 'color'.
-
-+++
-** Enriched mode supports the 'charset' text property.
-You can add or modify the 'charset' text properties of text using the
-'Edit->Text Properties->Special Properties' menu, or by invoking the
-'facemenu-set-charset' command. Documents in Enriched mode will be
-saved with the charset properties, and those properties will be
-restored when the file is visited.
-
-** Smtpmail
-
----
-*** Authentication mechanisms can be added via external packages, by
-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' 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'
-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 user option 'footnote-align-to-fn-text'.
-
-** CSS mode
-
----
-*** A new command 'css-cycle-color-format' for cycling between color
-formats (e.g. "black" => "#000000" => "rgb(0, 0, 0)") has been added,
-bound to 'C-c C-f'.
-
----
-*** CSS mode, SCSS mode, and Less CSS mode now have support for Imenu.
-
-** SGML mode
-
----
-*** 'sgml-quote' now handles double quotes and apostrophes
-when escaping text and in addition all numeric entities when
-unescaping text.
-
-** Python mode
-
----
-*** Python mode supports three different font lock decoration levels.
-The maximum level is used by default; customize
-'font-lock-maximum-decoration' to tone down the decoration.
-
----
-*** New user option 'python-pdbtrack-kill-buffers'.
-If non-nil, the default, buffers opened during pdbtracking session are
-killed when pdbtracking session is finished.
-
----
-*** New function 'python-shell-send-region'.
-It sends the statement delimited by 'python-nav-beginning-of-statement'
-and 'python-nav-end-of-statement' to the inferior Python process.
-
-** Help
-
----
-*** Descriptions of variables and functions give an estimated first release
-where the variable or function appeared in Emacs.
-
----
-*** Output format of 'C-h l' ('view-lossage') has changed.
-For convenience, 'view-lossage' now displays the last keystrokes
-and commands in the same format as the edit buffer of
-'edit-last-kbd-macro'. This makes it possible to copy the lines from
-the buffer generated by 'view-lossage' to the "*Edit Macro*" buffer
-created by 'edit-last-kbd-macro', and to save the macro by 'C-c C-c'.
-
----
-*** The list of help commands produced by 'C-h C-h' ('help-for-help')
-can now be searched via 'C-s'.
-
-** Ibuffer
-
----
-*** New filter 'ibuffer-filter-by-process'; bound to '/ E'.
-
----
-*** All mode filters can now accept a list of symbols.
-This means you can now easily filter several major modes, as well
-as a single mode.
-
-** Search and Replace
-
-+++
-*** Isearch supports a prefix argument for 'C-s' ('isearch-repeat-forward')
-and 'C-r' ('isearch-repeat-backward'). With a prefix argument, these
-commands repeat the search for the specified occurrence of the search string.
-A negative argument repeats the search in the opposite direction.
-This makes possible also to use a prefix argument for 'M-s .'
-('isearch-forward-symbol-at-point') to find the next Nth symbol.
-Also a prefix argument is supported for 'isearch-yank-until-char',
-'isearch-yank-word-or-char', 'isearch-yank-symbol-or-char'.
-
-+++
-*** To go to the first/last occurrence of the current search string
-is possible now with new commands 'isearch-beginning-of-buffer' and
-'isearch-end-of-buffer' bound to 'M-s M-<' and 'M-s M->' in Isearch.
-With a numeric argument, they go to the Nth absolute occurrence
-counting from the beginning/end of the buffer. This complements
-'C-s'/'C-r' that searches for the next Nth relative occurrence
-with a numeric argument.
-
-+++
-*** 'isearch-lazy-count' shows the current match number and total number
-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.
-
----
-*** 'lazy-highlight-buffer' highlights matches in the full buffer.
-It is useful in combination with 'lazy-highlight-cleanup' customized to nil
-to leave matches highlighted in the whole buffer after exiting isearch.
-Also when 'lazy-highlight-buffer' prepares highlighting in the buffer,
-navigation through the matches without flickering is more smooth.
-'lazy-highlight-buffer-max-at-a-time' controls the number of matches to
-highlight in one iteration while processing the full buffer.
-
-+++
-*** New isearch bindings.
-
-'C-M-z' invokes new function 'isearch-yank-until-char', which yanks
-everything from point up to but not including the specified
-character into the search string. This is especially useful for
-keyboard macros.
-
-'C-M-w' in isearch changed from 'isearch-del-char' to the new function
-'isearch-yank-symbol-or-char'. 'isearch-del-char' is now bound to
-'C-M-d'.
-
-+++
-'M-s h l' invokes 'highlight-lines-matching-regexp' using the search
-string to highlight lines matching the search string. This is similar
-to the existing binding 'M-s h r' ('highlight-regexp') that highlights
-JUST the search string.
-
-+++
-*** 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.
-
-+++
-*** 'isearch-allow-scroll' provides new option 'unlimited' to allow
-scrolling any distance off screen.
-
----
-*** Isearch now remembers the regexp-based search mode for words/symbols
-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.
-
----
-*** 'char-fold-to-regexp' now matches more variants of a base character.
-The table used to check for equivalence of characters is now built
-using the complete chain of unicode decompositions of a character,
-rather than stopping after one level, such that searching for
-e.g. "GREEK SMALL LETTER IOTA" will now also find "GREEK SMALL LETTER
-IOTA WITH OXIA".
-
-+++
-*** New char-folding options: 'char-fold-include' lets you add ad hoc
-foldings, 'char-fold-exclude' to remove foldings from default decomposition,
-and 'char-fold-symmetric' to search for any of an equivalence class of
-characters. For example, with a 'nil' value of 'char-fold-symmetric'
-you can search for "e" to find "é", but not vice versa. With a non-nil
-value you can search for either, for example, you can search for "é"
-to find "e".
-
-** Debugger
-
-+++
-*** The Lisp Debugger is now based on 'backtrace-mode'.
-Backtrace mode adds fontification and commands for changing the
-appearance of backtrace frames. See the node "(elisp) Backtraces" in
-the Elisp manual for documentation of the new mode and its commands.
-
-** Edebug
-
-+++
-*** 'edebug-eval-last-sexp' and 'edebug-eval-print-last-sexp' interactively
-now take a zero prefix analogously to the non-Edebug counterparts.
-
-+++
-*** New faces 'edebug-enabled-breakpoint' and 'edebug-disabled-breakpoint'.
-When setting breakpoints in Edebug, an overlay with these faces are
-placed over the point in question, depending on whether they are
-enabled or not.
-
-+++
-*** New command 'edebug-toggle-disable-breakpoint'.
-This command allows you to disable a breakpoint temporarily. This is
-mainly useful with breakpoints that are conditional and would take
-some time to recreate.
-
-+++
-*** New command 'edebug-unset-breakpoints'.
-To clear all breakpoints in the current form, the 'U' command in
-'edebug-mode', or 'M-x edebug-unset-breakpoints' can be used.
-
----
-*** Re-instrumenting a function with Edebug will now try to preserve
-previously-set breakpoints. However, if the code has changed
-substantially, this may not be possible.
-
-+++
-*** New command 'edebug-remove-instrumentation'.
-This command removes Edebug instrumentation from all functions that
-have been instrumented.
-
-+++
-*** The runtime behavior of Edebug's instrumentation can be changed
-using the new variables 'edebug-behavior-alist',
-'edebug-after-instrumentation-function' and
-'edebug-new-definition-function'. Edebug's behavior can be changed
-globally or for individual definitions.
-
-+++
-*** Edebug's backtrace buffer now uses 'backtrace-mode'.
-Backtrace mode adds fontification, links and commands for changing the
-appearance of backtrace frames. See the node "(elisp) Backtraces" in
-the Elisp manual for documentation of the new mode and its commands.
-
-The binding of 'd' in Edebug's keymap is now 'edebug-pop-to-backtrace'
-which replaces 'edebug-backtrace'. Consequently Edebug's backtrace
-windows now behave like those of the Lisp Debugger and of ERT, in that
-when they appear they will be the selected window.
-
-The new 'backtrace-goto-source' command, bound to 's', works in
-Edebug's backtraces on backtrace frames whose source code has
-been instrumented by Edebug.
-
-** Enhanced xterm support
-
----
-*** New user option 'xterm-set-window-title' controls whether Emacs sets
-the XTerm window title. This feature is experimental and is disabled
-by default.
-
-** Grep
-
-+++
-*** '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 user option
-'grep-find-abbreviate'. The new command
-'grep-find-toggle-abbreviation' toggles it interactively.
-
----
-*** 'grep-find-use-xargs' is now customizable with sorting options.
-
-** ERT
-
-+++
-*** New variable 'ert-quiet' allows to make ERT output in batch mode
-less verbose by removing non-essential information.
-
-+++
-*** ERT's backtrace buffer now uses 'backtrace-mode'.
-Backtrace mode adds fontification and commands for changing the
-appearance of backtrace frames. See the node "(elisp) Backtraces" in
-the Elisp manual for documentation of the new mode and its commands.
-
-** Gamegrid
-
----
-*** Gamegrid now determines its default glyph size based on display
-dimensions, instead of always using 16 pixels. As a result, Tetris,
-Snake and Pong are better playable on HiDPI displays.
-
----
-*** 'gamegrid-add-score' can now sort scores from lower to higher.
-This is useful for games where lower scores are better, like time-based games.
-
-** Filecache
-
----
-*** Completing filenames in the minibuffer via 'C-TAB' now uses the
-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
-are evaluated lazily.
-
-** next-error
-
-+++
-*** 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
-error.
-
-+++
-*** New command 'next-error-select-buffer'.
-It can be used to set any buffer as the next one to be used by
-'next-error' and 'previous-error'.
-
-** nxml-mode
-
----
-*** The default value of 'nxml-sexp-element-flag' is now t.
-This means that pressing 'C-M-SPACE' now selects the entire tree by
-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)'.
-
----
-*** Eshell no longer re-initializes its keymap every call.
-This allows users to use (define-key eshell-mode-map ...) as usual.
-Some modules have their own minor mode now to account for these
-changes.
-
-+++
-*** Expansion of history event designators is disabled by default.
-To restore the old behavior, use
-
- (add-hook 'eshell-expand-input-functions
- #'eshell-expand-history-references)
-
----
-*** The function 'eshell-uniquify-list' has been renamed from
-'eshell-uniqify-list'.
-
----
-*** The function 'eshell/kill' is now able to handle signal switches.
-Previously 'eshell/kill' would fail if provided a kill signal to send
-to the process. It now accepts signals specified either by name or by
-its number.
-
----
-*** Emacs now follows symlinks in history-related files.
-The files specified by 'eshell-history-file-name' and
-'eshell-last-dir-ring-file-name' can include symlinks; these are now
-followed when Emacs writes the relevant history variables to the disk.
-
-** Shell
-
----
-*** Program name completion inside remote shells works now as expected.
-
-+++
-*** 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
-
-+++
-*** 'async-shell-command-width' defines the number of display columns
-available for output of asynchronous shell commands.
-
-+++
-*** Prompt for shell commands can now show the current directory.
-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 function 'pcomplete-uniquify-list' has been renamed from
-'pcomplete-uniqify-list'.
-
----
-*** 'pcomplete/make' now completes on targets in included files, recursively.
-To recover the previous behavior, set new user option
-'pcmpl-gnu-makefile-includes' to nil.
-
-** Auth-source
-
----
-*** The Secret Service backend supports the ':create' key now.
-
----
-*** ".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 new
-'authinfo-hidden' user option can be used to control what to hide.
-
-** Tramp
-
-+++
-*** New connection method "nextcloud", which allows to access OwnCloud
-or NextCloud hosted files and directories.
-
-+++
-*** New connection method "rclone", which allows to access system
-storages via the 'rclone' program. This feature is experimental.
-
-+++
-*** New connection method "sudoedit", which allows to edit local files
-with different user credentials. Contrary to the "sudo" method, no
-session is run permanently in the background. This is for security
-reasons.
-
-+++
-*** Connection methods "obex" and "synce" are removed, because they
-are obsoleted in GVFS.
-
-+++
-*** Validated passwords are saved by auth-source backends which support this.
-
-+++
-*** During user and host name completion in the minibuffer, results
-from auth-source search are taken into account. This can be disabled
-by setting the user option 'tramp-completion-use-auth-sources' to nil.
-
-+++
-*** The user option 'tramp-ignored-file-name-regexp' allows to disable
-Tramp for some look-alike remote file names.
-
-+++
-*** For some connection methods, like "su" or "sudo", the host name in
-ad-hoc multi-hop file names must match the previous hop. Default host
-names are adjusted to the host name from the previous hop.
-
-+++
-*** For the connection methods "sudo" and "doas" there exists a
-timeout, after which the underlying session is disabled. This is for
-security reasons.
-
-+++
-*** For some connection methods, like "sshx" or "plink", it is
-possible to configure the remote login shell. This avoids problems
-with remote hosts, where "/bin/sh" is a link to a shell which
-cooperates badly with Tramp.
-
-+++
-*** New commands 'tramp-rename-files' and 'tramp-rename-these-files'.
-They allow to save remote files somewhere else when the corresponding
-host is not reachable anymore.
-
-** Rcirc
-
----
-*** New user option 'rcirc-url-max-length'.
-Setting this option to an integer causes URLs displayed in Rcirc
-buffers to be truncated to that many characters.
-
----
-*** The default '/quit' and '/part' reasons are now configurable.
-Two new user options are provided for this:
-'rcirc-default-part-reason' and 'rcirc-default-quit-reason'.
-
-** Register
-
----
-*** The return value of method 'register-val-describe' includes the
-names of buffers shown by the windows of a window configuration.
-
----
-** The options.el library has been removed.
-It was obsolete since Emacs 22.1, replaced by customize.
-
----
-** The tls.el and starttls.el libraries are now marked obsolete.
-Use of built-in libgnutls based functionality (described in the Emacs
-GnuTLS manual) is recommended instead.
-
-** Message
-
----
-*** Completion of email addresses can use the standard completion UI.
-This is controlled by 'message-expand-name-standard-ui'.
-With the standard UI the different sources (ecomplete, bbdb, and eudc)
-are matched together and try to obey 'completion-styles'.
-It should work for other completion front ends like Company.
-
----
-*** '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
-when the PGP keyring contains a public key for every recipient. To
-achieve this, add 'message-sign-encrypt-if-all-keys-available' to
-'message-send-hook'.
-
----
-*** When replying a message that have addresses on the form
-'"foo@bar.com" <foo@bar.com>', Message will elide the repeated "name"
-from the address field in the response.
-
----
-*** The default of 'message-forward-as-mime' has changed from t to nil
-as it has been reported that many recipients can't read forwards that
-are formatted as MIME digests.
-
-+++
-*** 'message-forward-included-headers' has changed its default to
-exclude most headers when forwarding.
-
-*** 'mml-secure-openpgp-sign-with-sender' sets also "gpg --sender"
-When 'mml-secure-openpgp-sign-with-sender' is non-nil message sender's
-email address (in addition to its old behavior) will also be used to
-set gpg's "--sender email@domain" option.
-
-The option is useful for two reasons when verifying the signature:
-
- 1. GnuPG's TOFU statistics are updated for the specific user id
- (email) only. See gpg(1) man page about "--sender".
-
- 2. GnuPG's '--auto-key-retrieve' functionality can use WKD (web key
- directory) method for finding the signer's key. You need GnuPG
- 2.2.17 to fully benefit from this feature. See gpg(1) man page for
- '--auto-key-retrieve'.
-
----
-** EasyPG
-
----
-*** 'epa-pinentry-mode' is renamed to 'epg-pinentry-mode'.
-It now applies to epg functions as well as epa functions.
-
----
-*** The alias functions 'epa--encode-coding-string',
-'epa--decode-coding-string', and 'epa--select-safe-coding-system' have
-been removed. Use 'encode-coding-string', 'decode-coding-string', and
-'select-safe-coding-system' instead.
-
----
-*** 'epg-context' structure supports now 'sender' slot.
-The value of the new 'sender' slot (if a string) is used to set gpg's
-'--sender' option. This feature is used by
-'mml-secure-openpgp-sign-with-sender'. See gpg(1) manual page about
-'--sender' for more information.
-
----
-** Rmail
-
-+++
-*** New user option 'rmail-output-reset-deleted-flag'.
-If this option is non-nil, messages appended to an output file by the
-'rmail-output' command have their Deleted flag reset.
-
----
-*** The command 'rmail-summary-by-senders' with an empty argument
-selects the messages to summarize with a regexp that matches the
-sender of the current message.
-
-** Threads
-
-+++
-*** New variable 'main-thread' holds Emacs's main thread.
-This is handy in Lisp programs that run on a non-main thread and want
-to signal the main thread, e.g., when they encounter an error.
-
-+++
-*** 'thread-join' now returns the result of the finished thread.
-
-+++
-*** 'thread-signal' does not propagate errors to the main thread.
-Instead, error messages are just printed in the main thread.
-
----
-*** 'thread-alive-p' is now obsolete, use 'thread-live-p' instead.
-
-+++
-*** New command 'list-threads' shows Lisp threads.
-See the current list of live threads in a tabulated-list buffer which
-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
-
----
-*** '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.
-
----
-*** 'number-at-point' will now recognize hex numbers like 0xAb09 and #xAb09
-and return them as numbers.
-
----
-*** 'word-at-point' and 'sentence-at-point' accept NO-PROPERTIES.
-Just like 'thing-at-point' itself.
-
-** Interactive automatic highlighting
-
-+++
-*** 'highlight-regexp' can now highlight subexpressions.
-The new command accepts a prefix numeric argument to choose the
-subexpression.
-
-** Mouse display of minor mode menu
-
----
-*** 'minor-mode-menu-from-indicator' now displays full minor mode name.
-When there is no menu for a mode, display the mode name after the
-indicator instead of just the indicator (which is sometimes cryptic).
-
-** rx
-
----
-*** rx now handles raw bytes in character alternatives correctly,
-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'.
-The symbol 'unmatchable' can be used as an alternative to '(or)'.
-
----
-*** 'regexp' and new 'literal' accept arbitrary lisp as arguments.
-In this case, 'rx' will generate code which produces a regexp string
-at run time, instead of a constant string.
-
----
-*** New rx extension mechanism: 'rx-define', 'rx-let', 'rx-let-eval'.
-These macros add new forms to the rx notation.
-
-+++
-*** 'anychar' is now an alias for 'anything'.
-Both match any single character; 'anychar' is more descriptive.
-
-+++
-*** New 'intersection' form for character sets.
-With 'or' and 'not', it can be used to compose character-matching
-expressions from simpler parts.
-
-+++
-*** 'not' argument can now be a character or single-char string.
-
-** Frames
-
-+++
-*** New command 'make-frame-on-monitor' makes a frame on the specified monitor.
-
-+++
-*** New value of 'minibuffer' frame parameter 'child-frame'.
-This allows to create and parent immediately a minibuffer-only child
-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.
-
-** Tabulated List mode
-
-+++
-*** 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 user options
-'tabulated-list-gui-sort-indicator-asc',
-'tabulated-list-gui-sort-indicator-desc',
-'tabulated-list-tty-sort-indicator-asc', and
-'tabulated-list-tty-sort-indicator-desc').
-
-+++
-*** Two new commands and keystrokes have been added to the tabulated
-list mode: 'w' (which widens the current column) and 'c' which makes
-the current column contract.
-
-+++
-*** New function 'tabulated-list-clear-all-tags'.
-This function clears all tags from the padding area in the current
-buffer. Tags are typically added by calling 'tabulated-list-put-tag'.
-
-** Text mode
-
-+++
-*** 'text-mode-variant' is now obsolete, use 'derived-mode-p' instead.
-
-** CUA mode
-
----
-*** 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
-
----
-*** JSX syntax is now automatically detected and enabled.
-If a file imports Facebook's 'React' library, or if the file uses the
-extension '.jsx', then various features supporting XML-like syntax
-will be supported in 'js-mode' and derivative modes. ('js-jsx-mode'
-no longer needs to be enabled.)
-
----
-*** New user option 'js-jsx-detect-syntax' disables automatic detection.
-This is turned on by default.
-
----
-*** New user option 'js-jsx-syntax' enables JSX syntax unconditionally.
-This is off by default.
-
----
-*** New variable 'js-jsx-regexps' controls JSX detection.
-
----
-*** JSX syntax is now highlighted like SGML.
-
----
-*** JSX code is properly indented in many more scenarios.
-Previously, JSX indentation usually only worked when an element was
-wrapped in parenthesis (e.g. in a 'return' statement or a function
-call). It would also fail in many intricate cases. Now, indentation
-should work anywhere without parenthesis; many more intricacies are
-supported; and, indentation conventions align more closely with those
-of the React developer community (see 'js-jsx-align->-with-<'),
-otherwise still adhering to SGML conventions.
-
----
-*** 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
-'>' is indented at the same level as attributes, which was also the
-old default for JSX.
-
-This is turned on by default. To get back the old default indentation
-behavior of aligning '>' with attributes, set 'js-jsx-align->-with-<'
-to nil.
-
----
-*** Indentation uses 'js-indent-level' instead of 'sgml-basic-offset'.
-Since JSX is a syntax extension of JavaScript, it makes the most sense
-for JSX expressions to be indented the same number of spaces as other
-JS expressions. This is a breaking change, but it probably aligns
-with how you'd expect this indentation to behave. If you want JSX to
-be indented like JS, you won't need to change your config.
-
-The old behavior can be emulated by controlling JSX indentation
-independently of JS, by setting 'js-jsx-indent-level'.
-
----
-*** 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 user option to the desired number.
-
----
-*** New user option 'js-jsx-attribute-offset' for JSX attribute indents.
-
----
-*** New variable 'js-syntactic-mode-name' controls mode name display.
-Previously, the mode name was simply 'JavaScript'. Now, when a syntax
-extension like JSX is enabled, the mode name is 'JavaScript[JSX]'.
-Set this variable to nil to disable the new behavior.
-
----
-*** New function 'js-use-syntactic-mode-name' for deriving modes.
-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 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
-'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.
-
----
-*** 'global-auto-revert-ignore-buffer' can now also be a predicate
-function that can be used for more fine-grained control of which
-buffers to auto-revert.
-
-** auth-source-pass
-
-+++
-*** New user option 'auth-source-pass-filename'.
-Allows setting the path to the password-store, defaults to
-"~/.password-store".
-
-+++
-*** New user option 'auth-source-pass-port-separator'.
-Specifies separator between host and port, defaults to colon ":".
-
----
-*** Minimize the number of decryptions during password lookup.
-This makes the package usable with physical tokens requiring touching
-a sensor for every decryption.
-
----
-*** 'auth-source-pass-get' is now autoloaded.
-
-** Bookmarks
-
----
-*** 'bookmark-file' and 'bookmark-old-default-file' are now obsolete
-aliases of 'bookmark-default-file'.
-
----
-*** New user option 'bookmark-watch-bookmark-file'.
-When non-nil, watch whether the bookmark file has changed on disk.
-
----
-*** The old bookmark file format is no longer supported.
-This bookmark file format has not been used in Emacs since at least
-version 19.34, released in 1996, and will no longer be automatically
-converted to the new bookmark file format.
-
-The following functions are now declared obsolete:
-'bookmark-grok-file-format-version',
-'bookmark-maybe-upgrade-file-format',
-'bookmark-upgrade-file-format-from-0', and
-'bookmark-upgrade-version-0-alist'.
-
----
-** The mantemp.el library is now marked obsolete.
-This library generates manual C++ template instantiations. It should
-no longer be useful on modern compilers, which do this automatically.
-
-** Ispell
-
----
-*** New hook 'ispell-change-dictionary-hook'.
-This runs after changing the dictionary and could be used to
-automatically spellcheck a buffer when changing language without
-needing to advice 'ispell-change-dictionary'.
-
-** scroll-lock
-
----
-*** New command 'scroll-lock-next-line-always-scroll'.
-This command is bound to 'S-down' and scrolls the buffer up in
-particular when the end of the buffer is visible in the window.
-
-** mwheel.el
-
----
-*** 'mwheel-install' is now obsolete.
-Use 'mouse-wheel-mode' instead. Note that 'mouse-wheel-mode' is
-already enabled by default on most graphical displays.
-
-** Gravatar
-
-+++
-*** 'gravatar-cache-ttl' is now a number of seconds.
-The previously used timestamp format of a list of integers is still
-supported, but is deprecated. The default value has not changed.
-
-+++
-*** 'gravatar-size' can now be nil.
-This results in the use of Gravatar's default size of 80 pixels.
-
-+++
-*** The default fallback gravatar is now configurable.
-This is possible using the new user options 'gravatar-default-image'
-and 'gravatar-force-default'.
-
-** ada-mode
-
----
-*** The built-in ada-mode is now deleted. The GNU ELPA package is a
-good replacement, even in very large source files.
-
-** time-stamp
-
----
-*** New '%5z' conversion for 'time-stamp-format' gives time zone offset.
-Specifying '%5z' in 'time-stamp-format' or 'time-stamp-pattern'
-expands to the time zone offset, e.g., '+0100'. The time zone used is
-specified by 'time-stamp-time-zone'.
-
-Because this feature is new in Emacs 27.1, do not use it in the local
-variables section of any file that might be edited by an older version
-of Emacs.
-
----
-*** Some conversions recommended for 'time-stamp-format' have changed.
-The new documented/recommended %-conversions are closer to those
-used by 'format-time-string' and are compatible at least as far back
-as Emacs 22.1 (released in 2007).
-
-Uppercase abbreviated day name of week: was %3A, now %#a
-Full day name of week: was %:a, now %:A
-Uppercase abbreviated month name: was %3B, now %#b
-Full month name: was %:b, now %:B
-Four-digit year: was %:y, now %Y
-Lowercase timezone name: was %z, now %#Z
-Fully-qualified host name: was %s, now %Q
-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
-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
----
-*** Declare 'define-overload' and 'define-child-mode' as obsolete.
-
----
-*** Rename several internal functions to use a 'mode-local-' prefix.
-
-** CC Mode
-
-+++
-*** You can now flag "wrong style" comments with 'font-lock-warning-face'.
-To do this, use 'c-toggle-comment-style', if needed, to set the desired
-default comment style (block or line); then set the user option
-'c-mark-wrong-style-of-comment' to non-nil.
+* Changes in Specialized Modes and Packages in Emacs 28.1
-* New Modes and Packages in Emacs 27.1
-
-** Tab Bars
-
-+++
-*** Tab Bar mode.
-The new command 'tab-bar-mode' enables the tab bar at the top of each
-frame, where you can use tabs to switch between named persistent
-window configurations.
-
-The 'C-x t' sequence is the new prefix key for tab-related commands:
-'C-x t 2' creates a new tab; 'C-x t 0' deletes the current tab;
-'C-x t b' switches to buffer in another tab; 'C-x t f' and 'C-x t C-f'
-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 '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 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.
-
-+++
-*** Tab Line mode
-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
-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.
-
-+++
-** fileloop.el lets one setup multifile operations like search&replace.
-
-+++
-** Emacs can now visit files in archives as if they were directories.
-This feature uses Tramp and works only on systems which support GVFS,
-i.e. GNU/Linux, roughly spoken. See the node "(tramp) Archive file
-names" in the Tramp manual for full documentation of these facilities.
-
-+++
-** New library for writing JSONRPC applications (https://jsonrpc.org).
-The 'jsonrpc' library enables writing Emacs Lisp applications that
-rely on this protocol. Since the protocol is designed to be
-transport-agnostic, the library provides an API to implement new
-transport strategies as well as a separate API to use them. A
-transport implementation for process-based communication, such as is
-used by the Language Server Protocol (LSP), is readily available.
-
-+++
-** Backtrace mode improves viewing of Elisp backtraces.
-Backtrace mode adds pretty printing, fontification and ellipsis
-expansion to backtrace buffers produced by the Lisp debugger, Edebug
-and ERT. See the node "(elisp) Backtraces" in the Elisp manual for
-documentation of the new mode and its commands.
-
-+++
-** so-long.el helps to mitigate performance problems with long lines.
-When 'global-so-long-mode' has been enabled, visiting a file with very
-long lines will (subject to configuration) cause the user's preferred
-'so-long-action' to be automatically invoked (by default, the buffer's
-major mode is replaced by 'so-long-mode'). In extreme cases this can
-prevent delays of several minutes, and make Emacs responsive almost
-immediately. Type 'M-x so-long-commentary' for full documentation.
+* New Modes and Packages in Emacs 28.1
-* Incompatible Lisp Changes in Emacs 27.1
-
----
-** Incomplete destructive splicing support has been removed.
-Support for Common Lisp style destructive splicing (",.") was
-incomplete and broken for a long time. It has now been removed.
-
-This means that backquote substitution now works for identifiers
-starting with a period ("."). Consider the following example:
-
- (let ((.foo 42)) `,.foo)
-
-In the past, this would have incorrectly evaluated to '(\,\. foo)',
-but will now instead evaluate to '42'.
-
----
-** The REGEXP in 'magic-mode-alist' is now matched case-sensitively.
-Likewise for 'magic-fallback-mode-alist'.
-
-+++
-** 'add-hook' does not always add to the front or the end any more.
-The replacement of 'append' with 'depth' implies that the function is
-not always added to the very front (when append/depth is nil) or the
-very end (when append/depth is t) any more because other functions on
-the hook may have specified higher/lower depths. This makes it
-possible to control the ordering of functions more precisely, as was
-already possible in 'add-function' and 'advice-add'.
-
----
-** 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.
-
----
-** Just loading a theme's file no longer activates the theme's settings.
-Loading a theme with 'M-x load-theme' still activates the theme, as it
-did before. However, loading the theme's file with 'M-x load-file',
-or using 'require' or 'load' in a Lisp program, doesn't actually apply
-the theme's settings until you either invoke 'M-x enable-theme' or
-type 'M-x load-theme'. (In a Lisp program, calling 'enable-theme' or
-invoking 'load-theme' with NO-ENABLE argument omitted or nil has the
-same effect of activating a theme whose file has been loaded.) The
-special case of the 'user' theme is an exception: it is frequently
-used for ad-hoc customizations, so the settings of that theme are by
-default applied immediately.
-
-The variable 'custom--inhibit-theme-enable' controls this behavior;
-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
-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
-independent of where Emacs was started.
-
----
-** 'file-name-absolute-p' no longer considers "~foo" to be an absolute
-file name if there is no user named "foo".
-
-+++
-** The FILENAME argument to 'file-name-base' is now mandatory and no
-longer defaults to 'buffer-file-name'.
-
-+++
-** File metadata primitives now signal an error if I/O, access, or
-other serious errors prevent them from determining the result.
-Formerly, these functions often (though not always) silently 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.
-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'.
-
----
-** The function 'eldoc-message' now accepts a single argument.
-Programs that called it with multiple arguments before should pass
-them through 'format' first. Even that is discouraged: for ElDoc
-support, you should set 'eldoc-documentation-function' instead of
-calling 'eldoc-message' directly.
-
----
-** Old-style backquotes now generate an error.
-They have been generating warnings for a decade. To interpret
-old-style backquotes as new-style, bind the new variable
-'force-new-style-backquotes' to t.
-
----
-** Defining a Common Lisp structure using 'cl-defstruct' or
-'cl-struct-define' whose name clashes with a builtin type (e.g.,
-'integer' or 'hash-table') now signals an error.
-
----
-** When formatting a floating-point number as an octal or hexadecimal
-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,
-and returns a NaN when given a NaN. Formerly, it returned an extreme
-fixnum for such arguments.
-
----
-** Some functions and variables obsolete since Emacs 22 have been removed:
-archive-mouse-extract, assoc-ignore-case, assoc-ignore-representation,
-backward-text-line, blink-cursor, bookmark-exit-hooks,
-c-opt-op-identitier-prefix, comint-use-prompt-regexp-instead-of-fields,
-compilation-finish-function, count-text-lines, cperl-vc-header-alist,
-custom-face-save-command, cvs-display-full-path, cvs-fileinfo->full-path,
-delete-frame-hook, derived-mode-class, describe-char-after, describe-project,
-desktop-basefilename, desktop-buffer-handlers, desktop-buffer-misc-functions,
-desktop-buffer-modes-to-save, desktop-enable, desktop-load-default,
-dired-omit-files-p, disabled-command-hook, dungeon-mode-map,
-electric-nroff-mode, electric-nroff-newline, electric-perl-terminator,
-focus-frame, forward-text-line, generic-define-mswindows-modes,
-generic-define-unix-modes, generic-font-lock-defaults, goto-address-at-mouse,
-highlight-changes-colours, ibuffer-elide-long-columns, ibuffer-hooks,
-ibuffer-mode-hooks, icalendar-convert-diary-to-ical,
-icalendar-extract-ical-from-buffer, imenu-always-use-completion-buffer-p,
-ipconfig-program, ipconfig-program-options, isearch-lazy-highlight-cleanup,
-isearch-lazy-highlight-initial-delay, isearch-lazy-highlight-interval,
-isearch-lazy-highlight-max-at-a-time, iswitchb-use-fonts,
-latin1-char-displayable-p, mouse-wheel-click-button, mouse-wheel-down-button,
-mouse-wheel-up-button, new-frame, pascal-outline, process-kill-without-query,
-recentf-menu-append-commands-p, rmail-pop-password,
-rmail-pop-password-required, savehist-load, set-default-font,
-spam-list-of-processors, speedbar-add-ignored-path-regexp,
-speedbar-buffers-line-path, speedbar-ignored-path-expressions,
-speedbar-ignored-path-regexp, speedbar-line-path, speedbar-path-line,
-timer-set-time-with-usecs, tooltip-gud-display, tooltip-gud-modes,
-tooltip-gud-toggle-dereference, unfocus-frame, unload-hook-features-list,
-update-autoloads-from-directories, vc-comment-ring, vc-comment-ring-index,
-vc-comment-search-forward, vc-comment-search-reverse, vc-comment-to-change-log,
-vc-diff-switches-list, vc-next-comment, vc-previous-comment, view-todo,
-x-lost-selection-hooks, x-sent-selection-hooks.
-
----
-** Further functions and variables obsolete since Emacs 24 have been removed:
-default-directory-alist, dired-default-directory,
-dired-default-directory-alist, dired-enable-local-variables,
-dired-hack-local-variables, dired-local-variables-file, dired-omit-here-always.
-
-+++
-** Garbage collection no longer treats miscellaneous objects specially;
-they are now allocated like any other pseudovector. As a result, the
-'garbage-collect' and 'memory-use-count' functions no longer return a
-'misc' component, and the 'misc-objects-consed' variable has been
-removed.
-
-+++
-** 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.
-
----
-** Internal 'rx' functions and variables have been removed,
-as a consequence of an improved implementation. Packages using
-these should use the public 'rx' and 'rx-to-string' instead.
-'rx-constituents' is still available for compatibility, but the new
-extension mechanism is preferred: 'rx-define', 'rx-let' and
-'rx-let-eval'.
-
-+++
-** 'text-mode' no longer sets the value of 'indent-line-function'.
-The global value of 'indent-line-function', which defaults to
-'indent-relative', will no longer be reset locally when turning on
-'text-mode'.
-
-To get back the old behavior, add a function to 'text-mode-hook' which
-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.
-
----
-** The obsolete package xesam.el (since Emacs 24) has been removed.
-
-+++
-** The XBM image handler now accepts a ':stride' argument, which should
-be specified in image specs representing the entire bitmap as a single
-bool vector.
-
-+++
-** 'regexp-quote' may return its argument string.
-If the argument needs no quoting, it can be returned instead of a copy.
-
-+++
-** Mouse scroll up and down with control key modifier changes font size.
-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 behavior 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 behavior, you can customize the user
-option 'mouse-wheel-follow-mouse'. Note that this will also affect
-scrolling.
-
-+++
-** Mouse scroll up and down with control key modifier also works on images
-where it scales the image under the mouse pointer.
-
----
-** 'help-follow-symbol' now signals 'user-error' if point (or the
-position pointed to by the argument POS) is not in a symbol.
+* Incompatible Lisp Changes in Emacs 28.1
-* Lisp Changes in Emacs 27.1
-
-+++
-** Emacs Lisp integers can now be of arbitrary size.
-Emacs uses the GNU Multiple Precision (GMP) library to support
-integers whose size is too large to support natively. The integers
-supported natively are known as "fixnums", while the larger ones are
-"bignums". The new predicates 'bignump' and 'fixnump' can be used to
-distinguish between these two types of integers.
-
-All the arithmetic, comparison, and logical (a.k.a. "bitwise")
-operations where bignums make sense now support both fixnums and
-bignums. However, note that unlike fixnums, bignums will not compare
-equal with 'eq', you must use 'eql' instead. (Numerical comparison
-with '=' works on both, of course.)
-
-Since large bignums consume a lot of memory, Emacs limits the size of
-the largest bignum a Lisp program is allowed to create. The
-nonnegative value of the new variable 'integer-width' specifies the
-maximum number of bits allowed in a bignum. Emacs signals an integer
-overflow error if this limit is exceeded.
-
-Several primitive functions formerly returned floats or lists of
-integers to represent integers that did not fit into fixnums. These
-functions now simply return integers instead. Affected functions
-include functions like 'encode-char' that compute code-points, functions
-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.
-
-+++
-** 'overflow-error' is now documented as a subcategory of 'range-error'.
-Formerly it was undocumented, and was (incorrectly) a subcategory
-of 'domain-error'.
-
-** Time values
-
-+++
-*** 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)',
-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
-'format-time-string', 'decode-time', and 'time-convert' rather than
-probing the innards of a timestamp directly, or creating a timestamp
-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.
-
-+++
-*** 'encode-time' supports a new API '(encode-time TIME)'.
-The old 'encode-time' API is still supported.
-
-+++
-*** A new package to parse ISO 8601 time, date, durations and
-intervals has been added. The main function to use is
-'iso8601-parse', but there's also 'iso8601-parse-date',
-'iso8601-parse-time', 'iso8601-parse-duration' and
-'iso8601-parse-interval'. All these functions return decoded time
-structures, except the final one, which returns three of them (start,
-end and duration).
-
-+++
-*** '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. If both arguments are finite, these
-functions now return exact results instead of rounding in some cases,
-and they also avoid excess precision when that is easy.
-
-+++
-*** New function 'time-equal-p' compares time values for equality.
-
-+++
-*** '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.
-
-+++
-*** To access (or alter) the elements a decoded time value, the
-'decoded-time-second', 'decoded-time-minute', 'decoded-time-hour',
-'decoded-time-day', 'decoded-time-month', 'decoded-time-year',
-'decoded-time-weekday', 'decoded-time-dst' and 'decoded-time-zone'
-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
-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
-elements as if it's midnight January 1st, 1970) have been added.
-
-+++
-*** In the DST slot, 'encode-time' and 'parse-time-string' now return -1
-if it is not known whether daylight saving time is in effect.
-Formerly they were inconsistent: 'encode-time' returned t in this
-situation, whereas 'parse-time-string' returned nil. Now they
-consistently use use nil to mean that DST is not in effect, and use -1
-to mean that it is not known whether DST is in effect.
-
-+++
-** New macro 'benchmark-progn'.
-This macro works like 'progn', but messages how long it takes to
-evaluate the body forms. The value of the last form is the return
-value.
-
-+++
-** New function 'read-char-from-minibuffer'.
-This function works like 'read-char', but uses 'read-from-minibuffer'
-to read a character, so it maintains a history that can be navigated
-via usual minibuffer keystrokes 'M-p'/'M-n'.
-
----
-** New variables 'set-message-function' and 'clear-message-function'
-can be used to specify functions to show and clear messages that
-normally are displayed in the echo area.
-
-+++
-** 'setq-local' can now set an arbitrary number of variables, which
-makes the syntax more like 'setq'.
-
----
-** 'reveal-mode' can now also be used for more than to toggle between
-invisible and visible: It can also toggle 'display' properties in
-overlays. This is only done on 'display' properties that have the
-'reveal-toggle-invisible' property set.
-
-+++
-** 'process-contact' now takes an optional NO-BLOCK argument to allow
-not waiting for a process to be set up.
-
----
-** New variable 'read-process-output-max' controls sub-process throughput.
-This variable determines how many bytes can be read from a sub-process
-in one read operation. The default, 4096 bytes, was previously a
-hard-coded constant. Setting it to a larger value might enhance
-throughput of reading from sub-processes that produces vast
-(megabytes) amounts of data in one go.
-
-+++
-** The new user option 'quit-window-hook' is now run first when
-executing the 'quit-window' command.
-
-** The user options 'help-enable-completion-auto-load',
-'help-enable-auto-load' and 'vhdl-project-auto-load', as well as the
-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
-now use the 'button-data' property. If present, the data in this
-property will be passed on to the 'action' function instead of the
-button itself in 'button-activate'.
-
-+++
-** 'defcustom' now takes a ':local' keyword that can be either t or
-'permanent', which mean that the variable should be automatically
-buffer-local. 'permanent' also sets the variable's 'permanent-local'
-property.
-
-+++
-** The new macro 'with-suppressed-warnings' can be used to suppress
-specific byte-compile warnings.
-
-+++
-** The new macro 'ignore-error' is like 'ignore-errors', but takes a
-specific error condition, and will only ignore that condition. (This
-can also be a list of conditions.)
-
----
-** The new function 'byte-compile-info-message' can be used to output
-informational messages that look pleasing during the Emacs build.
-
----
-** New 'help-fns-describe-variable-functions' hook.
-Makes it possible to add metadata information to 'describe-variable'.
-
-** i18n (internationalization)
-
----
-*** ngettext can be used now to return the right plural form
-according to the given numeric value.
-
-+++
-** 'inhibit-null-byte-detection' is renamed to 'inhibit-nul-byte-detection'.
-
-+++
-** 'self-insert-command' takes the char to insert as (optional) argument.
-
-+++
-** 'lookup-key' can take a list of keymaps as argument.
-
-+++
-** 'condition-case' now accepts 't' to match any error symbol.
-
-+++
-** New function 'proper-list-p'.
-Given a proper list as argument, this predicate returns its length;
-otherwise, it returns nil. 'format-proper-list-p' is now an obsolete
-alias for the new function.
-
----
-** 'define-minor-mode' automatically documents the meaning of ARG.
-
-+++
-** The function 'recenter' now accepts an additional optional argument.
-By default, calling 'recenter' will not redraw the frame even if
-'recenter-redisplay' is non-nil. Call 'recenter' with the new second
-argument non-nil to force redisplay per 'recenter-redisplay's value.
-
-+++
-** New functions 'major-mode-suspend' and 'major-mode-restore'.
-Use them when switching temporarily to another major mode, e.g. for
-'hexl-mode', or to switch between 'c-mode' and 'image-mode' in XPM.
-
-+++
-** New macro 'dolist-with-progress-reporter'.
-This works like 'dolist', but reports progress similar to
-'dotimes-with-progress-reporter'.
-
-+++
-** New hook 'after-delete-frame-functions'.
-This works like 'delete-frame-functions', but runs after the frame to
-be deleted has been made dead and removed from the frame list.
-
----
-** The function 'provided-mode-derived-p' was extended to support aliases.
-The function now returns non-nil when the argument MODE is derived
-from any alias of any of MODES.
-
-+++
-** New frame focus state inspection interface.
-The hooks 'focus-in-hook' and 'focus-out-hook' are now obsolete.
-Instead, attach to 'after-focus-change-function' using 'add-function'
-and inspect the focus state of each frame using 'frame-focus-state'.
-
-+++
-** Emacs now requests and recognizes focus-change notifications from TTYs.
-On terminal emulators that support the feature, Emacs can now support
-'focus-in-hook' and 'focus-out-hook' for TTY frames.
-
-+++
-** Window-specific face remapping.
-Face specifications (of the kind used in 'face-remapping-alist')
-now support filters, allowing faces to vary between different windows
-displaying the same buffer. See the node "(elisp) Face Remapping"
-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
-changed), 'window-size-change-functions' (run after a window was
-assigned a new buffer or size), 'window-configuration-change-hook'
-(like the former but run also when a window was deleted),
-'window-selection-change-functions' (run when the selected window
-changed) and 'window-state-change-functions' and
-'window-state-change-hook' (run when any of the preceding ones is
-run). Applications can enforce running the latter two using the new
-function 'set-frame-window-state-change'. 'window-scroll-functions'
-are unaffected by these changes.
-
-In addition, a number of functions now allow the caller to detect what
-has changed since last redisplay: 'window-old-buffer' returns for any
-window the buffer it showed at that time. ‘old-selected-window’ and
-'old-selected-frame' return the window and frame that were selected
-during last redisplay. 'window-old-pixel-width' (renamed from
-'window-pixel-width-before-size-change'), 'window-old-pixel-height'
-(renamed from 'window-pixel-height-before-size-change'),
-'window-old-body-pixel-width' and 'window-old-body-pixel-height'
-return the total and body sizes of any window during last redisplay.
-
-Also 'run-window-configuration-change-hook' is declared obsolete.
+* Lisp Changes in Emacs 28.1
-See the section "(elisp) Window Hooks" in the Elisp manual for a
-detailed explanation of the new behavior.
-
-+++
-** Scroll bar and fringe settings can now be made persistent for windows.
-The functions 'set-window-scroll-bars' and 'set-window-fringes' now
-have a new optional argument that makes the settings they produce
-reliably survive subsequent invocations of 'set-window-buffer'.
-
-+++
-** 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.
-
-+++
-** 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'.
-
-+++
-** New buffer display action alist entry 'window-min-height'.
-Such an entry allows to specify a minimum height of the window used
-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.
-
-+++
-** New function 'string-distance' to calculate the Levenshtein distance
-between two strings.
-
-+++
-** 'print-quoted' now defaults to t, so if you want to see
-'(quote x)' instead of 'x you will have to bind it to nil where applicable.
-
-+++
-** Numbers formatted via '%o' or '%x' are now formatted as signed integers.
-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
-integers, they now support the '+' and space flags.
-
-+++
-** In Emacs Lisp mode, symbols with confusable quotes are highlighted.
-For example, the first character in '‘foo' would be highlighted in
-'font-lock-warning-face'.
-
-+++
-** Omitting variables after '&optional' and '&rest' is now allowed.
-For example '(defun foo (&optional))' is no longer an error. This is
-sometimes convenient when writing macros. See the ChangeLog entry
-titled "Allow '&rest' or '&optional' without following variable
-(Bug#29165)" for a full listing of which arglists are accepted across
-versions.
-
----
-** Internal parsing commands now use 'syntax-ppss' and disregard
-'open-paren-in-column-0-is-defun-start'. This affects mostly things like
-'forward-comment', 'scan-sexps', and 'forward-sexp' when parsing backward.
-The new variable 'comment-use-syntax-ppss' can be set to nil to recover
-the old behavior if needed.
-
----
-** The 'server-name' and 'server-socket-dir' variables are set when a
-socket has been passed to Emacs.
-
----
-** The 'file-system-info' function is now available on all platforms.
-instead of just Microsoft platforms. This fixes a 'get-free-disk-space'
-bug on OS X 10.8 and later.
-
----
-** The function 'get-free-disk-space' returns now a non-nil value for
-remote systems, which support this check.
-
-+++
-** 'memory-limit' now returns a better estimate of memory consumption.
-
-+++
-** 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
-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.
-
-+++
-** New macro 'combine-change-calls' arranges to call the change hooks
-('before-change-functions' and 'after-change-functions') just once
-each around a sequence of lisp forms, given a region. This is
-useful when a function makes a possibly large number of repetitive
-changes and the change hooks are time consuming.
-
-+++
-** 'eql', 'make-hash-table', etc. now treat NaNs consistently.
-Formerly, some of these functions ignored signs and significands of
-NaNs. Now, all these functions treat NaN signs and significands as
-significant. For example, '(eql 0.0e+NaN -0.0e+NaN)' now returns nil
-because the two NaNs have different signs; formerly it returned t.
-Also, Emacs now reads and prints NaN significands; e.g., if X is a
-NaN, '(format "%s" X)' now returns "0.0e+NaN", "1.0e+NaN", etc.,
-depending on X's significand.
-
-+++
-** The function 'make-string' accepts an additional optional argument.
-If the optional third argument is non-nil, 'make-string' will produce
-a multibyte string even if its second argument is an ASCII character.
-
----
-** '(format "%d" X)' no longer mishandles a floating-point number X that
-does not fit in a machine integer.
-
----
-** New coding-system 'ibm038'.
-This is the International EBCDIC encoding, also available as aliases
-'ebcdic-int' and 'cp038'.
-
----
-** New JSON parsing and serialization functions 'json-serialize',
-'json-insert', 'json-parse-string', and 'json-parse-buffer'. These
-are implemented in C using the Jansson library.
-
-+++
-** New function 'ring-resize'.
-'ring-resize' can be used to grow or shrink a ring.
-
-+++
-** New function 'flatten-tree'.
-'flatten-list' is provided as an alias. These functions take a tree
-and 'flatten' it such that the result is a list of all the terminal
-nodes.
-
-+++
-** 'zlib-decompress-region' can partially decompress corrupted data.
-If the new optional ALLOW-PARTIAL argument is passed, then the data
-that was decompressed successfully before failing will be inserted
-into the buffer.
-
-** Mailcap
-
----
-*** The new function 'mailcap-file-name-to-mime-type' has been added.
-It's a simple convenience function for looking up MIME types based on
-file name extensions.
-
----
-*** The default way the list of possible external viewers for MIME
-types is sorted and chosen has changed. Earlier, the most specific
-viewer was chosen, even if there was a general override in "~/.mailcap".
-For instance, if "/etc/mailcap" has an entry for "image/gif", that one
-will be chosen even if you have an entry for "image/*" in your
-"~/.mailcap" file. But with the new method, entries from "~/.mailcap"
-overrides all system and Emacs-provided defaults. To get the old
-method back, set 'mailcap-prefer-mailcap-viewers' to nil.
-
-** URL
-
----
-*** The 'file:' handler no longer looks for "index.html" in
-directories if you ask it for a "file:///dir" URL. Since this is a
-low-level library, such decisions (if they are to be made at all) are
-left to higher-level functions.
-
----
-** The url-ns.el library is now marked obsolete.
-This library is used to open configuration files for the long defunct
-web browser Netscape, and is no longer relevant.
-
-** Image mode
-
----
-*** New library Exif.
-An Exif library has been added that can parse JPEG files and output
-data about creation times and orientation and the like.
-'exif-parse-file' and 'exif-parse-buffer' are the main interface
-functions.
-
----
-*** 'image-mode' now uses this library to automatically rotate images
-according to the orientation in the Exif data, if any.
-
----
-*** New library image-converter.
-If you need to view exotic image formats for which Emacs doesn't have
-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.
-
----
-*** 'auto-mode-alist' now includes many of the types typically
-supported by the external image converters, like WEPB, BMP and ICO.
-These now default to using 'image-mode'.
-
----
-*** 'imagemagick-types-inhibit' disables using ImageMagick by default.
-'image-mode' started using ImageMagick by default for all images
-some years back. It now respects 'imagemagick-types-inhibit' as a way
-to disable that.
-
----
-*** 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.
-
-+++
-*** Three new 'image-mode' commands have been added: 'm', which marks
-the file in the dired buffer(s) for the directory the file is in; 'u',
-which unmarks the file; and 'w', which pushes the current buffer's file
-name to the kill ring.
-
-+++
-*** The command 'image-rotate' now accepts a prefix argument.
-With a prefix argument, 'image-rotate' now rotates the image at point
-90 degrees counter-clockwise, instead of the default clockwise.
-
-** 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
-the new variable 'custom-variable-history'.
-
----
-** The functions 'string-to-unibyte' and 'string-to-multibyte' are no
-longer declared obsolete. We have found that there are legitimate use
-cases for these functions, where there's no better alternative. We
-believe that the incorrect uses of these functions all but disappeared
-by now, so we are un-obsoleting them.
-
-+++
-** New function 'group-name' returns a group name corresponding to GID.
-
-+++
-** 'make-process' now takes a keyword argument ':file-handler'; if
-that is non-nil, it will look for a file name handler for the current
-buffer's 'default-directory' and invoke that file name handler to make
-the process. That way 'make-process' can start remote processes.
-
-+++
-** '(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.
-
-+++
-** The function 'regexp-opt' accepts an additional optional argument.
-By default, the regexp returned by 'regexp-opt' may match the strings
-in any order. If the new third argument is non-nil, the match is
-guaranteed to be performed in the order given, as if the strings were
-made into a regexp by joining them with '\|'.
-
-+++
-** The function 'regexp-opt', when given an empty list of strings, now
-returns a regexp that never matches anything, which is an identity for
-this operation. Previously, the empty string was returned in this
-case.
-
-+++
-** 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.
-
-++++
-** New functions to handle the URL variant of base-64 encoding.
-New functions 'base64url-encode-string' and 'base64url-encode-region'
-implement the url-variant of base-64 encoding as defined in RFC4648.
-
-The functions 'base64-decode-string' and 'base64-decode-region' now
-accept an optional argument to decode the URL variant of base-64
-encoding.
-
-+++
-** The function 'file-size-human-readable' accepts more optional arguments.
-The new third argument is a string put between the number and unit; it
-defaults to the empty string. The new fourth argument is a string
-representing the unit to use; it defaults to "B" when the second
-argument is 'iec' and the empty string otherwise. We recomment a
-space or non-breaking space as third argument, and "B" as fourth
-argument, circumstances allowing.
-
-+++
-** 'format-spec' has been expanded with several modifiers to allow
-greater flexibility when customizing variables. The modifiers include
-zero-padding, upper- and lower-casing, and limiting the length of the
-interpolated strings. The function has now also been documented in
-the Emacs Lisp manual.
-
-+++
-** 'directory-files-recursively' can now take an optional PREDICATE
-parameter to control descending into subdirectories, and a
-FOLLOW-SYMLINK parameter to say that symbolic links that point to
-other directories should be followed.
-
-+++
-** New function 'xor' returns the boolean exclusive-or of its args.
-The function was previously defined in array.el, but has been moved to
-subr.el so that it is available by default. It now always returns the
-non-nil argument when the other is nil. Several duplicates of 'xor'
-in other packages are now obsolete aliases of 'xor'.
-
-+++
-** 'define-globalized-minor-mode' now takes BODY forms.
-
-+++
-** New text property 'help-echo-inhibit-substitution'.
-Setting this on the first character of a help string disables
-conversions via 'substitute-command-keys'.
-
-+++
-** 'undo' can be made to ignore the active region for a command
-by setting 'undo-inhibit-region' symbol property of that command to
-non-nil. This is used by 'mouse-drag-region' to make the effect
-easier to undo immediately afterwards.
-
----
-** When called interactively, 'next-buffer' and 'previous-buffer' now
-signal 'user-error' if there is no buffer to switch to.
+** The module header 'emacs-module.h' now contains type aliases
+'emacs_function' and 'emacs_finalizer' for module functions and
+finalizers, respectively.
-* Changes in Emacs 27.1 on Non-Free Operating Systems
-
----
-** Battery status is now supported in all Cygwin builds.
-Previously it was supported only in the Cygwin-w32 build.
-
-** Emacs now handles key combinations involving the macOS "command"
-and "option" modifier keys more correctly.
-
-** MacOS modifier key behavior is now more adjustable.
-The behavior of the macOS "Option", "Command", "Control" and
-"Function" keys can now be specified separately for use with
-ordinary keys, function keys and mouse clicks. This allows using them
-in their standard macOS way for composing characters.
-
-** The special handling of 'frame-title-format' on NS where setting it
-to 't' would enable the macOS proxy icon has been replaced with a
-separate variable, 'ns-use-proxy-icon'. 'frame-title-format' will now
-work as on other platforms.
-
----
-** New primitive 'w32-read-registry'.
-This primitive lets Lisp programs access the MS-Windows Registry by
-retrieving values stored under a given key. It is intended to be used
-for supporting features such as XDG-like location of important files
-and directories.
-
-+++
-** The default value of 'w32-pipe-read-delay' is now zero.
-This speeds up reading output from sub-processes that produce a lot of
-data.
-
-This variable may need to be non-zero only when running DOS programs
-as Emacs subprocesses, which by now is not supported on modern
-versions of MS-Windows. Set this variable to 50 if for some reason
-you need the old behavior (and please report such situations to Emacs
-developers).
-
----
-** New variable 'w32-multibyte-code-page'.
-This variable holds the value of the multibyte code page used by the
-system. It is usually zero, which indicates that 'w32-ansi-code-page'
-is being used, except in Far Eastern locales. When this variable is
-non-zero, Emacs at startup sets 'locale-coding-system' to the
-corresponding encoding, instead of using 'w32-ansi-code-page'.
-
----
-** The default value of 'inhibit-compacting-font-caches' is t on MS-Windows.
-Experience shows that compacting font caches causes more trouble on
-MS-Windows than it helps.
+* Changes in Emacs 28.1 on Non-Free Operating Systems
+++
-** Font lookup on MS-Windows was improved to support rare scripts.
-To activate the improvement, run the new function
-'w32-find-non-USB-fonts' once per Emacs session, or assign to the new
-variable 'w32-non-USB-fonts' the list of scripts and the corresponding
-fonts. See the documentation of this function and variable in the
-Emacs manual for more details.
-
-+++
-** On NS the behavior of drag and drop can now be modified by use of
-modifier keys in line with Apples guidelines. This makes the drag and
-drop behavior more consistent, as previously the sending application
-was able to 'set' modifiers without the knowledge of the user.
-
-** On NS multicolor font display is enabled again since it is also
-implemented in Emacs on free operating systems via Cairo drawing.
+** On macOS, Emacs can now load dynamic modules with a '.dylib' suffix.
+'module-file-suffix' now has the value ".dylib" on macOS, but the
+'.so' suffix is supported as well.
----------------------------------------------------------------------
@@ -3607,6 +74,17 @@ GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>.
++++
+** 'read-number' now has its own history variable.
+Additionally, the function now accepts a HIST argument which can be
+used to specify a custom history variable.
+
++++
+** Input history for 'goto-line' is now local to every buffer.
+Each buffer will keep a separate history of line numbers used with
+'goto-line'. This should help making faster the process of finding
+line numbers that were previously jumped to.
+
Local variables:
coding: utf-8
diff --git a/etc/NEWS.27 b/etc/NEWS.27
new file mode 100644
index 00000000000..0c055ca682b
--- /dev/null
+++ b/etc/NEWS.27
@@ -0,0 +1,3615 @@
+GNU Emacs NEWS -- history of user-visible changes.
+
+Copyright (C) 2017-2019 Free Software Foundation, Inc.
+See the end of the file for license conditions.
+
+Please send Emacs bug reports to 'bug-gnu-emacs@gnu.org'.
+If possible, use 'M-x report-emacs-bug'.
+
+This file is about changes in Emacs version 27.
+
+See file HISTORY for a list of GNU Emacs versions and release dates.
+See files NEWS.26, NEWS.25, ..., NEWS.18, and NEWS.1-17 for changes
+in older Emacs versions.
+
+You can narrow news to a specific version by calling 'view-emacs-news'
+with a prefix argument or by typing 'C-u C-h C-n'.
+
+Temporary note:
++++ indicates that all relevant manuals in doc/ have been updated.
+--- means no change in the manuals is needed.
+When you add a new item, use the appropriate mark if you are sure it
+applies, and please also update docstrings as needed.
+
+
+* Installation Changes in Emacs 27.1
+
+---
+** Emacs now uses GMP, the GNU Multiple Precision library.
+By default, if 'configure' does not find a suitable libgmp, it
+arranges for the included mini-gmp library to be built and used.
+The new 'configure' option '--without-libgmp' uses mini-gmp even if a
+suitable libgmp is available.
+
+---
+** Emacs can now use HarfBuzz as its shaping engine.
+The new configure option '--with-harfbuzz' adds support for the
+HarfBuzz text shaping engine. It is on by default; use './configure
+--without-harfbuzz' to build without it. The HarfBuzz text shaping is
+available via new font backend drivers 'xfthb' and 'ftcrhb' for Xft
+and Cairo drawings, respectively, and via the 'harfbuzz' backend on
+MS-Windows. The Harfbuzz text shaping is preferred to the previously
+supported ones, so the font backends that use older shaping engines
+(FLT on GNU and Unix systems and Uniscribe on MS-Windows) are not
+enabled by default; they can be enabled via the 'font-backend' frame
+parameter or via X resources.
+
+---
+** The new configure option '--with-json' adds native support for JSON.
+This uses the Jansson library. The option is on by default; use
+'./configure --with-json=no' to build without Jansson support. The
+new JSON functions 'json-serialize', 'json-insert',
+'json-parse-string', and 'json-parse-buffer' are typically much faster
+than their Lisp counterparts from json.el.
+
+---
+** The configure option '--with-cairo' is no longer experimental.
+This builds Emacs with Cairo drawing, and supports built-in printing
+when Emacs is built with GTK+. Some severe bugs in this build were
+fixed, and we can therefore offer this to users without caveats.
+
++++
+** Emacs now uses a "portable dumper" instead of unexec.
+This improves compatibility with memory allocation on modern systems,
+and in particular better supports the Address Space Layout
+Randomization (ASLR) feature, a security technique used by most modern
+operating systems.
+
+When built with the portable dumping support (which is the default),
+Emacs looks for the 'emacs.pdmp' file, generated during the build, in
+its data directory at startup, and loads the dumped state from there.
+The new command-line argument '--dump-file=FILE' allows to specify a
+non-default '.pdmp' file to load the state from; see the node "Initial
+Options" in the Emacs manual for more information.
+
+An Emacs started via a dump file can create a new dump file only if it
+was invoked with the '-batch' option. (This is a temporary
+limitation; we plan on lifting it in a future release.)
+
+Although the portable dumper has been tested, it may have a bug on
+unusual platforms. If you require traditional unexec dumping you can
+use the configure-time option '--with-dumping=unexec'; however, please
+file a bug report describing the situation, as unexec dumping is
+deprecated, and we plan on removing it in some future release.
+
+---
+** The new configure option '--enable-checking=structs' attempts to
+check that the portable dumper code has been updated to match the last
+change to one of the data structures that it relies on.
+
+---
+** The configure options '--enable-checking=conslist' and
+'--enable-checking=xmallocoverrun' have been withdrawn. The former
+made Emacs irredeemably slow, and the latter made it crash. Neither
+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.)
+
+---
+** Emacs no longer defaults to using ImageMagick to display images.
+This is due to security and stability concerns with ImageMagick. 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'.
+
+---
+** The 'etags' program now uses the C library's regular expression matcher.
+If it's possible, 'etags' will use the regexp matcher from the
+system's standard C library, otherwise it will be linked with a
+compatible regex substitute. This lets developers maintain Emacs's
+own regex code without having to also support other programs. The new
+configure option '--without-included-regex' forces 'etags' to use the C
+library's regex matcher even if the regex substitute ordinarily would
+be used to work around compatibility problems.
+
+---
+** Emacs has been ported to the '-fcheck-pointer-bounds' option of GCC.
+This causes Emacs to check bounds of some arrays addressed by its
+internal pointers, which can be helpful when debugging the Emacs
+interpreter or modules that it uses. If your platform supports it you
+can enable it when configuring, e.g., './configure CFLAGS="-g3 -O2
+-mmpx -fcheck-pointer-bounds"' on Intel MPX platforms.
+
+---
+** Emacs now normally uses a C pointer type instead of a C integer
+type to implement Lisp_Object, which is the fundamental machine word
+type internal to the Emacs Lisp interpreter. This change aims to
+catch typos and supports '-fcheck-pointer-bounds'. The 'configure'
+option '--enable-check-lisp-object-type' is therefore no longer as
+useful and so is no longer enabled by default in developer builds,
+to reduce differences between developer and production builds.
+
+---
+** 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.
+
+---
+** New make target 'help' shows a summary of common make targets.
+
+---
+** Emacs now builds with dynamic module support by default.
+Pass '--without-modules' to 'configure' to disable dynamic module
+support.
+
+
+* Startup Changes in Emacs 27.1
+
++++
+** Emacs now uses the XDG convention for init files.
+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")
+specifies the parent directory of these and other configuration files,
+and will override their traditional locations (the home directory,
+"~/.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
+XDG_CONFIG_HOME='/nowhere' might be useful if your new-location init
+files are scrambled, or if you want to force Emacs to ignore files
+under XDG_CONFIG_HOME for some other reason.
+
++++
+** Emacs can now be configured using an early init file.
+The file is called 'early-init.el', in 'user-emacs-directory'. It is
+loaded very early in the startup process: before graphical elements
+such as the tool bar are initialized, and before the package manager
+is initialized. The primary purpose is to allow customizing how the
+package system is initialized given that initialization now happens
+before loading the regular init file (see below).
+
+We recommend against putting any customizations in this file that
+don't need to be set up before initializing installed add-on packages,
+because the early init file is read too early into the startup
+process, and some important parts of the Emacs session, such as
+'window-system' and other GUI features, are not yet set up, which could
+make some customization fail to work.
+
++++
+** Installed packages are now activated *before* loading the init file.
+As a result of this change, it is no longer necessary to call
+'package-initialize' in your init file.
+
+Previously, a call to 'package-initialize' was automatically inserted
+into the init file when Emacs was started. This call can now safely
+be removed. Alternatively, if you want to ensure that your init file
+is still compatible with earlier versions of Emacs, change it to:
+
+(when (< emacs-major-version 27)
+ (package-initialize))
+
+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.
+Units that are ordered after 'emacs.service' will only be started
+after Emacs has finished initialization and is ready for use.
+(If your Emacs is installed in a non-standard location and you copied the
+emacs.service file to eg "~/.config/systemd/user/", you will need to copy
+the new version of the file again.)
+
+
+* Changes in Emacs 27.1
+
++++
+** Emacs now supports resizing and rotating images without ImageMagick.
+All modern systems support this feature. (On GNU and Unix systems,
+Cairo drawing or the XRender extension to X11 is required for this to
+be available; the configure script will test for it and, if found,
+enable scaling.)
+
+The new function 'image-transforms-p' can be used to test whether any
+given frame supports these capabilities.
+
++++
+** The Network Security Manager now allows more fine-grained control
+of what checks to run via the 'network-security-protocol-checks'
+user option.
+
++++
+** TLS connections have their security tightened by default.
+Most of the checks for outdated, believed-to-be-weak TLS algorithms
+and ciphers are now switched on by default. (In addition, several new
+TLS weaknesses are now warned about.) By default, the NSM will
+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 user option to only happen on the 'high'
+security level (assuming you use the 'medium' level).
+
+---
+** New user option 'nsm-trust-local-network'.
+Allows skipping Network Security Manager checks for hosts on your
+local subnet(s). It defaults to nil. Usually, there should be no
+need to set this non-nil, and doing that risks opening your local
+network connections to attacks. So be sure you know what you are
+doing before changing the value.
+
++++
+** 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
+':client-certificate t' to trigger looking up of per-server
+certificates via 'auth-source'.
+
++++
+** New user option 'network-stream-use-client-certificates'.
+When non-nil, 'open-network-stream' performs lookups of client
+certificates using 'auth-source' as if ':client-certificate t' were
+specified if there is no explicit ':client-certificate' parameter.
+Defaults to nil.
+
++++
+** 'next/previous-multiframe-window' have been renamed.
+The new names are as follows:
+
+ 'next-multiframe-window' -> 'next-window-any-frame'
+ 'previous-multiframe-window' -> 'previous-window-any-frame'
+
+The old function names are maintained as aliases for backward
+compatibility.
+
+** emacsclient
+
++++
+*** emacsclient now supports the 'EMACS_SOCKET_NAME' environment variable.
+The command-line argument '--socket-name' overrides it.
+(The same behavior as for the pre-existing 'EMACS_SERVER_FILE' variable.)
+
++++
+*** Emacs and emacsclient now default to "$XDG_RUNTIME_DIR/emacs".
+This is used as the directory for client/server sockets, if Emacs is
+running on a platform or environment 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.
+
+---
+*** When run by root, emacsclient no longer connects to non-root sockets.
+(Instead you can use Tramp methods to run root commands in a non-root Emacs.)
+
+---
+** 'xft-ignore-color-fonts' now ignores even more color fonts.
+There are color fonts that managed to bypass the existing checks,
+causing XFT crashes, they are now filtered out. Setting
+'xft-ignore-color-fonts' to nil removes those checks, which might
+require setting 'face-ignored-fonts' to filter out problematic fonts.
+Known problematic fonts are "Noto Color Emoji" and "Emoji One".
+
++++
+** New user option 'what-cursor-show-names'.
+When non-nil, 'what-cursor-position' will show the name of the character
+in addition to the decimal/hex/octal representation. Default nil.
+
++++
+** New function 'network-lookup-address-info'.
+This does IPv4 and/or IPv6 address lookups on hostnames.
+
++++
+** 'network-interface-list' can now return IPv4 and IPv6 addresses.
+IPv4 and IPv6 addresses are now returned by default if available,
+optionally including netmask/broadcast address information.
+
+---
+** Control of the threshold for using the 'distant-foreground' color.
+The threshold for color distance below which the 'distant-foreground'
+color of the face will be used instead of the foreground color can now
+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-answer' now accepts not only single character
+answers, but also function keys like 'F1', character events such as
+'C-M-h', and control characters like 'C-h'.
+
+** 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 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 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'.
+This hook is a convenient place to perform initializations in daemon
+mode which require GUI features to be available. One example is
+restoration of the previous session using the desktop.el package: put
+the call to 'desktop-read' in this hook, if you want the GUI settings
+to be restored, or if desktop.el needs to interact with you during
+restoration of the session.
+
++++
+** The functions 'set-frame-height' and 'set-frame-width' are now
+commands, and will set the currently selected frame to the height/
+width specified by the numeric prefix.
+
++++
+** New function 'logcount' calculates an integer's Hamming weight.
+
++++
+** New function 'libxml-available-p'.
+This function returns non-nil if libxml support is both compiled in
+and available at run time. Lisp programs should use this function to
+detect built-in libxml support, instead of testing for that
+indirectly, e.g., by checking that functions like
+'libxml-parse-html-region' return nil.
+
++++
+** '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
+used to remove comments before calling the libxml functions to parse
+the data.
+
++++
+** A new DOM (the XML/HTML document structure returned by functions
+such as 'libxml-parse-html-region') traversal function has been added:
+'dom-search', which takes a DOM and a predicate and returns all nodes
+that match.
+
++++
+** New function 'fill-polish-nobreak-p', to be used in 'fill-nobreak-predicate'.
+It blocks line breaking after a one-letter word, also in the case when
+this word is preceded by a non-space, but non-alphanumeric character.
+
++++
+** The limit on repetitions in regexps has been raised to 2^16-1.
+It was previously limited to 2^15-1. For example, the following
+regular expression was previously invalid, but is now accepted:
+
+ x\{32768\}
+
+---
+** The German prefix and postfix input methods now support Capital sharp S.
+
+---
+** New input methods 'hawaiian-postfix' and 'hawaiian-prefix'.
+
+---
+** New input methods 'georgian-qwerty' and 'georgian-nuskhuri'.
+
+---
+** New input methods for several variants of the Sami language.
+The Sami input methods include: 'norwegian-sami-prefix',
+'bergsland-hasselbrink-sami-prefix', 'southern-sami-prefix',
+'ume-sami-prefix', 'northern-sami-prefix', 'inari-sami-prefix',
+'skolt-sami-prefix', and 'kildin-sami-prefix'.
+
++++
+** Japanese environments use UTF-8 by default.
+In Japanese environments that do not specify encodings and are not
+based on MS-Windows, the default encoding is now utf-8 instead of
+japanese-iso-8bit.
+
++++
+** New function 'exec-path'.
+This function by default returns the value of the corresponding
+user option, but can optionally return the equivalent of 'exec-path'
+from a remote host.
+
++++
+** The function 'executable-find' supports an optional argument REMOTE.
+This triggers to search the program on the remote host as indicated by
+'default-directory'.
+
++++
+** New user option 'auto-save-no-message'.
+When set to t, no message will be shown when auto-saving (default
+value: nil).
+
+---
+** The value of 'make-cursor-line-fully-visible' can now be a function.
+In addition to nil or non-nil, the value can now be a predicate
+function. Follow mode uses this to control scrolling of its windows
+when the last screen line in a window is not fully visible.
+
++++
+** New variable 'emacs-repository-branch'.
+It reports the git branch from which Emacs was built.
+
++++
+** New user option 'switch-to-buffer-obey-display-actions'.
+When non-nil, 'switch-to-buffer' uses 'pop-to-buffer-same-window' that
+respects display actions specified by 'display-buffer-alist' and
+'display-buffer-overriding-action'.
+
++++
+** The user option 'switch-to-visible-buffer' is now obsolete.
+Customize 'switch-to-prev-buffer-skip' instead.
+
++++
+** New user option 'switch-to-prev-buffer-skip'.
+This user option allows to specify the set of buffers that may be
+shown by 'switch-to-prev-buffer' and 'switch-to-next-buffer' more
+stringently than the now obsolete 'switch-to-visible-buffer'.
+
+** New 'flex' completion style
+An implementation of popular "flex/fuzzy/scatter" completion which
+matches strings where the pattern appears as a subsequence. Put
+simply, makes "foo" complete to both "barfoo" and "frodo". Add 'flex'
+to 'completion-styles' or 'completion-category-overrides' to use it.
+
+** The 'completion-common-part' face is now visible by default.
+
++++
+** New face attribute ':extend' to control face extension at EOL.
+The new face attribute ':extend' controls whether to use the face for
+displaying the empty space beyond end of line (EOL) till the edge of
+the window. By default, this attribute is non-nil only for a small
+number of faces, notably, 'region'; any other face that crosses end of
+line will not affect the display of the empty space at EOL. This is
+to make Emacs behave more like other GUI applications with respect to
+displaying faces that cross line boundaries.
+
+This attribute behaves specially when theme definitions are applied:
+if the theme doesn't specify an explicit value of this attribute for a
+face, the value from the original face definition is inherited.
+Consequently, a theme generally shouldn't specify this attribute
+unless it has a good reason to do so.
+
+** Connection-local variables
+
++++
+*** Connection-local variables are applied by default like file-local
+and directory-local variables.
+
++++
+*** The macro 'with-connection-local-variables' has been renamed from
+'with-connection-local-profiles'. No argument PROFILES needed any longer.
+
+---
+** New user option 'next-error-verbose' controls when 'next-error'
+outputs a message about the error locus.
+
+---
+** New user option 'grep-search-path' defines the directories searched for
+grep hits (this used to be controlled by 'compilation-search-path').
+
+---
+** 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').
+
+---
+** 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 user options '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".
+
++++
+** 'progress-reporter-update' accepts a suffix string to display.
+
+---
+** New user option 'xref-file-name-display' controls the display of
+file names in xref buffers.
+
+** New user option 'byte-count-to-string-function'.
+It is used for displaying file sizes and disk space in some cases.
+
++++
+** Emacs now interprets RGB triplets like HTML, SVG, and CSS do.
+
+The X convention previously used differed slightly, particularly for
+RGB triplets with a single hexadecimal digit per component.
+
+---
+** The toolbar now shows the equivalent key binding in its tooltips.
+
+---
+** The File menu-bar menu was re-arranged: Print menu items moved to
+submenu, and also added the new entries for tabs.
+
+---
+** 'scroll-lock-mode' is now bound to the 'Scroll_Lock' key globally.
+Note that this key binding will not work on MS-Windows systems if
+'w32-scroll-lock-modifier' is non-nil.
+
+---
+** 'global-set-key', called interactively, now no longer downcases a
+key binding with an upper case letter - if you can type it, you can
+bind it.
+
++++
+** 'read-from-minibuffer' now works with buffer-local history variables.
+The HIST argument of 'read-from-minibuffer' now works correctly with
+buffer-local variables. This means that different buffers can have
+their own separated input history list if desired.
+
+** 'backup-by-copying-when-privileged-mismatch' applies to file gid, too.
+In addition to checking the file owner uid, Emacs also checks that the
+group gid is not greater than 'backup-by-copying-when-privileged-mismatch';
+if so, 'backup-by-copying-when-mismatch' will be forced on.
+
+
+* Editing Changes in Emacs 27.1
+
++++
+** When asked to visit a large file, Emacs now offers visiting it literally.
+Previously, Emacs would only ask for confirmation before visiting
+large files. Now it also offers a third alternative: to visit the
+file literally, as in 'find-file-literally', which speeds up
+navigation and editing of large files.
+
++++
+** 'zap-to-char' now uses history of characters you used to zap to.
+'zap-to-char' uses the new 'read-char-from-minibuffer' function to allow
+navigating through the history of characters that have been input.
+This is mostly useful for characters that have complex input methods
+where inputting the character again may involve many keystrokes.
+
++++
+** 'save-some-buffers' now has a new action in the prompt: 'C-f' will
+exit the command and switch to the buffer currently being asked about.
+
+---
+** More commands support noncontiguous rectangular regions, namely
+'upcase-dwim', 'downcase-dwim', 'capitalize-dwim', 'capitalize-region',
+'upcase-initials-region', 'replace-string', 'replace-regexp', and
+'delimit-columns-region'.
+
++++
+** The new 'amalgamating-undo-limit' variable can be used to control
+how many changes should be amalgamated when using the 'undo' command.
+
+---
+** The 'newline-and-indent' command (commonly bound to 'RET' in many
+modes) now takes an optional numeric argument to specify how many
+times is should insert newlines (and indent).
+
++++
+** New command 'make-empty-file'.
+
+---
+** New variable 'x-wait-for-event-timeout'.
+This controls how long Emacs will wait for updates to the graphical
+state to take effect (making a frame visible, for example).
+
++++
+** New user option 'electric-quote-replace-double'.
+This option controls whether '"' is replaced in 'electric-quote-mode',
+in addition to other quote characters. If non-nil, ASCII double-quote
+characters that quote text "like this" are replaced by double
+typographic quotes, “like this”, in text modes, and in comments in
+non-text modes.
+
+---
+** New user option 'flyspell-case-fold-duplications'.
+This option controls whether Flyspell mode considers consecutive words
+to be duplicates if they are not in the same case. If non-nil, the
+default, words are considered to be duplicates even if their letters'
+case does not match.
+
+---
+** 'write-abbrev-file' now includes special properties.
+'write-abbrev-file' now writes special properties like ':case-fixed'
+for abbrevs that have them.
+
++++
+** 'write-abbrev-file' skips empty tables.
+'write-abbrev-file' now skips inserting a 'define-abbrev-table' form for
+tables which do not have any non-system abbrevs to save.
+
++++
+** The new functions and commands 'text-property-search-forward' and
+'text-property-search-backward' have been added. These provide an
+interface that's more like functions like 'search-forward'.
+
+---
+** 'add-dir-local-variable' now uses dotted pair notation syntax to
+write alists of variables to ".dir-locals.el". This is the same
+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.
+'make-network-process' now uses the correct loopback address when
+asked to use ':host 'local' and ':family 'ipv6'.
+
++++
+** 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').
+
++++
+** The command 'replace-buffer-contents' now has two optional
+arguments mitigating performance issues when operating on huge
+buffers.
+
++++
+** Dragging 'C-M-mouse-1' now marks rectangular regions.
+
++++
+** 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.
+
++++
+** You can now change the font size with the mouse wheel.
+Scroling the mouse wheel with the Ctrl key pressed will now act the
+same as the 'C-x C-+' and 'C-x C--' commands.
+
+
+* Changes in Specialized Modes and Packages in Emacs 27.1
+
+---
+** New HTML mode skeleton 'html-id-anchor'.
+This new command (which inserts an <a id="foo">_</a> skeleton) is
+bound to 'C-c C-c #'.
+
++++
+** New command 'font-lock-refontify'.
+This is an interactive convenience function to be used when developing
+font locking for a mode. It recomputes the font locking data and then
+re-fontifies the buffer.
+
+---
+** Font Lock is smarter about fontifying unterminated strings and comments.
+When you type a quote that starts a string, or a comment delimiter
+that starts a comment, font-lock will not immediately refontify the
+following characters in 'font-lock-string-face' or
+'font-lock-comment-face'. Instead, it will delay the fontification
+beyond the current line to give you a chance to close the string or
+comment. This is controlled by the new user option
+'jit-lock-antiblink-grace', which specifies the delay in seconds. The
+default is 2 seconds; set to nil to get back the old behavior.
+
+---
+** The 'C' command in 'tar-mode' will now preserve the timestamp of
+the extracted file if the new user option 'tar-copy-preserve-time' is
+non-nil.
+
+---
+** 'autoconf-mode' is now used instead of 'm4-mode' for the
+acinclude.m4/aclocal.m4/acsite.m4 files.
+
+---
+** On GNU/Linux, 'M-x battery' will now list all batteries, no matter
+what they're named, and the 'battery-linux-sysfs-regexp' variable has
+been removed.
+
+** The 'list-processes' command now includes port numbers in the
+network connection information (in addition to the host name).
+
+** The 'cl' package is now officially deprecated in favor of 'cl-lib'.
+
+---
+** desktop
+*** When called interactively with a prefix arg 'C-u', 'desktop-read'
+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 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
+an offset to absolute line numbers.
+
++++
+** winner
+*** A new user option, 'winner-boring-buffers-regexp', has been added.
+
+** table
+** 'table-generate-source' and friends now support outputting wiki and
+mediawiki format tables.
+
+---
+** telnet-mode
+*** Reverting a buffer in 'telnet-mode' will restart a closed connection.
+
+** goto-addr
+*** A way to more conveniently specify what URI address schemes that
+should be ignored have been added via the
+'goto-address-uri-schemes-ignored' variable.
+
++++
+** tex-mode
+*** 'latex-noindent-commands' controls indentation of certain commands.
+You can use this new user option to control indentation of arguments of
+\emph, \footnote, and similar commands.
+
+** byte compiler
+*** 'byte-compile-dynamic' is now obsolete.
+This is because on the one hand it suffers from misbehavior in corner
+cases that have plagued it for years, and on the other experiments indicated
+that it doesn't bring any measurable benefit.
+
+---
+*** The 'g' keystroke in *Compile-Log* buffers has been bound to a new
+command that will recompile the file previously compiled with 'M-x
+byte-compile-file' and the like.
+
+** compile.el
+---
+*** In 'compilation-error-regexp-alist', 'line' (and 'end-line') can
+be functions.
++++
+*** 'compilation-context-lines' can now take the value t; this is like
+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' user option can
+be used to transform file name matches compilation output, and remove
+known false positives being recognized as warnings/errors.
+
+** cl-lib.el
++++
+*** 'cl-defstruct' has a new ':noinline' argument to prevent inlining
+its functions.
+
++++
+*** 'cl-defstruct' slots accept a ':documentation' property.
+
+---
+*** 'cl-values-list' will now signal an error if its argument isn't a list.
+
+** doc-view.el
+*** New commands 'doc-view-presentation' and 'doc-view-fit-window-to-page'.
+*** Added support for password-protected PDF files
+
+*** 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
+names match certain regular expressions as big. Ido won't attempt to
+list the contents of such directories when completing file names.
+
+** Minibuffer
+
++++
+*** 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).
+
++++
+*** When the minibuffer is active, echo-area messages are displayed at
+the end of the minibuffer instead of hiding the minibuffer by the echo
+area display. The new user option 'minibuffer-message-clear-timeout'
+controls how messages displayed in this situation are removed from the
+minibuffer.
+
+---
+*** Minibuffer now uses 'minibuffer-message' to display error messages
+at the end of the active minibuffer.
+
++++
+*** 'y-or-n-p' now uses the minibuffer to read 'y' or 'n' answer.
+
+---
+*** Some commands that previously used 'read-char-choice' now read
+a character using the minibuffer by 'read-char-from-minibuffer'.
+
+** map.el
+*** Now also understands plists.
+*** Now defined via generic functions that can be extended via 'cl-defmethod'.
+*** Deprecate the 'map-put' macro in favor of a new 'map-put!' function.
+*** 'map-contains-key' now returns a boolean rather than the key.
+*** Deprecate the 'testfn' args of 'map-elt' and 'map-contains-key'.
+*** New generic function 'map-insert'.
+
++++
+*** The 'type' arg can be a list '(hash-table :key1 VAL1 :key2 VAL2 ...)'.
+
+** seq.el
+New convenience functions 'seq-first' and 'seq-rest' give easy access
+to respectively the first and all but the first elements of sequences.
+
+The new predicate function 'seq-contains-p' should be used instead of
+the now obsolete 'seq-contains'.
+
+---
+** Follow mode
+In the current follow group of windows, "ghost" cursors are no longer
+displayed in the non-selected follow windows. To get the old behavior
+back, customize 'follow-hide-ghost-cursors' to nil.
+
++++
+** New variable 'warning-fill-column' for 'display-warning'.
+
+** Windmove
+
+---
+*** 'windmove-create-window' when non-nil makes a new window.
+This happens upon moving off the edge of the frame.
+
+---
+*** Windmove supports directional window display and selection.
+The new command 'windmove-display-default-keybindings' binds default
+keys with provided modifiers (by default, Shift-Meta) to the commands
+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,
+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. 'S-M-t C-h C-n'
+displays NEWS in a new tab.
+
+---
+*** Windmove also supports directional window deletion.
+The new command 'windmove-delete-default-keybindings' binds default
+keys with provided prefix (by default, 'C-x') and modifiers (by default,
+'Shift') to the commands that delete the window in the specified
+direction. For example, 'C-x S-down' deletes the window below.
+With a prefix arg 'C-u', also kills the buffer in that window.
+With 'M-0', deletes the selected window and selects the window
+that was in the specified direction.
+
+---
+*** New command 'windmove-swap-states-in-direction' binds default keys
+to the commands that swap the states of the selected window with the
+window in the specified direction.
+
+---
+*** Windmove code no longer used is now obsolete.
+That includes the user option 'windmove-window-distance-delta' and the
+functions 'windmove-coord-add', 'windmove-constrain-to-range',
+'windmove-constrain-around-range', 'windmove-frame-edges',
+'windmove-constrain-loc-for-movement', 'windmove-wrap-loc-for-movement',
+'windmove-reference-loc' and 'windmove-other-window-loc'.
+
+** Octave mode
+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 user option 'project-read-file-name-function'.
+
+** Etags
+
++++
+*** 'next-file' is now an obsolete alias of 'tags-next-file'.
+
+---
+*** 'tags-loop-revert-buffers' is an obsolete alias of
+'fileloop-revert-buffers'.
+
++++
+*** The 'tags-loop-continue' function along with the
+'tags-loop-operate' and 'tags-loop-scan' variables are now obsolete;
+use the new 'fileloop-initialize' and 'fileloop-continue' functions
+instead.
+
++++
+*** etags is now able to read Zstandard-compressed files.
+
+** bibtex
+
+---
+*** New commands 'bibtex-next-entry' and 'bibtex-previous-entry'.
+In 'bibtex-mode-map', 'forward-paragraph' and 'backward-paragraph' are
+remapped to these, respectively.
+
+** Dired
+
+---
+*** On systems that support suid/guid files, Dired now fontifies the
+permissions of such files with a special face 'dired-set-id'.
+
++++
+*** New command 'dired-create-empty-file'.
+
++++
+*** New command 'dired-number-of-marked-files'.
+It is by default bound to '* N'.
+
+---
+*** The marking commands now report how many files were marked by the
+command itself, not how many files are marked in total.
+
+---
+*** A new face, 'dired-special', is used to highlight sockets, named
+pipes, block devices and character devices.
+
++++
+*** The new user option 'dired-create-destination-dirs' controls whether
+'dired-do-copy' and 'dired-rename-file' should create non-existent
+directories in the destination.
+
++++
+*** 'dired-dwim-target' can be customized to prefer either the next window,
+or one of the most recently visited windows with a Dired buffer.
+
++++
+*** When the new user option 'dired-vc-rename-file' is non-nil,
+Dired performs file renaming using underlying version control system.
+
+---
+*** Zstandard compression is now supported for 'dired-do-compress' and
+'dired-do-compress-to'.
+
+** Find-Dired
+
+---
+*** New user option 'find-dired-refine-function'.
+The default value is 'find-dired-sort-by-filename'.
+
+---
+*** New sorting options for the user option 'find-ls-option'.
+
+** Change Logs and VC
+
+---
+*** New user option 'vc-tor'.
+When non-nil, this user option causes the VC commands to communicate
+with the repository via Tor's proxy, using the 'torsocks' wrapper
+script. The default is nil.
+
++++
+*** New command 'log-edit-generate-changelog-from-diff', bound to 'C-c C-w'.
+This generates ChangeLog entries from the VC fileset diff.
+
+---
+*** 'vc-dir' now shows a button allowing you to hide the stash list.
+Controlled by user option 'vc-git-show-stash'. Default t means show
+the entire list as before. An integer value limits the list length
+(but still allows you to show the entire list via the button).
+
++++
+*** Recording ChangeLog entries doesn't require an actual file.
+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 user option to nil to get the
+previous behavior of always creating a buffer that visits a ChangeLog
+file.
+
+---
+*** 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.
+
+---
+*** 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.
+When some files are marked, only those are stashed.
+When no files are marked, all modified files are stashed, as before.
+
+---
+*** 'vc-git-stash' is now bound to 'C' in the stash headers.
+
+--
+*** Some stash keybindings are now available in the stash button.
+'vc-git-stash' and 'vc-git-stash-snapshot' can now be run using 'C'
+and 'S' respectively, including when there are no stashes.
+
+---
+*** The new hook 'vc-retrieve-tag-hook' runs after retrieving a tag.
+
+---
+*** 'vc-hg' now invokes 'smerge-mode' when visiting files.
+Code that attempted to invoke 'smerge-mode' when visiting an Hg file
+with conflicts existed in earlier versions of Emacs, but incorrectly
+never detected a conflict due to invalid assumptions about cached
+values.
+
++++
+*** The Hg (Mercurial) back-end now supports 'vc-region-history'.
+The 'C-x v h' command now works in buffers that visit files controlled
+by Hg.
+
++++
+*** The Hg (Mercurial) back-end now prompts for revision to merge when
+you invoke 'C-x v m' ('vc-merge').
+
+---
+*** The Hg (Mercurial) back-end now use tags, branches and bookmarks
+instead of revision numbers as completion candidates when it prompts
+for a revision.
+
++++
+*** 'C-u C-x v D' ('vc-root-version-diff') prompts for two revisions
+and compares their entire trees.
+
+*** New user option 'vc-hg-revert-switches'.
+It specifies switches to pass to Hg's 'revert' command.
+
+*** '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
+given revisions.
+
++++
+*** The new 'd' command ('vc-dir-clean-files') in 'vc-dir-mode'
+buffers will delete the marked files (or if no files are marked, the
+file under point). This command does not notify the VC backend, and
+is mostly useful for unregistered files.
+
++++
+*** New command 'vc-log-search' asks for a pattern, searches it
+in the revision log, and displays matched log entries in the
+log buffer. For example, 'M-x vc-log-search RET bug#36644 RET'
+displays all entries whose log messages match the bug number.
+With a prefix argument asks for a command, so for example,
+'C-u M-x vc-log-search RET git log -1 f302475 RET' will display
+just one log entry found by its revision number.
+
++++
+*** It is now possible to display a specific revision given by its ID.
+If you invoke 'C-x v L' ('vc-print-root-log') with a numeric argument
+of 1, as in 'C-1 C-x v L' or 'C-u 1 C-x v L', it asks for a revision
+ID, and shows its log entry together with the diffs introduced by the
+revision's commit. (For some less capable VCSes, only the log entry
+is shown.)
+
+---
+*** 'C-x v =' can now mimic Magit's diff format.
+Set the new user option 'diff-font-lock-prettify' to t for that, see
+below under "Diff mode".
+
+---
+*** The 'diff' function arguments OLD and NEW may each be a buffer
+rather than a file, in non-interactive calls. This change was made in
+Emacs 24.1, but wasn't documented until now.
+
++++
+*** New command 'diff-buffers' interactively diffs two buffers.
+
+** Diff mode
++++
+*** Hunks are now automatically refined by font-lock.
+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
+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 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.
+On GUI frames, this option also displays the insertion and deletion
+indicators on the left fringe.
+
++++
+*** Prefix arg of 'diff-goto-source' means jump to the old revision
+of the file under version control if point is on an old changed line,
+or to the new revision of the file otherwise.
+
+** Texinfo
+
++++
+*** 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'.
+
+** Browse-url
+
+---
+*** The function 'browse-url-emacs' can now visit a URL in selected window.
+It now treats the optional 2nd argument to mean that the URL should be
+shown in the currently selected window.
+
+---
+*** A new function, 'browse-url-add-buttons' can be used to add clickable
+links to most ordinary special-mode buffers that display text that
+have URLs embedded. 'browse-url-button-regexp' controls what's
+considered a button.
+
+---
+*** New user option 'browse-url-secondary-browser-function'.
+It can be set to a function that invokes an alternative browser.
+
+** Comint
+
++++
+*** 'send-invisible' is now an obsolete alias for 'comint-send-invisible'.
+Also, 'shell-strip-ctrl-m' is declared obsolete.
+
++++
+*** 'C-c .' ('comint-insert-previous-argument') no longer interprets '&'.
+This feature caused problems when '&&' was present in the previous
+command. Since this command emulates 'M-.' in Bash and zsh, neither
+of which treats '&' specially, the feature was removed for
+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 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
+from the beginning of the arguments, while the latter counts from the
+end.
+
++++
+*** 'comint-run' can now accept a list of switches to pass to the program.
+'C-u M-x comint-run' will prompt for the switches interactively.
+
++++
+*** Abnormal hook 'comint-password-function' has been added.
+This hook permits a derived mode to supply a password for the
+underlying command interpreter without prompting the user. For
+example, in 'sql-mode', the password for connecting to the database may
+be stored in the connection wallet and may be passed on the command
+line to start the SQL interpreter. This is a potential security flaw
+that could expose user's database passwords on the command line
+through the use of a process list (Bug#8427). With this hook, it is
+possible to not pass the password on the command line and wait for the
+program to prompt for the password. When it does so, the password can
+be supplied to the SQL interpreter without involving the user just as
+if it had been supplied on the command line.
+
+** 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
+sparse and rules for formatting are fairly well established. Instead
+SQL is more like COBOL (from which it came) and code tends to be very
+dense and line ending decisions driven by syntax and line length
+considerations to make readable code. Experienced SQL developers may
+prefer to rely upon existing Emacs facilities for formatting code but
+the 'sql-indent' package provides facilities to aid more casual SQL
+developers layout queries and complex expressions.
+
+---
+**** 'sql-use-indent-support' (default t) enables SQL indention support.
+The 'sql-indent' package from ELPA must be installed to get the
+indentation support in 'sql-mode' and 'sql-interactive-mode'.
+
+---
+**** 'sql-mode-hook' and 'sql-interactive-mode-hook' changed.
+Both hook variables have had 'sql-indent-enable' added to their
+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,
+like 'sql-mysql' or 'my-postgres', the password wallet will be
+searched for the password. The 'sql-product', 'sql-server',
+'sql-database', and the 'sql-username' will be used to identify the
+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
+formats. By default, the wallet file is expected to be in the
+'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.
+
+** Term
+
+---
+*** 'term-read-noecho' is now obsolete, use 'read-passwd' instead.
+
++++
+*** 'serial-term' now takes an optional parameter to leave the
+emulator in line mode.
+
+** Flymake
+
++++
+*** The variable 'flymake-diagnostic-types-alist' is obsolete.
+You should instead set properties on known diagnostic symbols, like
+':error' and ':warning', as demonstrated in the Flymake manual.
+
++++
+*** 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.
+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
+it can't find the config file.
+
+---
+*** Rubocop is called with 'bundle exec' if Gemfile mentions it.
+
+---
+*** New command 'ruby-find-library-file' bound to 'C-c C-f'.
+
+** Package
+
+---
+*** Warn if "footer line" is missing, but still install package.
+package.el used to refuse to install a package without the so-called
+"footer line", which appears at the very end of the file:
+
+;;; FILENAME ends here
+
+package.el will now install packages without this line, but it will
+issue a warning. To avoid this warning, packages should keep the
+"footer line".
+
+Note that versions of Emacs older than 27.1 will not only refuse to
+install packages without such a line -- they will be unable to parse
+package data. It is therefore recommended to keep this line.
+
++++
+*** 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.
+
++++
+*** The meaning of 'allow-unsigned' in 'package-check-signature' has
+changed slightly: If a usable OpenPGP configuration can't be found
+(for instance, if gpg isn't installed), it now has the same meaning as
+nil.
+
+---
+*** 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 user options 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'.
+
++++
+*** New functions for filtering packages list.
+A new function has been added which allows users to filter the
+packages list by name: 'package-menu-filter-by-name'. By default, it
+is bound to '/ n'. Additionally, the function
+'package-menu-filter-by-keyword' has been renamed from
+'package-menu-filter'. Its keybinding has also been changed to '/ k'
+(from 'f'). To clear any of the two filters, the user can now call
+the 'package-menu-clear-filter' function, bound to '/ /' by default.
+
+---
+*** Imenu support has been added to 'package-menu-mode'.
+
+---
+*** The package list can now be sorted by version or description.
+
++++
+*** In Package Menu, 'g' now updates package data from archives.
+Previously, 'g' invoked 'tabulated-list-revert' which did not update
+the cached archive data. It is now bound to 'revert-buffer', which
+will update the data.
+
+'package-menu-refresh' is an obsolete alias for 'revert-buffer'.
+
+** Info
+
++++
+*** Clicking on the left/right arrow icon in the Info tool-bar while
+holding down the Ctrl key pops up a menu of previously visited Info nodes
+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.
+
+---
+** Display of man pages now limits the width for formatting pages.
+The new user option 'Man-width-max' (80 by default) limits the number
+of columns passed to the 'man' program for formatting man pages. This
+is to enhance readability when man pages are displayed in very wide
+windows (which are customary with today's large displays).
+
+** Xref
+
++++
+*** New command 'xref-find-definitions-at-mouse'.
+This command finds definitions of the identifier at the place of a
+mouse click event, and is intended to be bound to a mouse event.
+
++++
+*** Changing 'xref-marker-ring-length' works after 'xref.el' is loaded.
+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.
+
+---
+*** New xref faces 'xref-file-header', 'xref-line-number', 'xref-match'.
+
+---
+*** 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.
+
+---
+*** Search results show the buffer even for one hit.
+The search-type Xref commands (e.g. 'xref-find-references' or
+'project-find-regexp') now show the results buffer even when there is
+only one hit. This can be altered by changing
+'xref-show-xrefs-function'.
+
++++
+*** Xref buffers support refreshing the search results.
+A new command 'xref-revert-buffer' is bound to 'g'.
+
+---
+*** Imenu support has been added to 'xref--xref-buffer-mode'.
+
+** Icomplete
+
++++
+*** New minor mode Fido mode.
+This mode is based on Icomplete, and its name stands for "Fake Ido".
+The point of this mode is to be an 'ido-mode' workalike, but provide
+most of the functionality present in Icomplete that is not in
+'ido-mode', while being much more compatible with all of Emacs's
+completion facilities.
+
+** Ecomplete
+
+---
+*** The ecomplete sorting has changed to a decay-based algorithm.
+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".
+
+** Gnus
+
+---
+*** 'mm-uu-diff-groups-regexp' now defaults to matching all groups,
+which means that "git am" diffs are recognized everywhere.
+
++++
+*** 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
+the previous unseen or next unseen article. (These are the ones that
+are marked with "." in the summary mode lines.)
+
++++
+*** The Gnus user variable 'nnimap-expunge' supports three new values:
+'never' for never expunging messages, 'immediately' for immediately
+expunging deleted messages, and 'on-exit' to expunge deleted articles
+when exiting the group's summary buffer. Setting 'nnimap-expunge' to
+'nil' or 't' is still supported but not recommended, since it may
+result in Gnus expunging all messages that have been flagged as
+deleted by any IMAP client (rather than just those that have been
+deleted by Gnus).
+
++++
+*** New user option 'gnus-use-atomic-windows' makes Gnus window layouts atomic.
+See the "Atomic Windows" section of the Elisp manual for details.
+
++++
+*** There's a new value for 'gnus-article-date-headers',
+'combined-local-lapsed', which will show both the time (in the local
+timezone) and the lapsed time.
+
+---
+*** Gnus now maps imaps to 993 only on old MS-Windows versions.
+The nnimap backend used to do this unconditionally to work around
+problems on old versions of MS-Windows. This is now done only for
+Windows XP and older.
+
++++
+*** The nnimap backend now has support for IMAP namespaces.
+This feature can be enabled by setting the new 'nnimap-use-namespaces'
+server variable to non-nil.
+
++++
+*** A prefix argument to 'gnus-summary-limit-to-score' will limit reverse.
+Limit to articles with score at below.
+
+---
+*** The function 'gnus-score-find-favorite-words' has been renamed
+from 'gnus-score-find-favourite-words'.
+
+---
+*** Gmane has been removed as an nnir backend, since Gmane no longer
+has a search engine.
+
++++
+*** Splitting mail on common mailing list headers has been added.
+See the concept index in the Gnus manual for the 'match-list' entry.
+
++++
+*** nil is no longer an allowed value for 'mm-text-html-renderer'.
+
++++
+The default value of 'mm-inline-large-images' has changed from nil to
+'resize', which means that large images will be resized instead of
+displayed with an external program by default.
+
++++
+*** A new Gnus summary mode command, 'S A'
+('gnus-summary-attach-article') can be used to attach the current
+article(s) to a pre-existing Message buffer, or create a new Message
+buffer with the article(s) attached.
+
++++
+*** A new Gnus summary mode command, 'w'
+('gnus-summary-browse-url') scans the article buffer for URLs, and
+offers them to the user to open with 'browse-url'.
+
+---
+*** 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'.
+
+---
+*** The buttons in the Gnus article buffer were formerly widgets
+(i.e., buttons from widget.el). This has now changed, and they are
+now buttons (from button.el), and commands like 'TAB' now search for
+buttons instead of widgets. There should be no user-visible changes,
+but out-of-tree code that relied on widgets being present might now
+fail.
+
+** erc
+
+---
+*** New hook 'erc-insert-done-hook'.
+This hook is called after strings have been inserted into the buffer,
+and is free to alter point and window configurations, as it's not
+called from inside a 'save-excursion', as opposed to
+'erc-insert-post-hook'.
+
+---
+*** 'erc-button-google-url' has been renamed to 'erc-button-search-url'
+and its value has been changed to Duck Duck Go.
+
+---
+*** 'erc-send-pre-hook' and 'erc-send-this' have been obsoleted.
+The user option to use instead to alter text to be sent is now
+'erc-pre-send-functions'.
+
+** EUDC
+
+---
+*** XEmacs support has been removed.
+
+** eww/shr
+
++++
+*** 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.
+
++++
+*** The 'eww' command can now create a new EWW buffer.
+Invoking the command with a prefix argument will cause it to create a
+new EWW buffer for the URL instead of reusing the default one.
+
++++
+*** Clicking with the Ctrl key or 'C-u RET' on a link opens a new tab
+when tab-bar-mode is enabled.
+
++++
+*** The 'd' ('eww-download') command now falls back to current page's URL.
+If this command is invoked with no URL at point, it now downloads the
+current page instead of signaling an error.
+
+*** When opening external links in eww/shr (typically with the
+'C-u RET' keystroke on a link), the link will be flashed with the new
+'shr-selected-link' face to give the user feedback that the command
+has been executed.
+
++++
+*** 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.
+
++++
+*** 'shr-external-browser' has been made into an obsolete alias
+of 'browse-url-secondary-browser-function'.
+
+---
+*** 'shr-tag-ol' now respects the ordered list 'start' attribute.
+
+---
+*** The following tags are now handled: '<code>', '<abbr>', and '<acronym>'.
+
+** Htmlfontify
+
++++
+*** The functions 'hfy-color', 'hfy-color-vals' and
+'hfy-fallback-color-values' and the variables 'hfy-fallback-color-map'
+and 'hfy-rgb-txt-color-map' have been renamed from names that used
+'colour' instead of 'color'.
+
++++
+** Enriched mode supports the 'charset' text property.
+You can add or modify the 'charset' text properties of text using the
+'Edit->Text Properties->Special Properties' menu, or by invoking the
+'facemenu-set-charset' command. Documents in Enriched mode will be
+saved with the charset properties, and those properties will be
+restored when the file is visited.
+
+** Smtpmail
+
+---
+*** Authentication mechanisms can be added via external packages, by
+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' 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'
+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 user option 'footnote-align-to-fn-text'.
+
+** CSS mode
+
+---
+*** A new command 'css-cycle-color-format' for cycling between color
+formats (e.g. "black" => "#000000" => "rgb(0, 0, 0)") has been added,
+bound to 'C-c C-f'.
+
+---
+*** CSS mode, SCSS mode, and Less CSS mode now have support for Imenu.
+
+** SGML mode
+
+---
+*** 'sgml-quote' now handles double quotes and apostrophes
+when escaping text and in addition all numeric entities when
+unescaping text.
+
+** Python mode
+
+---
+*** Python mode supports three different font lock decoration levels.
+The maximum level is used by default; customize
+'font-lock-maximum-decoration' to tone down the decoration.
+
+---
+*** New user option 'python-pdbtrack-kill-buffers'.
+If non-nil, the default, buffers opened during pdbtracking session are
+killed when pdbtracking session is finished.
+
+---
+*** New function 'python-shell-send-region'.
+It sends the statement delimited by 'python-nav-beginning-of-statement'
+and 'python-nav-end-of-statement' to the inferior Python process.
+
+** Help
+
+---
+*** Descriptions of variables and functions give an estimated first release
+where the variable or function appeared in Emacs.
+
+---
+*** Output format of 'C-h l' ('view-lossage') has changed.
+For convenience, 'view-lossage' now displays the last keystrokes
+and commands in the same format as the edit buffer of
+'edit-last-kbd-macro'. This makes it possible to copy the lines from
+the buffer generated by 'view-lossage' to the "*Edit Macro*" buffer
+created by 'edit-last-kbd-macro', and to save the macro by 'C-c C-c'.
+
+---
+*** The list of help commands produced by 'C-h C-h' ('help-for-help')
+can now be searched via 'C-s'.
+
+** Ibuffer
+
+---
+*** New filter 'ibuffer-filter-by-process'; bound to '/ E'.
+
+---
+*** All mode filters can now accept a list of symbols.
+This means you can now easily filter several major modes, as well
+as a single mode.
+
+** Search and Replace
+
++++
+*** Isearch supports a prefix argument for 'C-s' ('isearch-repeat-forward')
+and 'C-r' ('isearch-repeat-backward'). With a prefix argument, these
+commands repeat the search for the specified occurrence of the search string.
+A negative argument repeats the search in the opposite direction.
+This makes possible also to use a prefix argument for 'M-s .'
+('isearch-forward-symbol-at-point') to find the next Nth symbol.
+Also a prefix argument is supported for 'isearch-yank-until-char',
+'isearch-yank-word-or-char', 'isearch-yank-symbol-or-char'.
+
++++
+*** To go to the first/last occurrence of the current search string
+is possible now with new commands 'isearch-beginning-of-buffer' and
+'isearch-end-of-buffer' bound to 'M-s M-<' and 'M-s M->' in Isearch.
+With a numeric argument, they go to the Nth absolute occurrence
+counting from the beginning/end of the buffer. This complements
+'C-s'/'C-r' that searches for the next Nth relative occurrence
+with a numeric argument.
+
++++
+*** 'isearch-lazy-count' shows the current match number and total number
+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.
+
+---
+*** 'lazy-highlight-buffer' highlights matches in the full buffer.
+It is useful in combination with 'lazy-highlight-cleanup' customized to nil
+to leave matches highlighted in the whole buffer after exiting isearch.
+Also when 'lazy-highlight-buffer' prepares highlighting in the buffer,
+navigation through the matches without flickering is more smooth.
+'lazy-highlight-buffer-max-at-a-time' controls the number of matches to
+highlight in one iteration while processing the full buffer.
+
++++
+*** New isearch bindings.
+
+'C-M-z' invokes new function 'isearch-yank-until-char', which yanks
+everything from point up to but not including the specified
+character into the search string. This is especially useful for
+keyboard macros.
+
+'C-M-w' in isearch changed from 'isearch-del-char' to the new function
+'isearch-yank-symbol-or-char'. 'isearch-del-char' is now bound to
+'C-M-d'.
+
++++
+'M-s h l' invokes 'highlight-lines-matching-regexp' using the search
+string to highlight lines matching the search string. This is similar
+to the existing binding 'M-s h r' ('highlight-regexp') that highlights
+JUST the search string.
+
++++
+*** 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.
+
++++
+*** 'isearch-allow-scroll' provides new option 'unlimited' to allow
+scrolling any distance off screen.
+
+---
+*** Isearch now remembers the regexp-based search mode for words/symbols
+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.
+
+---
+*** 'char-fold-to-regexp' now matches more variants of a base character.
+The table used to check for equivalence of characters is now built
+using the complete chain of unicode decompositions of a character,
+rather than stopping after one level, such that searching for
+e.g. "GREEK SMALL LETTER IOTA" will now also find "GREEK SMALL LETTER
+IOTA WITH OXIA".
+
++++
+*** New char-folding options: 'char-fold-include' lets you add ad hoc
+foldings, 'char-fold-exclude' to remove foldings from default decomposition,
+and 'char-fold-symmetric' to search for any of an equivalence class of
+characters. For example, with a 'nil' value of 'char-fold-symmetric'
+you can search for "e" to find "é", but not vice versa. With a non-nil
+value you can search for either, for example, you can search for "é"
+to find "e".
+
+** Debugger
+
++++
+*** The Lisp Debugger is now based on 'backtrace-mode'.
+Backtrace mode adds fontification and commands for changing the
+appearance of backtrace frames. See the node "(elisp) Backtraces" in
+the Elisp manual for documentation of the new mode and its commands.
+
+** Edebug
+
++++
+*** 'edebug-eval-last-sexp' and 'edebug-eval-print-last-sexp' interactively
+now take a zero prefix analogously to the non-Edebug counterparts.
+
++++
+*** New faces 'edebug-enabled-breakpoint' and 'edebug-disabled-breakpoint'.
+When setting breakpoints in Edebug, an overlay with these faces are
+placed over the point in question, depending on whether they are
+enabled or not.
+
++++
+*** New command 'edebug-toggle-disable-breakpoint'.
+This command allows you to disable a breakpoint temporarily. This is
+mainly useful with breakpoints that are conditional and would take
+some time to recreate.
+
++++
+*** New command 'edebug-unset-breakpoints'.
+To clear all breakpoints in the current form, the 'U' command in
+'edebug-mode', or 'M-x edebug-unset-breakpoints' can be used.
+
+---
+*** Re-instrumenting a function with Edebug will now try to preserve
+previously-set breakpoints. However, if the code has changed
+substantially, this may not be possible.
+
++++
+*** New command 'edebug-remove-instrumentation'.
+This command removes Edebug instrumentation from all functions that
+have been instrumented.
+
++++
+*** The runtime behavior of Edebug's instrumentation can be changed
+using the new variables 'edebug-behavior-alist',
+'edebug-after-instrumentation-function' and
+'edebug-new-definition-function'. Edebug's behavior can be changed
+globally or for individual definitions.
+
++++
+*** Edebug's backtrace buffer now uses 'backtrace-mode'.
+Backtrace mode adds fontification, links and commands for changing the
+appearance of backtrace frames. See the node "(elisp) Backtraces" in
+the Elisp manual for documentation of the new mode and its commands.
+
+The binding of 'd' in Edebug's keymap is now 'edebug-pop-to-backtrace'
+which replaces 'edebug-backtrace'. Consequently Edebug's backtrace
+windows now behave like those of the Lisp Debugger and of ERT, in that
+when they appear they will be the selected window.
+
+The new 'backtrace-goto-source' command, bound to 's', works in
+Edebug's backtraces on backtrace frames whose source code has
+been instrumented by Edebug.
+
+** Enhanced xterm support
+
+---
+*** New user option 'xterm-set-window-title' controls whether Emacs sets
+the XTerm window title. This feature is experimental and is disabled
+by default.
+
+** Grep
+
++++
+*** '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 user option
+'grep-find-abbreviate'. The new command
+'grep-find-toggle-abbreviation' toggles it interactively.
+
+---
+*** 'grep-find-use-xargs' is now customizable with sorting options.
+
+** ERT
+
++++
+*** New variable 'ert-quiet' allows to make ERT output in batch mode
+less verbose by removing non-essential information.
+
++++
+*** ERT's backtrace buffer now uses 'backtrace-mode'.
+Backtrace mode adds fontification and commands for changing the
+appearance of backtrace frames. See the node "(elisp) Backtraces" in
+the Elisp manual for documentation of the new mode and its commands.
+
+** Gamegrid
+
+---
+*** Gamegrid now determines its default glyph size based on display
+dimensions, instead of always using 16 pixels. As a result, Tetris,
+Snake and Pong are better playable on HiDPI displays.
+
+---
+*** 'gamegrid-add-score' can now sort scores from lower to higher.
+This is useful for games where lower scores are better, like time-based games.
+
+** Filecache
+
+---
+*** Completing filenames in the minibuffer via 'C-TAB' now uses the
+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
+are evaluated lazily.
+
+** next-error
+
++++
+*** 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
+error.
+
++++
+*** New command 'next-error-select-buffer'.
+It can be used to set any buffer as the next one to be used by
+'next-error' and 'previous-error'.
+
+** nxml-mode
+
+---
+*** The default value of 'nxml-sexp-element-flag' is now t.
+This means that pressing 'C-M-SPACE' now selects the entire tree by
+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)'.
+
+---
+*** Eshell no longer re-initializes its keymap every call.
+This allows users to use (define-key eshell-mode-map ...) as usual.
+Some modules have their own minor mode now to account for these
+changes.
+
++++
+*** Expansion of history event designators is disabled by default.
+To restore the old behavior, use
+
+ (add-hook 'eshell-expand-input-functions
+ #'eshell-expand-history-references)
+
+---
+*** The function 'eshell-uniquify-list' has been renamed from
+'eshell-uniqify-list'.
+
+---
+*** The function 'eshell/kill' is now able to handle signal switches.
+Previously 'eshell/kill' would fail if provided a kill signal to send
+to the process. It now accepts signals specified either by name or by
+its number.
+
+---
+*** Emacs now follows symlinks in history-related files.
+The files specified by 'eshell-history-file-name' and
+'eshell-last-dir-ring-file-name' can include symlinks; these are now
+followed when Emacs writes the relevant history variables to the disk.
+
+** Shell
+
+---
+*** Program name completion inside remote shells works now as expected.
+
++++
+*** 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
+
++++
+*** 'async-shell-command-width' defines the number of display columns
+available for output of asynchronous shell commands.
+
++++
+*** Prompt for shell commands can now show the current directory.
+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 function 'pcomplete-uniquify-list' has been renamed from
+'pcomplete-uniqify-list'.
+
+---
+*** 'pcomplete/make' now completes on targets in included files, recursively.
+To recover the previous behavior, set new user option
+'pcmpl-gnu-makefile-includes' to nil.
+
+** Auth-source
+
+---
+*** The Secret Service backend supports the ':create' key now.
+
+---
+*** ".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 new
+'authinfo-hidden' user option can be used to control what to hide.
+
+** Tramp
+
++++
+*** New connection method "nextcloud", which allows to access OwnCloud
+or NextCloud hosted files and directories.
+
++++
+*** New connection method "rclone", which allows to access system
+storages via the 'rclone' program. This feature is experimental.
+
++++
+*** New connection method "sudoedit", which allows to edit local files
+with different user credentials. Contrary to the "sudo" method, no
+session is run permanently in the background. This is for security
+reasons.
+
++++
+*** Connection methods "obex" and "synce" are removed, because they
+are obsoleted in GVFS.
+
++++
+*** Validated passwords are saved by auth-source backends which support this.
+
++++
+*** During user and host name completion in the minibuffer, results
+from auth-source search are taken into account. This can be disabled
+by setting the user option 'tramp-completion-use-auth-sources' to nil.
+
++++
+*** The user option 'tramp-ignored-file-name-regexp' allows to disable
+Tramp for some look-alike remote file names.
+
++++
+*** For some connection methods, like "su" or "sudo", the host name in
+ad-hoc multi-hop file names must match the previous hop. Default host
+names are adjusted to the host name from the previous hop.
+
++++
+*** For the connection methods "sudo" and "doas" there exists a
+timeout, after which the underlying session is disabled. This is for
+security reasons.
+
++++
+*** For some connection methods, like "sshx" or "plink", it is
+possible to configure the remote login shell. This avoids problems
+with remote hosts, where "/bin/sh" is a link to a shell which
+cooperates badly with Tramp.
+
++++
+*** New commands 'tramp-rename-files' and 'tramp-rename-these-files'.
+They allow to save remote files somewhere else when the corresponding
+host is not reachable anymore.
+
+** Rcirc
+
+---
+*** New user option 'rcirc-url-max-length'.
+Setting this option to an integer causes URLs displayed in Rcirc
+buffers to be truncated to that many characters.
+
+---
+*** The default '/quit' and '/part' reasons are now configurable.
+Two new user options are provided for this:
+'rcirc-default-part-reason' and 'rcirc-default-quit-reason'.
+
+** Register
+
+---
+*** The return value of method 'register-val-describe' includes the
+names of buffers shown by the windows of a window configuration.
+
+---
+** The options.el library has been removed.
+It was obsolete since Emacs 22.1, replaced by customize.
+
+---
+** The tls.el and starttls.el libraries are now marked obsolete.
+Use of built-in libgnutls based functionality (described in the Emacs
+GnuTLS manual) is recommended instead.
+
+** Message
+
+---
+*** Completion of email addresses can use the standard completion UI.
+This is controlled by 'message-expand-name-standard-ui'.
+With the standard UI the different sources (ecomplete, bbdb, and eudc)
+are matched together and try to obey 'completion-styles'.
+It should work for other completion front ends like Company.
+
+---
+*** '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
+when the PGP keyring contains a public key for every recipient. To
+achieve this, add 'message-sign-encrypt-if-all-keys-available' to
+'message-send-hook'.
+
+---
+*** When replying a message that have addresses on the form
+'"foo@bar.com" <foo@bar.com>', Message will elide the repeated "name"
+from the address field in the response.
+
+---
+*** The default of 'message-forward-as-mime' has changed from t to nil
+as it has been reported that many recipients can't read forwards that
+are formatted as MIME digests.
+
++++
+*** 'message-forward-included-headers' has changed its default to
+exclude most headers when forwarding.
+
+*** 'mml-secure-openpgp-sign-with-sender' sets also "gpg --sender"
+When 'mml-secure-openpgp-sign-with-sender' is non-nil message sender's
+email address (in addition to its old behavior) will also be used to
+set gpg's "--sender email@domain" option.
+
+The option is useful for two reasons when verifying the signature:
+
+ 1. GnuPG's TOFU statistics are updated for the specific user id
+ (email) only. See gpg(1) man page about "--sender".
+
+ 2. GnuPG's '--auto-key-retrieve' functionality can use WKD (web key
+ directory) method for finding the signer's key. You need GnuPG
+ 2.2.17 to fully benefit from this feature. See gpg(1) man page for
+ '--auto-key-retrieve'.
+
+---
+** EasyPG
+
+---
+*** 'epa-pinentry-mode' is renamed to 'epg-pinentry-mode'.
+It now applies to epg functions as well as epa functions.
+
+---
+*** The alias functions 'epa--encode-coding-string',
+'epa--decode-coding-string', and 'epa--select-safe-coding-system' have
+been removed. Use 'encode-coding-string', 'decode-coding-string', and
+'select-safe-coding-system' instead.
+
+---
+*** 'epg-context' structure supports now 'sender' slot.
+The value of the new 'sender' slot (if a string) is used to set gpg's
+'--sender' option. This feature is used by
+'mml-secure-openpgp-sign-with-sender'. See gpg(1) manual page about
+'--sender' for more information.
+
+---
+** Rmail
+
++++
+*** New user option 'rmail-output-reset-deleted-flag'.
+If this option is non-nil, messages appended to an output file by the
+'rmail-output' command have their Deleted flag reset.
+
+---
+*** The command 'rmail-summary-by-senders' with an empty argument
+selects the messages to summarize with a regexp that matches the
+sender of the current message.
+
+** Threads
+
++++
+*** New variable 'main-thread' holds Emacs's main thread.
+This is handy in Lisp programs that run on a non-main thread and want
+to signal the main thread, e.g., when they encounter an error.
+
++++
+*** 'thread-join' now returns the result of the finished thread.
+
++++
+*** 'thread-signal' does not propagate errors to the main thread.
+Instead, error messages are just printed in the main thread.
+
+---
+*** 'thread-alive-p' is now obsolete, use 'thread-live-p' instead.
+
++++
+*** New command 'list-threads' shows Lisp threads.
+See the current list of live threads in a tabulated-list buffer which
+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
+
+---
+*** '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.
+
+---
+*** 'number-at-point' will now recognize hex numbers like 0xAb09 and #xAb09
+and return them as numbers.
+
+---
+*** 'word-at-point' and 'sentence-at-point' accept NO-PROPERTIES.
+Just like 'thing-at-point' itself.
+
+** Interactive automatic highlighting
+
++++
+*** 'highlight-regexp' can now highlight subexpressions.
+The new command accepts a prefix numeric argument to choose the
+subexpression.
+
+** Mouse display of minor mode menu
+
+---
+*** 'minor-mode-menu-from-indicator' now displays full minor mode name.
+When there is no menu for a mode, display the mode name after the
+indicator instead of just the indicator (which is sometimes cryptic).
+
+** rx
+
+---
+*** rx now handles raw bytes in character alternatives correctly,
+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'.
+The symbol 'unmatchable' can be used as an alternative to '(or)'.
+
+---
+*** 'regexp' and new 'literal' accept arbitrary lisp as arguments.
+In this case, 'rx' will generate code which produces a regexp string
+at run time, instead of a constant string.
+
+---
+*** New rx extension mechanism: 'rx-define', 'rx-let', 'rx-let-eval'.
+These macros add new forms to the rx notation.
+
++++
+*** 'anychar' is now an alias for 'anything'.
+Both match any single character; 'anychar' is more descriptive.
+
++++
+*** New 'intersection' form for character sets.
+With 'or' and 'not', it can be used to compose character-matching
+expressions from simpler parts.
+
++++
+*** 'not' argument can now be a character or single-char string.
+
+** Frames
+
++++
+*** New command 'make-frame-on-monitor' makes a frame on the specified monitor.
+
++++
+*** New value of 'minibuffer' frame parameter 'child-frame'.
+This allows to create and parent immediately a minibuffer-only child
+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.
+
+** Tabulated List mode
+
++++
+*** 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 user options
+'tabulated-list-gui-sort-indicator-asc',
+'tabulated-list-gui-sort-indicator-desc',
+'tabulated-list-tty-sort-indicator-asc', and
+'tabulated-list-tty-sort-indicator-desc').
+
++++
+*** Two new commands and keystrokes have been added to the tabulated
+list mode: 'w' (which widens the current column) and 'c' which makes
+the current column contract.
+
++++
+*** New function 'tabulated-list-clear-all-tags'.
+This function clears all tags from the padding area in the current
+buffer. Tags are typically added by calling 'tabulated-list-put-tag'.
+
+** Text mode
+
++++
+*** 'text-mode-variant' is now obsolete, use 'derived-mode-p' instead.
+
+** CUA mode
+
+---
+*** 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
+
+---
+*** JSX syntax is now automatically detected and enabled.
+If a file imports Facebook's 'React' library, or if the file uses the
+extension '.jsx', then various features supporting XML-like syntax
+will be supported in 'js-mode' and derivative modes. ('js-jsx-mode'
+no longer needs to be enabled.)
+
+---
+*** New user option 'js-jsx-detect-syntax' disables automatic detection.
+This is turned on by default.
+
+---
+*** New user option 'js-jsx-syntax' enables JSX syntax unconditionally.
+This is off by default.
+
+---
+*** New variable 'js-jsx-regexps' controls JSX detection.
+
+---
+*** JSX syntax is now highlighted like SGML.
+
+---
+*** JSX code is properly indented in many more scenarios.
+Previously, JSX indentation usually only worked when an element was
+wrapped in parenthesis (e.g. in a 'return' statement or a function
+call). It would also fail in many intricate cases. Now, indentation
+should work anywhere without parenthesis; many more intricacies are
+supported; and, indentation conventions align more closely with those
+of the React developer community (see 'js-jsx-align->-with-<'),
+otherwise still adhering to SGML conventions.
+
+---
+*** 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
+'>' is indented at the same level as attributes, which was also the
+old default for JSX.
+
+This is turned on by default. To get back the old default indentation
+behavior of aligning '>' with attributes, set 'js-jsx-align->-with-<'
+to nil.
+
+---
+*** Indentation uses 'js-indent-level' instead of 'sgml-basic-offset'.
+Since JSX is a syntax extension of JavaScript, it makes the most sense
+for JSX expressions to be indented the same number of spaces as other
+JS expressions. This is a breaking change, but it probably aligns
+with how you'd expect this indentation to behave. If you want JSX to
+be indented like JS, you won't need to change your config.
+
+The old behavior can be emulated by controlling JSX indentation
+independently of JS, by setting 'js-jsx-indent-level'.
+
+---
+*** 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 user option to the desired number.
+
+---
+*** New user option 'js-jsx-attribute-offset' for JSX attribute indents.
+
+---
+*** New variable 'js-syntactic-mode-name' controls mode name display.
+Previously, the mode name was simply 'JavaScript'. Now, when a syntax
+extension like JSX is enabled, the mode name is 'JavaScript[JSX]'.
+Set this variable to nil to disable the new behavior.
+
+---
+*** New function 'js-use-syntactic-mode-name' for deriving modes.
+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 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
+'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.
+
+---
+*** 'global-auto-revert-ignore-buffer' can now also be a predicate
+function that can be used for more fine-grained control of which
+buffers to auto-revert.
+
+** auth-source-pass
+
++++
+*** New user option 'auth-source-pass-filename'.
+Allows setting the path to the password-store, defaults to
+"~/.password-store".
+
++++
+*** New user option 'auth-source-pass-port-separator'.
+Specifies separator between host and port, defaults to colon ":".
+
+---
+*** Minimize the number of decryptions during password lookup.
+This makes the package usable with physical tokens requiring touching
+a sensor for every decryption.
+
+---
+*** 'auth-source-pass-get' is now autoloaded.
+
+** Bookmarks
+
+---
+*** 'bookmark-file' and 'bookmark-old-default-file' are now obsolete
+aliases of 'bookmark-default-file'.
+
+---
+*** New user option 'bookmark-watch-bookmark-file'.
+When non-nil, watch whether the bookmark file has changed on disk.
+
+---
+*** The old bookmark file format is no longer supported.
+This bookmark file format has not been used in Emacs since at least
+version 19.34, released in 1996, and will no longer be automatically
+converted to the new bookmark file format.
+
+The following functions are now declared obsolete:
+'bookmark-grok-file-format-version',
+'bookmark-maybe-upgrade-file-format',
+'bookmark-upgrade-file-format-from-0', and
+'bookmark-upgrade-version-0-alist'.
+
+---
+** The mantemp.el library is now marked obsolete.
+This library generates manual C++ template instantiations. It should
+no longer be useful on modern compilers, which do this automatically.
+
+** Ispell
+
+---
+*** New hook 'ispell-change-dictionary-hook'.
+This runs after changing the dictionary and could be used to
+automatically spellcheck a buffer when changing language without
+needing to advice 'ispell-change-dictionary'.
+
+** scroll-lock
+
+---
+*** New command 'scroll-lock-next-line-always-scroll'.
+This command is bound to 'S-down' and scrolls the buffer up in
+particular when the end of the buffer is visible in the window.
+
+** mwheel.el
+
+---
+*** 'mwheel-install' is now obsolete.
+Use 'mouse-wheel-mode' instead. Note that 'mouse-wheel-mode' is
+already enabled by default on most graphical displays.
+
+** Gravatar
+
++++
+*** 'gravatar-cache-ttl' is now a number of seconds.
+The previously used timestamp format of a list of integers is still
+supported, but is deprecated. The default value has not changed.
+
++++
+*** 'gravatar-size' can now be nil.
+This results in the use of Gravatar's default size of 80 pixels.
+
++++
+*** The default fallback gravatar is now configurable.
+This is possible using the new user options 'gravatar-default-image'
+and 'gravatar-force-default'.
+
+** ada-mode
+
+---
+*** The built-in ada-mode is now deleted. The GNU ELPA package is a
+good replacement, even in very large source files.
+
+** time-stamp
+
+---
+*** New '%5z' conversion for 'time-stamp-format' gives time zone offset.
+Specifying '%5z' in 'time-stamp-format' or 'time-stamp-pattern'
+expands to the time zone offset, e.g., '+0100'. The time zone used is
+specified by 'time-stamp-time-zone'.
+
+Because this feature is new in Emacs 27.1, do not use it in the local
+variables section of any file that might be edited by an older version
+of Emacs.
+
+---
+*** Some conversions recommended for 'time-stamp-format' have changed.
+The new documented/recommended %-conversions are closer to those
+used by 'format-time-string' and are compatible at least as far back
+as Emacs 22.1 (released in 2007).
+
+Uppercase abbreviated day name of week: was %3A, now %#a
+Full day name of week: was %:a, now %:A
+Uppercase abbreviated month name: was %3B, now %#b
+Full month name: was %:b, now %:B
+Four-digit year: was %:y, now %Y
+Lowercase timezone name: was %z, now %#Z
+Fully-qualified host name: was %s, now %Q
+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
+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
+---
+*** Declare 'define-overload' and 'define-child-mode' as obsolete.
+
+---
+*** Rename several internal functions to use a 'mode-local-' prefix.
+
+** CC Mode
+
++++
+*** You can now flag "wrong style" comments with 'font-lock-warning-face'.
+To do this, use 'c-toggle-comment-style', if needed, to set the desired
+default comment style (block or line); then set the user option
+'c-mark-wrong-style-of-comment' to non-nil.
+
+
+* New Modes and Packages in Emacs 27.1
+
+** Tab Bars
+
++++
+*** Tab Bar mode.
+The new command 'tab-bar-mode' enables the tab bar at the top of each
+frame, where you can use tabs to switch between named persistent
+window configurations.
+
+The 'C-x t' sequence is the new prefix key for tab-related commands:
+'C-x t 2' creates a new tab; 'C-x t 0' deletes the current tab;
+'C-x t b' switches to buffer in another tab; 'C-x t f' and 'C-x t C-f'
+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 '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 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.
+
++++
+*** Tab Line mode
+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
+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.
+
++++
+** fileloop.el lets one setup multifile operations like search&replace.
+
++++
+** Emacs can now visit files in archives as if they were directories.
+This feature uses Tramp and works only on systems which support GVFS,
+i.e. GNU/Linux, roughly spoken. See the node "(tramp) Archive file
+names" in the Tramp manual for full documentation of these facilities.
+
++++
+** New library for writing JSONRPC applications (https://jsonrpc.org).
+The 'jsonrpc' library enables writing Emacs Lisp applications that
+rely on this protocol. Since the protocol is designed to be
+transport-agnostic, the library provides an API to implement new
+transport strategies as well as a separate API to use them. A
+transport implementation for process-based communication, such as is
+used by the Language Server Protocol (LSP), is readily available.
+
++++
+** Backtrace mode improves viewing of Elisp backtraces.
+Backtrace mode adds pretty printing, fontification and ellipsis
+expansion to backtrace buffers produced by the Lisp debugger, Edebug
+and ERT. See the node "(elisp) Backtraces" in the Elisp manual for
+documentation of the new mode and its commands.
+
++++
+** so-long.el helps to mitigate performance problems with long lines.
+When 'global-so-long-mode' has been enabled, visiting a file with very
+long lines will (subject to configuration) cause the user's preferred
+'so-long-action' to be automatically invoked (by default, the buffer's
+major mode is replaced by 'so-long-mode'). In extreme cases this can
+prevent delays of several minutes, and make Emacs responsive almost
+immediately. Type 'M-x so-long-commentary' for full documentation.
+
+
+* Incompatible Lisp Changes in Emacs 27.1
+
+---
+** Incomplete destructive splicing support has been removed.
+Support for Common Lisp style destructive splicing (",.") was
+incomplete and broken for a long time. It has now been removed.
+
+This means that backquote substitution now works for identifiers
+starting with a period ("."). Consider the following example:
+
+ (let ((.foo 42)) `,.foo)
+
+In the past, this would have incorrectly evaluated to '(\,\. foo)',
+but will now instead evaluate to '42'.
+
+---
+** The REGEXP in 'magic-mode-alist' is now matched case-sensitively.
+Likewise for 'magic-fallback-mode-alist'.
+
++++
+** 'add-hook' does not always add to the front or the end any more.
+The replacement of 'append' with 'depth' implies that the function is
+not always added to the very front (when append/depth is nil) or the
+very end (when append/depth is t) any more because other functions on
+the hook may have specified higher/lower depths. This makes it
+possible to control the ordering of functions more precisely, as was
+already possible in 'add-function' and 'advice-add'.
+
+---
+** 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.
+
+---
+** Just loading a theme's file no longer activates the theme's settings.
+Loading a theme with 'M-x load-theme' still activates the theme, as it
+did before. However, loading the theme's file with 'M-x load-file',
+or using 'require' or 'load' in a Lisp program, doesn't actually apply
+the theme's settings until you either invoke 'M-x enable-theme' or
+type 'M-x load-theme'. (In a Lisp program, calling 'enable-theme' or
+invoking 'load-theme' with NO-ENABLE argument omitted or nil has the
+same effect of activating a theme whose file has been loaded.) The
+special case of the 'user' theme is an exception: it is frequently
+used for ad-hoc customizations, so the settings of that theme are by
+default applied immediately.
+
+The variable 'custom--inhibit-theme-enable' controls this behavior;
+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
+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
+independent of where Emacs was started.
+
+---
+** 'file-name-absolute-p' no longer considers "~foo" to be an absolute
+file name if there is no user named "foo".
+
++++
+** The FILENAME argument to 'file-name-base' is now mandatory and no
+longer defaults to 'buffer-file-name'.
+
++++
+** File metadata primitives now signal an error if I/O, access, or
+other serious errors prevent them from determining the result.
+Formerly, these functions often (though not always) silently 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.
+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'.
+
+---
+** The function 'eldoc-message' now accepts a single argument.
+Programs that called it with multiple arguments before should pass
+them through 'format' first. Even that is discouraged: for ElDoc
+support, you should set 'eldoc-documentation-function' instead of
+calling 'eldoc-message' directly.
+
+---
+** Old-style backquotes now generate an error.
+They have been generating warnings for a decade. To interpret
+old-style backquotes as new-style, bind the new variable
+'force-new-style-backquotes' to t.
+
+---
+** Defining a Common Lisp structure using 'cl-defstruct' or
+'cl-struct-define' whose name clashes with a builtin type (e.g.,
+'integer' or 'hash-table') now signals an error.
+
+---
+** When formatting a floating-point number as an octal or hexadecimal
+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,
+and returns a NaN when given a NaN. Formerly, it returned an extreme
+fixnum for such arguments.
+
+---
+** Some functions and variables obsolete since Emacs 22 have been removed:
+archive-mouse-extract, assoc-ignore-case, assoc-ignore-representation,
+backward-text-line, blink-cursor, bookmark-exit-hooks,
+c-opt-op-identitier-prefix, comint-use-prompt-regexp-instead-of-fields,
+compilation-finish-function, count-text-lines, cperl-vc-header-alist,
+custom-face-save-command, cvs-display-full-path, cvs-fileinfo->full-path,
+delete-frame-hook, derived-mode-class, describe-char-after, describe-project,
+desktop-basefilename, desktop-buffer-handlers, desktop-buffer-misc-functions,
+desktop-buffer-modes-to-save, desktop-enable, desktop-load-default,
+dired-omit-files-p, disabled-command-hook, dungeon-mode-map,
+electric-nroff-mode, electric-nroff-newline, electric-perl-terminator,
+focus-frame, forward-text-line, generic-define-mswindows-modes,
+generic-define-unix-modes, generic-font-lock-defaults, goto-address-at-mouse,
+highlight-changes-colours, ibuffer-elide-long-columns, ibuffer-hooks,
+ibuffer-mode-hooks, icalendar-convert-diary-to-ical,
+icalendar-extract-ical-from-buffer, imenu-always-use-completion-buffer-p,
+ipconfig-program, ipconfig-program-options, isearch-lazy-highlight-cleanup,
+isearch-lazy-highlight-initial-delay, isearch-lazy-highlight-interval,
+isearch-lazy-highlight-max-at-a-time, iswitchb-use-fonts,
+latin1-char-displayable-p, mouse-wheel-click-button, mouse-wheel-down-button,
+mouse-wheel-up-button, new-frame, pascal-outline, process-kill-without-query,
+recentf-menu-append-commands-p, rmail-pop-password,
+rmail-pop-password-required, savehist-load, set-default-font,
+spam-list-of-processors, speedbar-add-ignored-path-regexp,
+speedbar-buffers-line-path, speedbar-ignored-path-expressions,
+speedbar-ignored-path-regexp, speedbar-line-path, speedbar-path-line,
+timer-set-time-with-usecs, tooltip-gud-display, tooltip-gud-modes,
+tooltip-gud-toggle-dereference, unfocus-frame, unload-hook-features-list,
+update-autoloads-from-directories, vc-comment-ring, vc-comment-ring-index,
+vc-comment-search-forward, vc-comment-search-reverse, vc-comment-to-change-log,
+vc-diff-switches-list, vc-next-comment, vc-previous-comment, view-todo,
+x-lost-selection-hooks, x-sent-selection-hooks.
+
+---
+** Further functions and variables obsolete since Emacs 24 have been removed:
+default-directory-alist, dired-default-directory,
+dired-default-directory-alist, dired-enable-local-variables,
+dired-hack-local-variables, dired-local-variables-file, dired-omit-here-always.
+
++++
+** Garbage collection no longer treats miscellaneous objects specially;
+they are now allocated like any other pseudovector. As a result, the
+'garbage-collect' and 'memory-use-count' functions no longer return a
+'misc' component, and the 'misc-objects-consed' variable has been
+removed.
+
++++
+** 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.
+
+---
+** Internal 'rx' functions and variables have been removed,
+as a consequence of an improved implementation. Packages using
+these should use the public 'rx' and 'rx-to-string' instead.
+'rx-constituents' is still available for compatibility, but the new
+extension mechanism is preferred: 'rx-define', 'rx-let' and
+'rx-let-eval'.
+
++++
+** 'text-mode' no longer sets the value of 'indent-line-function'.
+The global value of 'indent-line-function', which defaults to
+'indent-relative', will no longer be reset locally when turning on
+'text-mode'.
+
+To get back the old behavior, add a function to 'text-mode-hook' which
+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.
+
+---
+** The obsolete package xesam.el (since Emacs 24) has been removed.
+
++++
+** The XBM image handler now accepts a ':stride' argument, which should
+be specified in image specs representing the entire bitmap as a single
+bool vector.
+
++++
+** 'regexp-quote' may return its argument string.
+If the argument needs no quoting, it can be returned instead of a copy.
+
++++
+** Mouse scroll up and down with control key modifier changes font size.
+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 behavior 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 behavior, you can customize the user
+option 'mouse-wheel-follow-mouse'. Note that this will also affect
+scrolling.
+
++++
+** Mouse scroll up and down with control key modifier also works on images
+where it scales the image under the mouse pointer.
+
+---
+** 'help-follow-symbol' now signals 'user-error' if point (or the
+position pointed to by the argument POS) is not in a symbol.
+
+
+* Lisp Changes in Emacs 27.1
+
++++
+** Emacs Lisp integers can now be of arbitrary size.
+Emacs uses the GNU Multiple Precision (GMP) library to support
+integers whose size is too large to support natively. The integers
+supported natively are known as "fixnums", while the larger ones are
+"bignums". The new predicates 'bignump' and 'fixnump' can be used to
+distinguish between these two types of integers.
+
+All the arithmetic, comparison, and logical (a.k.a. "bitwise")
+operations where bignums make sense now support both fixnums and
+bignums. However, note that unlike fixnums, bignums will not compare
+equal with 'eq', you must use 'eql' instead. (Numerical comparison
+with '=' works on both, of course.)
+
+Since large bignums consume a lot of memory, Emacs limits the size of
+the largest bignum a Lisp program is allowed to create. The
+nonnegative value of the new variable 'integer-width' specifies the
+maximum number of bits allowed in a bignum. Emacs signals an integer
+overflow error if this limit is exceeded.
+
+Several primitive functions formerly returned floats or lists of
+integers to represent integers that did not fit into fixnums. These
+functions now simply return integers instead. Affected functions
+include functions like 'encode-char' that compute code-points, functions
+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.
+
++++
+** 'overflow-error' is now documented as a subcategory of 'range-error'.
+Formerly it was undocumented, and was (incorrectly) a subcategory
+of 'domain-error'.
+
+** Time values
+
++++
+*** 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)',
+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
+'format-time-string', 'decode-time', and 'time-convert' rather than
+probing the innards of a timestamp directly, or creating a timestamp
+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.
+
++++
+*** 'encode-time' supports a new API '(encode-time TIME)'.
+The old 'encode-time' API is still supported.
+
++++
+*** A new package to parse ISO 8601 time, date, durations and
+intervals has been added. The main function to use is
+'iso8601-parse', but there's also 'iso8601-parse-date',
+'iso8601-parse-time', 'iso8601-parse-duration' and
+'iso8601-parse-interval'. All these functions return decoded time
+structures, except the final one, which returns three of them (start,
+end and duration).
+
++++
+*** '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. If both arguments are finite, these
+functions now return exact results instead of rounding in some cases,
+and they also avoid excess precision when that is easy.
+
++++
+*** New function 'time-equal-p' compares time values for equality.
+
++++
+*** '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.
+
++++
+*** To access (or alter) the elements a decoded time value, the
+'decoded-time-second', 'decoded-time-minute', 'decoded-time-hour',
+'decoded-time-day', 'decoded-time-month', 'decoded-time-year',
+'decoded-time-weekday', 'decoded-time-dst' and 'decoded-time-zone'
+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
+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
+elements as if it's midnight January 1st, 1970) have been added.
+
++++
+*** In the DST slot, 'encode-time' and 'parse-time-string' now return -1
+if it is not known whether daylight saving time is in effect.
+Formerly they were inconsistent: 'encode-time' returned t in this
+situation, whereas 'parse-time-string' returned nil. Now they
+consistently use use nil to mean that DST is not in effect, and use -1
+to mean that it is not known whether DST is in effect.
+
++++
+** New macro 'benchmark-progn'.
+This macro works like 'progn', but messages how long it takes to
+evaluate the body forms. The value of the last form is the return
+value.
+
++++
+** New function 'read-char-from-minibuffer'.
+This function works like 'read-char', but uses 'read-from-minibuffer'
+to read a character, so it maintains a history that can be navigated
+via usual minibuffer keystrokes 'M-p'/'M-n'.
+
+---
+** New variables 'set-message-function' and 'clear-message-function'
+can be used to specify functions to show and clear messages that
+normally are displayed in the echo area.
+
++++
+** 'setq-local' can now set an arbitrary number of variables, which
+makes the syntax more like 'setq'.
+
+---
+** 'reveal-mode' can now also be used for more than to toggle between
+invisible and visible: It can also toggle 'display' properties in
+overlays. This is only done on 'display' properties that have the
+'reveal-toggle-invisible' property set.
+
++++
+** 'process-contact' now takes an optional NO-BLOCK argument to allow
+not waiting for a process to be set up.
+
+---
+** New variable 'read-process-output-max' controls sub-process throughput.
+This variable determines how many bytes can be read from a sub-process
+in one read operation. The default, 4096 bytes, was previously a
+hard-coded constant. Setting it to a larger value might enhance
+throughput of reading from sub-processes that produces vast
+(megabytes) amounts of data in one go.
+
++++
+** The new user option 'quit-window-hook' is now run first when
+executing the 'quit-window' command.
+
+** The user options 'help-enable-completion-auto-load',
+'help-enable-auto-load' and 'vhdl-project-auto-load', as well as the
+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
+now use the 'button-data' property. If present, the data in this
+property will be passed on to the 'action' function instead of the
+button itself in 'button-activate'.
+
++++
+** 'defcustom' now takes a ':local' keyword that can be either t or
+'permanent', which mean that the variable should be automatically
+buffer-local. 'permanent' also sets the variable's 'permanent-local'
+property.
+
++++
+** The new macro 'with-suppressed-warnings' can be used to suppress
+specific byte-compile warnings.
+
++++
+** The new macro 'ignore-error' is like 'ignore-errors', but takes a
+specific error condition, and will only ignore that condition. (This
+can also be a list of conditions.)
+
+---
+** The new function 'byte-compile-info-message' can be used to output
+informational messages that look pleasing during the Emacs build.
+
+---
+** New 'help-fns-describe-variable-functions' hook.
+Makes it possible to add metadata information to 'describe-variable'.
+
+** i18n (internationalization)
+
+---
+*** ngettext can be used now to return the right plural form
+according to the given numeric value.
+
++++
+** 'inhibit-null-byte-detection' is renamed to 'inhibit-nul-byte-detection'.
+
++++
+** 'self-insert-command' takes the char to insert as (optional) argument.
+
++++
+** 'lookup-key' can take a list of keymaps as argument.
+
++++
+** 'condition-case' now accepts 't' to match any error symbol.
+
++++
+** New function 'proper-list-p'.
+Given a proper list as argument, this predicate returns its length;
+otherwise, it returns nil. 'format-proper-list-p' is now an obsolete
+alias for the new function.
+
+---
+** 'define-minor-mode' automatically documents the meaning of ARG.
+
++++
+** The function 'recenter' now accepts an additional optional argument.
+By default, calling 'recenter' will not redraw the frame even if
+'recenter-redisplay' is non-nil. Call 'recenter' with the new second
+argument non-nil to force redisplay per 'recenter-redisplay's value.
+
++++
+** New functions 'major-mode-suspend' and 'major-mode-restore'.
+Use them when switching temporarily to another major mode, e.g. for
+'hexl-mode', or to switch between 'c-mode' and 'image-mode' in XPM.
+
++++
+** New macro 'dolist-with-progress-reporter'.
+This works like 'dolist', but reports progress similar to
+'dotimes-with-progress-reporter'.
+
++++
+** New hook 'after-delete-frame-functions'.
+This works like 'delete-frame-functions', but runs after the frame to
+be deleted has been made dead and removed from the frame list.
+
+---
+** The function 'provided-mode-derived-p' was extended to support aliases.
+The function now returns non-nil when the argument MODE is derived
+from any alias of any of MODES.
+
++++
+** New frame focus state inspection interface.
+The hooks 'focus-in-hook' and 'focus-out-hook' are now obsolete.
+Instead, attach to 'after-focus-change-function' using 'add-function'
+and inspect the focus state of each frame using 'frame-focus-state'.
+
++++
+** Emacs now requests and recognizes focus-change notifications from TTYs.
+On terminal emulators that support the feature, Emacs can now support
+'focus-in-hook' and 'focus-out-hook' for TTY frames.
+
++++
+** Window-specific face remapping.
+Face specifications (of the kind used in 'face-remapping-alist')
+now support filters, allowing faces to vary between different windows
+displaying the same buffer. See the node "(elisp) Face Remapping"
+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
+changed), 'window-size-change-functions' (run after a window was
+assigned a new buffer or size), 'window-configuration-change-hook'
+(like the former but run also when a window was deleted),
+'window-selection-change-functions' (run when the selected window
+changed) and 'window-state-change-functions' and
+'window-state-change-hook' (run when any of the preceding ones is
+run). Applications can enforce running the latter two using the new
+function 'set-frame-window-state-change'. 'window-scroll-functions'
+are unaffected by these changes.
+
+In addition, a number of functions now allow the caller to detect what
+has changed since last redisplay: 'window-old-buffer' returns for any
+window the buffer it showed at that time. ‘old-selected-window’ and
+'old-selected-frame' return the window and frame that were selected
+during last redisplay. 'window-old-pixel-width' (renamed from
+'window-pixel-width-before-size-change'), 'window-old-pixel-height'
+(renamed from 'window-pixel-height-before-size-change'),
+'window-old-body-pixel-width' and 'window-old-body-pixel-height'
+return the total and body sizes of any window during last redisplay.
+
+Also 'run-window-configuration-change-hook' is declared obsolete.
+
+See the section "(elisp) Window Hooks" in the Elisp manual for a
+detailed explanation of the new behavior.
+
++++
+** Scroll bar and fringe settings can now be made persistent for windows.
+The functions 'set-window-scroll-bars' and 'set-window-fringes' now
+have a new optional argument that makes the settings they produce
+reliably survive subsequent invocations of 'set-window-buffer'.
+
++++
+** 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.
+
++++
+** 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'.
+
++++
+** New buffer display action alist entry 'window-min-height'.
+Such an entry allows to specify a minimum height of the window used
+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.
+
++++
+** New function 'string-distance' to calculate the Levenshtein distance
+between two strings.
+
++++
+** 'print-quoted' now defaults to t, so if you want to see
+'(quote x)' instead of 'x you will have to bind it to nil where applicable.
+
++++
+** Numbers formatted via '%o' or '%x' are now formatted as signed integers.
+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
+integers, they now support the '+' and space flags.
+
++++
+** In Emacs Lisp mode, symbols with confusable quotes are highlighted.
+For example, the first character in '‘foo' would be highlighted in
+'font-lock-warning-face'.
+
++++
+** Omitting variables after '&optional' and '&rest' is now allowed.
+For example '(defun foo (&optional))' is no longer an error. This is
+sometimes convenient when writing macros. See the ChangeLog entry
+titled "Allow '&rest' or '&optional' without following variable
+(Bug#29165)" for a full listing of which arglists are accepted across
+versions.
+
+---
+** Internal parsing commands now use 'syntax-ppss' and disregard
+'open-paren-in-column-0-is-defun-start'. This affects mostly things like
+'forward-comment', 'scan-sexps', and 'forward-sexp' when parsing backward.
+The new variable 'comment-use-syntax-ppss' can be set to nil to recover
+the old behavior if needed.
+
+---
+** The 'server-name' and 'server-socket-dir' variables are set when a
+socket has been passed to Emacs.
+
+---
+** The 'file-system-info' function is now available on all platforms.
+instead of just Microsoft platforms. This fixes a 'get-free-disk-space'
+bug on OS X 10.8 and later.
+
+---
+** The function 'get-free-disk-space' returns now a non-nil value for
+remote systems, which support this check.
+
++++
+** 'memory-limit' now returns a better estimate of memory consumption.
+
++++
+** 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
+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.
+
++++
+** New macro 'combine-change-calls' arranges to call the change hooks
+('before-change-functions' and 'after-change-functions') just once
+each around a sequence of lisp forms, given a region. This is
+useful when a function makes a possibly large number of repetitive
+changes and the change hooks are time consuming.
+
++++
+** 'eql', 'make-hash-table', etc. now treat NaNs consistently.
+Formerly, some of these functions ignored signs and significands of
+NaNs. Now, all these functions treat NaN signs and significands as
+significant. For example, '(eql 0.0e+NaN -0.0e+NaN)' now returns nil
+because the two NaNs have different signs; formerly it returned t.
+Also, Emacs now reads and prints NaN significands; e.g., if X is a
+NaN, '(format "%s" X)' now returns "0.0e+NaN", "1.0e+NaN", etc.,
+depending on X's significand.
+
++++
+** The function 'make-string' accepts an additional optional argument.
+If the optional third argument is non-nil, 'make-string' will produce
+a multibyte string even if its second argument is an ASCII character.
+
+---
+** '(format "%d" X)' no longer mishandles a floating-point number X that
+does not fit in a machine integer.
+
+---
+** New coding-system 'ibm038'.
+This is the International EBCDIC encoding, also available as aliases
+'ebcdic-int' and 'cp038'.
+
+---
+** New JSON parsing and serialization functions 'json-serialize',
+'json-insert', 'json-parse-string', and 'json-parse-buffer'. These
+are implemented in C using the Jansson library.
+
++++
+** New function 'ring-resize'.
+'ring-resize' can be used to grow or shrink a ring.
+
++++
+** New function 'flatten-tree'.
+'flatten-list' is provided as an alias. These functions take a tree
+and 'flatten' it such that the result is a list of all the terminal
+nodes.
+
++++
+** 'zlib-decompress-region' can partially decompress corrupted data.
+If the new optional ALLOW-PARTIAL argument is passed, then the data
+that was decompressed successfully before failing will be inserted
+into the buffer.
+
+** Mailcap
+
+---
+*** The new function 'mailcap-file-name-to-mime-type' has been added.
+It's a simple convenience function for looking up MIME types based on
+file name extensions.
+
+---
+*** The default way the list of possible external viewers for MIME
+types is sorted and chosen has changed. Earlier, the most specific
+viewer was chosen, even if there was a general override in "~/.mailcap".
+For instance, if "/etc/mailcap" has an entry for "image/gif", that one
+will be chosen even if you have an entry for "image/*" in your
+"~/.mailcap" file. But with the new method, entries from "~/.mailcap"
+overrides all system and Emacs-provided defaults. To get the old
+method back, set 'mailcap-prefer-mailcap-viewers' to nil.
+
+** URL
+
+---
+*** The 'file:' handler no longer looks for "index.html" in
+directories if you ask it for a "file:///dir" URL. Since this is a
+low-level library, such decisions (if they are to be made at all) are
+left to higher-level functions.
+
+---
+** The url-ns.el library is now marked obsolete.
+This library is used to open configuration files for the long defunct
+web browser Netscape, and is no longer relevant.
+
+** Image mode
+
+---
+*** New library Exif.
+An Exif library has been added that can parse JPEG files and output
+data about creation times and orientation and the like.
+'exif-parse-file' and 'exif-parse-buffer' are the main interface
+functions.
+
+---
+*** 'image-mode' now uses this library to automatically rotate images
+according to the orientation in the Exif data, if any.
+
+---
+*** New library image-converter.
+If you need to view exotic image formats for which Emacs doesn't have
+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.
+
+---
+*** 'auto-mode-alist' now includes many of the types typically
+supported by the external image converters, like WEPB, BMP and ICO.
+These now default to using 'image-mode'.
+
+---
+*** 'imagemagick-types-inhibit' disables using ImageMagick by default.
+'image-mode' started using ImageMagick by default for all images
+some years back. It now respects 'imagemagick-types-inhibit' as a way
+to disable that.
+
+---
+*** 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.
+
++++
+*** Three new 'image-mode' commands have been added: 'm', which marks
+the file in the dired buffer(s) for the directory the file is in; 'u',
+which unmarks the file; and 'w', which pushes the current buffer's file
+name to the kill ring.
+
++++
+*** The command 'image-rotate' now accepts a prefix argument.
+With a prefix argument, 'image-rotate' now rotates the image at point
+90 degrees counter-clockwise, instead of the default clockwise.
+
+** 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
+the new variable 'custom-variable-history'.
+
+---
+** The functions 'string-to-unibyte' and 'string-to-multibyte' are no
+longer declared obsolete. We have found that there are legitimate use
+cases for these functions, where there's no better alternative. We
+believe that the incorrect uses of these functions all but disappeared
+by now, so we are un-obsoleting them.
+
++++
+** New function 'group-name' returns a group name corresponding to GID.
+
++++
+** 'make-process' now takes a keyword argument ':file-handler'; if
+that is non-nil, it will look for a file name handler for the current
+buffer's 'default-directory' and invoke that file name handler to make
+the process. That way 'make-process' can start remote processes.
+
++++
+** '(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.
+
++++
+** The function 'regexp-opt' accepts an additional optional argument.
+By default, the regexp returned by 'regexp-opt' may match the strings
+in any order. If the new third argument is non-nil, the match is
+guaranteed to be performed in the order given, as if the strings were
+made into a regexp by joining them with '\|'.
+
++++
+** The function 'regexp-opt', when given an empty list of strings, now
+returns a regexp that never matches anything, which is an identity for
+this operation. Previously, the empty string was returned in this
+case.
+
++++
+** 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.
+
+++++
+** New functions to handle the URL variant of base-64 encoding.
+New functions 'base64url-encode-string' and 'base64url-encode-region'
+implement the url-variant of base-64 encoding as defined in RFC4648.
+
+The functions 'base64-decode-string' and 'base64-decode-region' now
+accept an optional argument to decode the URL variant of base-64
+encoding.
+
++++
+** The function 'file-size-human-readable' accepts more optional arguments.
+The new third argument is a string put between the number and unit; it
+defaults to the empty string. The new fourth argument is a string
+representing the unit to use; it defaults to "B" when the second
+argument is 'iec' and the empty string otherwise. We recomment a
+space or non-breaking space as third argument, and "B" as fourth
+argument, circumstances allowing.
+
++++
+** 'format-spec' has been expanded with several modifiers to allow
+greater flexibility when customizing variables. The modifiers include
+zero-padding, upper- and lower-casing, and limiting the length of the
+interpolated strings. The function has now also been documented in
+the Emacs Lisp manual.
+
++++
+** 'directory-files-recursively' can now take an optional PREDICATE
+parameter to control descending into subdirectories, and a
+FOLLOW-SYMLINK parameter to say that symbolic links that point to
+other directories should be followed.
+
++++
+** New function 'xor' returns the boolean exclusive-or of its args.
+The function was previously defined in array.el, but has been moved to
+subr.el so that it is available by default. It now always returns the
+non-nil argument when the other is nil. Several duplicates of 'xor'
+in other packages are now obsolete aliases of 'xor'.
+
++++
+** 'define-globalized-minor-mode' now takes BODY forms.
+
++++
+** New text property 'help-echo-inhibit-substitution'.
+Setting this on the first character of a help string disables
+conversions via 'substitute-command-keys'.
+
++++
+** 'undo' can be made to ignore the active region for a command
+by setting 'undo-inhibit-region' symbol property of that command to
+non-nil. This is used by 'mouse-drag-region' to make the effect
+easier to undo immediately afterwards.
+
+---
+** When called interactively, 'next-buffer' and 'previous-buffer' now
+signal 'user-error' if there is no buffer to switch to.
+
+
+* Changes in Emacs 27.1 on Non-Free Operating Systems
+
+---
+** Battery status is now supported in all Cygwin builds.
+Previously it was supported only in the Cygwin-w32 build.
+
+** Emacs now handles key combinations involving the macOS "command"
+and "option" modifier keys more correctly.
+
+** MacOS modifier key behavior is now more adjustable.
+The behavior of the macOS "Option", "Command", "Control" and
+"Function" keys can now be specified separately for use with
+ordinary keys, function keys and mouse clicks. This allows using them
+in their standard macOS way for composing characters.
+
+** The special handling of 'frame-title-format' on NS where setting it
+to 't' would enable the macOS proxy icon has been replaced with a
+separate variable, 'ns-use-proxy-icon'. 'frame-title-format' will now
+work as on other platforms.
+
+---
+** New primitive 'w32-read-registry'.
+This primitive lets Lisp programs access the MS-Windows Registry by
+retrieving values stored under a given key. It is intended to be used
+for supporting features such as XDG-like location of important files
+and directories.
+
++++
+** The default value of 'w32-pipe-read-delay' is now zero.
+This speeds up reading output from sub-processes that produce a lot of
+data.
+
+This variable may need to be non-zero only when running DOS programs
+as Emacs subprocesses, which by now is not supported on modern
+versions of MS-Windows. Set this variable to 50 if for some reason
+you need the old behavior (and please report such situations to Emacs
+developers).
+
+---
+** New variable 'w32-multibyte-code-page'.
+This variable holds the value of the multibyte code page used by the
+system. It is usually zero, which indicates that 'w32-ansi-code-page'
+is being used, except in Far Eastern locales. When this variable is
+non-zero, Emacs at startup sets 'locale-coding-system' to the
+corresponding encoding, instead of using 'w32-ansi-code-page'.
+
+---
+** The default value of 'inhibit-compacting-font-caches' is t on MS-Windows.
+Experience shows that compacting font caches causes more trouble on
+MS-Windows than it helps.
+
++++
+** Font lookup on MS-Windows was improved to support rare scripts.
+To activate the improvement, run the new function
+'w32-find-non-USB-fonts' once per Emacs session, or assign to the new
+variable 'w32-non-USB-fonts' the list of scripts and the corresponding
+fonts. See the documentation of this function and variable in the
+Emacs manual for more details.
+
++++
+** On NS the behavior of drag and drop can now be modified by use of
+modifier keys in line with Apples guidelines. This makes the drag and
+drop behavior more consistent, as previously the sending application
+was able to 'set' modifiers without the knowledge of the user.
+
+** On NS multicolor font display is enabled again since it is also
+implemented in Emacs on free operating systems via Cairo drawing.
+
+
+----------------------------------------------------------------------
+This file is part of GNU Emacs.
+
+GNU Emacs is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+GNU Emacs is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>.
+
+
+Local variables:
+coding: utf-8
+mode: outline
+paragraph-separate: "[ ]*$"
+end:
diff --git a/etc/refcards/ru-refcard.tex b/etc/refcards/ru-refcard.tex
index 59741f31ebe..ab94acedf2c 100644
--- a/etc/refcards/ru-refcard.tex
+++ b/etc/refcards/ru-refcard.tex
@@ -40,7 +40,7 @@
\newlength{\ColThreeWidth}
\setlength{\ColThreeWidth}{25mm}
-\newcommand{\versionemacs}[0]{27} % version of Emacs this is for
+\newcommand{\versionemacs}[0]{28} % version of Emacs this is for
\newcommand{\cyear}[0]{2019} % copyright year
\newcommand\shortcopyrightnotice[0]{\vskip 1ex plus 2 fill
diff --git a/lisp/calendar/diary-lib.el b/lisp/calendar/diary-lib.el
index 25849627cdd..b20a4c907cf 100644
--- a/lisp/calendar/diary-lib.el
+++ b/lisp/calendar/diary-lib.el
@@ -98,7 +98,7 @@ specifies which face attribute (e.g. `:foreground') to modify, or
that this is a face (`:face') to apply. TYPE is the type of
attribute being applied. Available TYPES (see `diary-attrtype-convert')
are: `string', `symbol', `int', `tnil', `stringtnil'."
- :type '(repeat (list (string :tag "Regular expression")
+ :type '(repeat (list (regexp :tag "Regular expression")
(integer :tag "Sub-expression")
(symbol :tag "Attribute (e.g. :foreground)")
(choice (const string :tag "A string")
diff --git a/lisp/cedet/semantic/db-ebrowse.el b/lisp/cedet/semantic/db-ebrowse.el
index 14ada88612b..958f6ed6401 100644
--- a/lisp/cedet/semantic/db-ebrowse.el
+++ b/lisp/cedet/semantic/db-ebrowse.el
@@ -74,7 +74,7 @@ By default, include only headers since the semantic use of EBrowse
is only for searching via semanticdb, and thus only headers would
be searched."
:group 'semanticdb
- :type 'string)
+ :type 'regexp)
;;; SEMANTIC Database related Code
;;; Classes:
diff --git a/lisp/cedet/srecode/document.el b/lisp/cedet/srecode/document.el
index 21acc61fef2..df7bc0aa330 100644
--- a/lisp/cedet/srecode/document.el
+++ b/lisp/cedet/srecode/document.el
@@ -89,7 +89,7 @@ versions of names. This is an alist with each element of the form:
MATCH is a regexp to match in the type field.
RESULT is a string."
:group 'document
- :type '(repeat (cons (string :tag "Regexp")
+ :type '(repeat (cons (regexp :tag "Regexp")
(string :tag "Doc Text"))))
(defcustom srecode-document-autocomment-function-alist
@@ -145,7 +145,7 @@ see how best to describe what can be returned.
Doesn't always work correctly, but that is just because English
doesn't always work correctly."
:group 'document
- :type '(repeat (cons (string :tag "Regexp")
+ :type '(repeat (cons (regexp :tag "Regexp")
(string :tag "Doc Text"))))
(defcustom srecode-document-autocomment-common-nouns-abbrevs
@@ -176,7 +176,7 @@ versions of names. This is an alist with each element of the form:
MATCH is a regexp to match in the type field.
RESULT is a string."
:group 'document
- :type '(repeat (cons (string :tag "Regexp")
+ :type '(repeat (cons (regexp :tag "Regexp")
(string :tag "Doc Text"))))
(defcustom srecode-document-autocomment-return-first-alist
@@ -193,7 +193,7 @@ This is an alist with each element of the form:
MATCH is a regexp to match in the type field.
RESULT is a string."
:group 'document
- :type '(repeat (cons (string :tag "Regexp")
+ :type '(repeat (cons (regexp :tag "Regexp")
(string :tag "Doc Text"))))
(defcustom srecode-document-autocomment-return-last-alist
@@ -214,7 +214,7 @@ MATCH is a regexp to match in the type field.
RESULT is a string, which can contain %s, which is replaced with
`match-string' 1."
:group 'document
- :type '(repeat (cons (string :tag "Regexp")
+ :type '(repeat (cons (regexp :tag "Regexp")
(string :tag "Doc Text"))))
(defcustom srecode-document-autocomment-param-alist
@@ -234,7 +234,7 @@ RESULT is a string of text to use to describe MATCH.
When one is encountered, document-insert-parameters will automatically
place this comment after the parameter name."
:group 'document
- :type '(repeat (cons (string :tag "Regexp")
+ :type '(repeat (cons (regexp :tag "Regexp")
(string :tag "Doc Text"))))
(defcustom srecode-document-autocomment-param-type-alist
@@ -259,7 +259,7 @@ This is an alist with each element of the form:
MATCH is a regexp to match in the type field.
RESULT is a string."
:group 'document
- :type '(repeat (cons (string :tag "Regexp")
+ :type '(repeat (cons (regexp :tag "Regexp")
(string :tag "Doc Text"))))
;;;###autoload
diff --git a/lisp/desktop.el b/lisp/desktop.el
index 6f45278218c..362a4e825a1 100644
--- a/lisp/desktop.el
+++ b/lisp/desktop.el
@@ -344,7 +344,7 @@ to the value obtained by evaluating FORM."
Each element is a regular expression. Buffers with a name matched by any of
these won't be deleted."
:version "23.3" ; added Warnings - bug#6336
- :type '(repeat string)
+ :type '(repeat regexp)
:group 'desktop)
;;;###autoload
diff --git a/lisp/elide-head.el b/lisp/elide-head.el
index c1678c003db..78197c0b474 100644
--- a/lisp/elide-head.el
+++ b/lisp/elide-head.el
@@ -64,8 +64,8 @@ elided with an invisible overlay from the end of the line where the
first match is found to the end of the match for the corresponding
cdr."
:group 'elide-head
- :type '(alist :key-type (string :tag "Start regexp")
- :value-type (string :tag "End regexp")))
+ :type '(alist :key-type (regexp :tag "Start regexp")
+ :value-type (regexp :tag "End regexp")))
(defvar elide-head-overlay nil)
(make-variable-buffer-local 'elide-head-overlay)
diff --git a/lisp/emacs-lisp/byte-opt.el b/lisp/emacs-lisp/byte-opt.el
index 22fea1b8da9..07fd548dec2 100644
--- a/lisp/emacs-lisp/byte-opt.el
+++ b/lisp/emacs-lisp/byte-opt.el
@@ -480,6 +480,13 @@
backwards)))))
(cons fn (mapcar 'byte-optimize-form (cdr form)))))
+ ((eq fn 'while)
+ (unless (consp (cdr form))
+ (byte-compile-warn "too few arguments for `while'"))
+ (cons fn
+ (cons (byte-optimize-form (cadr form) nil)
+ (byte-optimize-body (cddr form) t))))
+
((eq fn 'interactive)
(byte-compile-warn "misplaced interactive spec: `%s'"
(prin1-to-string form))
diff --git a/lisp/emacs-lisp/bytecomp.el b/lisp/emacs-lisp/bytecomp.el
index 118356ec26a..60dbae1d4bc 100644
--- a/lisp/emacs-lisp/bytecomp.el
+++ b/lisp/emacs-lisp/bytecomp.el
@@ -3462,7 +3462,7 @@ for symbols generated by the byte compiler itself."
(if (equal-including-properties (car elt) ,const)
(setq result elt)))
result)
- (assq ,const byte-compile-constants))
+ (assoc ,const byte-compile-constants #'eql))
(car (setq byte-compile-constants
(cons (list ,const) byte-compile-constants)))))
diff --git a/lisp/emacs-lisp/edebug.el b/lisp/emacs-lisp/edebug.el
index 04a640c82c3..68b87f10b21 100644
--- a/lisp/emacs-lisp/edebug.el
+++ b/lisp/emacs-lisp/edebug.el
@@ -3708,7 +3708,6 @@ Return the result of the last expression."
(prin1-to-string edebug-arg))
(cdr value) ", ")))
-(defvar print-readably) ; defined by lemacs
;; Alternatively, we could change the definition of
;; edebug-safe-prin1-to-string to only use these if defined.
@@ -3716,8 +3715,7 @@ Return the result of the last expression."
(let ((print-escape-newlines t)
(print-length (or edebug-print-length print-length))
(print-level (or edebug-print-level print-level))
- (print-circle (or edebug-print-circle print-circle))
- (print-readably nil)) ; lemacs uses this.
+ (print-circle (or edebug-print-circle print-circle)))
(edebug-prin1-to-string value)))
(defun edebug-compute-previous-result (previous-value)
diff --git a/lisp/emacs-lisp/generator.el b/lisp/emacs-lisp/generator.el
index 9dba87eaeb4..9ea76433f3a 100644
--- a/lisp/emacs-lisp/generator.el
+++ b/lisp/emacs-lisp/generator.el
@@ -155,7 +155,7 @@ DYNAMIC-VAR bound to STATIC-VAR."
(defun cps--add-state (kind body)
"Create a new CPS state with body BODY and return the state's name."
(declare (indent 1))
- (let* ((state (cps--gensym "cps-state-%s-" kind)))
+ (let ((state (cps--gensym "cps-state-%s-" kind)))
(push (list state body cps--cleanup-function) cps--states)
(push state cps--bindings)
state))
diff --git a/lisp/epa.el b/lisp/epa.el
index 13708d046d6..7434a27e728 100644
--- a/lisp/epa.el
+++ b/lisp/epa.el
@@ -361,7 +361,10 @@ If ARG is non-nil, mark the key."
'start-open t
'end-open t)))))
-(defun epa--list-keys (name secret)
+(defun epa--list-keys (name secret &optional doc)
+ "NAME specifies which key to list.
+SECRET says list data on the secret key (default, the public key).
+DOC is documentation text to insert at the start."
(unless (and epa-keys-buffer
(buffer-live-p epa-keys-buffer))
(setq epa-keys-buffer (generate-new-buffer "*Keys*")))
@@ -371,13 +374,28 @@ If ARG is non-nil, mark the key."
buffer-read-only
(point (point-min))
(context (epg-make-context epa-protocol)))
+
+ ;; Find the end of the documentation text at the start.
+ ;; Set POINT to where it ends, or nil if ends at eob.
(unless (get-text-property point 'epa-list-keys)
(setq point (next-single-property-change point 'epa-list-keys)))
+
+ ;; If caller specified documentation text for that, replace the old
+ ;; documentation text (if any) with what was specified.
+ ;; Otherwise, preserve whatever intro text is present.
+ (when doc
+ (if (or point (not (eobp)))
+ (delete-region (point-min) point))
+ (insert doc)
+ (setq point (point)))
+
+ ;; Now delete the key description text, if any.
(when point
(delete-region point
(or (next-single-property-change point 'epa-list-keys)
(point-max)))
(goto-char point))
+
(epa--insert-keys (epg-list-keys context name secret))
(widget-setup)
(set-keymap-parent (current-local-map) widget-keymap))
@@ -396,7 +414,13 @@ If ARG is non-nil, mark the key."
(car epa-list-keys-arguments)))))
(list (if (equal name "") nil name)))
(list nil)))
- (epa--list-keys name nil))
+ (epa--list-keys name nil
+ "The letters at the start of a line have these meanings.
+e expired key. n never trust. m trust marginally. u trust ultimately.
+f trust fully (keys you have signed, usually).
+q trust status questionable. - trust status unspecified.
+ See GPG documentaion for more explanation.
+\n"))
;;;###autoload
(defun epa-list-secret-keys (&optional name)
diff --git a/lisp/erc/erc-backend.el b/lisp/erc/erc-backend.el
index 72a7f86da2f..2ac43e42742 100644
--- a/lisp/erc/erc-backend.el
+++ b/lisp/erc/erc-backend.el
@@ -375,7 +375,7 @@ Example: If you know that the channel #linux-ru uses the coding-system
`cyrillic-koi8', then add (\"#linux-ru\" . cyrillic-koi8) to the
alist."
:group 'erc-server
- :type '(repeat (cons (string :tag "Target")
+ :type '(repeat (cons (regexp :tag "Target")
coding-system)))
(defcustom erc-server-connect-function #'erc-open-network-stream
diff --git a/lisp/erc/erc-ezbounce.el b/lisp/erc/erc-ezbounce.el
index 899ea2f6b5f..b3585c986aa 100644
--- a/lisp/erc/erc-ezbounce.el
+++ b/lisp/erc/erc-ezbounce.el
@@ -34,7 +34,7 @@
(defcustom erc-ezb-regexp "^ezbounce!srv$"
"Regexp used by the EZBouncer to identify itself to the user."
:group 'erc-ezbounce
- :type 'string)
+ :type 'regexp)
(defcustom erc-ezb-login-alist '()
"Alist of logins suitable for the server we're connecting to.
diff --git a/lisp/files.el b/lisp/files.el
index 059fdbbe371..10dba39f363 100644
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -405,7 +405,7 @@ editing a remote file.
On MS-DOS filesystems without long names this variable is always
ignored."
:group 'auto-save
- :type '(repeat (list (string :tag "Regexp") (string :tag "Replacement")
+ :type '(repeat (list (regexp :tag "Regexp") (string :tag "Replacement")
(boolean :tag "Uniquify")))
:initialize 'custom-initialize-delay
:version "21.1")
diff --git a/lisp/gnus/deuglify.el b/lisp/gnus/deuglify.el
index 3bf6a3aa2aa..8f242762376 100644
--- a/lisp/gnus/deuglify.el
+++ b/lisp/gnus/deuglify.el
@@ -266,21 +266,21 @@
"\\(On \\|Am \\)?\\(Mon\\|Tue\\|Wed\\|Thu\\|Fri\\|Sat\\|Sun\\),[^,]+, "
"Regular expression matching the beginning of an attribution line that should be cut off."
:version "22.1"
- :type 'string
+ :type 'regexp
:group 'gnus-outlook-deuglify)
(defcustom gnus-outlook-deuglify-attrib-verb-regexp
"wrote\\|writes\\|says\\|schrieb\\|schreibt\\|meinte\\|skrev\\|a écrit\\|schreef\\|escribió"
"Regular expression matching the verb used in an attribution line."
:version "22.1"
- :type 'string
+ :type 'regexp
:group 'gnus-outlook-deuglify)
(defcustom gnus-outlook-deuglify-attrib-end-regexp
": *\\|\\.\\.\\."
"Regular expression matching the end of an attribution line."
:version "22.1"
- :type 'string
+ :type 'regexp
:group 'gnus-outlook-deuglify)
(defcustom gnus-outlook-display-hook nil
diff --git a/lisp/gnus/gnus-fun.el b/lisp/gnus/gnus-fun.el
index 8b710512be8..323860bf18c 100644
--- a/lisp/gnus/gnus-fun.el
+++ b/lisp/gnus/gnus-fun.el
@@ -40,7 +40,7 @@
"Regexp to match faces in `gnus-x-face-directory' to be omitted."
:version "25.1"
:group 'gnus-fun
- :type '(choice (const nil) string))
+ :type '(choice (const nil) regexp))
(defcustom gnus-face-directory (expand-file-name "faces" gnus-directory)
"Directory where Face PNG files are stored."
@@ -52,7 +52,7 @@
"Regexp to match faces in `gnus-face-directory' to be omitted."
:version "25.1"
:group 'gnus-fun
- :type '(choice (const nil) string))
+ :type '(choice (const nil) regexp))
(defcustom gnus-convert-pbm-to-x-face-command "pbmtoxbm %s | compface"
"Command for converting a PBM to an X-Face."
diff --git a/lisp/gnus/nnheader.el b/lisp/gnus/nnheader.el
index 28c4cebb2d1..a30fa637960 100644
--- a/lisp/gnus/nnheader.el
+++ b/lisp/gnus/nnheader.el
@@ -487,8 +487,8 @@ the line could be found."
(< num article)))
(forward-line 1)
(setq found (point))
- (or (eobp)
- (= (setq num (read cur)) article)))
+ (unless (eobp)
+ (setq num (read cur))))
(unless (eq num article)
(goto-char found)))
(beginning-of-line)
diff --git a/lisp/gnus/spam.el b/lisp/gnus/spam.el
index 83df2f6198f..e7a63d278e7 100644
--- a/lisp/gnus/spam.el
+++ b/lisp/gnus/spam.el
@@ -579,7 +579,7 @@ This must be a list. For example, `(\"-C\" \"configfile\")'."
(defcustom spam-spamassassin-positive-spam-flag-header "YES"
"The regex on `spam-spamassassin-spam-flag-header' for positive spam
identification."
- :type 'string
+ :type 'regexp
:group 'spam-spamassassin)
(defcustom spam-spamassassin-spam-status-header "X-Spam-Status"
diff --git a/lisp/htmlfontify.el b/lisp/htmlfontify.el
index 481b14738bc..6b88ea9d730 100644
--- a/lisp/htmlfontify.el
+++ b/lisp/htmlfontify.el
@@ -197,7 +197,7 @@ It takes only one argument, the filename."
"Regex to remove from the `<style> a' variant of an htmlfontify CSS class."
:group 'htmlfontify
:tag "src-doc-link-unstyle"
- :type '(string))
+ :type '(regexp))
(defcustom hfy-link-extn nil
"File extension used for href links.
diff --git a/lisp/info-look.el b/lisp/info-look.el
index 8a484bbed1a..ea8fe9646ac 100644
--- a/lisp/info-look.el
+++ b/lisp/info-look.el
@@ -75,7 +75,7 @@ List elements are cons cells of the form
If a file name matches REGEXP, then use help mode MODE instead of the
buffer's major mode."
- :group 'info-lookup :type '(repeat (cons (string :tag "Regexp")
+ :group 'info-lookup :type '(repeat (cons (regexp :tag "Regexp")
(symbol :tag "Mode"))))
(defvar info-lookup-history nil
diff --git a/lisp/international/rfc1843.el b/lisp/international/rfc1843.el
index 545ee4e53e4..d7a6ddfce71 100644
--- a/lisp/international/rfc1843.el
+++ b/lisp/international/rfc1843.el
@@ -60,7 +60,7 @@ e-mail transmission, news posting, etc."
(defcustom rfc1843-newsgroups-regexp "chinese\\|hz"
"Regexp of newsgroups in which might be HZ encoded."
- :type 'string
+ :type 'regexp
:group 'mime)
(defun rfc1843-decode-region (from to)
diff --git a/lisp/mail/feedmail.el b/lisp/mail/feedmail.el
index 08db4262f17..7b7cefa4055 100644
--- a/lisp/mail/feedmail.el
+++ b/lisp/mail/feedmail.el
@@ -1203,7 +1203,7 @@ no longer matches to transformed string. Used by function
feedmail-tidy-up-slug and indirectly by feedmail-queue-subject-slug-maker."
:version "24.1"
:group 'feedmail-queue
- :type 'string
+ :type 'regexp
)
diff --git a/lisp/mail/rmail-spam-filter.el b/lisp/mail/rmail-spam-filter.el
index 86217e5dd5c..f08c050802e 100644
--- a/lisp/mail/rmail-spam-filter.el
+++ b/lisp/mail/rmail-spam-filter.el
@@ -133,7 +133,7 @@ If any element matches the \"From\" header, the message is
flagged as a valid, non-spam message. E.g., if your domain is
\"emacs.com\" then including \"emacs\\\\.com\" in this list would
flag all mail (purporting to be) from your colleagues as valid."
- :type '(repeat string)
+ :type '(repeat regexp)
:group 'rmail-spam-filter)
(defcustom rsf-definitions-alist nil
@@ -157,22 +157,22 @@ A rule matches only if all the specified elements match."
(list :format "%v"
(cons :format "%v" :value (from . "")
(const :format "" from)
- (string :tag "From" ""))
+ (regexp :tag "From" ""))
(cons :format "%v" :value (to . "")
(const :format "" to)
- (string :tag "To" ""))
+ (regexp :tag "To" ""))
(cons :format "%v" :value (subject . "")
(const :format "" subject)
- (string :tag "Subject" ""))
+ (regexp :tag "Subject" ""))
(cons :format "%v" :value (content-type . "")
(const :format "" content-type)
- (string :tag "Content-Type" ""))
+ (regexp :tag "Content-Type" ""))
(cons :format "%v" :value (contents . "")
(const :format "" contents)
- (string :tag "Contents" ""))
+ (regexp :tag "Contents" ""))
(cons :format "%v" :value (x-spam-status . "")
(const :format "" x-spam-status)
- (string :tag "X-Spam-Status" ""))
+ (regexp :tag "X-Spam-Status" ""))
(cons :format "%v" :value (action . output-and-delete)
(const :format "" action)
(choice :tag "Action selection"
diff --git a/lisp/man.el b/lisp/man.el
index 2509e5f90c9..522661fbd16 100644
--- a/lisp/man.el
+++ b/lisp/man.el
@@ -253,7 +253,7 @@ the associated section number."
"Regexp that matches the text that precedes the command's name.
Used in `bookmark-set' to get the default bookmark name."
:version "24.1"
- :type 'string :group 'bookmark)
+ :type 'regexp :group 'bookmark)
(defcustom manual-program "man"
"Program used by `man' to produce man pages."
diff --git a/lisp/net/ange-ftp.el b/lisp/net/ange-ftp.el
index 140a0e7e935..71570233425 100644
--- a/lisp/net/ange-ftp.el
+++ b/lisp/net/ange-ftp.el
@@ -838,7 +838,7 @@ If nil, prompt the user for a password."
"If non-nil, regexp matching hosts on which `dir' command lists directory."
:group 'ange-ftp
:type '(choice (const :tag "Default" nil)
- string))
+ regexp))
(defcustom ange-ftp-binary-file-name-regexp ""
"If a file matches this regexp then it is transferred in binary mode."
diff --git a/lisp/net/ldap.el b/lisp/net/ldap.el
index 75fc7d62211..a109f28db53 100644
--- a/lisp/net/ldap.el
+++ b/lisp/net/ldap.el
@@ -727,7 +727,7 @@ an alist of attribute/value pairs."
(setq record nil)
(skip-chars-forward " \t\n")
(message "Parsing results... %d" numres)
- (1+ numres))
+ (setq numres (1+ numres)))
(message "Parsing results... done")
(nreverse result)))))
diff --git a/lisp/net/newst-backend.el b/lisp/net/newst-backend.el
index 792ddbbf0b7..43e1d2b4ec6 100644
--- a/lisp/net/newst-backend.el
+++ b/lisp/net/newst-backend.el
@@ -363,7 +363,7 @@ description are marked as immortal."
(const :tag "Title" title)
(const :tag "Description" description)
(const :tag "All" all))
- (string :tag "Regexp")))))
+ (regexp :tag "Regexp")))))
:group 'newsticker-headline-processing)
;; ======================================================================
diff --git a/lisp/net/rcirc.el b/lisp/net/rcirc.el
index a373c7c7d3e..e652508cd73 100644
--- a/lisp/net/rcirc.el
+++ b/lisp/net/rcirc.el
@@ -254,7 +254,7 @@ Examples:
(\"bitlbee\" bitlbee \"robert\" \"sekrit\")
(\"dal.net\" nickserv \"bob\" \"sekrit\" \"NickServ@services.dal.net\")
(\"quakenet.org\" quakenet \"bobby\" \"sekrit\"))"
- :type '(alist :key-type (string :tag "Server")
+ :type '(alist :key-type (regexp :tag "Server")
:value-type (choice (list :tag "NickServ"
(const nickserv)
(string :tag "Nick")
@@ -359,9 +359,9 @@ If VAL is a coding system, it is used for both decoding and encoding
messages.
If VAL is a cons of coding systems, the car part is used for decoding,
and the cdr part is used for encoding."
- :type '(alist :key-type (choice (string :tag "Channel Regexp")
- (cons (string :tag "Channel Regexp")
- (string :tag "Server Regexp")))
+ :type '(alist :key-type (choice (regexp :tag "Channel Regexp")
+ (cons (regexp :tag "Channel Regexp")
+ (regexp :tag "Server Regexp")))
:value-type (choice coding-system
(cons (coding-system :tag "Decode")
(coding-system :tag "Encode")))))
diff --git a/lisp/org/org-agenda.el b/lisp/org/org-agenda.el
index 2f0bd5f4e17..f77354f11f6 100644
--- a/lisp/org/org-agenda.el
+++ b/lisp/org/org-agenda.el
@@ -1883,7 +1883,7 @@ Nil means don't hide any tags."
:group 'org-agenda-line-format
:type '(choice
(const :tag "Hide none" nil)
- (string :tag "Regexp ")))
+ (regexp :tag "Regexp ")))
(defvaralias 'org-agenda-remove-tags-when-in-prefix
'org-agenda-remove-tags)
@@ -1980,7 +1980,7 @@ category, you can use:
(\"Emacs\" \\='(space . (:width (16))))"
:group 'org-agenda-line-format
:version "24.1"
- :type '(alist :key-type (string :tag "Regexp matching category")
+ :type '(alist :key-type (regexp :tag "Regexp matching category")
:value-type (choice (list :tag "Icon"
(string :tag "File or data")
(symbol :tag "Type")
diff --git a/lisp/org/org-protocol.el b/lisp/org/org-protocol.el
index 44c6abbd959..5ba21268207 100644
--- a/lisp/org/org-protocol.el
+++ b/lisp/org/org-protocol.el
@@ -278,7 +278,7 @@ This should be a single regexp string."
:group 'org-protocol
:version "24.4"
:package-version '(Org . "8.0")
- :type 'string)
+ :type 'regexp)
;;; Helper functions:
diff --git a/lisp/org/org-table.el b/lisp/org/org-table.el
index a2e77e07392..daacc988d52 100644
--- a/lisp/org/org-table.el
+++ b/lisp/org/org-table.el
@@ -198,7 +198,7 @@ Other options offered by the customize interface are more restrictive."
"^\\([<>]?[-+^.0-9]*[0-9][-+^.0-9eEdDx()%]*\\|[<>]?[-+]?0[xX][[:xdigit:].]+\\|[<>]?[-+]?[0-9]+#[0-9a-zA-Z.]+\\|nan\\|[-+u]?inf\\)$")
(const :tag "Very General Number-Like, including hex and Calc radix, allows comma as decimal mark"
"^\\([<>]?[-+^.,0-9]*[0-9][-+^.0-9eEdDx()%]*\\|[<>]?[-+]?0[xX][[:xdigit:].]+\\|[<>]?[-+]?[0-9]+#[0-9a-zA-Z.]+\\|nan\\|[-+u]?inf\\)$")
- (string :tag "Regexp:")))
+ (regexp :tag "Regexp:")))
(defcustom org-table-number-fraction 0.5
"Fraction of numbers in a column required to make the column align right.
diff --git a/lisp/org/ox-latex.el b/lisp/org/ox-latex.el
index 65f40fb7a15..72777c019cb 100644
--- a/lisp/org/ox-latex.el
+++ b/lisp/org/ox-latex.el
@@ -1239,7 +1239,7 @@ calling `org-latex-compile'."
:package-version '(Org . "8.3")
:type '(repeat
(cons
- (string :tag "Regexp")
+ (regexp :tag "Regexp")
(string :tag "Message"))))
diff --git a/lisp/progmodes/bug-reference.el b/lisp/progmodes/bug-reference.el
index 813ecbe3847..b5db6368951 100644
--- a/lisp/progmodes/bug-reference.el
+++ b/lisp/progmodes/bug-reference.el
@@ -72,7 +72,7 @@ so that it is considered safe, see `enable-local-variables'.")
"\\([Bb]ug ?#?\\|[Pp]atch ?#\\|RFE ?#\\|PR [a-z+-]+/\\)\\([0-9]+\\(?:#[0-9]+\\)?\\)"
"Regular expression matching bug references.
The second subexpression should match the bug reference (usually a number)."
- :type 'string
+ :type 'regexp
:version "24.3" ; previously defconst
:group 'bug-reference)
diff --git a/lisp/progmodes/hideif.el b/lisp/progmodes/hideif.el
index 9fea447e765..adfeb0ba351 100644
--- a/lisp/progmodes/hideif.el
+++ b/lisp/progmodes/hideif.el
@@ -162,7 +162,7 @@ This behavior is generally undesirable. If this option is non-nil, the outermos
"\\.h\\(h\\|xx\\|pp\\|\\+\\+\\)?\\'"
"C/C++ header file name patterns to determine if current buffer is a header.
Effective only if `hide-ifdef-expand-reinclusion-protection' is t."
- :type 'string
+ :type 'regexp
:version "25.1")
(defvar hide-ifdef-mode-submap
diff --git a/lisp/progmodes/idlw-help.el b/lisp/progmodes/idlw-help.el
index c4cf29c1418..f4d4f4b4cd6 100644
--- a/lisp/progmodes/idlw-help.el
+++ b/lisp/progmodes/idlw-help.el
@@ -182,14 +182,14 @@ definition is displayed instead."
which specifies the `name' section. Can be used for localization
support."
:group 'idlwave-online-help
- :type 'string)
+ :type 'regexp)
(defcustom idlwave-help-doclib-keyword "KEYWORD"
"A regexp for the heading word to search for in doclib headers
which specifies the `keywords' section. Can be used for localization
support."
:group 'idlwave-online-help
- :type 'string)
+ :type 'regexp)
(defface idlwave-help-link
'((t :inherit link))
diff --git a/lisp/progmodes/idlwave.el b/lisp/progmodes/idlwave.el
index 9c46ac84e22..c2071d21e50 100644
--- a/lisp/progmodes/idlwave.el
+++ b/lisp/progmodes/idlwave.el
@@ -314,7 +314,7 @@ split then a terminal beep and warning are issued."
expression will not be changed. Note that the indentation of a comment
at the beginning of a line is never changed."
:group 'idlwave-code-formatting
- :type 'string)
+ :type 'regexp)
(defcustom idlwave-begin-line-comment nil
"A comment anchored at the beginning of line.
diff --git a/lisp/progmodes/python.el b/lisp/progmodes/python.el
index 2956bfa0419..0482cd78dc4 100644
--- a/lisp/progmodes/python.el
+++ b/lisp/progmodes/python.el
@@ -1993,7 +1993,7 @@ position, else returns nil."
;; IPython prompts activated, this adds some safeguard for that.
"In : " "\\.\\.\\.: ")
"List of regular expressions matching input prompts."
- :type '(repeat string)
+ :type '(repeat regexp)
:version "24.4")
(defcustom python-shell-prompt-output-regexps
@@ -2001,28 +2001,28 @@ position, else returns nil."
"Out\\[[0-9]+\\]: " ; IPython
"Out :") ; ipdb safeguard
"List of regular expressions matching output prompts."
- :type '(repeat string)
+ :type '(repeat regexp)
:version "24.4")
(defcustom python-shell-prompt-regexp ">>> "
"Regular expression matching top level input prompt of Python shell.
It should not contain a caret (^) at the beginning."
- :type 'string)
+ :type 'regexp)
(defcustom python-shell-prompt-block-regexp "\\.\\.\\.:? "
"Regular expression matching block input prompt of Python shell.
It should not contain a caret (^) at the beginning."
- :type 'string)
+ :type 'regexp)
(defcustom python-shell-prompt-output-regexp ""
"Regular expression matching output prompt of Python shell.
It should not contain a caret (^) at the beginning."
- :type 'string)
+ :type 'regexp)
(defcustom python-shell-prompt-pdb-regexp "[(<]*[Ii]?[Pp]db[>)]+ "
"Regular expression matching pdb input prompt of Python shell.
It should not contain a caret (^) at the beginning."
- :type 'string)
+ :type 'regexp)
(define-obsolete-variable-alias
'python-shell-enable-font-lock 'python-shell-font-lock-enable "25.1")
@@ -2111,7 +2111,7 @@ virtualenv."
"(" (group (1+ digit)) ")" (1+ (not (any "("))) "()")
1 2))
"`compilation-error-regexp-alist' for inferior Python."
- :type '(alist string)
+ :type '(alist regexp)
:group 'python)
(defmacro python-shell--add-to-path-with-priority (pathvar paths)
@@ -3785,7 +3785,7 @@ the top stack frame has been reached.
Filename is expected in the first parenthesized expression.
Line number is expected in the second parenthesized expression."
- :type 'string
+ :type 'regexp
:version "27.1"
:safe 'stringp)
diff --git a/lisp/progmodes/sql.el b/lisp/progmodes/sql.el
index 7a51739c5f3..069acdb1046 100644
--- a/lisp/progmodes/sql.el
+++ b/lisp/progmodes/sql.el
@@ -905,7 +905,7 @@ it automatically."
(const :tag "Default Terminator" t)
(string :tag "Terminator String")
(cons :tag "Terminator Pattern and String"
- (string :tag "Terminator Pattern")
+ (regexp :tag "Terminator Pattern")
(string :tag "Terminator String")))
:version "22.2"
:group 'SQL)
@@ -1033,7 +1033,7 @@ All products share this list; products should define a regexp to
identify additional keywords in a variable defined by
the :statement feature."
:version "24.1"
- :type 'string
+ :type 'regexp
:group 'SQL)
;; Customization for Oracle
diff --git a/lisp/registry.el b/lisp/registry.el
index f65e60caa35..c0170cb50ec 100644
--- a/lisp/registry.el
+++ b/lisp/registry.el
@@ -317,7 +317,7 @@ Errors out if the key exists already."
(message "reindexing: %d of %d (%.2f%%)"
count expected (/ (* 100.0 count) expected)))
(dolist (val (cdr-safe (assq tr v)))
- (let* ((value-keys (registry-lookup-secondary-value db tr val)))
+ (let ((value-keys (registry-lookup-secondary-value db tr val)))
(push key value-keys)
(registry-lookup-secondary-value db tr val value-keys))))
(oref db data))))))
diff --git a/lisp/simple.el b/lisp/simple.el
index 6d5030073bb..6219986da0f 100644
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -1212,6 +1212,10 @@ that uses or sets the mark."
;; Counting lines, one way or another.
+(defvar goto-line-history nil
+ "History of values entered with `goto-line'.")
+(make-variable-buffer-local 'goto-line-history)
+
(defun goto-line (line &optional buffer)
"Go to LINE, counting from line 1 at beginning of buffer.
If called interactively, a numeric prefix argument specifies
@@ -1256,7 +1260,8 @@ rather than line counts."
"")))
;; Read the argument, offering that number (if any) as default.
(list (read-number (format "Goto line%s: " buffer-prompt)
- (list default (line-number-at-pos)))
+ (list default (line-number-at-pos))
+ 'goto-line-history)
buffer))))
;; Switch to the desired buffer, one way or another.
(if buffer
diff --git a/lisp/speedbar.el b/lisp/speedbar.el
index 961a1571c7b..fa443cbbccd 100644
--- a/lisp/speedbar.el
+++ b/lisp/speedbar.el
@@ -641,7 +641,7 @@ They should include commonly existing directories which are not
useful. It is no longer necessary to include version-control
directories here; see `vc-directory-exclusion-list'."
:group 'speedbar
- :type 'string)
+ :type 'regexp)
(defcustom speedbar-file-unshown-regexp
(let ((nstr "") (noext completion-ignored-extensions))
@@ -654,7 +654,7 @@ directories here; see `vc-directory-exclusion-list'."
"Regexp matching files we don't want displayed in a speedbar buffer.
It is generated from the variable `completion-ignored-extensions'."
:group 'speedbar
- :type 'string)
+ :type 'regexp)
(defvar speedbar-file-regexp nil
"Regular expression matching files we know how to expand.
diff --git a/lisp/subr.el b/lisp/subr.el
index ed55853bb27..f5b7c98f50d 100644
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -2518,10 +2518,15 @@ by doing (clear-string STRING)."
;; And of course, don't keep the sensitive data around.
(erase-buffer))))))))
-(defun read-number (prompt &optional default)
+(defvar read-number-history nil
+ "The default history for the `read-number' function.")
+
+(defun read-number (prompt &optional default hist)
"Read a numeric value in the minibuffer, prompting with PROMPT.
DEFAULT specifies a default value to return if the user just types RET.
The value of DEFAULT is inserted into PROMPT.
+HIST specifies a history list variable. See `read-from-minibuffer'
+for details of the HIST argument.
This function is used by the `interactive' code letter `n'."
(let ((n nil)
(default1 (if (consp default) (car default) default)))
@@ -2535,7 +2540,7 @@ This function is used by the `interactive' code letter `n'."
(while
(progn
(let ((str (read-from-minibuffer
- prompt nil nil nil nil
+ prompt nil nil nil (or hist 'read-number-history)
(when default
(if (consp default)
(mapcar 'number-to-string (delq nil default))
diff --git a/lisp/textmodes/flyspell.el b/lisp/textmodes/flyspell.el
index ce788207cf5..e8d47d4b76f 100644
--- a/lisp/textmodes/flyspell.el
+++ b/lisp/textmodes/flyspell.el
@@ -89,7 +89,7 @@ EXCEPTION-LIST is a list of strings. The checked word is
downcased before comparing with these exceptions."
:group 'flyspell
:type '(alist :key-type (choice (const :tag "All dictionaries" nil)
- string)
+ regexp)
:value-type (repeat string))
:version "24.1")
@@ -234,7 +234,7 @@ Ispell's ultimate default dictionary."
"A string that is the regular expression that matches TeX commands."
:group 'flyspell
:version "21.1"
- :type 'string)
+ :type 'regexp)
(defcustom flyspell-check-tex-math-command nil
"Non-nil means check even inside TeX math environment.
diff --git a/lisp/textmodes/paragraphs.el b/lisp/textmodes/paragraphs.el
index 3762010985f..6b82bdb5f96 100644
--- a/lisp/textmodes/paragraphs.el
+++ b/lisp/textmodes/paragraphs.el
@@ -168,7 +168,7 @@ to obtain the value of this variable."
(defcustom sentence-end-base "[.?!…‽][]\"'”’)}»›]*"
"Regexp matching the basic end of a sentence, not including following space."
:group 'paragraphs
- :type 'string
+ :type 'regexp
:version "25.1")
(put 'sentence-end-base 'safe-local-variable 'stringp)
diff --git a/lisp/textmodes/tildify.el b/lisp/textmodes/tildify.el
index ccbc2b086c6..55742ba80be 100644
--- a/lisp/textmodes/tildify.el
+++ b/lisp/textmodes/tildify.el
@@ -67,7 +67,7 @@ matching the white space). The pattern is matched case-sensitive regardless of
the value of `case-fold-search' setting."
:version "25.1"
:group 'tildify
- :type 'string
+ :type 'regexp
:safe t)
(defcustom tildify-pattern-alist ()
@@ -417,7 +417,7 @@ of a space at point. The regexp is always case sensitive, regardless of the
current `case-fold-search' setting."
:version "25.1"
:group 'tildify
- :type 'string)
+ :type 'regexp)
(defcustom tildify-space-predicates '(tildify-space-region-predicate)
"A list of predicate functions for `tildify-space' function."
diff --git a/lisp/vc/ediff-init.el b/lisp/vc/ediff-init.el
index a9cbf40c5e3..d30ba1a1cdf 100644
--- a/lisp/vc/ediff-init.el
+++ b/lisp/vc/ediff-init.el
@@ -1282,7 +1282,7 @@ Do not start with `~/' or `~USERNAME/'."
(defcustom ediff-metachars "[ \t\n!\"#$&'()*;<=>?[\\^`{|~]"
"Regexp that matches characters that must be quoted with `\\' in shell command line.
This default should work without changes."
- :type 'string
+ :type 'regexp
:group 'ediff)
;; needed to simulate frame-char-width in XEmacs.
diff --git a/lisp/vc/vc-git.el b/lisp/vc/vc-git.el
index cdb50db0d03..c39ee64fca7 100644
--- a/lisp/vc/vc-git.el
+++ b/lisp/vc/vc-git.el
@@ -166,7 +166,7 @@ format string (which is passed to \"git log\" via the argument
\"--pretty=tformat:FORMAT\"), REGEXP is a regular expression
matching the resulting Git log output, and KEYWORDS is a list of
`font-lock-keywords' for highlighting the Log View buffer."
- :type '(list string string (repeat sexp))
+ :type '(list string regexp (repeat sexp))
:version "24.1")
(defcustom vc-git-commits-coding-system 'utf-8
diff --git a/lisp/vc/vc-hg.el b/lisp/vc/vc-hg.el
index f264ba2c9af..205303761a5 100644
--- a/lisp/vc/vc-hg.el
+++ b/lisp/vc/vc-hg.el
@@ -182,7 +182,7 @@ is the \"--template\" argument string to pass to Mercurial,
REGEXP is a regular expression matching the resulting Mercurial
output, and KEYWORDS is a list of `font-lock-keywords' for
highlighting the Log View buffer."
- :type '(list string string (repeat sexp))
+ :type '(list string regexp (repeat sexp))
:group 'vc-hg
:version "24.5")
diff --git a/lisp/whitespace.el b/lisp/whitespace.el
index 243e7502461..ed81514629d 100644
--- a/lisp/whitespace.el
+++ b/lisp/whitespace.el
@@ -716,8 +716,8 @@ and the cons cdr is used for TABs visualization.
Used when `whitespace-style' includes `indentation',
`indentation::tab' or `indentation::space'."
- :type '(cons (string :tag "Indentation SPACEs")
- (string :tag "Indentation TABs"))
+ :type '(cons (regexp :tag "Indentation SPACEs")
+ (regexp :tag "Indentation TABs"))
:group 'whitespace)
@@ -747,8 +747,8 @@ and the cons cdr is used for TABs visualization.
Used when `whitespace-style' includes `space-after-tab',
`space-after-tab::tab' or `space-after-tab::space'."
- :type '(cons (string :tag "SPACEs After TAB")
- string)
+ :type '(cons (regexp :tag "SPACEs After TAB")
+ regexp)
:group 'whitespace)
(defcustom whitespace-big-indent-regexp
diff --git a/lisp/woman.el b/lisp/woman.el
index 39d9b806d27..27ccf9d99b5 100644
--- a/lisp/woman.el
+++ b/lisp/woman.el
@@ -674,7 +674,7 @@ These normally have names of the form `man?'. Its default value is
\"[Mm][Aa][Nn]\", which is case-insensitive mainly for the benefit of
Microsoft platforms. Its purpose is to avoid `cat?', `.', `..', etc."
;; Based on a suggestion by Wei-Xue Shi.
- :type 'string
+ :type 'regexp
:group 'woman-interface)
(defcustom woman-path
@@ -753,7 +753,7 @@ Default is t."
An alist with elements of the form (MENU-TITLE REGEXP INDEX) --
see the documentation for `imenu-generic-expression'."
:type '(alist :key-type (choice :tag "Title" (const nil) string)
- :value-type (group (choice (string :tag "Regexp")
+ :value-type (group (choice (regexp :tag "Regexp")
function)
integer))
:group 'woman-interface)
diff --git a/msdos/sed2v2.inp b/msdos/sed2v2.inp
index eebf1679472..f69b8bc8db3 100644
--- a/msdos/sed2v2.inp
+++ b/msdos/sed2v2.inp
@@ -66,7 +66,7 @@
/^#undef PACKAGE_NAME/s/^.*$/#define PACKAGE_NAME ""/
/^#undef PACKAGE_STRING/s/^.*$/#define PACKAGE_STRING ""/
/^#undef PACKAGE_TARNAME/s/^.*$/#define PACKAGE_TARNAME ""/
-/^#undef PACKAGE_VERSION/s/^.*$/#define PACKAGE_VERSION "27.0.60"/
+/^#undef PACKAGE_VERSION/s/^.*$/#define PACKAGE_VERSION "28.0.50"/
/^#undef SYSTEM_TYPE/s/^.*$/#define SYSTEM_TYPE "ms-dos"/
/^#undef HAVE_DECL_GETENV/s/^.*$/#define HAVE_DECL_GETENV 1/
/^#undef SYS_SIGLIST_DECLARED/s/^.*$/#define SYS_SIGLIST_DECLARED 1/
diff --git a/nt/README.W32 b/nt/README.W32
index 196122ecf71..64dc4c9e68b 100644
--- a/nt/README.W32
+++ b/nt/README.W32
@@ -1,7 +1,7 @@
Copyright (C) 2001-2019 Free Software Foundation, Inc.
See the end of the file for license conditions.
- Emacs version 27.0.60 for MS-Windows
+ Emacs version 28.0.50 for MS-Windows
This README file describes how to set up and run a precompiled
distribution of the latest version of GNU Emacs for MS-Windows. You
diff --git a/src/emacs-module.c b/src/emacs-module.c
index f2e3f627756..76229137d87 100644
--- a/src/emacs-module.c
+++ b/src/emacs-module.c
@@ -122,12 +122,6 @@ To add a new module function, proceed as follows:
/* Function prototype for the module init function. */
typedef int (*emacs_init_function) (struct emacs_runtime *);
-/* Function prototype for module user-pointer finalizers. These
- should not throw C++ exceptions, so emacs-module.h declares the
- corresponding interfaces with EMACS_NOEXCEPT. There is only C code
- in this module, though, so this constraint is not enforced here. */
-typedef void (*emacs_finalizer_function) (void *);
-
/* Memory management. */
@@ -343,11 +337,11 @@ CHECK_USER_PTR (Lisp_Object obj)
the Emacs main thread. */
static emacs_env *
-module_get_environment (struct emacs_runtime *ert)
+module_get_environment (struct emacs_runtime *runtime)
{
module_assert_thread ();
- module_assert_runtime (ert);
- return ert->private_members->env;
+ module_assert_runtime (runtime);
+ return runtime->private_members->env;
}
/* To make global refs (GC-protected global values) keep a hash that
@@ -356,11 +350,11 @@ module_get_environment (struct emacs_runtime *ert)
static Lisp_Object Vmodule_refs_hash;
static emacs_value
-module_make_global_ref (emacs_env *env, emacs_value ref)
+module_make_global_ref (emacs_env *env, emacs_value value)
{
MODULE_FUNCTION_BEGIN (NULL);
struct Lisp_Hash_Table *h = XHASH_TABLE (Vmodule_refs_hash);
- Lisp_Object new_obj = value_to_lisp (ref), hashcode;
+ Lisp_Object new_obj = value_to_lisp (value), hashcode;
ptrdiff_t i = hash_lookup (h, new_obj, &hashcode);
if (i >= 0)
@@ -381,14 +375,14 @@ module_make_global_ref (emacs_env *env, emacs_value ref)
}
static void
-module_free_global_ref (emacs_env *env, emacs_value ref)
+module_free_global_ref (emacs_env *env, emacs_value global_value)
{
/* TODO: This probably never signals. */
/* FIXME: Wait a minute. Shouldn't this function report an error if
the hash lookup fails? */
MODULE_FUNCTION_BEGIN ();
struct Lisp_Hash_Table *h = XHASH_TABLE (Vmodule_refs_hash);
- Lisp_Object obj = value_to_lisp (ref);
+ Lisp_Object obj = value_to_lisp (global_value);
ptrdiff_t i = hash_lookup (h, obj, NULL);
if (i >= 0)
@@ -406,7 +400,7 @@ module_free_global_ref (emacs_env *env, emacs_value ref)
if (module_assertions)
{
ptrdiff_t count = 0;
- if (value_storage_contains_p (&global_storage, ref, &count))
+ if (value_storage_contains_p (&global_storage, global_value, &count))
return;
module_abort ("Global value was not found in list of %"pD"d globals",
count);
@@ -430,14 +424,15 @@ module_non_local_exit_clear (emacs_env *env)
}
static enum emacs_funcall_exit
-module_non_local_exit_get (emacs_env *env, emacs_value *sym, emacs_value *data)
+module_non_local_exit_get (emacs_env *env,
+ emacs_value *symbol, emacs_value *data)
{
module_assert_thread ();
module_assert_env (env);
struct emacs_env_private *p = env->private_members;
if (p->pending_non_local_exit != emacs_funcall_exit_return)
{
- *sym = &p->non_local_exit_symbol;
+ *symbol = &p->non_local_exit_symbol;
*data = &p->non_local_exit_data;
}
return p->pending_non_local_exit;
@@ -445,12 +440,13 @@ module_non_local_exit_get (emacs_env *env, emacs_value *sym, emacs_value *data)
/* Like for `signal', DATA must be a list. */
static void
-module_non_local_exit_signal (emacs_env *env, emacs_value sym, emacs_value data)
+module_non_local_exit_signal (emacs_env *env,
+ emacs_value symbol, emacs_value data)
{
module_assert_thread ();
module_assert_env (env);
if (module_non_local_exit_check (env) == emacs_funcall_exit_return)
- module_non_local_exit_signal_1 (env, value_to_lisp (sym),
+ module_non_local_exit_signal_1 (env, value_to_lisp (symbol),
value_to_lisp (data));
}
@@ -464,10 +460,6 @@ module_non_local_exit_throw (emacs_env *env, emacs_value tag, emacs_value value)
value_to_lisp (value));
}
-/* Function prototype for the module Lisp functions. */
-typedef emacs_value (*emacs_subr) (emacs_env *, ptrdiff_t,
- emacs_value [], void *);
-
/* Module function. */
/* A function environment is an auxiliary structure returned by
@@ -484,7 +476,7 @@ struct Lisp_Module_Function
/* Fields ignored by GC. */
ptrdiff_t min_arity, max_arity;
- emacs_subr subr;
+ emacs_function subr;
void *data;
} GCALIGNED_STRUCT;
@@ -503,8 +495,7 @@ allocate_module_function (void)
static emacs_value
module_make_function (emacs_env *env, ptrdiff_t min_arity, ptrdiff_t max_arity,
- emacs_subr subr, const char *documentation,
- void *data)
+ emacs_function func, const char *docstring, void *data)
{
MODULE_FUNCTION_BEGIN (NULL);
@@ -518,11 +509,11 @@ module_make_function (emacs_env *env, ptrdiff_t min_arity, ptrdiff_t max_arity,
struct Lisp_Module_Function *function = allocate_module_function ();
function->min_arity = min_arity;
function->max_arity = max_arity;
- function->subr = subr;
+ function->subr = func;
function->data = data;
- if (documentation)
- function->documentation = build_string_from_utf8 (documentation);
+ if (docstring)
+ function->documentation = build_string_from_utf8 (docstring);
Lisp_Object result;
XSET_MODULE_FUNCTION (result, function);
@@ -532,8 +523,8 @@ module_make_function (emacs_env *env, ptrdiff_t min_arity, ptrdiff_t max_arity,
}
static emacs_value
-module_funcall (emacs_env *env, emacs_value fun, ptrdiff_t nargs,
- emacs_value args[])
+module_funcall (emacs_env *env, emacs_value func, ptrdiff_t nargs,
+ emacs_value *args)
{
MODULE_FUNCTION_BEGIN (NULL);
@@ -545,7 +536,7 @@ module_funcall (emacs_env *env, emacs_value fun, ptrdiff_t nargs,
if (INT_ADD_WRAPV (nargs, 1, &nargs1))
overflow_error ();
SAFE_ALLOCA_LISP (newargs, nargs1);
- newargs[0] = value_to_lisp (fun);
+ newargs[0] = value_to_lisp (func);
for (ptrdiff_t i = 0; i < nargs; i++)
newargs[1 + i] = value_to_lisp (args[i]);
emacs_value result = lisp_to_value (env, Ffuncall (nargs1, newargs));
@@ -561,17 +552,17 @@ module_intern (emacs_env *env, const char *name)
}
static emacs_value
-module_type_of (emacs_env *env, emacs_value value)
+module_type_of (emacs_env *env, emacs_value arg)
{
MODULE_FUNCTION_BEGIN (NULL);
- return lisp_to_value (env, Ftype_of (value_to_lisp (value)));
+ return lisp_to_value (env, Ftype_of (value_to_lisp (arg)));
}
static bool
-module_is_not_nil (emacs_env *env, emacs_value value)
+module_is_not_nil (emacs_env *env, emacs_value arg)
{
MODULE_FUNCTION_BEGIN_NO_CATCH (false);
- return ! NILP (value_to_lisp (value));
+ return ! NILP (value_to_lisp (arg));
}
static bool
@@ -582,14 +573,14 @@ module_eq (emacs_env *env, emacs_value a, emacs_value b)
}
static intmax_t
-module_extract_integer (emacs_env *env, emacs_value n)
+module_extract_integer (emacs_env *env, emacs_value arg)
{
MODULE_FUNCTION_BEGIN (0);
- Lisp_Object l = value_to_lisp (n);
- CHECK_INTEGER (l);
+ Lisp_Object lisp = value_to_lisp (arg);
+ CHECK_INTEGER (lisp);
intmax_t i;
- if (! integer_to_intmax (l, &i))
- xsignal1 (Qoverflow_error, l);
+ if (! integer_to_intmax (lisp, &i))
+ xsignal1 (Qoverflow_error, lisp);
return i;
}
@@ -601,10 +592,10 @@ module_make_integer (emacs_env *env, intmax_t n)
}
static double
-module_extract_float (emacs_env *env, emacs_value f)
+module_extract_float (emacs_env *env, emacs_value arg)
{
MODULE_FUNCTION_BEGIN (0);
- Lisp_Object lisp = value_to_lisp (f);
+ Lisp_Object lisp = value_to_lisp (arg);
CHECK_TYPE (FLOATP (lisp), Qfloatp, lisp);
return XFLOAT_DATA (lisp);
}
@@ -617,8 +608,8 @@ module_make_float (emacs_env *env, double d)
}
static bool
-module_copy_string_contents (emacs_env *env, emacs_value value, char *buffer,
- ptrdiff_t *length)
+module_copy_string_contents (emacs_env *env, emacs_value value, char *buf,
+ ptrdiff_t *len)
{
MODULE_FUNCTION_BEGIN (false);
Lisp_Object lisp_str = value_to_lisp (value);
@@ -642,77 +633,77 @@ module_copy_string_contents (emacs_env *env, emacs_value value, char *buffer,
ptrdiff_t raw_size = SBYTES (lisp_str_utf8);
ptrdiff_t required_buf_size = raw_size + 1;
- if (buffer == NULL)
+ if (buf == NULL)
{
- *length = required_buf_size;
+ *len = required_buf_size;
return true;
}
- if (*length < required_buf_size)
+ if (*len < required_buf_size)
{
- ptrdiff_t actual = *length;
- *length = required_buf_size;
+ ptrdiff_t actual = *len;
+ *len = required_buf_size;
args_out_of_range_3 (INT_TO_INTEGER (actual),
INT_TO_INTEGER (required_buf_size),
INT_TO_INTEGER (PTRDIFF_MAX));
}
- *length = required_buf_size;
- memcpy (buffer, SDATA (lisp_str_utf8), raw_size + 1);
+ *len = required_buf_size;
+ memcpy (buf, SDATA (lisp_str_utf8), raw_size + 1);
return true;
}
static emacs_value
-module_make_string (emacs_env *env, const char *str, ptrdiff_t length)
+module_make_string (emacs_env *env, const char *str, ptrdiff_t len)
{
MODULE_FUNCTION_BEGIN (NULL);
- if (! (0 <= length && length <= STRING_BYTES_BOUND))
+ if (! (0 <= len && len <= STRING_BYTES_BOUND))
overflow_error ();
- Lisp_Object lstr = make_string_from_utf8 (str, length);
+ Lisp_Object lstr = make_string_from_utf8 (str, len);
return lisp_to_value (env, lstr);
}
static emacs_value
-module_make_user_ptr (emacs_env *env, emacs_finalizer_function fin, void *ptr)
+module_make_user_ptr (emacs_env *env, emacs_finalizer fin, void *ptr)
{
MODULE_FUNCTION_BEGIN (NULL);
return lisp_to_value (env, make_user_ptr (fin, ptr));
}
static void *
-module_get_user_ptr (emacs_env *env, emacs_value uptr)
+module_get_user_ptr (emacs_env *env, emacs_value arg)
{
MODULE_FUNCTION_BEGIN (NULL);
- Lisp_Object lisp = value_to_lisp (uptr);
+ Lisp_Object lisp = value_to_lisp (arg);
CHECK_USER_PTR (lisp);
return XUSER_PTR (lisp)->p;
}
static void
-module_set_user_ptr (emacs_env *env, emacs_value uptr, void *ptr)
+module_set_user_ptr (emacs_env *env, emacs_value arg, void *ptr)
{
MODULE_FUNCTION_BEGIN ();
- Lisp_Object lisp = value_to_lisp (uptr);
+ Lisp_Object lisp = value_to_lisp (arg);
CHECK_USER_PTR (lisp);
XUSER_PTR (lisp)->p = ptr;
}
-static emacs_finalizer_function
-module_get_user_finalizer (emacs_env *env, emacs_value uptr)
+static emacs_finalizer
+module_get_user_finalizer (emacs_env *env, emacs_value arg)
{
MODULE_FUNCTION_BEGIN (NULL);
- Lisp_Object lisp = value_to_lisp (uptr);
+ Lisp_Object lisp = value_to_lisp (arg);
CHECK_USER_PTR (lisp);
return XUSER_PTR (lisp)->finalizer;
}
static void
-module_set_user_finalizer (emacs_env *env, emacs_value uptr,
- emacs_finalizer_function fin)
+module_set_user_finalizer (emacs_env *env, emacs_value arg,
+ emacs_finalizer fin)
{
MODULE_FUNCTION_BEGIN ();
- Lisp_Object lisp = value_to_lisp (uptr);
+ Lisp_Object lisp = value_to_lisp (arg);
CHECK_USER_PTR (lisp);
XUSER_PTR (lisp)->finalizer = fin;
}
@@ -727,30 +718,31 @@ check_vec_index (Lisp_Object lvec, ptrdiff_t i)
}
static void
-module_vec_set (emacs_env *env, emacs_value vec, ptrdiff_t i, emacs_value val)
+module_vec_set (emacs_env *env, emacs_value vector, ptrdiff_t index,
+ emacs_value value)
{
MODULE_FUNCTION_BEGIN ();
- Lisp_Object lvec = value_to_lisp (vec);
- check_vec_index (lvec, i);
- ASET (lvec, i, value_to_lisp (val));
+ Lisp_Object lisp = value_to_lisp (vector);
+ check_vec_index (lisp, index);
+ ASET (lisp, index, value_to_lisp (value));
}
static emacs_value
-module_vec_get (emacs_env *env, emacs_value vec, ptrdiff_t i)
+module_vec_get (emacs_env *env, emacs_value vector, ptrdiff_t index)
{
MODULE_FUNCTION_BEGIN (NULL);
- Lisp_Object lvec = value_to_lisp (vec);
- check_vec_index (lvec, i);
- return lisp_to_value (env, AREF (lvec, i));
+ Lisp_Object lisp = value_to_lisp (vector);
+ check_vec_index (lisp, index);
+ return lisp_to_value (env, AREF (lisp, index));
}
static ptrdiff_t
-module_vec_size (emacs_env *env, emacs_value vec)
+module_vec_size (emacs_env *env, emacs_value vector)
{
MODULE_FUNCTION_BEGIN (0);
- Lisp_Object lvec = value_to_lisp (vec);
- CHECK_VECTOR (lvec);
- return ASIZE (lvec);
+ Lisp_Object lisp = value_to_lisp (vector);
+ CHECK_VECTOR (lisp);
+ return ASIZE (lisp);
}
/* This function should return true if and only if maybe_quit would
@@ -771,10 +763,10 @@ module_process_input (emacs_env *env)
}
static struct timespec
-module_extract_time (emacs_env *env, emacs_value value)
+module_extract_time (emacs_env *env, emacs_value arg)
{
MODULE_FUNCTION_BEGIN ((struct timespec) {0});
- return lisp_time_argument (value_to_lisp (value));
+ return lisp_time_argument (value_to_lisp (arg));
}
static emacs_value
@@ -1088,14 +1080,14 @@ module_assert_thread (void)
}
static void
-module_assert_runtime (struct emacs_runtime *ert)
+module_assert_runtime (struct emacs_runtime *runtime)
{
if (! module_assertions)
return;
ptrdiff_t count = 0;
for (Lisp_Object tail = Vmodule_runtimes; CONSP (tail); tail = XCDR (tail))
{
- if (xmint_pointer (XCAR (tail)) == ert)
+ if (xmint_pointer (XCAR (tail)) == runtime)
return;
++count;
}
diff --git a/src/emacs-module.h.in b/src/emacs-module.h.in
index 5743d10ca43..fbeaebd7956 100644
--- a/src/emacs-module.h.in
+++ b/src/emacs-module.h.in
@@ -56,7 +56,7 @@ extern "C" {
#endif
/* Current environment. */
-typedef struct emacs_env_27 emacs_env;
+typedef struct emacs_env_@emacs_major_version@ emacs_env;
/* Opaque pointer representing an Emacs Lisp value.
BEWARE: Do not assume NULL is a valid value! */
@@ -74,10 +74,25 @@ struct emacs_runtime
struct emacs_runtime_private *private_members;
/* Return an environment pointer. */
- emacs_env *(*get_environment) (struct emacs_runtime *ert)
+ emacs_env *(*get_environment) (struct emacs_runtime *runtime)
EMACS_ATTRIBUTE_NONNULL(1);
};
+/* Type aliases for function pointer types used in the module API.
+ Note that we don't use these aliases directly in the API to be able
+ to mark the function arguments as 'noexcept' before C++20.
+ However, users can use them if they want. */
+
+/* Function prototype for the module Lisp functions. These must not
+ throw C++ exceptions. */
+typedef emacs_value (*emacs_function) (emacs_env *env, ptrdiff_t nargs,
+ emacs_value *args,
+ void *data)
+ EMACS_NOEXCEPT EMACS_ATTRIBUTE_NONNULL (1);
+
+/* Function prototype for module user-pointer finalizers. These must
+ not throw C++ exceptions. */
+typedef void (*emacs_finalizer) (void *data) EMACS_NOEXCEPT;
/* Possible Emacs function call outcomes. */
enum emacs_funcall_exit
@@ -131,8 +146,19 @@ struct emacs_env_27
@module_env_snippet_27@
};
+struct emacs_env_28
+{
+@module_env_snippet_25@
+
+@module_env_snippet_26@
+
+@module_env_snippet_27@
+
+@module_env_snippet_28@
+};
+
/* Every module should define a function as follows. */
-extern int emacs_module_init (struct emacs_runtime *ert)
+extern int emacs_module_init (struct emacs_runtime *runtime)
EMACS_NOEXCEPT
EMACS_ATTRIBUTE_NONNULL(1);
diff --git a/src/lread.c b/src/lread.c
index 7b3686b3d71..6329172f4b4 100644
--- a/src/lread.c
+++ b/src/lread.c
@@ -1199,6 +1199,9 @@ Return t if the file exists and loads successfully. */)
|| suffix_p (file, ".elc")
#ifdef HAVE_MODULES
|| suffix_p (file, MODULES_SUFFIX)
+#ifdef MODULES_SECONDARY_SUFFIX
+ || suffix_p (file, MODULES_SECONDARY_SUFFIX)
+#endif
#endif
)
must_suffix = Qnil;
@@ -1268,7 +1271,12 @@ Return t if the file exists and loads successfully. */)
}
#ifdef HAVE_MODULES
- bool is_module = suffix_p (found, MODULES_SUFFIX);
+ bool is_module =
+ suffix_p (found, MODULES_SUFFIX)
+#ifdef MODULES_SECONDARY_SUFFIX
+ || suffix_p (found, MODULES_SECONDARY_SUFFIX)
+#endif
+ ;
#else
bool is_module = false;
#endif
@@ -4856,9 +4864,16 @@ This list should not include the empty string.
`load' and related functions try to append these suffixes, in order,
to the specified file name if a suffix is allowed or required. */);
#ifdef HAVE_MODULES
+#ifdef MODULES_SECONDARY_SUFFIX
+ Vload_suffixes = list4 (build_pure_c_string (".elc"),
+ build_pure_c_string (".el"),
+ build_pure_c_string (MODULES_SUFFIX),
+ build_pure_c_string (MODULES_SECONDARY_SUFFIX));
+#else
Vload_suffixes = list3 (build_pure_c_string (".elc"),
build_pure_c_string (".el"),
build_pure_c_string (MODULES_SUFFIX));
+#endif
#else
Vload_suffixes = list2 (build_pure_c_string (".elc"),
build_pure_c_string (".el"));
diff --git a/src/macfont.m b/src/macfont.m
index 7170e801407..fa4a818efa6 100644
--- a/src/macfont.m
+++ b/src/macfont.m
@@ -1126,7 +1126,8 @@ struct macfont_metrics
};
#define METRICS_VALUE(metrics, member) \
- (((metrics)->member##_high << 8) | (metrics)->member##_low)
+ ((int) (((unsigned int) (metrics)->member##_high << 8) \
+ | (metrics)->member##_low))
#define METRICS_SET_VALUE(metrics, member, value) \
do {short tmp = (value); (metrics)->member##_low = tmp & 0xff; \
(metrics)->member##_high = tmp >> 8;} while (0)
diff --git a/src/minibuf.c b/src/minibuf.c
index f8790f55070..9badc8cdd36 100644
--- a/src/minibuf.c
+++ b/src/minibuf.c
@@ -414,12 +414,13 @@ read_minibuf (Lisp_Object map, Lisp_Object initial, Lisp_Object prompt,
if (!enable_recursive_minibuffers
&& minibuf_level > 0)
{
+ Lisp_Object str
+ = build_string ("Command attempted to use minibuffer while in minibuffer");
if (EQ (selected_window, minibuf_window))
- error ("Command attempted to use minibuffer while in minibuffer");
+ Fsignal (Quser_error, (list1 (str)));
else
/* If we're in another window, cancel the minibuffer that's active. */
- Fthrow (Qexit,
- build_string ("Command attempted to use minibuffer while in minibuffer"));
+ Fthrow (Qexit, str);
}
if ((noninteractive
diff --git a/src/module-env-25.h b/src/module-env-25.h
index d8f8eb68119..01ce65e9148 100644
--- a/src/module-env-25.h
+++ b/src/module-env-25.h
@@ -6,12 +6,10 @@
/* Memory management. */
- emacs_value (*make_global_ref) (emacs_env *env,
- emacs_value any_reference)
+ emacs_value (*make_global_ref) (emacs_env *env, emacs_value value)
EMACS_ATTRIBUTE_NONNULL(1);
- void (*free_global_ref) (emacs_env *env,
- emacs_value global_reference)
+ void (*free_global_ref) (emacs_env *env, emacs_value global_value)
EMACS_ATTRIBUTE_NONNULL(1);
/* Non-local exit handling. */
@@ -23,19 +21,15 @@
EMACS_ATTRIBUTE_NONNULL(1);
enum emacs_funcall_exit (*non_local_exit_get)
- (emacs_env *env,
- emacs_value *non_local_exit_symbol_out,
- emacs_value *non_local_exit_data_out)
+ (emacs_env *env, emacs_value *symbol, emacs_value *data)
EMACS_ATTRIBUTE_NONNULL(1, 2, 3);
void (*non_local_exit_signal) (emacs_env *env,
- emacs_value non_local_exit_symbol,
- emacs_value non_local_exit_data)
+ emacs_value symbol, emacs_value data)
EMACS_ATTRIBUTE_NONNULL(1);
void (*non_local_exit_throw) (emacs_env *env,
- emacs_value tag,
- emacs_value value)
+ emacs_value tag, emacs_value value)
EMACS_ATTRIBUTE_NONNULL(1);
/* Function registration. */
@@ -43,48 +37,46 @@
emacs_value (*make_function) (emacs_env *env,
ptrdiff_t min_arity,
ptrdiff_t max_arity,
- emacs_value (*function) (emacs_env *env,
- ptrdiff_t nargs,
- emacs_value args[],
- void *)
+ emacs_value (*func) (emacs_env *env,
+ ptrdiff_t nargs,
+ emacs_value* args,
+ void *data)
EMACS_NOEXCEPT
EMACS_ATTRIBUTE_NONNULL(1),
- const char *documentation,
+ const char *docstring,
void *data)
EMACS_ATTRIBUTE_NONNULL(1, 4);
emacs_value (*funcall) (emacs_env *env,
- emacs_value function,
+ emacs_value func,
ptrdiff_t nargs,
- emacs_value args[])
+ emacs_value* args)
EMACS_ATTRIBUTE_NONNULL(1);
- emacs_value (*intern) (emacs_env *env,
- const char *symbol_name)
+ emacs_value (*intern) (emacs_env *env, const char *name)
EMACS_ATTRIBUTE_NONNULL(1, 2);
/* Type conversion. */
- emacs_value (*type_of) (emacs_env *env,
- emacs_value value)
+ emacs_value (*type_of) (emacs_env *env, emacs_value arg)
EMACS_ATTRIBUTE_NONNULL(1);
- bool (*is_not_nil) (emacs_env *env, emacs_value value)
+ bool (*is_not_nil) (emacs_env *env, emacs_value arg)
EMACS_ATTRIBUTE_NONNULL(1);
bool (*eq) (emacs_env *env, emacs_value a, emacs_value b)
EMACS_ATTRIBUTE_NONNULL(1);
- intmax_t (*extract_integer) (emacs_env *env, emacs_value value)
+ intmax_t (*extract_integer) (emacs_env *env, emacs_value arg)
EMACS_ATTRIBUTE_NONNULL(1);
- emacs_value (*make_integer) (emacs_env *env, intmax_t value)
+ emacs_value (*make_integer) (emacs_env *env, intmax_t n)
EMACS_ATTRIBUTE_NONNULL(1);
- double (*extract_float) (emacs_env *env, emacs_value value)
+ double (*extract_float) (emacs_env *env, emacs_value arg)
EMACS_ATTRIBUTE_NONNULL(1);
- emacs_value (*make_float) (emacs_env *env, double value)
+ emacs_value (*make_float) (emacs_env *env, double d)
EMACS_ATTRIBUTE_NONNULL(1);
/* Copy the content of the Lisp string VALUE to BUFFER as an utf8
@@ -101,13 +93,13 @@
bool (*copy_string_contents) (emacs_env *env,
emacs_value value,
- char *buffer,
- ptrdiff_t *size_inout)
+ char *buf,
+ ptrdiff_t *len)
EMACS_ATTRIBUTE_NONNULL(1, 4);
/* Create a Lisp string from a utf8 encoded string. */
emacs_value (*make_string) (emacs_env *env,
- const char *contents, ptrdiff_t length)
+ const char *str, ptrdiff_t len)
EMACS_ATTRIBUTE_NONNULL(1, 2);
/* Embedded pointer type. */
@@ -116,25 +108,24 @@
void *ptr)
EMACS_ATTRIBUTE_NONNULL(1);
- void *(*get_user_ptr) (emacs_env *env, emacs_value uptr)
+ void *(*get_user_ptr) (emacs_env *env, emacs_value arg)
EMACS_ATTRIBUTE_NONNULL(1);
- void (*set_user_ptr) (emacs_env *env, emacs_value uptr, void *ptr)
+ void (*set_user_ptr) (emacs_env *env, emacs_value arg, void *ptr)
EMACS_ATTRIBUTE_NONNULL(1);
void (*(*get_user_finalizer) (emacs_env *env, emacs_value uptr))
(void *) EMACS_NOEXCEPT EMACS_ATTRIBUTE_NONNULL(1);
- void (*set_user_finalizer) (emacs_env *env,
- emacs_value uptr,
+ void (*set_user_finalizer) (emacs_env *env, emacs_value arg,
void (*fin) (void *) EMACS_NOEXCEPT)
EMACS_ATTRIBUTE_NONNULL(1);
/* Vector functions. */
- emacs_value (*vec_get) (emacs_env *env, emacs_value vec, ptrdiff_t i)
+ emacs_value (*vec_get) (emacs_env *env, emacs_value vector, ptrdiff_t index)
EMACS_ATTRIBUTE_NONNULL(1);
- void (*vec_set) (emacs_env *env, emacs_value vec, ptrdiff_t i,
- emacs_value val)
+ void (*vec_set) (emacs_env *env, emacs_value vector, ptrdiff_t index,
+ emacs_value value)
EMACS_ATTRIBUTE_NONNULL(1);
- ptrdiff_t (*vec_size) (emacs_env *env, emacs_value vec)
+ ptrdiff_t (*vec_size) (emacs_env *env, emacs_value vector)
EMACS_ATTRIBUTE_NONNULL(1);
diff --git a/src/module-env-27.h b/src/module-env-27.h
index 0fe2557d71b..9ef3c8b33bb 100644
--- a/src/module-env-27.h
+++ b/src/module-env-27.h
@@ -3,7 +3,7 @@
enum emacs_process_input_result (*process_input) (emacs_env *env)
EMACS_ATTRIBUTE_NONNULL (1);
- struct timespec (*extract_time) (emacs_env *env, emacs_value value)
+ struct timespec (*extract_time) (emacs_env *env, emacs_value arg)
EMACS_ATTRIBUTE_NONNULL (1);
emacs_value (*make_time) (emacs_env *env, struct timespec time)
diff --git a/src/module-env-28.h b/src/module-env-28.h
new file mode 100644
index 00000000000..dec8704edde
--- /dev/null
+++ b/src/module-env-28.h
@@ -0,0 +1,3 @@
+ /* Add module environment functions newly added in Emacs 28 here.
+ Before Emacs 28 is released, remove this comment and start
+ module-env-29.h on the master branch. */
diff --git a/src/msdos.c b/src/msdos.c
index 1192b37a0d4..d80e58bb713 100644
--- a/src/msdos.c
+++ b/src/msdos.c
@@ -1794,7 +1794,7 @@ internal_terminal_init (void)
}
Vinitial_window_system = Qpc;
- Vwindow_system_version = make_fixnum (27); /* RE Emacs version */
+ Vwindow_system_version = make_fixnum (28); /* RE Emacs version */
tty->terminal->type = output_msdos_raw;
/* If Emacs was dumped on DOS/V machine, forget the stale VRAM
diff --git a/src/nsfns.m b/src/nsfns.m
index 1d3aea038ae..3e835a71d03 100644
--- a/src/nsfns.m
+++ b/src/nsfns.m
@@ -255,7 +255,10 @@ ns_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
[col getRed: &r green: &g blue: &b alpha: &alpha];
FRAME_FOREGROUND_PIXEL (f) =
- ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
+ ARGB_TO_ULONG ((unsigned long) (alpha * 0xff),
+ (unsigned long) (r * 0xff),
+ (unsigned long) (g * 0xff),
+ (unsigned long) (b * 0xff));
if (FRAME_NS_VIEW (f))
{
@@ -296,7 +299,10 @@ ns_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
[col getRed: &r green: &g blue: &b alpha: &alpha];
FRAME_BACKGROUND_PIXEL (f) =
- ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
+ ARGB_TO_ULONG ((unsigned long) (alpha * 0xff),
+ (unsigned long) (r * 0xff),
+ (unsigned long) (g * 0xff),
+ (unsigned long) (b * 0xff));
if (view != nil)
{
diff --git a/src/nsimage.m b/src/nsimage.m
index 25d3b2299cb..6ca6ee86d66 100644
--- a/src/nsimage.m
+++ b/src/nsimage.m
@@ -407,9 +407,10 @@ ns_set_alpha (void *img, int x, int y, unsigned char a)
if (pixmapData[0] != NULL)
{
int loc = x + y * [self size].width;
- return (pixmapData[3][loc] << 24) /* alpha */
- | (pixmapData[0][loc] << 16) | (pixmapData[1][loc] << 8)
- | (pixmapData[2][loc]);
+ return (((unsigned long) pixmapData[3][loc] << 24) /* alpha */
+ | ((unsigned long) pixmapData[0][loc] << 16)
+ | ((unsigned long) pixmapData[1][loc] << 8)
+ | (unsigned long) pixmapData[2][loc]);
}
else
{
diff --git a/src/nsterm.m b/src/nsterm.m
index fbec816cccd..ab571e4a1a7 100644
--- a/src/nsterm.m
+++ b/src/nsterm.m
@@ -2301,8 +2301,10 @@ ns_color_index_to_rgba(int idx, struct frame *f)
EmacsCGFloat r, g, b, a;
[col getRed: &r green: &g blue: &b alpha: &a];
- return ARGB_TO_ULONG((int)(a*255),
- (int)(r*255), (int)(g*255), (int)(b*255));
+ return ARGB_TO_ULONG((unsigned long) (a * 255),
+ (unsigned long) (r * 255),
+ (unsigned long) (g * 255),
+ (unsigned long) (b * 255));
}
void
@@ -2322,8 +2324,10 @@ ns_query_color(void *col, Emacs_Color *color_def, bool setPixel)
if (setPixel == YES)
color_def->pixel
- = ARGB_TO_ULONG((int)(a*255),
- (int)(r*255), (int)(g*255), (int)(b*255));
+ = ARGB_TO_ULONG((unsigned long) (a * 255),
+ (unsigned long) (r * 255),
+ (unsigned long) (g * 255),
+ (unsigned long) (b * 255));
}
bool
diff --git a/test/lisp/time-stamp-tests.el b/test/lisp/time-stamp-tests.el
index fb2780af2de..5326d26e1df 100644
--- a/test/lisp/time-stamp-tests.el
+++ b/test/lisp/time-stamp-tests.el
@@ -38,9 +38,7 @@
(cl-letf (((symbol-function 'time-stamp-conv-warn)
(lambda (old-format _new)
(ert-fail
- (format "Unexpected format warning for '%s'" old-format))))
- ((symbol-function 'system-name)
- (lambda () "test-system-name.example.org")))
+ (format "Unexpected format warning for '%s'" old-format)))))
;; Not all reference times are used in all tests;
;; suppress the byte compiler's "unused" warning.
(list ref-time1 ref-time2 ref-time3)
@@ -56,6 +54,13 @@
(apply orig-time-stamp-string-fn ts-format ,reference-time nil))))
,@body))
+(defmacro with-time-stamp-system-name (name &rest body)
+ "Force (system-name) to return NAME while evaluating BODY."
+ (declare (indent defun))
+ `(cl-letf (((symbol-function 'system-name)
+ (lambda () ,name)))
+ ,@body))
+
(defmacro time-stamp-should-warn (form)
"Similar to `should' but verifies that a format warning is generated."
`(let ((warning-count 0))
@@ -170,6 +175,20 @@
;; triggering the tests above.
(time-stamp)))))))
+(ert-deftest time-stamp-custom-format-tabs-expand ()
+ "Test that Tab characters expand in the format but not elsewhere."
+ (with-time-stamp-test-env
+ (let ((time-stamp-start "Updated in: <\t")
+ ;; Tabs in the format should expand
+ (time-stamp-format "\t%Y\t")
+ (time-stamp-end "\t>"))
+ (with-time-stamp-test-time ref-time1
+ (with-temp-buffer
+ (insert "Updated in: <\t\t>")
+ (time-stamp)
+ (should (equal (buffer-string)
+ "Updated in: <\t 2006 \t>")))))))
+
(ert-deftest time-stamp-custom-inserts-lines ()
"Test that time-stamp inserts lines or not, as directed."
(with-time-stamp-test-env
@@ -194,19 +213,46 @@
(time-stamp)
(should (equal (buffer-string) buffer-expected-2line)))))))
+(ert-deftest time-stamp-custom-end ()
+ "Test that time-stamp finds the end pattern on the correct line."
+ (with-time-stamp-test-env
+ (let ((time-stamp-start "Updated on: <")
+ (time-stamp-format "%Y-%m-%d")
+ (time-stamp-end ">") ;changed later in the test
+ (buffer-original-contents "Updated on: <\n>\n")
+ (buffer-expected-time-stamped "Updated on: <2006-01-02\n>\n"))
+ (with-time-stamp-test-time ref-time1
+ (with-temp-buffer
+ (insert buffer-original-contents)
+ ;; time-stamp-end is not on same line, should not be seen
+ (time-stamp)
+ (should (equal (buffer-string) buffer-original-contents))
+
+ ;; add a newline to time-stamp-end, so it starts on same line
+ (setq time-stamp-end "\n>")
+ (time-stamp)
+ (should (equal (buffer-string) buffer-expected-time-stamped)))))))
+
(ert-deftest time-stamp-custom-count ()
"Test that time-stamp updates no more than time-stamp-count templates."
(with-time-stamp-test-env
(let ((time-stamp-start "TS: <")
(time-stamp-format "%Y-%m-%d")
- (time-stamp-count 1) ;changed later in the test
+ (time-stamp-count 0) ;changed later in the test
(buffer-expected-once "TS: <2006-01-02>\nTS: <>")
(buffer-expected-twice "TS: <2006-01-02>\nTS: <2006-01-02>"))
(with-time-stamp-test-time ref-time1
(with-temp-buffer
(insert "TS: <>\nTS: <>")
(time-stamp)
+ ;; even with count = 0, expect one time stamp
+ (should (equal (buffer-string) buffer-expected-once)))
+ (with-temp-buffer
+ (setq time-stamp-count 1)
+ (insert "TS: <>\nTS: <>")
+ (time-stamp)
(should (equal (buffer-string) buffer-expected-once))
+
(setq time-stamp-count 2)
(time-stamp)
(should (equal (buffer-string) buffer-expected-twice)))))))
@@ -488,26 +534,35 @@
(ert-deftest time-stamp-format-non-date-conversions ()
"Test time-stamp formats for non-date items."
(with-time-stamp-test-env
- ;; implemented and documented since 1995
- (should (equal (time-stamp-string "%%" ref-time1) "%")) ;% last char
- (should (equal (time-stamp-string "%%P" ref-time1) "%P")) ;% not last char
- (should (equal (time-stamp-string "%f" ref-time1) "time-stamped-file"))
- (should
- (equal (time-stamp-string "%F" ref-time1) "/emacs/test/time-stamped-file"))
- (should (equal (time-stamp-string "%h" ref-time1) "test-mail-host-name"))
- ;; documented 1995-2019
- (should (equal
- (time-stamp-string "%s" ref-time1) "test-system-name.example.org"))
- (should (equal (time-stamp-string "%U" ref-time1) "100%d Tester"))
- (should (equal (time-stamp-string "%u" ref-time1) "test-logname"))
- ;; implemented since 2001, documented since 2019
- (should (equal (time-stamp-string "%L" ref-time1) "100%d Tester"))
- (should (equal (time-stamp-string "%l" ref-time1) "test-logname"))
- ;; implemented since 2007, documented since 2019
- (should (equal
- (time-stamp-string "%Q" ref-time1) "test-system-name.example.org"))
- (should (equal
- (time-stamp-string "%q" ref-time1) "test-system-name"))))
+ (with-time-stamp-system-name "test-system-name.example.org"
+ ;; implemented and documented since 1995
+ (should (equal (time-stamp-string "%%" ref-time1) "%")) ;% last char
+ (should (equal (time-stamp-string "%%P" ref-time1) "%P")) ;% not last char
+ (should (equal (time-stamp-string "%f" ref-time1) "time-stamped-file"))
+ (should (equal (time-stamp-string "%F" ref-time1)
+ "/emacs/test/time-stamped-file"))
+ (with-temp-buffer
+ (should (equal (time-stamp-string "%f" ref-time1) "(no file)"))
+ (should (equal (time-stamp-string "%F" ref-time1) "(no file)")))
+ (should (equal (time-stamp-string "%h" ref-time1) "test-mail-host-name"))
+ (let ((mail-host-address nil))
+ (should (equal (time-stamp-string "%h" ref-time1)
+ "test-system-name.example.org")))
+ ;; documented 1995-2019
+ (should (equal (time-stamp-string "%s" ref-time1)
+ "test-system-name.example.org"))
+ (should (equal (time-stamp-string "%U" ref-time1) "100%d Tester"))
+ (should (equal (time-stamp-string "%u" ref-time1) "test-logname"))
+ ;; implemented since 2001, documented since 2019
+ (should (equal (time-stamp-string "%L" ref-time1) "100%d Tester"))
+ (should (equal (time-stamp-string "%l" ref-time1) "test-logname"))
+ ;; implemented since 2007, documented since 2019
+ (should (equal (time-stamp-string "%Q" ref-time1)
+ "test-system-name.example.org"))
+ (should (equal (time-stamp-string "%q" ref-time1) "test-system-name")))
+ (with-time-stamp-system-name "sysname-no-dots"
+ (should (equal (time-stamp-string "%Q" ref-time1) "sysname-no-dots"))
+ (should (equal (time-stamp-string "%q" ref-time1) "sysname-no-dots")))))
(ert-deftest time-stamp-format-ignored-modifiers ()
"Test additional args allowed (but ignored) to allow for future expansion."
@@ -538,6 +593,13 @@
;;; Tests of helper functions
+(ert-deftest time-stamp-helper-string-defaults ()
+ "Test that time-stamp-string defaults its format to time-stamp-format."
+ (with-time-stamp-test-env
+ (should (equal (time-stamp-string nil ref-time1)
+ (time-stamp-string time-stamp-format ref-time1)))
+ (should (equal (time-stamp-string 'not-a-string ref-time1) nil))))
+
(ert-deftest time-stamp-helper-zone-type-p ()
"Test time-stamp-zone-type-p."
(should (time-stamp-zone-type-p t))
diff --git a/test/src/emacs-module-tests.el b/test/src/emacs-module-tests.el
index 18766081c0a..322500ff604 100644
--- a/test/src/emacs-module-tests.el
+++ b/test/src/emacs-module-tests.el
@@ -384,4 +384,22 @@ Interactively, you can try hitting \\[keyboard-quit] to quit."
(ert-info ((format "input: %d" input))
(should (= (mod-test-double input) (* 2 input))))))
+(ert-deftest module-darwin-secondary-suffix ()
+ "Check that on Darwin, both .so and .dylib suffixes work.
+See Bug#36226."
+ (skip-unless (eq system-type 'darwin))
+ (should (member ".dylib" load-suffixes))
+ (should (member ".so" load-suffixes))
+ ;; Preserve the old `load-history'. This is needed for some of the
+ ;; other unit tests that indirectly rely on `load-history'.
+ (let ((load-history load-history)
+ (dylib (concat mod-test-file ".dylib"))
+ (so (concat mod-test-file ".so")))
+ (should (file-regular-p dylib))
+ (should-not (file-exists-p so))
+ (add-name-to-file dylib so)
+ (unwind-protect
+ (load so nil nil :nosuffix :must-suffix)
+ (delete-file so))))
+
;;; emacs-module-tests.el ends here