diff options
Diffstat (limited to 'lispref/frames.texi')
| -rw-r--r-- | lispref/frames.texi | 23 |
1 files changed, 14 insertions, 9 deletions
diff --git a/lispref/frames.texi b/lispref/frames.texi index e5db70c1107..77694c87130 100644 --- a/lispref/frames.texi +++ b/lispref/frames.texi @@ -304,8 +304,8 @@ special-display-frame-alist}. If you use options that specify window appearance when you invoke Emacs, they take effect by adding elements to @code{default-frame-alist}. One exception is @samp{-geometry}, which adds the specified position to -@code{initial-frame-alist} instead. @xref{Command Arguments,,, emacs, -The GNU Emacs Manual}. +@code{initial-frame-alist} instead. @xref{Emacs Invocation,, Command +Line Arguments for Emacs Invocation, emacs, The GNU Emacs Manual}. @node Window Frame Parameters @subsection Window Frame Parameters @@ -1438,13 +1438,14 @@ the menu keymap as necessary. A dialog box is a variant of a pop-up menu---it looks a little different, it always appears in the center of a frame, and it has just -one level and one pane. The main use of dialog boxes is for asking -questions that the user can answer with ``yes'', ``no'', and a few other -alternatives. The functions @code{y-or-n-p} and @code{yes-or-no-p} use -dialog boxes instead of the keyboard, when called from commands invoked -by mouse clicks. - -@defun x-popup-dialog position contents +one level and one or more buttons. The main use of dialog boxes is +for asking questions that the user can answer with ``yes'', ``no'', +and a few other alternatives. With a single button, they can also +force the user to acknowledge important information. The functions +@code{y-or-n-p} and @code{yes-or-no-p} use dialog boxes instead of the +keyboard, when called from commands invoked by mouse clicks. + +@defun x-popup-dialog position contents &optional header This function displays a pop-up dialog box and returns an indication of what selection the user makes. The argument @var{contents} specifies the alternatives to offer; it has this format: @@ -1474,6 +1475,10 @@ Dialog boxes always appear in the center of a frame; the argument @code{x-popup-menu}, but the precise coordinates or the individual window don't matter; only the frame matters. +If @var{header} is non-@code{nil}, the frame title for the box is +@samp{Information}, otherwise it is @samp{Question}. The former is used +for @code{message-box} (@pxref{The Echo Area}). + 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. |