From 9fcdd5b63fcb5f9c6fba9884911f305806980fd5 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sun, 20 Mar 2022 18:21:44 +0200 Subject: [PATCH] Improve doc strings of read-char-from-minibuffer-insert-* commands * lisp/subr.el (read-char-from-minibuffer-insert-char) (read-char-from-minibuffer-insert-other): Clarify the doc strings. (Bug#54479) --- lisp/subr.el | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/lisp/subr.el b/lisp/subr.el index 8e5a65efcd2..921853de607 100644 --- a/lisp/subr.el +++ b/lisp/subr.el @@ -3050,7 +3050,7 @@ If there is a natural number at point, use it as default." (make-hash-table :test 'equal)) (defun read-char-from-minibuffer-insert-char () - "Insert the character you type in the minibuffer and exit. + "Insert the character you type into the minibuffer and exit minibuffer. Discard all previous input before inserting and exiting the minibuffer." (interactive) (when (minibufferp) @@ -3059,9 +3059,11 @@ Discard all previous input before inserting and exiting the minibuffer." (exit-minibuffer))) (defun read-char-from-minibuffer-insert-other () - "Handle inserting of a character other than allowed. -Display an error on trying to insert a disallowed character. -Also discard all previous input in the minibuffer." + "Reject a disallowed character typed into the minibuffer. +This command is intended to be bound to keys that users are not +allowed to type into the minibuffer. When the user types any +such key, this command discard all minibuffer input and displays +an error message." (interactive) (when (minibufferp) (delete-minibuffer-contents) -- 2.39.2