From 6bedbafc7ad60a9c75bf6f7ee9171408dcc3911f Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Mon, 22 Sep 2025 08:33:01 +0300 Subject: [PATCH 1/4] ; * doc/lispref/text.texi (Suspicious Text): Indexing fix. --- doc/lispref/text.texi | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi index dc35e93f2da..ec30efe67a3 100644 --- a/doc/lispref/text.texi +++ b/doc/lispref/text.texi @@ -5090,6 +5090,7 @@ having an @acronym{HTML} link text that says one thing, while the underlying @acronym{URL} points somewhere else. @cindex suspicious text strings +@cindex confusable characters To help identify these @dfn{suspicious text strings}, Emacs provides a library to do a number of checks on text. (See @url{https://www.unicode.org/reports/tr39/, UTS #39: Unicode Security From 307f465f7b9042c60b721b16f06a947f01244b70 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Mon, 22 Sep 2025 10:59:17 +0300 Subject: [PATCH 2/4] ; * doc/lispref/text.texi (Suspicious Text): Fix suspicious address. --- doc/lispref/text.texi | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi index ec30efe67a3..36f2ad1ccbc 100644 --- a/doc/lispref/text.texi +++ b/doc/lispref/text.texi @@ -5141,7 +5141,7 @@ suspicious. @var{object} should be a string. @item email-address-header Check whether a full RFC2822 email address header (e.g., -@samp{=?utf-8?Q?=C3=81?= }) looks suspicious. +@samp{=?utf-8?Q?=E2=84=AB?= }) looks suspicious. @var{object} should be a string. @end table From 704fab0452a403d2419261765242eb295677b245 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Fri, 26 Sep 2025 09:13:10 +0300 Subject: [PATCH 3/4] ; Improve documentation of handling errors * doc/lispref/control.texi (Processing of Errors): Document that pending input is discarded upon errors. (Bug#79510) --- doc/lispref/control.texi | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/doc/lispref/control.texi b/doc/lispref/control.texi index 4346840463d..689e7324d43 100644 --- a/doc/lispref/control.texi +++ b/doc/lispref/control.texi @@ -2034,7 +2034,8 @@ concept of continuable errors. @subsubsection How Emacs Processes Errors @cindex processing of errors -When an error is signaled, @code{signal} searches for an active +When a Lisp program signals an error, it calls the function +@code{signal}, which searches for an active @dfn{handler} for the error. A handler is a sequence of Lisp expressions designated to be executed if an error happens in part of the Lisp program. If the error has an applicable handler, the handler is @@ -2044,9 +2045,16 @@ established it; all functions called within that @code{condition-case} have already been exited, and the handler cannot return to them. If there is no applicable handler for the error, it terminates the -current command and returns control to the editor command loop. (The -command loop has an implicit handler for all kinds of errors.) The -command loop's handler uses the error symbol and associated data to +current command, flushes all pending unprocessed input events +(@pxref{Input Events})@footnote{ +Pending input is discarded because the user could have typed something +in advance under the assumption that execution will proceed without +errors, so keeping these input events would cause unintended +consequences, like inserting stray characters into an unrelated buffer +or execution of some unintended command. +}, and returns control to the editor command loop. +(The command loop has an implicit handler for all kinds of errors.) The +command loop's handler then uses the error symbol and associated data to print an error message. You can use the variable @code{command-error-function} to control how this is done: From 6d35c807e5ff5d00f734f88562e687a857515513 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sat, 27 Sep 2025 12:22:42 +0300 Subject: [PATCH 4/4] ; Improve documentation of globalized minor modes * doc/lispref/modes.texi (Defining Minor Modes): Document the subtlety with ':init-value t' for globalized modes. --- doc/lispref/modes.texi | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi index 421ec136c7c..c5c6c10a6fa 100644 --- a/doc/lispref/modes.texi +++ b/doc/lispref/modes.texi @@ -1861,7 +1861,17 @@ marking the @code{define-minor-mode} form as autoloaded. @item :init-value @var{init-value} This is the value to which the @var{mode} variable is initialized. Except in unusual circumstances (see below), this value must be -@code{nil}. +@code{nil}. If the mode is global (see below), and the initial value is +@code{t}, i.e., the mode is turned on by default, you should consider +forcing Emacs to run the mode function at startup, like this: + +@lisp + :initialize #'custom-initialize-delay +@end lisp + +@noindent +otherwise, the minor mode might not appear in the @file{*Help*} buffer +generated by @kbd{C-h m} (@pxref{Mode Help}). @item :lighter @var{lighter} The string @var{lighter} says what to display in the mode line