Mercurial > hg > xemacs-beta

comparison man/lispref/display.texi @ 1703:f561c3904bb3

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
[xemacs-hg @ 2003-09-20 01:46:53 by youngs] 2003-09-20 Ilya N. Golubev <gin@mo.msk.ru> * simple.el (raw-append-message): Allow user to specify alternative function for displaying message. (redisplay-echo-area-function): New. (clear-message): Allow user to specify function for finishing message display. (undisplay-echo-area-function): New. 2003-09-20 Ilya N. Golubev <gin@mo.msk.ru> * xemacs/mini.texi (Minibuffer): Add customizing message display reference. * lispref/display.texi (Customizing Message Display): New, describe `redisplay-echo-area-function', `undisplay-echo-area-function', `minibuffer-echo-wait-function'. (The Echo Area): Add menu. 2003-09-20 Ilya N. Golubev <gin@mo.msk.ru> * cmdloop.c (Fcommand_loop_1): Allow specifying elisp function for waiting user input while displaying message while in minibuffer. (Vminibuffer_echo_wait_function): New, associated variable... (vars_of_cmdloop): ... initialize it.
author youngs
date Sat, 20 Sep 2003 01:47:03 +0000
parents 1fa8838efe99
children f43f9ca6c7d9
comparison
equal deleted inserted replaced
1702:245980c04067 1703:f561c3904bb3
168 same as the minibuffer, despite the fact that the minibuffer appears 168 same as the minibuffer, despite the fact that the minibuffer appears
169 (when active) in the same place on the screen as the echo area. The 169 (when active) in the same place on the screen as the echo area. The
170 @cite{XEmacs Lisp Reference Manual} specifies the rules for resolving conflicts 170 @cite{XEmacs Lisp Reference Manual} specifies the rules for resolving conflicts
171 between the echo area and the minibuffer for use of that screen space 171 between the echo area and the minibuffer for use of that screen space
172 (@pxref{Minibuffer,, The Minibuffer, xemacs, The XEmacs Lisp Reference Manual}). 172 (@pxref{Minibuffer,, The Minibuffer, xemacs, The XEmacs Lisp Reference Manual}).
173 Such a conflicts may be avoided at all as described in @ref{Customizing Message
174 Display}.
175
173 Error messages appear in the echo area; see @ref{Errors}. 176 Error messages appear in the echo area; see @ref{Errors}.
174 177
175 You can write output in the echo area by using the Lisp printing 178 You can write output in the echo area by using the Lisp printing
176 functions with @code{t} as the stream (@pxref{Output Functions}), or as 179 functions with @code{t} as the stream (@pxref{Output Functions}), or as
177 follows: 180 follows:
345 appears at the end of the message. Otherwise, the cursor appears at 348 appears at the end of the message. Otherwise, the cursor appears at
346 point---not in the echo area at all. 349 point---not in the echo area at all.
347 350
348 The value is normally @code{nil}; Lisp programs bind it to @code{t} 351 The value is normally @code{nil}; Lisp programs bind it to @code{t}
349 for brief periods of time. 352 for brief periods of time.
353 @end defvar
354
355 @menu
356 * Customizing Message Display::
357 @end menu
358
359 @node Customizing Message Display
360 @subsection Customizing Message Display
361
362 Message display function specify message intended for echo area by
363 putting message text into @code{" *Echo Area*"} buffer. When event
364 loop code decides to update display after displaying the message, text
365 of this buffer is erased. How exactly the text will be displayed may
366 be affected by the following.
367
368 @findex redisplay-echo-area
369 @defvar redisplay-echo-area-function
370 The function called to display echo area text. The default variable
371 value, @code{redisplay-echo-area} function, does that by displaying
372 the text in the same place on the screen as the echo area. So does
373 other redisplay code. User code can avoid this regardless of what
374 redisplay code will run afterwards by erasing text of @code{" *Echo
375 Area*"} buffer.
376 @end defvar
377
378 @defvar undisplay-echo-area-function
379 The variable value, if non-@code{nil}, is called by command loop after
380 erasing text of @code{" *Echo Area*"} buffer. It must clean up data
381 created by @code{redisplay-echo-area-function} value.
382 @end defvar
383
384 @defvar minibuffer-echo-wait-function
385 The function is called by command loop only when minibuffer was active
386 and message was displayed (text appeared in @code{" *Echo Area*"}
387 buffer). It must wait after displaying message so that user can read
388 it. By default, when the variable value is @code{nil}, the equivalent
389 of @code{(sit-for 2)} is run.
350 @end defvar 390 @end defvar
351 391
352 @node Warnings 392 @node Warnings
353 @section Warnings 393 @section Warnings
354 394