summaryrefslogtreecommitdiff
path: root/doc/lispref/minibuf.texi
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2023-07-02 09:16:58 +0300
committerEli Zaretskii <eliz@gnu.org>2023-07-02 09:16:58 +0300
commit37ed3d15f38339400eba67647c87fad85de3a384 (patch)
tree765df1e0a93785c65e1f6b22b3f21e3049ac61f5 /doc/lispref/minibuf.texi
parent15ff87617772c2a2c3d8a3a1e2ed7f96e527ad9e (diff)
downloademacs-37ed3d15f38339400eba67647c87fad85de3a384.tar.gz
emacs-37ed3d15f38339400eba67647c87fad85de3a384.tar.bz2
emacs-37ed3d15f38339400eba67647c87fad85de3a384.zip
Avoid errors in completion due to 'completion-regexp-list'
* doc/lispref/minibuf.texi (Basic Completion): * src/minibuf.c (syms_of_minibuf) <completion-regexp-list>: Document that global non-nil settings of 'completion-regexp-list' are not safe. * lisp/minibuffer.el (completion-pcm--merge-completions): Avoid errors in 'try-completion' when PREFIX is nil. (Bug#64351)
Diffstat (limited to 'doc/lispref/minibuf.texi')
-rw-r--r--doc/lispref/minibuf.texi6
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi
index 52eea3b9535..7fbdd9eb6e2 100644
--- a/doc/lispref/minibuf.texi
+++ b/doc/lispref/minibuf.texi
@@ -1052,6 +1052,12 @@ This is a list of regular expressions. The completion functions only
consider a completion acceptable if it matches all regular expressions
in this list, with @code{case-fold-search} (@pxref{Searching and Case})
bound to the value of @code{completion-ignore-case}.
+
+Do not set this variable to a non-@code{nil} value globally, as that
+is not safe and will probably cause errors in completion commands.
+This variable should be only let-bound to non-@code{nil} values around
+calls to basic completion functions: @code{try-completion},
+@code{test-completion}, and @code{all-completions}.
@end defvar
@defmac lazy-completion-table var fun