[Emacs-diffs] master 5af51bd: read-multiple-choice: explain dialog popups more

[Teodor Zlatanov]

branch: master
commit 5af51bd4451ae6d00ab878a7cfc6782280a81c84
Author: Ted Zlatanov <address@hidden>
Commit: Ted Zlatanov <address@hidden>

    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.
---
 lisp/emacs-lisp/subr-x.el |    5 +++++
 1 file changed, 5 insertions(+)

diff --git a/lisp/emacs-lisp/subr-x.el b/lisp/emacs-lisp/subr-x.el
index 7736225..52331b9 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: