# HG changeset patch
# User Luc Teirlinck <teirllm@auburn.edu>
# Date 1115332296 0
# Node ID cd1e4bc8e488dfea96ee28d8bf277b69301baf0b
# Parent  e002770fe3acffa2b693c7743b6dcd36292dd24f
(Fx_popup_menu, Fx_popup_dialog): Doc fixes.

diff -r e002770fe3ac -r cd1e4bc8e488 src/xmenu.c
--- a/src/xmenu.c	Thu May 05 22:15:58 2005 +0000
+++ b/src/xmenu.c	Thu May 05 22:31:36 2005 +0000
@@ -767,7 +767,14 @@
 With this form of menu, the return value is VALUE from the chosen item.
 
 If POSITION is nil, don't display the menu at all, just precalculate the
-cached information about equivalent key sequences.  */)
+cached information about equivalent key sequences.
+
+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
+`x-popup-menu' does not return.  But if POSITION is a mouse button
+event (indicating that the user invoked the menu with the mouse) then
+no quit occurs and `x-popup-menu' returns nil.  */)
      (position, menu)
      Lisp_Object position, menu;
 {
@@ -1005,7 +1012,11 @@
 An ITEM may also be just a string--that makes a nonselectable item.
 An ITEM may also be nil--that means to put all preceding items
 on the left of the dialog box and all following items on the right.
-\(By default, approximately half appear on each side.)  */)
+\(By default, approximately half appear on each side.)
+
+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
+`x-popup-dialog' does not return.  */)
      (position, contents)
      Lisp_Object position, contents;
 {