summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTed Zlatanov <tzz@lifelogs.com>2017-01-31 14:17:58 -0500
committerTed Zlatanov <tzz@lifelogs.com>2017-01-31 14:18:51 -0500
commit5af51bd4451ae6d00ab878a7cfc6782280a81c84 (patch)
tree28588b51f1f5ff0f6f22c9d9a8717cf5b6e2e2bb
parent52515f1133f2b87c573524d83c86b08e70ce1c30 (diff)
downloademacs-5af51bd4451ae6d00ab878a7cfc6782280a81c84.tar.gz
read-multiple-choice: explain dialog popups more
* lisp/emacs-lisp/subr-x.el (read-multiple-choice): Explain when a graphical popup is used and how it can be avoided.
-rw-r--r--lisp/emacs-lisp/subr-x.el5
1 files changed, 5 insertions, 0 deletions
diff --git a/lisp/emacs-lisp/subr-x.el b/lisp/emacs-lisp/subr-x.el
index 7736225b5fa..52331b9ad36 100644
--- a/lisp/emacs-lisp/subr-x.el
+++ b/lisp/emacs-lisp/subr-x.el
@@ -214,6 +214,11 @@ user enters `recenter', `scroll-up', or `scroll-down' responses,
perform the requested window recentering or scrolling and ask
again.
+When `use-dialog-box' is t (the default), this function can pop
+up a dialog window to collect the user input. That functionality
+requires `display-popup-menus-p' to return t. Otherwise, a text
+dialog will be used.
+
The return value is the matching entry from the CHOICES list.
Usage example: