changeset 62095:f1e37047f8ed

(Pop-Up Menus): Complete description of `x-popup-menu'. (Dialog Boxes): Complete description of `x-popup-dialog'.

--- a/lispref/frames.texi	Thu May 05 22:58:40 2005 +0000
+++ b/lispref/frames.texi	Thu May 05 23:05:00 2005 +0000
@@ -1402,6 +1402,13 @@
 where @var{line} is a string, and @var{value} is the value to return if
 that @var{line} is chosen.  An item can also be a string; this makes a
 non-selectable line in the menu.
+
+If the user gets rid of the menu without making a valid choice, for
+instance by clicking the mouse away from a valid choice or by typing
+keyboard input, then this normally results in a quit and
+@code{x-popup-menu} does not return.  But if @var{position} is a mouse
+button event (indicating that the user invoked the menu with the
+mouse) then no quit occurs and @code{x-popup-menu} returns @code{nil}.
 @end defun
 
   @strong{Usage note:} Don't use @code{x-popup-menu} to display a menu
@@ -1470,6 +1477,10 @@
 In some configurations, Emacs cannot display a real dialog box; so
 instead it displays the same items in a pop-up menu in the center of the
 frame.
+
+If the user gets rid of the dialog box without making a valid choice,
+for instance using the window manager, then this produces a quit and
+@code{x-popup-dialog} does not return.
 @end defun
 
 @node Pointer Shapes