diff options
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 @@ -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. @@ -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 |