]> git.eshelyaron.com Git - emacs.git/commitdiff
; Fix documentation of last change
authorEli Zaretskii <eliz@gnu.org>
Thu, 7 Sep 2023 08:56:16 +0000 (11:56 +0300)
committerEli Zaretskii <eliz@gnu.org>
Thu, 7 Sep 2023 08:56:16 +0000 (11:56 +0300)
* lisp/minibuffer.el (minibuffer-regexp-prompts):
* doc/lispref/minibuf.texi (Minibuffer Misc): Fix docs (bug#50766).

doc/lispref/minibuf.texi
lisp/minibuffer.el

index 0b877a25e68a0575a5e9586774fe445657a9fbf9..661912437023e6104308dc20b4180a22bdfadc9c 100644 (file)
@@ -2879,19 +2879,20 @@ if the minibuffer is in a separate frame.  @xref{Minibuffers and Frames}.
 @end deffn
 
 @deffn Command minibuffer-regexp-mode
-This is a minor mode for editing regular expressions in the minibuffer.
-It highlight parens via @code{show-paren-mode} and
+This minor mode makes editing regular expressions in the minibuffer
+more convenient.  It highlight parens via @code{show-paren-mode} and
 @code{blink-matching-paren} in a user-friendly way, avoids reporting
-alleged paren mismatches and makes sexp navigation more intuitive.
-
-The list of prompts activating this mode in specific minibuffer
-interactions is customizable via @code{minibuffer-regexp-prompts}, see
-below.
+false paren mismatches, and makes sexp navigation more intuitive.
 @end deffn
 
+By default, only certain minibuffer prompts automatically activate the
+convenience features of @code{minibuffer-regexp-mode} when the
+minibuffer becomes active.  This list of prompts can be customized via
+@code{minibuffer-regexp-prompts}.
+
 @defopt minibuffer-regexp-prompts
-List of minibuffer prompts that trigger @code{minibuffer-regexp-mode}.
-@code{minibuffer-regexp-mode} is activated in a specific minibuffer
-interaction if and only if a prompt in this list appears at the
-beginning of the minibuffer.
+This variable holds the list of regular expressions for activating the
+features of @code{minibuffer-regexp-mode} in the minibuffer.  The
+mode's features will be activated only if the minibuffer prompt
+matches one of the regular expressions in the list.
 @end defopt
index d43201eb36d29358aacf8504f8c42c3345a114df..8c642b15a4d7fbeb3c8c05da56d7abd2d0684055 100644 (file)
@@ -4759,10 +4759,13 @@ and `blink-matching-paren' more user-friendly."
 
 (defcustom minibuffer-regexp-prompts
   '("Posix search" "RE search" "Search for regexp" "Query replace regexp")
-  "List of minibuffer prompts that trigger `minibuffer-regexp-mode'.
-`minibuffer-regexp-mode' is activated in a specific minibuffer
-interaction if and only if a prompt in this list appears at the
-beginning of the minibuffer."
+  "List of regular expressions that trigger `minibuffer-regexp-mode' features.
+The features of `minibuffer-regexp-mode' will be activated in a minibuffer
+interaction if and only if a prompt matching some regexp in this list
+appears at the beginning of the minibuffer.
+
+Setting this variable directly with `setq' has no effect; instead,
+either use \\[customize-option] interactively or use `setopt'."
   :type '(repeat (string :tag "Prompt"))
   :set (lambda (sym val)
         (set-default sym val)