[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
emacs-27 fdbe7ca: Document the changes in 'read-answer'
From: |
Eli Zaretskii |
Subject: |
emacs-27 fdbe7ca: Document the changes in 'read-answer' |
Date: |
Sat, 7 Mar 2020 06:41:08 -0500 (EST) |
branch: emacs-27
commit fdbe7cacfb1e56e8a2115971ad2a09cdd1b0fd85
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>
Document the changes in 'read-answer'
* doc/lispref/minibuf.texi (Multiple Queries): Document the
fact that 'read-answer' can now accept non-character input
events.
---
doc/lispref/minibuf.texi | 20 ++++++++++----------
etc/NEWS | 1 +
2 files changed, 11 insertions(+), 10 deletions(-)
diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi
index 1266cf8..c161599 100644
--- a/doc/lispref/minibuf.texi
+++ b/doc/lispref/minibuf.texi
@@ -2227,16 +2227,16 @@ the end of @var{question}. The possible responses are
provided in
@noindent
where @var{long-answer} is the complete text of the user response, a
string; @var{short-answer} is a short form of the same response, a
-single character; and @var{help-message} is the text that describes
-the meaning of the answer. If the variable @code{read-answer-short}
-is non-@code{nil}, the prompt will show the short variants of the
-possible answers and the user is expected to type the single
-characters shown in the prompt; otherwise the prompt will show the
-long variants of the answers, and the user is expected to type the
-full text of one of the answers and end by pressing @key{RET}. If
-@code{use-dialog-box} is non-@code{nil}, and this function was invoked
-by mouse events, the question and the answers will be displayed in a
-GUI dialog box.
+single character or a function key; and @var{help-message} is the text
+that describes the meaning of the answer. If the variable
+@code{read-answer-short} is non-@code{nil}, the prompt will show the
+short variants of the possible answers and the user is expected to
+type the single characters/keys shown in the prompt; otherwise the
+prompt will show the long variants of the answers, and the user is
+expected to type the full text of one of the answers and end by
+pressing @key{RET}. If @code{use-dialog-box} is non-@code{nil}, and
+this function was invoked by mouse events, the question and the
+answers will be displayed in a GUI dialog box.
The function returns the text of the @var{long-answer} selected by the
user, regardless of whether long or short answers were shown in the
diff --git a/etc/NEWS b/etc/NEWS
index 2d719fb..08bd2af 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -347,6 +347,7 @@ 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'.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- emacs-27 fdbe7ca: Document the changes in 'read-answer',
Eli Zaretskii <=